gSOAP 源码分析(二)

最新推荐文章于 2024-09-13 21:56:59 发布
最新推荐文章于 2024-09-13 21:56:59 发布
阅读量6.7k 收藏 7
点赞数
分类专栏： # 网络 文章标签： soap encoding namespaces xml 文档 schema
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/flyfish1986/article/details/7603931
版权

 gSOAP 源码分析(二)

 

2012-5-24 flyfish

 

一 gSOAP XML介绍

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

比如

<Email>

<From>a@domain.com/From>

<To>b@domain.com</To>

<Head>Hello</Head>

<Body>Hello World</Body>

</Email>

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

 

 <ns:add>

   <a>0.0</a>

   <b>0.0</b>

  </ns:add>

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/">

  <ns:add>

   <a>0.0</a>

   <b>0.0</b>

  </ns:add>

 </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定义的默认命名空间

有了默认的命名空间

 

直接是<a>0.0</a>就可以，而不用<ns:a>0.0</ns:a>

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

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];

  register char *s = buf;

  register int i = sizeof(buf);

  register soap_wchar c = soap_getchar(soap);

  /* 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;

      }

    }

  }

  if ((int)c != EOF)

    c = soap_getchar(soap);

  return c;

}

 

 

四 XML Schema

定义了文档中的元素，属性，数据类型，默认值等

因为WSDL 是一种基于 schema 的语言，所以这个看WDSL文档更清楚

 <schema targetNamespace="urn:calc"

  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"

  xmlns="http://www.w3.org/2001/XMLSchema"

  elementFormDefault="unqualified"

  attributeFormDefault="unqualified">

  <import namespace="http://schemas.xmlsoap.org/soap/encoding/"/>

 </schema>

<message name="addRequest">

 <part name="a" type="xsd:double"/><!-- ns__add::a -->

 <part name="b" type="xsd:double"/><!-- ns__add::b -->

</message>

 

<message name="addResponse">

 <part name="result" type="xsd:double"/><!-- ns__add::result -->

</message>

定义简易元素的语法：

<part name="xxx" type="yyy"/>

 上面示例中a,b,result指的是元素的名称 double是数据类型,xsd:double 表示是XMLSchema

内建的数据类型

elementFormDefault="unqualified"

elementFormDefault这一属性用来指示 XML Schema 处理程序把这个 XML schema 中定义的元素或者类型放到哪个命名空间

Unqualified 表示目标命名空间下的这个属性不需要带命名空间前缀，子元素不必使用命名空间前缀

 

  attributeFormDefault="unqualified"

表示目标命名空间下的这个属性不需要带命名空间前缀.

<import namespace="http://schemas.xmlsoap.org/soap/encoding/"/> 表示需要导入的命名空间

 

 五 xml数据的绑定

soapcalcService.h文件中的接口声明函数

virtual int add(double a, double b, double *result) SOAP_PURE_VIRTUAL;

soapcalcService.cpp文件中的实现函数

int calcService::add(double a, double b, double *result)

{ 

*result = a + b;

return SOAP_OK;

} 

Req.Xml文件中 body元素中的内容

  <ns:add>

   <a>0.0</a>

   <b>0.0</b>

  </ns:add>

res.xml文件中 body元素中的内容

<ns:addResponse>

   <result>0.0</result>

  </ns:addResponse>

 

WSDL文件中add部分

<message name="addRequest">

 <part name="a" type="xsd:double"/><!-- ns__add::a -->

 <part name="b" type="xsd:double"/><!-- ns__add::b -->

</message>

 

<message name="addResponse">

 <part name="result" type="xsd:double"/><!-- ns__add::result -->

</message>

存根文件soapStub.h文件中

struct ns__add

{

public:

double a; /* required element of type xsd:double */

double b; /* required element of type xsd:double */

};

struct ns__addResponse

{

public:

double *result; /* SOAP 1.2 RPC return element (when namespace qualified) */ /* optional element of type xsd:double */

};

 

对比上述各个文件关于add的描述

目的是将数据解析到一个对象中，这些对象可以应用到我们的程序中。不需要编写代码搜索xml节点元素，只需要调用add这个函数，就可以得到double返回值

数据绑定，就是将xml数据转换成C++对象，这个C++对象可以表达出xml的数据块

 

六 xml数据的传输

 

soapC.cpp文件中关于add部分

 

add发送请求部分

soap_default_ns__add

soap_serialize_ns__add

soap_out_ns__add

soap_in_ns__add

soap_put_ns__add

soap_get_ns__add

soap_instantiate_ns__add

soap_copy_ns__add

 

add应答部分

soap_default_ns__addResponse

soap_serialize_ns__addResponse

soap_out_ns__addResponse

soap_in_ns__addResponse

soap_put_ns__addResponse

soap_get_ns__addResponse

soap_instantiate_ns__addResponse

soap_copy_ns__addResponse

每个函数都类似以上格式 一个发送请求的 default,serialize,out，in，put,get,instantiate,copy。

 

西笑生
关注
专栏目录
gsoap源代码 带实例带教程带使用说明
07-15
带gsoap-2.8源码，基于服务器客户端的实例，带自动生成服务客户端代码的批处理程序，及如何使用。带自己学习参考的教程； 0.解压附件，soapInterface.bat所在路径不得含中文 空格 1.新建头文件 取soapInterface.bat文件的同名：soapInterface.h 文件内编写接口，具体说明看附件参考的教程 //gsoap ns service name: gservice //gsoap ns service style: rpc int ns__add(int num1, int num2, int* result ); int ns__sub(int num1, int num2, int* result ); int ns__mult( int num1, int num2, int *result); int ns__divid( int num1, int num2, int *result); 2.从附件内gsoap-2.8包中搜索复制stdsoap2.h，stdsoap2.cpp，soapcpp2.exe， 存放于soapInterface.bat同级目录 3.双击soapInterface.bat运行。生成gClientSoap，gServerSoap两个文件夹，分别复制到服务器工程与客户端工程中使用 4.gClientSoap，gServerSoap两个文件夹内用到的文件功能说明，更多参考附件教程 1)soapC.cpp , soapH.h//soap的序列和反序列代码，它已经包含了soapStub.h 2)soapServer.c ppsoapServerLib.cpp //服务器端代码(纯C代码是soapServer.c soapServerLib.c ),soapServerLib.cpp文件则只是简单地包含soapServer.cpp和soapC.cpp 3)soapClient.cpp soapClientLib.cpp//客户端代码(纯C代码是soapClient.csoapClientLib.c )，soapClientLib.cpp文件则只是简单地包含soapClient.cpp和soapC.cpp 4) soapStub.h // soap的存根文件，定义了我们编写的头文件里对应的远程调用模型 5) add.nsmap //XML服务命名空间 6）服务器端要载入的文件有：soapServer.cpp,soapC.cpp,stdsoap2.cpp; 要包含的文件有：gservice.nsmap，soapH.h； 客户端要输入的文件有： soapClient.cpp，soapC.cpp,stdsoap2.cpp; 要包含的文件有：gservice.nsmap，soapH.h
gSOAP 源码分析(三)
flyfish
05-28 5924
gSOAP 源码分析(三) 2012-5-25 flyfish 一 HTTP请求方法 GET     请求获取Request-URI所标识的资源 POST    在Request-URI所标识的资源后附加新的数据 HEAD    请求获取由Request-URI所标识的资源的响应消息报头 PUT     请求服务器存储一个资源，并用Request-URI作为其标识 DEL
gSOAP2.8源码包
11-28
gSOAP是一个夸平台的,用于开发Web Service服务端和客户端的工具,在Windows、Linux、MAC OS和UNIX下使用C和C++语言编码,集合了SSL功能。
第六章 基于gsoap 生成onvif的C++源码
sxjkl10的博客
02-10 707
第六章 基于gsoap 生成onvif的C++源码 前言 gsoap是第三方工具，我们的重点是在onvif的源码基础上做二次开发。能够熟练使用gsoap工具，生成对应的C/C++框架代码，做好客户端或者服务端的前期准备。 一、openssl安装 centos7安装时一般带有openssl，建议卸载；onvif在使用过程中会用到onvif，在onvif封装库的时候，不是源码安装，使用过程会报错； 参考链接：https://blog.51cto.com/1012682/2380553?source=dra op
《gSoap编译生成ONVIF linux C/C++源码》
安阳知秋
05-16 541
文章目录1 准备1.1 简介1.2 下载1.3 安装编译OpenSSL1.4 安装编译gSOAP2 编译在线配置本地配置3 简单测试 1 准备 1.1 简介 ONVIF有很多模块，每个模块对应不同的WSDL文档，可以根据需求编译指定WSDL文档； WSDL文档可以通过协议规范，选择相应的wsdl，右键链接另存为(本地编译需要，在线编译不需要)； gSoap可以将WSDL文档编译生成C/C++源码； gSoap工具下载地址：gSoap下载 gSoap使用指南：https://www.genivia.com/
linux下onvif协议gsoap实现的源码(测试编译成功版)
01-29
5. **onvif_test源码分析** - `onvif_test`很可能是一个测试用例或示例程序，演示如何使用gSOAP与ONVIF设备交互。 - 可能包含了初始化gSOAP上下文、解析WSDL、调用ONVIF服务方法等功能。 - 通过阅读和调试`onvif_...
源码_qt程序通过gsoap访问webservice.zip
09-28
在“源码_qt程序通过gsoap访问webservice.zip”压缩包中，我们可以期待找到以下内容： 1. **Qt项目文件**：可能包含`.pro`文件，这是Qt Creator项目配置文件，定义了编译和链接的选项，以及项目依赖项。 2. **源...
gsoap和soapUI使用教程，
09-05
1. **安装gSOAP**：包括下载gSOAP源码，编译和安装到你的开发环境中。 2. **生成服务接口代码**：如何使用gSOAP的`soapcpp2`工具，根据WSDL（Web服务描述语言）文件自动生成客户端和服务端的C/C++代码。 3. **编码与...
gsoap生成onvif框架的脚本和示例代码
02-08
首先，你需要安装gSOAP，这通常涉及下载源码，编译并将其添加到你的开发环境中。在Windows系统中，可以使用预编译的二进制文件；而在Linux或macOS上，可以通过包管理器进行安装。 接下来，获取Onvif的WSDL文件，...
gsoap-linux-2.7.tar.gz_gsoap 2.7 linux_linux c soap_linux snmp_s
09-21
通过分析这些示例，开发者可以了解如何初始化gSOAP环境，生成客户端代码，发送请求，以及解析响应等基本操作。同时，这些示例也提供了实际项目中可能遇到的问题解决方案，如错误处理、安全通信等。 四、总结 gSOAP ...
gsoap编译的onvif客户端源码
07-31
使用gsoap编译出来的完整的onvif客户端代码，已在项目中使用，可放心下载。
C++ 通过gsoap生成WebServer 和WebClient 内附gsoap包和测试源码
08-24
C++ 通过gsoap生成WebServer 和WebClient 内附gsoap包和测试源码，内部附有gsoap包、简单的使用说明以及测试代码
gsoap_2.8.105.zip
08-13
gSOAP编译工具提供了一个SOAP/XML 关于C/C++ 语言的实现，从而让C/C++语言开发web服务或客户端程序的工作变得轻松了很多。绝大多数的C++web服务工具包提供一组API函数类库来处理特定的SOAP数据结构，这样就使得用户必须改变程序结构来适应相关的类库
基于 gsoap 生成 onvif 服务端框架代码
qq_39770363的博客
03-11 3218
gsoap 生成 onvif 服务端代码框架
gsoap生成onvif c/c++代码框架
mynamepass的博客
04-26 1175
j　　　　 和-i类似，区别在于生成的代理类不继承于soap struct，而是包含了包含了一个soap结构的指针。进入/home/james/workdir/gsoap-2.8/install/bin目录下，里面就是生成的工具了。地址：https://www.onvif.org/profiles/specifications/执行copy.sh后，此时的onvif_code/onvif_soap目录的文件如下。现在可以看到生成的onvif.h在onvif_code/onvif目录下。
使用gSOAP开发实例(5) libxml2解析SOAP响应消息
闲云野鹤 的专栏
11-07 1432
转载自yui的csdn博客 原文地址： http://blog.csdn.net/yui/article/details/5767494 电信provisioning系统中，常常需要与远程服务器实时交换一些数据，以完成用户的请求。由于简单对象访问协议（Simple Object Access Protocol, SOAP）的流行，许多涉及到第三方的应用，我们一般都比较乐意使用SOAP
gsoap xml 自动映射 C/C++
MyDriverC
04-22 3308
gsoap xml 自动映射 C/C++
Python XML 解析
最新发布
qq_48368964的博客
09-13 1509
XML 指可扩展标记语言（eXtensibleMarkupLanguage）。你可以通过本站学习XML 教程XML 被设计用来传输和存储数据。XML 是一套定义语义标记的规则，这些标记将文档分成许多部件并对这些部件加以标识。它也是元标记语言，即定义了用于定义其他与特定领域有关的、语义的、结构化的标记语言的句法语言。Python 对 XML 的解析常见的 XML 编程接口有 DOM 和 SAX，这两种接口处理 XML 文件的方式不同，当然使用场合也不同。characters(content)方法。
GSOAP工具安装与使用指南
"gsoap安装和使用" GSOAP是一个开源的C/C++软件开发工具包，用于构建基于Web服务的应用程序。它允许开发者通过SOAP（Simple Object Access Protocol）协议来实现客户端和服务端通信。GSOAP不仅支持HTTP，还支持...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

西笑生

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值