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

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

soapcpp2.exe

wsdl2h.exe

一、编写一个头文件

文件名：itoa.h

//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:itoaint ns__itoa(int i, char **a);

二、生成wsdl和服务端代码

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

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”文件的内容，使用以下代码:

// itoaServer.cpp : 定义控制台应用程序的入口点。//#include "soapH.h"#include 
    
     #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命令提示符

3、执行命令：itoaServer.exe 8087

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

4、允许访问

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

2016-05-29更新

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

//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，加入代码：

//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供别人调用，以后再讲讲如何调用的吧。