linux下gsoap的初次使用

这两天，接到一个项目，需要在linux程序中调用远程的web应用，通过soap协议。开始上网查了下资料，发现了gsoap库这个好东东^_^。继续在网上搜索例子代码，发现基本都不可编译通过，于是便一边学习一边写了这个最简单的例子，希望对后来者起到一点帮助。

  • 对gsoap的简单介绍，请自己参阅http://gsoap2.sourceforge.net/

    下载相应的包，主要有2个工具和源代码：
    wsdl2h -o outfile.h infile.wsdl 实现wsdl文件到h文件的数据映射
        soapcpp2 -c outfile.h生成相应的底层通信stub，strech程序

  • 下面这个简单的例子实现的是在客户端输入2个数字，然后远程调用服务端的加法函数，最后返回结果给客户端。

    在这里我们不需要wsdl的文件，可以直接从.h文件来生成代码。我们定义一个函数声明文件，用来定义接口函数，名称为add.h，内容如下：

  1. //gsoapopt cw
  2. //gsoap ns2 schema namespace: urn:add
  3. //gsoap ns2 schema form: unqualified
  4. //gsoap ns2 service name: add
  5. //gsoap ns2 service type: addPortType
  6. //gsoap ns2 service port:http://websrv.cs.fsu.edu/~engelen/addserver.cgi
  7. //gsoap ns2 service namespace: urn:add
  8. //gsoap ns2 service transport: http://schemas.xmlsoap.org/soap/http
  9. //gsoap ns2  service method-style:      add rpc
  10. //gsoap ns2  service method-encoding:   
  11. add http://schemas.xmlsoap.org/soap/encoding/
  12. //gsoap ns2  service method-action:     add ""
  13. int ns2__add( int num1, int num2, int* sum );

然后我们执行soapcpp2 -c add.h，自动生成一些远程调用需要的文件。

接下来我们写一个服务端，创建文件addserver.c

  1. #include "soapH.h"
  2. #include "add.nsmap"
  4. int main(int argc, char **argv)
  5. {
  6.     int m, s;
  7.     struct soap add_soap;
  8.     soap_init(&add_soap);
  9.     soap_set_namespaces(&add_soap, namespaces);
  11.     if (argc < 2) {
  12.         printf("usage: %s <server_port> /n", argv[0]);
  13.         exit(1);
  14.     } else {
  15.         m = soap_bind(&add_soap, NULL, atoi(argv[1]), 100);
  16.         if (m < 0) {
  17.             soap_print_fault(&add_soap, stderr);
  18.             exit(-1);
  19.         }
  20.         fprintf(stderr, "Socket connection successful: master socket = %d/n", m);
  21.         for (;;) {
  22.             s = soap_accept(&add_soap);
  23.             if (s < 0) {
  24.                 soap_print_fault(&add_soap, stderr);
  25.                 exit(-1);
  26.             }
  27.             fprintf(stderr, "Socket connection successful: slave socket = %d/n", s);
  28.             soap_serve(&add_soap);
  29.             soap_end(&add_soap);
  30.         }
  31.     }
  32.     return 0;
  33. }
  35. int ns2__add(struct soap *add_soap, int num1, int num2, int *sum)
  36. {
  37.     *sum = num1 + num2;
  38.     return 0;
  39. }


我们接着写客户端，文件addclient.c

  1. #include "soapStub.h"
  2. #include "add.nsmap"
  4. int add(const char *server, int num1, int num2, int *sum)
  5. {
  6.     struct soap add_soap;
  7.     int result = 0;
  8.     soap_init(&add_soap);
  9.     soap_set_namespaces(&add_soap, namespaces);
  10.     soap_call_ns2__add(&add_soap, server, NULL, num1, num2, sum);
  11.     printf("server is %s, num1 is %d, num2 is %d/n", server, num1, num2);
  13.     if (add_soap.error) {
  14.         printf("soap error: %d, %s, %s/n", add_soap.error, *soap_faultcode(&add_soap), *soap_faultstring(&add_soap));
  15.         result = add_soap.error;
  16.     }
  17.     soap_end(&add_soap);
  18.     soap_done(&add_soap);
  19.     return result;
  20. }

最后写一个测试代码，addtest.c

  1. #include <stdio.h>
  2. #include <stdlib.h>
  3. #include <string.h>
  5. int add(const char *server, int num1, int num2, int *sum);
  6. int main(int argc, char **argv)
  7. {
  8.     int result = -1;
  9.     char server[128] = {0};
  10.     int num1;
  11.     int num2;
  12.     int sum;
  14.     if (argc < 4) {
  15.         printf("usage: %s <ip:port> num1 num2 /n", argv[0]);
  16.         exit(1);
  17.     }
  19.     strcpy(server,argv[1]);
  20.     num1 = atoi(argv[2]);
  21.     num2 = atoi(argv[3]);
  22.     result = add(server, num1, num2, ∑);
  24.     if (result != 0) {
  25.         printf("soap error, errcode=%d/n", result);
  26.     } else {
  27.         printf("%d + %d = %d/n", num1, num2, sum);
  28.     }
  29.     return 0;
  30. }

到此为止，我们自己的代码已经编写完毕，现在我们来编译服务端和客户端
注意：编译的时候我们需要gsoap包里的源代码文件，把stdsoap2.c和stdsoap2.h文件拷贝到当前目录

我们写一个Makefile文件：

  1. GSOAP_ROOT = /root/gsoap-2.7/gsoap
  2. WSNAME = add
  3. CC = g++ -g -DWITH_NONAMESPACES
  4. INCLUDE = -I$(GSOAP_ROOT)
  5. SERVER_OBJS = soapC.o stdsoap2.o soapServer.o $(WSNAME)server.o 
  6. CLIENT_OBJS = soapC.o stdsoap2.o soapClient.o $(WSNAME)client.o $(WSNAME)test.o
  8. all: server
  9. server: $(SERVER_OBJS) 
  10.     $(CC) $(INCLUDE) -o $(WSNAME)server $(SERVER_OBJS) 
  12. client: $(CLIENT_OBJS) 
  13.     $(CC) $(INCLUDE) -o $(WSNAME)test $(CLIENT_OBJS)
  15. cl:
  16.     rm -f *.o *.xml *.a *.wsdl *.nsmap soapH.h $(WSNAME)Stub.* $(WSNAME)server ns.xsd $(WSNAME)test

然后我们执行make，即可生产addserver程序；make client，生成addtest程序。
让server跑起来,执行./addserver 6666

终端打印出“Socket connection successful: master socket = 3”，那么你的server已经在前台run起来了；
运行客户端，./addtest ip:port num1 num2，返回加法的结果。

OK，一个最简单的soap调用的例子完成了，进深一步的学习请参考http://gsoap2.sourceforge.net/

from：http://blog.csdn.net/jinpw/article/details/3346844

posted @ 2011-08-19 16:44  dkcndk  阅读(14846)  评论(8)  编辑  收藏  举报