libcurl + libxml2 + soapUI开发SOAP客户端程序

2010年，我写过一些使用gSOAP开发SOAP应用程序的系列文章，共8篇，详情请参考以前的博文：

(1) 股票信息客户端程序

(2) 股票信息服务端程序

(3) iconv解决中文乱码问题

(4) iconv解决中文乱码问题（续）

(5) libxml2解析SOAP响应消息

(6) 在HP-UX下编译gSOAP-2.7.17

(7) 基于HTTPS的基本认证(Basic Authentication)

(8) 自定义header实现用户名令牌认证(Usernametoken Authentication)


使用gSOAP，基本上可以实现傻瓜相机式的快速开发。不过，大部分操作系统，即使是Linux，都没有自带gSOAP，要使用它就必须首先下载、编译、安装。另外，虽然gSOAP本身是跨平台的，但是它必须基于一系列GNU的组件，如果不满足条件的话，恭喜你啦，可以看看我在HP-UX下使用gSOAP有多么的麻烦。再次，gSOAP封装得太多，使用起来太简单，可能也不能满足部分人士（比如我这种人啦）学习的需要。

那么，Linux下有没有免安装的、更容易实现跨平台的、比gSOAP轻量级的、能够进一步学习和理解HTTP、SOAP的开发工具呢？

答案是肯定的。curl就是RHEL Linux自带的、功能强大的客户端工具，它支持许多协议：HTTP、FTP、TELNET、SMTP、POP3等等，基于HTTP和HTTPS的SOAP更是不在话下了。更妙的是，它同时还提供一套编程接口libcurl，可以把curl命令的各项功能嵌入到你自己的C程序中。所以，除了SOAP客户端，使用libcurl，还可以开发出下载工具和邮件客户端，这是gSOAP无法相比的。

由于SOAP和XML的天然联系，最好使用同样是Linux自带的libxml2来生成SOAP请求和解析SOAP响应。即使有的Unix系统、甚至Windows系统，没有libcurl或者libxml2，下载源代码编译安装基本上也不会遇到什么麻烦，比编译gSOAP的过程轻松多了。Windows下编译libxml2的过程及可能遇到的问题，请参考以前的博文：http://blog.csdn.net/yui/archive/2011/01/02/6112622.aspx

此外，我们还需要soapUI进行辅助开发，我觉得soapUI最实用的功能是能够测试一个SOAP连接是否成功，并且一字不漏地呈现它的请求格式，包括其HTTP头信息。这样，我们就可以根据一个在soapUI里测试成功的范例，依样画葫芦，使用libcurl把它重现出来。soapUI的官方网站是：http://www.soapui.org/

那么，libcurl+libxml2是否就可以取代gSOAP呢？当然也不是，首先，libcurl只是一个客户端工具，开发不了服务端程序，其次，使用libxml2生成SOAP请求和解析SOAP响应，在大部分场合都比调用gSOAP的接口麻烦，这个也是必须承认的事实。仅仅进行SOAP客户端开发的话，如果是在GNU Linux下，还是推荐gSOAP。libcurl+libxml2方案的亮点是：支持多种协议、有利于跨平台。总之，多备一把刀，总是好的，免得杀鸡的时候被迫用了把牛刀，砍树的时候又被迫用了把小刀。

以下是基于HTTP的SOAP客户端程序的例子，用了http://www.webxml.com.cn/zh_cn/web_services.aspx 提供的Web Service，应该很容易看懂。中文乱码的问题就不在这里多说了，上面gSOAP的系列文章有解释。

#include <stdio.h> #include <string.h> #include <curl/curl.h> #include <libxml/parser.h> #include <libxml/xmlmemory.h> #include <libxml/xpath.h> #include <libxml/xpathInternals.h> static void set_value(xmlXPathContextPtr context, const xmlChar *xpath, const xmlChar *value){ xmlXPathObjectPtr result = xmlXPathEvalExpression(xpath, context); if ( result ) { xmlNodeSetPtr nodeset = result->nodesetval; xmlNodeSetContent(nodeset->nodeTab[0], value); xmlXPathFreeObject(result); } } static void get_request(char *buffer, int *len, const char *stock_code) { xmlChar *buff; xmlDocPtr doc = xmlParseFile("stock.xml"); if ( doc == NULL ) { printf("xmlParseFile failed\n"); return; } xmlXPathContextPtr context = xmlXPathNewContext(doc); if ( context == NULL ) { printf("xmlXPathNewContext failed\n"); return; } xmlXPathRegisterNs(context, (const xmlChar *)"soapenv", (const xmlChar *)"http://schemas.xmlsoap.org/soap/envelope/"); xmlXPathRegisterNs(context, (const xmlChar *)"web", (const xmlChar *)"http://WebXml.com.cn/"); set_value(context, (const xmlChar *)"//web:theStockCode", (const xmlChar *) stock_code); xmlDocDumpMemory(doc, &buff, len); strcpy(buffer, (char *) buff); printf("%s\n", buffer); xmlFree(buff); xmlXPathFreeContext(context); xmlFreeDoc(doc); xmlCleanupParser(); } int main(int argc, char **argv) { const char *stock_code = argv[1]; char buffer[2048]; int len = 0; get_request(buffer, &len, stock_code); struct curl_slist *headers = NULL; headers = curl_slist_append(headers, "Content-Type: text/xml;charset=UTF-8"); headers = curl_slist_append(headers, "SOAPAction: \"http://WebXml.com.cn/getStockInfoByCode\""); CURL *curl = curl_easy_init(); if ( curl ) { curl_easy_setopt(curl, CURLOPT_URL, "http://webservice.webxml.com.cn/WebServices/ChinaStockWebService.asmx"); curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers); curl_easy_setopt(curl, CURLOPT_POSTFIELDS, buffer); curl_easy_setopt(curl, CURLOPT_POSTFIELDSIZE, strlen(buffer)); curl_easy_setopt(curl, CURLOPT_POST, 1); curl_easy_setopt(curl, CURLOPT_VERBOSE, 1); curl_easy_setopt(curl, CURLOPT_HEADER, 1); curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1); curl_easy_perform(curl); /* always cleanup */ curl_easy_cleanup(curl); curl_slist_free_all(headers); } return 0; }

程序需要读取stock.xml作为SOAP请求模板，也就是从soapUI测试过程中抓取的内容：

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://WebXml.com.cn/"> <soapenv:Header/> <soapenv:Body> <web:getStockInfoByCode> <!--Optional:--> <web:theStockCode>?</web:theStockCode> </web:getStockInfoByCode> </soapenv:Body> </soapenv:Envelope>

如果需要开发基于HTTPS的SOAP客户端的话，首先要在libcurl添加openssl支持，我的前一篇博文也有介绍：http://blog.csdn.net/yui/archive/2011/01/31/6170889.aspx

使用的方法基本与前面的程序一样，不过可能需要多加一句：

curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 0);

另外，如果在Code::Blocks下，编译的关键是库文件链接次序，请见上一篇博文最后的图。