目錄
- SOAP簡介
- gSOAP
- 準備作業
- 頭檔案
- 構建客戶端應用程式
- 生成soap原始碼
- 建立客戶端專案
- 構建服務端應用程式
- 生成SOAP原始碼
- 建立服務端專案
- 列印報文
- SOAP測驗
- 專案原始碼
本文主要介紹C++中gSOAP的使用方法，附帶介紹SOAP協議的基礎知識，適用于第一次使用gSOAP的開發人員，gSOAP官網上的示例代碼存在一些錯誤，對初次接觸的人不太友好，本文是在官方示例calc++的基礎上進行了一些補充、改動，
SOAP簡介
SOAP 是一種簡單的基于 XML 的協議，它使應用程式通過 HTTP 來交換資訊，具體內容可以參考SOAP 教程，SOAP的本質是通過HTTP協議以XML格式進行資料互動，只不過這個XML格式的定義是大家公認的，
使用SOAP時需注意，SOAP的XML命名空間由于版本的不同可能存在差異（如soapevn、SOAP-ENV），在呼叫SOAP服務前最好確認服務器的XML格式，
gSOAP
gSOAP 有商業版、開源版兩個版本，開源版使用GPLv2開源協議，支持多個作業系統，具體內容參考github或者官網，
gSOAP提供了一組編譯工具（可以認為是代碼生成器）和一些庫檔案，簡化C/C++語言開發web服務或客戶端程式的作業，開發人員可以專注于實作應用程式的邏輯：
- 編譯工具提供了一個SOAP/XML 關于C/C++ 語言的實作，能夠自動完成本地C或C++資料型別和XML資料結構之間的轉換，
- 庫檔案提供了SOAP報文生成、HTTP協議通訊的實作，及相關的配套設施，用于最終的SOAP報文的生成、傳輸，
本文使用的庫檔案主要是以下幾個：
- stdsoap2.h、stdsoap2.cpp：HTTP協議的實作、最終的SOAP報文生成，如果是C語言則使用stdsoap2.h、stdsoap2.c
- typemap.dat： wsdl2h工具根據wsdl檔案生成頭檔案時需要此檔案，可以更改專案的xml命名空間（后面再細說）
- threads.h：實作高性能的多執行緒服務器需要的檔案，可以并發處理請求，并且在服務操作變得耗時時不會阻塞其他客戶端請求
準備作業
先進入官網的下載頁面，然后選擇開源版本：
也可以直接點擊開源版本的官方下載鏈接或gsoap_2.8.117 提取碼: f78f，
將下載的壓縮包解壓（本文使用的是gsoap_2.8.117.zip），解壓后的檔案放到自己習慣的位置（推薦放到C盤），
在命令列提示符視窗中，使用cd命令進入..\gsoap_2.8.117\gsoap-2.8\gsoap\bin\win64目錄：
注：后面需要把頭檔案、typemap.dat放到該程式目錄下，生成的檔案也在這里，
頭檔案
使用gSOAP的編譯工具生成代碼，需要一個定義API的頭檔案，此處使用官方示例中的calc.h頭檔案，對兩個數字進行加、減、乘、除或乘方運算：，
calc.h頭檔案可以通過wsdl2h工具自動生成（需要Web 服務的 WSDL檔案 ），運行的cmd命令如下：
wsdl2h -o calc.h http://www.genivia.com/calc.wsdl
也可以手動定義一個calc.h頭檔案，內容如下：
//gsoap ns service method add Sums two values
int ns__add(double a, double b, double &result);
//gsoap ns service method sub Subtracts two values
int ns__sub(double a, double b, double &result);
//gsoap ns service method mul Multiplies two values
int ns__mul(double a, double b, double &result);
//gsoap ns service method div Divides two values
int ns__div(double a, double b, double &result);
//gsoap ns service method pow Raises a to b
int ns__pow(double a, double b, double &result);
構建客戶端應用程式
客戶端應用程式在命令列中運行并使用命令列引數呼叫計算器 Web 服務來對兩個數字進行加、減、乘、除或乘方運算，
生成soap原始碼
為客戶端生成服務和資料系結介面：
soapcpp2 -j -r -CL calc.h
其中 option-j生成 C++ 代理類，option-r生成報告，option-CL僅生成客戶端，而沒有（未使用的）lib 檔案，
這會生成以下幾個檔案：
其中，xml檔案是SOAP報文的示例，便于后期的除錯，以add方法為例，
add方法的請求報文ns.add.req.xml內容如下：
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:ns="http://tempuri.org/ns.xsd">
<SOAP-ENV:Body>
<ns:add>
<a>0.0</a>
<b>0.0</b>
</ns:add>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
add方法的回應報文ns.add.req.xml內容如下：
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:ns="http://tempuri.org/ns.xsd">
<SOAP-ENV:Body>
<ns:addResponse>
<result>0.0</result>
</ns:addResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
建立客戶端專案
建立一個C++的控制臺應用專案，引入上面生成的幾個檔案：
- soapStub.h： 沒有注釋的純 C/C++ 頭檔案語法的規范副本，
- soapH.h：宣告 XML 序列化程式，
- soapC.cpp： 實作 XML 序列化程式，
- soapProxy.h： 定義客戶端 XML 服務 API 類Proxy，
- soapProxy.cpp： 實作客戶端 XML 服務 API 類Proxy，
- calc.nsmap： XML 命名空間系結表到 #include，
還需要引入gSOAP解壓目錄下的stdsoap2.h和stdsoap2.cpp檔案，
為方便除錯，客戶端程式示例改為固定引數呼叫add方法，代碼如下：
#include "soapProxy.h"
#include "ns.nsmap"
/* the Web service endpoint URL */
const char server[] = "http://localhost:8080";
int main(int argc, char** argv)
{
/*if (argc < 4)
{
fprintf(stderr, "Usage: [add|sub|mul|div|pow] num num\n");
exit(1);
}*/
Proxy calc(server);
double a, b, result;
/*a = strtod(argv[2], NULL);
b = strtod(argv[3], NULL);*/
a = 3;
b = 23;
/*switch (*argv[1])*/
switch ('a')
{
case 'a':
calc.add(a, b, result);
break;
case 's':
calc.sub(a, b, result);
break;
case 'm':
calc.mul(a, b, result);
break;
case 'd':
calc.div(a, b, result);
break;
case 'p':
calc.pow(a, b, result);
break;
default:
fprintf(stderr, "Unknown command\n");
exit(1);
}
if (calc.soap->error)
calc.soap_stream_fault(std::cerr);
else
std::cout << "result = " << result << std::endl;
calc.destroy(); /* clean up */
std::cout << std::endl;
return 0;
}
構建服務端應用程式
實作一個獨立的迭代服務器，它接受主機埠上的傳入請求，支持多執行緒，可以并發處理請求，并且在服務操作變得耗時時不會阻塞其他客戶端請求，
生成SOAP原始碼
為服務器端生成服務和資料系結介面：
soapcpp2 -j -r -SL calc.h
其中 option-j生成 C++ 服務類，option-r生成報告，option-SL僅生成服務器端，而沒有（未使用的）lib 檔案，
生成的檔案和客戶端的檔案名稱一樣，只是內容不同，
建立服務端專案
建立一個C++的控制臺應用專案，引入的生成檔案和客戶端的相同，為了支持多執行緒，需要引入檔案threads.h，
服務端代碼如下：
#include "soapService.h"
#include "ns.nsmap"
#include "threads.h"
int port = 8080;
void* process_request(void* arg)
{
Service* service = (Service*)arg;
THREAD_DETACH(THREAD_ID);
if (service)
{
service->serve();
service->destroy(); /* clean up */
delete service;
}
return NULL;
}
int main()
{
Service service(SOAP_IO_KEEPALIVE); /* enable HTTP kee-alive */
service.soap->send_timeout = service.soap->recv_timeout = 5; /* 5 sec socket idle timeout */
service.soap->transfer_timeout = 30; /* 30 sec message transfer timeout */
SOAP_SOCKET m = service.bind(NULL, port, 100); /* master socket */
if (soap_valid_socket(m))
{
while (soap_valid_socket(service.accept()))
{
THREAD_TYPE tid;
void* arg = (void*)service.copy();
/* use updated THREAD_CREATE from plugin/threads.h https://www.genivia.com/files/threads.zip */
if (arg)
while (THREAD_CREATE(&tid, (void* (*)(void*))process_request, arg))
Sleep(1);
}
}
service.soap_stream_fault(std::cerr);
service.destroy(); /* clean up */
return 0;
}
/* service operation function */
int Service::add(double a, double b, double& result)
{
result = a + b;
return SOAP_OK;
}
/* service operation function */
int Service::sub(double a, double b, double& result)
{
result = a - b;
return SOAP_OK;
}
/* service operation function */
int Service::mul(double a, double b, double& result)
{
result = a * b;
return SOAP_OK;
}
/* service operation function */
int Service::div(double a, double b, double& result)
{
if (b)
result = a / b;
else
return soap_senderfault("Division by zero", NULL);
return SOAP_OK;
}
/* service operation function */
int Service::pow(double a, double b, double& result)
{
result = ::pow(a, b);
if (soap_errno == EDOM) /* soap_errno is like errno, but portable */
return soap_senderfault("Power function domain error", NULL);
return SOAP_OK;
}
列印報文
在實際除錯中，需要確定SOAP協議程序中具體的報文，只需要改動stdsoap2.cpp原始碼即可，參考gsoap報文列印，實作保存最后一次報文到特定的檔案，
在stdsoap2.h頭檔案include下添加fstream，內容如下：
#include "stdsoap2.h"
#include <fstream>
soap_begin_recv函式開始處添加以下代碼：
//發送完請求報文 獲取請求報文資訊（作為客戶端的時候）
std::string str_reqXml = "";
std::string strBuf;
std::string::size_type pos1 = std::string::npos;
std::string::size_type pos2 = std::string::npos;
strBuf = soap->buf;
pos1 = strBuf.find("<?xml", 0);
pos2 = strBuf.find("</SOAP-ENV:Envelope>", 0);
if (pos1 != std::string::npos && pos2 != std::string::npos)
{
str_reqXml = strBuf.substr(pos1, pos2 - pos1 + 20);
}
std::ofstream outfile;
outfile.open("reqXml.txt");
outfile << str_reqXml;
outfile.close();
soap_body_end_in函式開始處添加以下代碼：
//接收完應答報文 獲取應答報文資訊（作為客戶端的時候）
std::string str_resXml = "";
std::string strBuf;
std::string strEnd = "</SOAP-ENV:Envelope>";
std::string::size_type pos1 = std::string::npos;
std::string::size_type pos2 = std::string::npos;
pos1 = std::string::npos;
pos2 = std::string::npos;
soap->buf[SOAP_BUFLEN - 1] = '\0';
strBuf = soap->buf;
pos1 = strBuf.find("<?xml", 0);
pos2 = strBuf.find(strEnd, 0);
if (pos1 != std::string::npos && pos2 != std::string::npos)
{
str_resXml = strBuf.substr(pos1, pos2 - pos1 + strEnd.length());
}
std::ofstream outfile;
outfile.open("resXml.txt");
outfile << str_resXml;
outfile.close();
soap_recv_raw函式結尾處（return前）添加以下代碼：
//請求報文（作為服務端的時候）
std::string req_data;
req_data.assign(soap->buf, ret);
std::ofstream outfile;
outfile.open("req_data.txt");
outfile << req_data;
outfile.close();
soap_flush_raw函式結尾處（return前）添加以下代碼：
//應答報文（作為服務端的時候）
std::string res_data;
res_data.assign(s, n);
std::ofstream outfile;
outfile.open("res_data.txt");
outfile << res_data;
outfile.close();
注：客戶端可以一直列印報文，服務端只能在Debug運行時才會列印報文，應該有其它方法可以解決，
SOAP測驗
運行上面的服務器、客戶端專案，可以看到運行API呼叫結果，也可以使用SoapUI進行測驗，
進入官網的下載鏈接：https://www.soapui.org/downloads/soapui/，下載開源版本并安裝，
打開軟體，在選單欄的“File”中選擇“New SOAP Project”：
展開左側的專案，雙擊“Request”，開始進行測驗:
專案原始碼
- SoapTest 提取碼: x4yr
轉載請註明出處，本文鏈接：https://www.uj5u.com/houduan/295931.html
標籤：C++