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







//gsoap ns service name: itoa

//gsoap ns service namespace: http://localhost/itoa.wsdl
//gsoap ns service location: http://localhost
//gsoap ns service executable: itoa.cgi

//gsoap ns service encoding: encoded

//gsoap ns schema namespace: urn:itoa

int ns__itoa(int i, char **a);

二、生成wsdl和服务端代码

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

[plain] view plain copy







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







// itoaServer.cpp : 定义控制台应用程序的入口点。

//

#include "soapH.h"

#include <windows.h>

#include "itoa.nsmap"

#define BACKLOG (100) /* Max. request backlog */

DWORD WINAPI process_request(LPVOID*);

int http_get(struct soap * soap);

int main(int argc, char **argv) {

struct soap soap;

struct soap *tsoap;

const char* fmt = "accepts socket %d connection from IP %d.%d.%d.%d\n";

soap_init(&soap);

if ( argc < 2 ) {

soap_serve(&soap);

soap_destroy(&soap);

soap_end(&soap);

}

else {

soap.send_timeout = 60;

soap.recv_timeout = 60;

soap.accept_timeout = 3600;

soap.max_keep_alive = 100;

soap.fget = http_get;

DWORD tid;

HANDLE hThread;

int port = atoi(argv[1]); // first command-line arg is port

SOAP_SOCKET m, s;

m = soap_bind(&soap, NULL, port, BACKLOG);

if ( !soap_valid_socket(m) ) exit(1);

printf("Socket connection successful %d\n", m);

for ( ; ; ) {

s = soap_accept(&soap);

if ( !soap_valid_socket(s) ) {

if ( soap.errnum ) {

soap_print_fault(&soap, stderr);

exit(1);

}

printf("server timed out\n");

break;

}

printf(fmt, s, (soap.ip>>24)&0xFF, (soap.ip>>16)&0xFF, (soap.ip>>8)&0xFF, soap.ip&0xFF);

tsoap = soap_copy(&soap); // make a safe copy

if ( !tsoap ) break;

hThread = CreateThread(NULL, 0, (LPTHREAD_START_ROUTINE)process_request, tsoap, 0, &tid);

if ( hThread == NULL ) {

printf("can not create a thread for SOAP request processing.\n");

exit(-1);

}

}

}

soap_done(&soap);

return 0;

}

DWORD WINAPI process_request(LPVOID* soap) {

soap_serve((struct soap*)soap);

soap_destroy((struct soap*)soap);

soap_end((struct soap*)soap);

soap_done((struct soap*)soap);

free(soap);

return 0;

}

// 服务消息的实现代码

int ns__itoa(struct soap *soap, int i, char **a)

{

*a = (char*)soap_malloc(soap, 11);

sprintf(*a, "%d", i);

return SOAP_OK;

}

int http_get(struct soap * soap) {

FILE *fd = NULL;

printf("call http_get.\n");

char *s = strchr(soap->path, '?');

if ( !s || strcmp(s, "?wsdl") ) return SOAP_GET_METHOD;

fd = fopen("itoa.wsdl", "rb");

if ( !fd ) return 404;

soap->http_content = "text/xml";

soap_response(soap, SOAP_FILE);

for ( ; ; ) {

size_t r = fread(soap->tmpbuf, 1, sizeof(soap->tmpbuf), fd);

if ( !r ) break;

if ( soap_send_raw(soap, soap->tmpbuf, r) ) break;

}

fclose(fd);

soap_end_send(soap);

return SOAP_OK;

}

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







//gsoap ns service name: itoa

//gsoap ns service protocol: SOAP

//gsoap ns service style: rpc

//gsoap ns service namespace: http://localhost:8087/itoa?wsdl
//gsoap ns service location: http://localhost:8087
//gsoap ns service encoding: encoded

//gsoap ns schema namespace: urn:itoa

int ns__itoa(int i, char **a);

int ns__add(double a, double b, double& result);

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

[cpp] view plain copy







//server端的实现函数与itoa.h中声明的函数相同，但是多了一个当前的soap连接的参数

int ns__add(struct soap *soap, double a, double b, double& result)

{

result = a + b;

return 0;

}

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