- Server Files Contains :
- soapStub.h
- soapH.h
- soapC.cpp
- {soap.h}.nsmap
- {soap.h}{service_name}Service.cpp
- {soap.h}{service_name}Service.h
- {service_name}.wsdl
- Client Files Contains :
- soapStub.h
- soapH.h
- soapC.cpp
- soapClient.cpp
- {service_name}.wsdl
產生Server/Client的方法如下：
第一步：定義 soap.h，範例如下：
//gsoap ns2 service name: soap
//gsoap ns2 service style: rpc
//gsoap ns2 service encoding: encoded
//gsoap ns2 service namespace: http://www.ateam.cn
//gsoap ns2 schema namespace: urn:proscan
class ResponseBase {
char status;
char *message;
};
class NtpResponse : public ResponseBase {
char *dateTime;
char *host;
};
int ns2__getNtpHost(
NtpResponse &result ///< Output parameter, : unqualified name as per RPC encoding
);
int ns2__setNtpHost(
char *name,
char *host,
NtpResponse &result
);
//gsoap ns2 service style: rpc
//gsoap ns2 service encoding: encoded
//gsoap ns2 service namespace: http://www.ateam.cn
//gsoap ns2 schema namespace: urn:proscan
class ResponseBase {
char status;
char *message;
};
class NtpResponse : public ResponseBase {
char *dateTime;
char *host;
};
int ns2__getNtpHost(
NtpResponse &result ///< Output parameter, : unqualified name as per RPC encoding
);
int ns2__setNtpHost(
char *name,
char *host,
NtpResponse &result
);
第二步：根據soap.h檔，產生Server/Client所需的程式，語法如下：
- Server Comnad:
#soapcpp2 -jSL soap.h
- Client Command :
#soapcpp2 -jCL soap.h
第三步：撰寫主程式
- Server : main.cpp
#include <pthread.h>
#include "soap.nsmap"
#include "soapsoapService.h"
#include "strtool.h"
using std::string;
using std::vector;
using std::cout;
using std::endl;
#define WSDL_PATH "proscan.wsdl"
int rep_wsdl(struct soap *soap, string path, string params)
{
FILE *fd = NULL;
fd = fopen(WSDL_PATH, "rb");
if (!fd)
return 404;
soap->http_content = "text/xml";
soap_response(soap, SOAP_FILE);
for (;;)
{
size_t r = fread(soap->tmpbuf, 1, sizeof(soap->tmpbuf), fd);
if (!r)
break;
if (soap_send_raw(soap, soap->tmpbuf, r))
break;
}
fclose(fd);
soap_end_send(soap);
return SOAP_OK;
}
int http_get(struct soap *soap)
{
vector<string> vt;
strtool::split(soap->path, vt, "?");
if ( vt[0].compare("/proscan") == 0 ) {
if ( vt.size() == 2 && vt[1].compare("wsdl") == 0 ) {
return rep_wsdl(soap, vt[0] , vt[1]);
}
}
return SOAP_GET_METHOD;
}
int main(int argc, char **argv)
{
struct soap soap;
int server_port = 8080;
//proscanService proscan(SOAP_XML_INDENT);
soap.fget = http_get;
soap.bind_flags = SO_REUSEADDR;
soap.send_timeout = 60; // 60 seconds
soap.recv_timeout = 60; // 60 seconds
soap.accept_timeout = 3600; // server stops after 1 hour of inactivity
soap.max_keep_alive = 100; // max keep-alive sequence
soapService soapService(&soap);
if ( argc > 2 ) {
server_port = atoi(argv[1]);
}
if (soapService.run(server_port) != SOAP_OK) {
soapService.soap_stream_fault(std::cerr);
}
soapService.destroy();
}
- Client : main.cpp
準備中
第四步：編譯程式碼
* 注意：編譯前需從原始碼裡複製此兩檔案 ： stdsoap2.cpp, stdsoap2.h
- Server Command
#g++ -o ${target} main.cpp soap.cpp soapsoapService.cpp main.cpp soapC.cpp stdsoap2.cpp -lpthread - Client Command
#g++ -o ${target} soap.cpp soapC.cpp soapClient.cpp stdsoap2.cpp
備註：
除了自行編寫soap.h之外，gsoap還提供將wsdl轉成soap.h的方法，語法如下：
#wsdl2h -o calc.h http://www.genivia.com/calc.wsdl
Reference:
[1] https://www.genivia.com/dev.html#what
