关于gsoap工具soapcpp2.exe无法通过头文件生成wsdl接口描述语言文件的原因

77 阅读 0 评论 51 点赞

我是靠谱客的博主愉快指甲油，最近开发中收集的这篇文章主要介绍关于gsoap工具soapcpp2.exe无法通过头文件生成wsdl接口描述语言文件的原因，觉得挺不错的，现在分享给大家，希望可以做个参考。

概述

wsdl是通过wsdl文件作为不同应用的通信接口，所以如何生成wsdl语言很重要，但是很多时候我们发现自己编写的头文件通过gsoap工具soapcpp2.exe从头文件中无法正常生成对应的wsdl语言，几经寻找，终于发现：

通过对应头文件.h生成客户端或服务器代理代码的时候，对应的头文件中的注释描述信息和对外接口都需要有规定的格式才能正确生成wsdl语言文件。

1、如过头文件中导出函数命名没有前缀，那么能生成对应的客户端或服务器代理相关代码，但是无法为每一个接口生成对应的请求和响应wsdl文件，否则，必须添加ns__前缀，注意是两条下划线才可以生成，且生成的schema对应的域名为默认ns.xsd

头文件：

#ifndef _C_WEB_CLIENT_INTERFACE_
#define _C_WEB_CLIENT_INTERFACE_

int ns__Add( int num1, int num2, int* sum );
int ns__Sub(int num1, int num2, int* sum);
int ns__Mul(char *namelist, char **arealist);

#endif

生成命令：

soapcpp2 -c test.h -1

生成结果包含各个接口的请求和响应wsdl文件，例如Add方法的请求wsdl： ns.Add.req.xml

<?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="http://tempuri.org/ns.xsd">
<SOAP-ENV:Body>
<ns:Add>
<num1>0</num1>
<num2>0</num2>
</ns:Add>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Add方法的响应wsdl文件：ns.Add.res.xml

<?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="http://tempuri.org/ns.xsd">
<SOAP-ENV:Body>
<ns:AddResponse>
<sum>0</sum>
</ns:AddResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

2、加入带注释的wsdl配置项目

#ifndef _C_WEB_CLIENT_INTERFACE_
#define _C_WEB_CLIENT_INTERFACE_

// wsdl配置项
//gsoap ns service name: name_area
//gsoap ns service style: rpc
//gsoap ns service encoding: encoded
//gsoap ns service namespace: http://127.0.0.1:9000/name_area.wsdl
//gsoap ns service location: http://127.0.0.1:9000/name_area
//gsoap ns schema namespace: urn:name_area

int ns__Add( int num1, int num2, int* sum );
int ns__Sub(int num1, int num2, int* sum);
int ns__Mul(char *namelist, char **arealist);

#endif

生成add方法的请求wsdl文件名：name_area.Add.req.xml

<?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:name_area">
<SOAP-ENV:Body SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<ns:Add>
<num1>0</num1>
<num2>0</num2>
</ns:Add>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

生成add方法的响应wsdl文件名：name_area.Add.res.xml

<?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:name_area">
<SOAP-ENV:Body SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<ns:AddResponse>
<sum>0</sum>
</ns:AddResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>