gsoap相关

小鱼儿 2022-08-25 13:50 127阅读 0赞

(1)soapcpp2 calc.h

编译器生成skeleton 函数soap serve ns add, soap serve ns sub,and soap serve ns sqrt

soapC.cpp 包含了skeleton的串行化和并行化函数

编译器还产生相关的服务函数（service dispatcher）soap\_server函数用来操作client 端的数据流（request）调用合适的骨架函数处理该请求。

(2) 远程函数的调用必须返回一个errocode 例如：SOAP\_OK  SOAP\_FAULT 等

SOAP 1.1The exception description can be assigned to the soap->fault->faultstring string and details can be assigned to the soap->fault->detail string

SOAP1.2 requires the soap->fault->SOAP ENV Reason and the soap->fault->SOAP ENV Detail strings to be assigned.

服务端用soap receiver fault 返回相应的错误信息：

return soap receiver fault(soap, ”Square root of negative number”, ”I can only take the square root of a non-negative number”);

// Contents of file ”calc.cpp”:  
\#include ”soapH.h”  
\#include <math.h> // for sqrt()  
main()  
\{ soap serve(soap new()); // use the remote method request dispatcher  
\}// Implementation of the ”add” remote method:  
int ns add(struct soap \*soap, double a, double b, double &result)  
\{ result = a + b;  
return SOAP OK;  
\}// Implementation of the ”sub” remote method:  
int ns sub(struct soap \*soap, double a, double b, double &result)  
\{ result = a - b;  
return SOAP OK;  
\}// Implementation of the ”sqrt” remote method:  
int ns sqrt(struct soap \*soap, double a, double &result)  
\{ if (a >= 0)  
\{ result = sqrt(a);  
return SOAP OK;  
\}else

return soap receiver fault(soap, ”Square root of negative number”, ”I can only take the square  
root of a non-negative number”);  
\}// As always, a namespace mapping table is needed:  
struct Namespace namespaces\[\] =  
\{ // \{”ns-prefix”, ”ns-name”\}  
\{”SOAP-ENV”, ”http://schemas.xmlsoap.org/soap/envelope/”\},  
\{”SOAP-ENC”, ”http://schemas.xmlsoap.org/soap/encoding/”\},  
\{”xsi”, ”http://www.w3.org/2001/XMLSchema-instance”\},  
\{”xsd”, ”http://www.w3.org/2001/XMLSchema”\},  
\{”ns”, ”urn:simple-calc”\}, // bind ”ns” namespace prefix  
\{NULL, NULL\}  
\};

（3）

int main()  
\{ struct soap soap;  
int m, s; // master and slave sockets  
soap init(&soap);  
m = soap bind(&soap, "machine.cs.fsu.edu", 18083, 100);  
if (m < 0)  
soap print fault(&soap, stderr);  
else  
\{ fprintf(stderr, "Socket connection successful: master socket = %d/n", m);  
for (int i = 1; ; i++)  
\{ s = soap accept(&soap);  
if (s < 0)  
\{ soap print fault(&soap, stderr);  
break;  
\}fprintf(stderr, "%d: accepted connection from IP=%d.%d.%d.%d socket=%d", i,  
(soap.ip>>24)&0xFF, (soap.ip>>16)&0xFF, (soap.ip>>8)&0xFF, soap.ip&0xFF, s);  
if (soap serve(&soap) != SOAP OK) // process RPC request  
soap print fault(&soap, stderr); // print error  
fprintf(stderr, "request served/n");  
soap destroy(&soap); // clean up class instances  
soap end(&soap); // clean up everything and close socket  
\}  
\}soap done(&soap); // close master socket and detach environment  
\}

Function Description  
soap new() Allocates and Initializes gSOAP context

soap init(struct soap \*soap) Initializes a stack-allocated gSOAP context (required  
once)

soap bind(struct soap \*soap, char \*host, int port,int backlog) Returns master socket (backlog = max. queue size for requests). When host==NULL: host is the machine on which the service runs

soap accept(struct soap \*soap) Returns slave socket

soap end(struct soap \*soap) Clean up deserialized data (except class instances) and temporary data

soap free temp(struct soap \*soap) Clean up temporary data only

soap destroy(struct soap \*soap) Clean up deserialized class instances (note: thisfunction will be renamed with option -n

soap done(struct soap \*soap) Reset and detach context: close master/slave sockets and remove callbacks

soap free(struct soap \*soap) Detach and deallocate context (soap new())