①(*********)soap结构中count(soap->count)成员记录的是http协议中Content-Length的数值;
②keep_alive既是在通讯过程中的正常链接的一个状态标示也是关系到http协议中Connection:keep-alive的填写open还是close.
1) gsoap中生成的*.c文件中在生成xml协议信息时,是通过soap->fposthdr,soap_puthttphdr生成一些http协议部分.
2)在gsoap通讯过程中,通过soap->fpost(),生成发送协议中的http协议部分.
函数soap_set_local_namespaces(struct soap *soap)
3)soap_connect()函数中把原来的soap->mode进行了修改,这样在下次调用,同时对填入soap->buf的字符进行计数,在函数soap_connect()中soap->bufidx统计的是http协议部分的字符数;在soap_envelope_begin_out()统计envelope部分的计数,同时填写xml中envelope部分;soap_putheader()统计putheader部分的计数,同时填写xml中putheader部分;soap_body_begin_out()统计body部分的计数,同时填写xml中body部分;soap_put___tds__(*)(*标示相关功能标识,例如GetNetworkInterfaces)统计__(*)(*标示相关功能标识,例如GetNetworkInterfaces)部分的计数,同时填写xml中__(*)(*标示相关功能标识,例如GetNetworkInterfaces)部分;soap_body_end_outconnect()中soap->bufidx统计的是body部分结束标签的字符数同时把结束标签写入xml;soap_envelope_end_out()同前;soap_end_send()->soap_flush()->soap_flush_raw()->soap->fsend(),在函数soap_end_send()中进行sock发送,在此函数中第一次使用soap结构(接受/发送结束),对soap->budidx,soap->count进行清零.在 次之前结构中soap->buflen一次未用到,猜测次成员只在解析时使用.在这些处理过程中,如果(soap->bufidx > SOAP_BUFLEN),那么,由于soap_connect()已经建立了socket通讯,所以只要条件满足就用soap->flush()把buf中的协议包发送给服务器端,不会丢失协议内容,至于服务器端怎样处理,只有读代码了.
4)soap_element()
{ if (soap->namespaces && !soap->local_namespaces)
{ register const struct Namespace *ns1;
register struct Namespace *ns2;
register size_t n = 1;
for (ns1 = soap->namespaces; ns1->id; ns1++)
n++;
n *= sizeof(struct Namespace);
ns2 = (struct Namespace*)SOAP_MALLOC(soap, n);
if (ns2)
{ memcpy(ns2, soap->namespaces, n);
if (ns2[0].ns)
{ if (!strcmp(ns2[0].ns, soap_env1))
soap->version = 1;
else
soap->version = 2;
}
soap->local_namespaces = ns2;
}
}
}
黑体字标示的地方,作用是吧ns2为首地址的各个成员指针指向在*.nsmap中的SOAP_NMAC struct Namespace namespaces[]{...}定义成员.
5)soap_attribute(){}函数是填写/处理xml协议中的"<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://www.w3.org/2003/05/soap-envelope" xmlns:SOAP-ENC="http://www.w3.org/2003/05/soap-encoding" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:wsa5="http://www.w3.org/2005/08/addressing" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:xenc="http://www.w3.org/2001/04/xmlenc#" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" xmlns:xmime="http://tempuri.org/xmime.xsd" xmlns:tt="http://www.onvif.org/ver10/schema" xmlns:tds="http://www.onvif.org/ver10/device/wsdl" xmlns:ter=">"类似xmlns:SOAP-ENV这些信息.
6)soap_element_begin_out函数//填写/处理一个标签的开始部分,包括它的属性信息,例如“xmlns:SOAP-ENV="http://www.w3.org/2003/05/soap-envelope"”
{
.............
soap_element()函数填写/处理一个xml节点标签的从“<”开始到">"之前的所有信息,
..............
soap_element_start_end_out()函数填写/处理同一xml节点标签的">".
.................
}
7)soap_putheader(){}->soap_out_SOAP_ENV__Header(){//用于处理(填写)xml中的soapheader部分标签
if (soap_element_begin_out()){//填写/处理header的开始标签
}
if (soap_out__wsa__MessageID()){
//soap_out__wsa__MessageID()==soap_out_string(){
//soap_outstring(){
// id = soap_element_id()//该id值可以是soap->malloc动态分配的空间在soap机构中struct soap_plist *pht[SOAP_PTRHASH];链表中的id值
//
}
//}
}
}
8)SOAP_FMAC5 int SOAP_FMAC6 soap_call___tds__(*)(例如GetNetworkInterfaces){
}
9)soap_default__<*>(<*>代表相应的功能函数标识, 例如soap_default__tds__GetNetworkInterfacesResponse)(){}//仅仅是对恢复结构进行初始化
10)soap_begin_count()函数在再次soap结构中一些在该请求中要用到和可能用到的量进行清零/初始化,最主要是的设置xml结构的mode信息默认情况下是soap->mode=0x20008;
11)soap_begin_recv(){
.......//前面在进行一些在接收/解析过程中的用到的一些数据的初始化/清理
Ⅰ) c = soap_getchar(soap);/*第一次进行接收数据,然而即使这次数据量为零,
*也 没有关 系,因为在后面的
*soap_envelope_begin_in()等函数中可以再次接收,
*也就是说第一次接收到数据量为0或者没有接收完完整
*的协议内容也可以在后面的soap_envelope_begin_in()
*等这些函数中继续接收,只要soap->socket不释放掉
*就可以.其中soap->buflen中记录了一次接收到的数据的
*字符统计数字,同时soap->count统计总的接收到的字符数.soap->bufidx = 0;soap->buflen = ret = soap->frecv()在每次socket接收前对soap->budidx进行清零;每次在soap_getchar(struct soap *soap){.......
return soap_get1(soap);}之前对soap->ahead进行清零/处理;整理得知:soap_getchar()->soap_get1()->soap_recv()/return (unsigned char)soap->buf[soap->bufidx++];->soap_recv_raw(soap)->soap->frecv()*/
......//这里是些宏选择代码
Ⅱ) while (soap_blank(c))//Ⅰ) Ⅱ) Ⅲ) 这三句代码目的:找到第一次接收到的数据信息中从soap->buf[0]开始的第一个不是0x00-0x20之间asii码之间的字符
Ⅲ) c = soap_getchar(soap);
.....//通过一系列的if()判断后从接收到的buf中找打第一个符合协议的要求的字符,这个字符存储在c变量中.
然后把这个符合协议要求起始字符存储在soap->ahead中(存储的是ASII码).
soap->error = soap->fparse(soap);//解析出http协议部分.
}
12)soap_envelope_begin_in(){//对指定的协议标识字符串进行解析, 例如SOAP-ENV:Envelope
if (soap_element_begin_in(soap, "SOAP-ENV:Envelope", 0, NULL)){
//soap_element_begin_in()=>if (!soap_peek_element(soap)){//soap_peek_element主要目的是在xml中找到相应的匹配字符串.例如SOAP-ENV:Envelope,存储在soap->tag中
..............
soap_unget(soap, c);//获取到第一个xml协议的第一个"<"
................
while (soap_blank(c))
c = soap_get(soap););//把xml协议的头部信息过滤掉.即:<?xml .....?>
....................
s = soap->tag;
do c = soap_get1(soap);
while (soap_blank(c));
i = sizeof(soap->tag);
while (c != '>' && c != '/' && soap_notblank(c) && (int)c != EOF)
{ if (--i > 0)
*s++ = (char)c;
c = soap_get1(soap);
}
while (soap_blank(c))
c = soap_get1(soap);
*s = '\0';//这几行把要解析的目标在xml中找到,即:"SOAP-ENV:Envelope"
...........
soap_pop_namespace(soap);//根据soap结构定义,可能和首选什么命名空间有关,在命令中也许和-n/-N有关,不确定.在测试中它返回值为NULL,即soap->nlist=NULL
........//后面紧接着是对命名空间的解析过程,同时对soap->body进行赋值if (!(soap->body = (c != '/')))
}
}
}
13)soap_recv_header()把xml数据中的相应解析得到数据放置在在soap->header中
14)soap_body_begin_in()与前面的连个函数相似功能.