WEB开发网
开发学院WEB开发Jsp gsoap中文文档(5.gSoap2.x版与gSOAP 1.x版的不同... 阅读

gsoap中文文档(5.gSoap2.x版与gSOAP 1.x版的不同)

 2008-01-05 18:39:47 来源:WEB开发网   
核心提示:5. gSoap2.x版与gSOAP 1.x版的不同 假如你是从1.x版升级到2.x版,请注重下面的内容,gsoap中文文档(5.gSoap2.x版与gSOAP 1.x版的不同), gSOAP2.0及之后的版本是在1.x版基础上重写的,gSOAP2.0之后的版本是线程安全的,退出 ... soap_call_ns__

5. gSoap2.x版与gSOAP 1.x版的不同
 假如你是从1.x版升级到2.x版,请注重下面的内容。
 gSOAP2.0及之后的版本是在1.x版基础上重写的。gSOAP2.0之后的版本是线程安全的,但之前版本不是。gSOAP2.x版本中的主要文件已经重新命名,以便与1.x版区分。

gSOAP 1.X  gSOAP 2.X 
soapcpp  soapcpp2 
soapcpp.exe  soapcpp2.exe 
stdsoap.h  stdsoap2.h 
stdsoap.c  stdsoap2.c 
stdsoap.cpp  stdsoap2.cpp 
 
 从1.x版升级到2.x版并不需要进行大量的代码重写工作。所有2.x版相关的函数都定义在stdsoap2.c[pp]文件中,这个文件是由gSOAP编译器自动生成的。所以,用1.x版开发的服务端或客户端代码需要进行修改以适应2.x版中函数的变化:在2.x版中,所有的gSOAP函数都增加了一个参数用来保存一个gSOAP运行环境实例。这个参数包括了文件描述,表,缓冲,标志位等,它在所有gSOAP函数中都是第一个参数。
 gSOAP运行环境实例是一个strUCt soap类型的变量。当客户端程序访问远程方法前或当服务端程序能够接收一个请求前,必须先将这个运行环境变量初始化。在2.x版中新增了3个函数来负责这些事情:
 函数             解释
 soap_init(struct soap *soap)      初始化环境变量(只需执行一次)
 struct soap *soap_new()       定义并初始化环境变量并返回一个该变量的指针
 struct soap *soap_copy(struct soap *soap)   定义一个环境变量并从已有的环境变量中拷贝环境信息
 
 环境变量定义好后就可以重复使用而不必再次初始化了。只有当线程独占访问时,我们才需要一个新的环境变量。例如,下面的代码分配了一个用于多个远程方法的环境变量:
 int main()
{
  struct soap soap;
  ...
  soap_init(&soap); // 初始化环境变量
  ...
  soap_call_ns__method1(&soap, ...); // 调用一个远程方法
  ...
  soap_call_ns__method2(&soap, ...); // 调用另一个远程方法
  ...
  soap_end(&soap); // 清除环境变量
  ...
}
 我们也可以像下面这样定义环境变量:
 int main()
{
  struct soap *soap;
  ...
  soap = soap_new(); // 定义并初始化环境变量
  if (!soap) // 假如不能定义,退出
  ...
  soap_call_ns__method1(soap, ...); // 调用远程函数
  ...
  soap_call_ns__method2(soap, ...); // 调用另一个远程函数
  ...
  soap_end(soap); // 清除环境变量
  ...
  free(soap); // 释放环境变量空间
}
 
 服务端代码在调用soap_serve函数前,需要定义相关环境变量:

int main()
{
  struct soap soap;
  soap_init(&soap);
  soap_serve(&soap);

 或者像下面这样:

int main()
{
  soap_serve(soap_new());

 soap_serve函数用来处理一个或多个(当答应HTTP keep-alive时,参见18.11节中的SOAP_IO_KEEPALIVE标志)请求。
 一个web服务可以用多线程技术来处理请求:
int main()
{
  struct soap soap1, soap2;
  pthread_t tid;
  ...
  soap_init(&soap1);
  if (soap_bind(&soap1, host, port, backlog) < 0) exit(1);
  if (soap_accept(&soap1) < 0) exit(1);
  pthread_create(&tid, NULL, (void*(*)(void*))soap_serve, (void*)&soap1);
  ...
  soap_init(&soap2);
  soap_call_ns__method(&soap2, ...); // 调用远程方法
  ...
  soap_end(&soap2);
  ...
  pthread_join(tid, NULL); // 等待线程结束
  soap_end(&soap1); // 释放环境变量


Tags:gsoap 文档

编辑录入:爽爽 [复制链接] [打 印]
赞助商链接