gSOAP 源码分析(二)-蒲公英云

gSOAP 源码分析(二)

2012-5-24 邵盛松

一 gSOAP XML介绍

Xml的全称是EXtensible Markup Language。可扩展标记语言。仅仅是一个纯文本。适合用于数据的存储和传输。里面的标签由作者赋予它含义

比如

a@domain.com/From>

b@domain.com

Hello

Hello World

可以赋予这个xml文档含义是 a发送给b一封邮件,邮件标题是“Hello”，正文是“Hello World”

0.0

0.0

gSOAP赋予add为一个接口函数的名称，a和b是接口函数参数

二命名空间

<?xml version=”1.0” encoding=”UTF-8”?>

<SOAP-ENV:Envelope

xmlns:SOAP-ENV=”http://schemas.xmlsoap.org/soap/envelope/“

xmlns:SOAP-ENC=”http://schemas.xmlsoap.org/soap/encoding/“

xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance“

xmlns:xsd=”http://www.w3.org/2001/XMLSchema“

xmlns:ns=”urn:calc”>

<SOAP-ENV:Body SOAP-ENV:encodingStyle=”http://schemas.xmlsoap.org/soap/encoding/">

0.0

0.0

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

由于标签是我们自定义的，多个XML文件中可能存在重复命名，但表示的含义却不一样，为了解决XML文档中命名的冲突问题就出现了命名空间。所以需要加上一个namespace来区分多个xml文件之间相同的标签。

使用语法：xmlns:namespace-prefix=”namespaceURI”

xmlns的意思是XML Namespace

URI是Uniform Resource Identifier 的缩写，作用是赋予命名空间一个惟一的名称用来表示URI 一个是URL，一个是**URN**，gSOAP中URL和URN都使用了：xmlns:ns=”urn:calc

其中calc是一个接口文件的文件名。这句是gsoap定义的默认命名空间有了默认的命名空间，直接是0.0就可以，而不用0.0

关于命名空间的处理代码如下

SOAP_FMAC1 int SOAP_FMAC2 soap_match_namespace(struct soap*, const char *, const char*, size_t n1, size_t n2);

SOAP_FMAC1 int SOAP_FMAC2 soap_set_namespaces(struct soap*, const struct Namespace*);

SOAP_FMAC1 void SOAP_FMAC2 soap_set_local_namespaces(struct soap*);

SOAP_FMAC1 void SOAP_FMAC2 soap_pop_namespace(struct soap*);

SOAP_FMAC1 struct soap_nlist* SOAP_FMAC2 soap_push_namespace(struct soap*, const char *,const char *);

SOAP_FMAC1 const char* SOAP_FMAC2 soap_current_namespace(struct soap *soap, const char *tag);

SOAP_FMAC1 struct soap_nlist* SOAP_FMAC2 soap_lookup_ns(struct soap *soap, const char *tag, size_t n);

三编码

gSOAP默认使用的是使用UTF-8编码

关于编码的处理函数

SOAP_FMAC1 int SOAP_FMAC2 soap_pututf8(struct soap*, unsigned long);

SOAP_FMAC1 soap_wchar SOAP_FMAC2 soap_getutf8(struct soap*);

SOAP_FMAC1 int SOAP_FMAC2 soap_putbase64(struct soap*, const unsigned char*, int);

SOAP_FMAC1 unsigned char* SOAP_FMAC2 soap_getbase64(struct soap*, int*, int);

SOAP_FMAC1 int SOAP_FMAC2 soap_puthex(struct soap*, const unsigned char*, int);

SOAP_FMAC1 unsigned char* SOAP_FMAC2 soap_gethex(struct soap*, int*);

XML指令处理（XML PI）

目的是为了给XML解析器提供额外的信息。这里处理XML文件的编码信息 <?xml version=”1.0” encoding=”UTF-8”?>

gSOAP关于指令处理代码如下

soap_get_pi(struct soap *soap)

{ char buf[64];

/* This is a quick way to parse XML PI and we could use a callback instead to

* enable applications to intercept processing instructions */

while ((int)c != EOF && c != ‘?’)

{ if (—i > 0)

\{ if (soap\_blank(c))
    c = ' ';
  \*s++ = (char)c;
\}
c = soap\_getchar(soap);

}

*s = ‘\0’;

DBGLOG(TEST, SOAP_MESSAGE(fdebug, “XML PI <?%s?>\n”, buf));

if (!strncmp(buf, “xml “, 4))

{ s = strstr(buf, “ encoding=”);

if (s && s\[10\])
\{ if (!soap\_tag\_cmp(s + 11, "iso-8859-1\*")
   || !soap\_tag\_cmp(s + 11, "latin1\*"))
  \{ DBGLOG(TEST, SOAP\_MESSAGE(fdebug, "Switching to latin1 encoding\\n"));
    soap->mode |= SOAP\_ENC\_LATIN;
  \}
  else if (!soap\_tag\_cmp(s + 11, "utf-8\*"))
  \{ DBGLOG(TEST, SOAP\_MESSAGE(fdebug, "Switching to utf-8 encoding\\n"));
    soap->mode &= ~SOAP\_ENC\_LATIN;
  \}
\}