gsoap使用心得!

gSOAP 是一个夸平台的，用于开发 Web Service 服务端和客户端的工具，在 Windows 、 Linux 、 MAC OS 和UNIX 下使用 C 和 C++ 语言编码，集合了 SSL 功能。

下载地址： http://sourceforge.net/projects/gsoap2

官方网站： http://genivia.com/Products/gsoap/index.html

对于 Windows 平台下开发客户端，首先下载最新的 gsoap_win32_2.7.6c.zip 包，具体在以下地址：http://optusnet.dl.sourceforge.net/sourceforge/gsoap2/gsoap_win32_2.7.6c.zip

首先查看gsoap的User's Guide，基本就能对gsoap有个全面的了解，通过阅读Sample里的例子程序深入。然后搜索网上其它一些文章，比如：
gSOAP简单多线程服务器程序 http://blog.chinaunix.net/u1/55091/showart_430965.html 
纯c gSoap实现WebService            http://hi.baidu.com/2sky2sea/blog/item/40ec5555680279c1b745ae9b.html  


接下来我结合自己的实践与理解，讲讲VC用gsoap下编写webService和客户端程序，有不对的地方还请大家指正，谢谢。
我以网上出现的实现一个简单的加法函数为例，讲讲我在操作过程中遇到的问题。

一 服务器端
1.首先编写 add.h文件：

1  //  gsoap ns service name: add
2    //  gsoap ns service namespace:   http://localhost/add.wsdl 
3    //  gsoap ns service location:   http://localhost 
4    //  gsoap ns service executable: add.cgi
5    //  gsoap ns service encoding: encoded
6    //  gsoap ns schema namespace: urn:add 
7   
8    int  ns__add(   int  num1,   int  num2,   int *  sum );
9 

2.用gsoap/bin目录下的soapcpp2.exe程序，生成一些文件。可以把soapcpp2.exe拷贝到一add.h目录下，用 cmd执行soapcpp2.exe add.h就可以，在这个目录下会自动生成许多将来有用的文件，如 add.namap,soapH.h,soapC.cpp,soapClient.cpp,soapServer.cpp等文件。 soapcpp2.exe可以带参数执行，具体执行soapcpp2.exe -h查看。

3.新建一个win32控制台工程，加入wsock32.lib库，将刚才生成的那些文件添加到工程中。然后编写webserver.cpp主程序：

#include  " add.h " 
 #include  " add.nsmap " 

  int  main(  int  argc,   char *  argv[])
 {
     
       int  m, s;   /*   master and slave sockets   */ 
       struct  soap add_soap;
     soap_init( & add_soap);
       //  soap_set_namespaces(&add_soap, add_namespaces); 
     
       if  (argc  <   2 )
      {
         printf( " usage: %s <server_port> \n " , argv[ 0 ]);
         exit( 1 );
     } 
       else 
      { 
         m  =  soap_bind( & add_soap, NULL, atoi(argv[ 1 ]),  100 );
           if  (m  <   0 )
          {
             soap_print_fault( & add_soap, stderr);
             exit( - 1 );
         } 
         
         fprintf(stderr,  " Socket connection successful: master socket = %d\n " , m);
           for  ( ; ; )
          { 
             s  =  soap_accept( & add_soap); 
               if  (s  <   0 )
              { 
                 soap_print_fault( & add_soap, stderr);
                 exit( - 1 );
             } 
             fprintf(stderr,  " Socket connection successful: slave socket = %d\n " , s);
             
             soap_serve( & add_soap);  //  该句说明该server的服务 
             soap_end( & add_soap);
         } 
     } 
       return   0 ;
 } 
  //  server端的实现函数与add.h中声明的函数相同，但是多了一个当前的soap连接的参数 
  int  ns__add(  struct  soap  * add_soap,   int  num1,   int  num2,   int   * sum)
 {
      * sum  =  num1  +  num2;
       return   0 ;
 } 

4. 编译这个程序，会提示错误，将gsoap_win32目录下stdsoap2.cpp，stdsoap2.h文件加入工程，重新编译如果还有错误，可能是 你将add.h生成的文件添加入工程出错的原因。实际上在编写server程序时，无须带Client的那些文件，还有带Lib的文件也无须添加到工程 中。再重新编译应该就没有问题了，启动4567端口，在ie中输入localhost:4567,如果显示xml页面，说明程序已经启动。

二 对应的客户端
1。客户端程序代码如下:

#include  < stdio.h > 
 #include  < stdlib.h > 
 #include  " soapH.h " 
 #include  " add.nsmap " 


  int  add(  const    char *  server,   int  num1,   int  num2,   int   * sum);

  int  main(  int  argc,   char   ** argv) 
 {
       int  result  =   - 1 ;
       char *  server = " http://localhost:4567 " ;
       int  num1  =   0 ;
       int  num2  =   0 ;
       int  sum  =   0 ;
       if ( argc  <   3  )
      {
         printf( " usage: %s num1 num2 \n " , argv[ 0 ]);
         exit( 0 );
     } 
     
     num1  =  atoi(argv[ 1 ]);
     num2  =  atoi(argv[ 2 ]);
     
     result  =  add(server, num1, num2,  & sum);
       if  (result  !=   0 )
      {
         printf( " soap err,errcode = %d\n " , result);
     } 
       else 
      {
         printf( " %d+%d=%d\n " , num1, num2, sum );
     } 
       return   0 ;
 } 

  int  add(   const    char *  server,   int  num1,   int  num2,   int   * sum )
 {
       struct  soap add_soap;
       int  result  =   0 ;
     soap_init( & add_soap);
  //      soap_set_namespaces(&add_soap, add_namespaces);
     
       //  该函数是客户端调用的主要函数，后面几个参数和add.h中声明的一样，前面多了3个参数，函数名是接口函数名ns__add前面加上soap_call_ 
     soap_call_ns__add(  & add_soap, server,  "" , num1, num2, sum );
       if (add_soap.error)
      {
         printf( " soap error:%d,%s,%s\n " , add_soap.error,  * soap_faultcode( & add_soap),  * soap_faultstring( &add_soap) );
         result  =  add_soap.error;
     }  
     soap_end( & add_soap);
     soap_done( & add_soap);
       return  result;
 }

2.客户端程序既可以新建一个新的win32控制台程序，将刚才生成的nsmap,soapH.h,soapClient.h等文件加入工程，编 译既可。我是直接在原先工程中加入一客户端代码，将webserver.cpp文件移除，并且将soapServer.cpp等server端需要的文件 移除，将soapClient.cpp等client端需要的cpp添加到工程，编译既可。
3.启动server程序，F5客户端程序，经测试正常。

三 遇到的问题
1.server端可以编译成CGI方式执行，而并不是绑定到某个端口，这种方式我没有实践。

if  (argc  <   2 )   //   no args: assume this is a CGI application  
     { 
       soap_serve( & soap);   //   serve request, one thread, CGI style  
       soap_destroy( & soap);   //   dealloc C++ data  
       soap_end( & soap);   //   dealloc data and clean up  
 }

2.在编译服务器及客户端程序时一开始对add.h生成的文件添加到工程，经常出现问题，需要自己不调试。特别是链接时段，server/client要 与其生成的文件相对应，server调用生成的soapserver.cpp，client调用生成的soapclient.cpp文件。
3.多线程方式，在windows下建议用pthread_win32库，这里给出多线程下的例子。

一 gSOAP需要的头文件：

  //  gsoap ns service name: calc
  //  gsoap ns service style: rpc
  //  gsoap ns service encoding: encoded
  //  gsoap ns service namespace:   http://127.0.0.1  :8089/calc.wsdl
  //  gsoap ns service location:   http://127.0.0.1  :8089/cal
  //  gsoap ns schema  namespace:    urn:calc 
  int  ns__add(  double  a,   double  b,   double   * result);
  int  ns__sub(  double  a,   double  b,   double   * result);
  int  ns__mul(  double  a,   double  b,   double   * result);
  int  ns__div(  double  a,   double  b,   double   * result);
  int  ns__pow(  double  a,   double  b,   double   * result);

 二 多线程服务器关键代码

 #include 
 #include   " calc.nsmap " 
 #include   " soapH.h " 

    /
  ///  宏与全局变量的定义 
#define   BACKLOG (100)   
  #define   MAX_THR (10)    
  #define   MAX_QUEUE (1000) 


 pthread_mutex_t queue_cs;                          //  队列锁 
 pthread_cond_t  queue_cv;                            //  条件变量 
 SOAP_SOCKET     queue[MAX_QUEUE];     //  数组队列 
  int                            head  = 0 , tail  = 0 ;            //  队列头队列尾初始化          
    //


    // 
void   *       process_queue(  void   * );          //  线程入口函数 
  int          enqueue(SOAP_SOCKET);    //  入队列函数 
 SOAP_SOCKET dequeue(  void );           //  出队列函数 
 
    // 
//  线程入口函数 
  void   *  process_queue(  void   *  soap)
 {
     struct  soap  *  tsoap  =  (  struct  soap  * )soap;
     for (;;)
    {
         tsoap -> socket  =  dequeue();
           if  ( ! soap_valid_socket(tsoap -> socket))
         {
            break ;
         } 
         soap_serve(tsoap);
         soap_destroy(tsoap);
         soap_end(tsoap);
   } 
     return  NULL;
 } 

  //  入队列操作 
  int  enqueue(SOAP_SOCKET sock)
 {
     int  status  =  SOAP_OK;
     int  next;
   pthread_mutex_lock( & queue_cs);
   next  =  tail  + 1 ;
     if  (next  >=  MAX_QUEUE) 
     next  =   0 ;
     if  (next  ==  head) 
       status  =  SOAP_EOM;
     else 
    {
     queue[tail]  = sock;
     tail  =  next;
   } 
   pthread_cond_signal( & queue_cv);
   pthread_mutex_unlock(  & queue_cs);