VS2010使用c++、gSOAP创建WebService 图文教程

VS2010使用c++、gSOAP创建的WebService 图文教程

环境

操作系统：Windows 7
gsoap版本：2.8.32
C++编译器/开发环境：Visual Studio 2010

gSOAP是什么

gSOAP编译工具提供了一个SOAP/XML 关于C/C++ 语言的实现，从而让C/C++语言开发web服务或客户端程序的工作变得轻松了很多。绝大多数的C++web服务工具包提供一组API函数类库来处理特定的SOAP数据结构，这样就使得用户必须改变程序结构来适应相关的类库。与之相反，gSOAP利用编译器技术提供了一组透明化的SOAP API，并将与开发无关的SOAP实现细节相关的内容对用户隐藏起来。

下载gSOAP工具包

http://120.52.73.49/jaist.dl.sourceforge.NET/project/gsoap2/gSOAP/gsoap_2.8.32.zip

gSOAP Toolkit
解压后把下面两个文件复制到“C:\Windows”目录下，或者添加环境变量，这 样就可以在任何位置执行命令：

soapcpp2.exe

wsdl2h.exe

一、编写一个头文件

文件名：itoa.h

[cpp] view plain copy

 

 

1. //gsoap ns service name: itoa  
2. //gsoap ns service namespace: http://localhost/itoa.wsdl  
3. //gsoap ns service location: http://localhost  
4. //gsoap ns service executable: itoa.cgi  
5. //gsoap ns service encoding: encoded  
6. //gsoap ns schema namespace: urn:itoa  
7.   
8. int ns__itoa(int i, char **a);  

二、生成wsdl和服务端代码

打开CMD命令行，切换目录到“itoa.h”文件所在目录，执行命令：

[plain] view plain copy

 

 

1. soapcpp2 -S -I C:\gSOAP\gsoap-2.8\gsoap\import itoa.h  

执行完成后，会在文件夹下面生成以下文件：

经测试直接使用“soapcpp2 -S itoa.h”也是可以的；

三、创建项目

1、打开VS2010，文件》新建》项目

2、左侧模板中选择Visual c++，右侧选择 Win32 控制台应用程序，输入项目名称，选择保存位置，勾选“为解决方案创建目录”，确定

3、下一步

4、取消“预编译头”的选中状态，完成

四、配置编译

1、打开项目文件目录

2、将第二步生成的代码复制到项目目录下

3、添加文件到项目

4、选择要添加到项目的文件

这里没有列全，有几个文件（stdsoap2.h，stdsoap2.cpp）是需要从gSOAP的源码目录复制过来的

注意：并不是要把所有文件都添加到项目里！

5、替换“itoaServer.cpp”文件的内容，使用以下代码:

[cpp] view plain copy

 

 

1. // itoaServer.cpp : 定义控制台应用程序的入口点。  
2. //  
3. #include "soapH.h"  
4. #include <windows.h>  
5. #include "itoa.nsmap"  
6.   
7. #define BACKLOG (100)    /* Max. request backlog */  
8. DWORD WINAPI process_request(LPVOID*);  
9. int http_get(struct soap * soap);  
10.   
11. int main(int argc, char **argv) {  
12.     struct soap soap;  
13.     struct soap *tsoap;  
14.     const char* fmt = "accepts socket %d connection from IP %d.%d.%d.%d\n";  
15.   
16.     soap_init(&soap);  
17.   
18.     if ( argc < 2 ) {  
19.         soap_serve(&soap);  
20.         soap_destroy(&soap);  
21.         soap_end(&soap);  
22.     }  
23.     else {  
24.         soap.send_timeout = 60;  
25.         soap.recv_timeout = 60;  
26.         soap.accept_timeout = 3600;  
27.         soap.max_keep_alive = 100;  
28.   
29.         soap.fget = http_get;  
30.   
31.         DWORD tid;  
32.         HANDLE hThread;  
33.   
34.         int port = atoi(argv[1]); // first command-line arg is port  
35.         SOAP_SOCKET m, s;  
36.   
37.         m = soap_bind(&soap, NULL, port, BACKLOG);  
38.         if ( !soap_valid_socket(m) ) exit(1);  
39.   
40.         printf("Socket connection successful %d\n", m);  
41.         for ( ; ; ) {  
42.             s = soap_accept(&soap);  
43.             if ( !soap_valid_socket(s) ) {  
44.                 if ( soap.errnum ) {  
45.                     soap_print_fault(&soap, stderr);  
46.                     exit(1);  
47.                 }  
48.   
49.                 printf("server timed out\n");  
50.                 break;  
51.             }  
52.   
53.             printf(fmt, s, (soap.ip>>24)&0xFF, (soap.ip>>16)&0xFF, (soap.ip>>8)&0xFF, soap.ip&0xFF);  
54.   
55.             tsoap = soap_copy(&soap); // make a safe copy  
56.             if ( !tsoap ) break;  
57.   
58.             hThread = CreateThread(NULL, 0, (LPTHREAD_START_ROUTINE)process_request, tsoap, 0, &tid);  
59.             if ( hThread == NULL ) {  
60.                 printf("can not create a thread for SOAP request processing.\n");  
61.                 exit(-1);  
62.             }  
63.         }  
64.     }  
65.   
66.     soap_done(&soap);  
67.     return 0;  
68. }  
69.   
70. DWORD WINAPI process_request(LPVOID* soap) {  
71.     soap_serve((struct soap*)soap);  
72.     soap_destroy((struct soap*)soap);  
73.     soap_end((struct soap*)soap);  
74.     soap_done((struct soap*)soap);  
75.     free(soap);  
76.     return 0;  
77. }  
78.   
79. // 服务消息的实现代码  
80. int ns__itoa(struct soap *soap, int i, char **a)   
81. {   
82.     *a = (char*)soap_malloc(soap, 11);   
83.     sprintf(*a, "%d", i);   
84.     return SOAP_OK;   
85. }  
86.   
87. int http_get(struct soap * soap) {  
88.     FILE *fd = NULL;  
89.   
90.     printf("call http_get.\n");  
91.     char *s = strchr(soap->path, ‘?‘);  
92.     if ( !s || strcmp(s, "?wsdl") ) return SOAP_GET_METHOD;  
93.   
94.     fd = fopen("itoa.wsdl", "rb");  
95.     if ( !fd ) return 404;  
96.   
97.     soap->http_content = "text/xml";  
98.     soap_response(soap, SOAP_FILE);  
99.   
100.     for ( ; ; ) {  
101.         size_t r = fread(soap->tmpbuf, 1, sizeof(soap->tmpbuf), fd);  
102.         if ( !r ) break;  
103.         if ( soap_send_raw(soap, soap->tmpbuf, r) ) break;  
104.     }  
105.   
106.     fclose(fd);  
107.     soap_end_send(soap);  
108.   
109.     return SOAP_OK;  
110. }  

6、编译生成，在项目名称上单击鼠标右键，选择重新生成

选择重新生成的好处是避免之前的生成错误影响本次生成的结果

7、生成成功后，从项目目录下将“itoa.wsdl”文件复制到输出目录

五、启动WebService并测试

1、打开CMD命令提示符

2、切换目录到生成输入目录

3、执行命令：itoaServer.exe 8087

后面的端口是可以自己定义的，你想用什么就输入什么，只要是未占用的，不是其它协议/服务常用的；

4、允许访问

5、打开浏览器，输入你的IP:端口号/itoa?wsdl 访问看看吧，正常的话应该显示“itoa.wsdl”文件的内容

2016-05-29更新

1、更新文件：itoa.h，添加了一个函数

[cpp] view plain copy

 

 

1. //gsoap ns service name: itoa  
2. //gsoap ns service protocol: SOAP  
3. //gsoap ns service style: rpc  
4. //gsoap ns service namespace: http://localhost:8087/itoa?wsdl   
5. //gsoap ns service location: http://localhost:8087  
6. //gsoap ns service encoding: encoded    
7. //gsoap ns schema namespace: urn:itoa  
8.     
9. int ns__itoa(int i, char **a);  
10. int ns__add(double a, double b, double& result);  

2、更新文件：itoaServer.cpp，加入代码：

[cpp] view plain copy

 

 

1. //server端的实现函数与itoa.h中声明的函数相同，但是多了一个当前的soap连接的参数  
2. int ns__add(struct soap *soap, double a, double b, double& result)  
3. {  
4.     result = a + b;  
5.     return 0;  
6. }  

3、ns与ns2的区别

目前只是发现如果头文件件中的函数名使用ns2开头的话（例如：ns2_itoa），那么生成的WSDL文件名就是“ns2.wsdl”，时间有限，还没有深入去研究；另外在官方用户手册中也会看到“//gsoap ns2 service”这样的，也没有尝试；

结束语

别人如果想访问你的WebService，必须能够拿到你的 wsdl 文件（本例中为：itoa.wsdl）才行，还有就是你的WebService运行的服务器IP及使用的端口。

这里只讲了如何用c++，gSOAP开发一个WebService供别人调用，以后再讲讲如何调用的吧。

相关源码下载：http://download.csdn.net/detail/testcs_dn/9528394

下一篇：VS2010使用c++、gSOAP调用WebService 图文教程

参考：

http://www.genivia.com/products.html

http://www.genivia.com/doc/soapdoc2.html

http://www.cppblog.com/qiujian5628/archive/2008/06/19/54019.html

http://www.cppblog.com/qiujian5628/archive/2008/09/16/61945.html

http://blog.csdn.net/testcs_dn/article/details/51463367

http://blog.csdn.net/testcs_dn/article/details/51526051

VS2010使用c++、gSOAP创建WebService 图文教程

原文：http://www.cnblogs.com/findumars/p/6309043.html