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

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); // 释放环境变量
　　}
　　在上面的例子中，需要两个环境变量信息。而在1.x版本中，由于静态分配环境变量，多线程技术是不被允许的（只有一个线程可以用这个环境变量调用远程方法或处理请求信息）。
　　8.2.4节将给出一个具体的多线程服务实例，它为每个SOAP请求分配一个独立线程进行处理。
　　Trackback: http://tb.blog.csdn.net/TrackBack.aspx?PostId=661693

本文转自
http://blog.csdn.net/lithe/archive/2006/04/13/661693.aspx