一、gSOAP簡介

gSOAP編譯工具提供了一個SOAP/XML 關於C/C++ 語言的實現，從而讓C/C++語言開發web服務或客戶端程式的工作變得輕鬆了很多。絕大多數的C++web服務工具包提供一組API函式類庫來處理特定的SOAP資料結構，這樣就使得使用者必須改變程式結構來適應相關的類庫。與之相反，gSOAP利用編譯器技術提供了一組透明化的SOAP API，並將與開發無關的SOAP實現細節相關的內容對使用者隱藏起來。

二、gSOAP下載地址

下載下來解壓以後資料夾如下：

其中gsoap中的兩個檔案：

以及如下路徑兩個檔案複製出來放到一個資料夾下，稍後有用：

拷出來以後總共是如下四個檔案：

三、實現簡單加法例項

基本功能：實現一個簡單的a+b程式，在伺服器端寫一個程式，裡面包含了a+b的函式，
然後通過客戶端程式碼向其傳送兩個數字，在伺服器運算得到結果返回給客戶端顯示出來。

1、新建一個資料夾server；
2、將gSoap解壓出來後的四個檔案放到server裡面；
3、在server資料夾下建立一個add.h的標頭檔案，程式碼如下：

<span style="font-size:18px;">//gsoap ns service name: add
//gsoap ns service namespace: http://localhost/add.wsdl
//gsoap ns service location: http://localhost
//gsoap ns service executable: add.cgi
//gsoap ns service encoding: encoded
//gsoap ns schema namespace: urn:add

int ns__add(int num1, int num2, int* sum);</span>
 

函式返回值必須是int，然後跟"ns__"(兩個下劃線)，最後一個引數必須是引用型別或者指標型別(需要將值傳出來)。

4、執行cmd跳到server資料夾，輸入命令soapcpp2.exe add.h後，該資料夾顯示如下(拷貝一份出來用於後面client)：

5、用VC6.0新建一個Win32控制檯應用程式(Empty)，名字為server（我前面的server資料夾得路徑為D:/add/server，那麼這個時候建立的工程路徑為D:/add/，名字為server），在工程下面新建一個addserver.cpp的原始檔，原始檔中的程式碼如下：

<span style="font-size:18px;">#include <stdio.h>
#include <stdlib.h>
#include "stdsoap2.h"
#include "add.h"
#include "add.nsmap"
#include "windows.h"
int main(int argc, char* argv[]) 
{
	int m, s;
	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;
}</span>
 

6、新增其他檔案有7個add.h、soapH.h、soapStub.h、stdsoap2.h、soapC.cpp、soapServer.cpp、stdsoap2.cpp，

在project-setting中將新增進來的3個原始檔的C/C++選項的Category設定為Precompiled Headers(只要改一個其他都改了)：

7、在project-setting-Link在Object/library modules後新增一個wsock32.lib：

8、編譯，如果這個時候有編譯錯誤，估計是檔案新增和add.h生成程式碼這兩步有錯誤，如果是“sockaddr_storage未定義”，那麼可以自己在上面新增如下程式碼(新增在巨集下面)：

<span style="font-size:18px;">struct sockaddr_storage {
 u_char sa_len;
 u_char sa_family;
 u_char padding[128];
 };</span>

到此應該沒有大的錯誤了，如果還有，那麼可以定位到那句話，將它註釋掉（一般可以這麼做）。
 如果編譯成功後，在Debug資料夾裡面會有一個server.exe的檔案，
開啟cmd，轉到Debug檔案下，輸入server.exe 4567，接著在IE中輸入http://localhost:4567

，如果顯示xml頁面，說明程式已經啟動。

9、客戶端程式碼編寫，步驟與server類似，新建一個client資料夾，上面第4步為止的所有檔案拷貝到client資料夾中，接著建立一個Win32控制檯應用程式，名字為client（我前面的client資料夾的路徑為D:/add/client那麼這個時候建立的工程路徑為D:/add/，名字為client），在工程下面新建一個addclient.cpp的原始檔，原始檔中的程式碼如下：

#include <stdio.h>
#include <stdlib.h>
#include "stdsoap2.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;
}