//gsoap ns1 service method-action: getQuote urn:xmethods-delayed-quotes#getQuote
int ns1__getQuote(char *symbol, float &Result);
这个头文件用C/C++代码为gSOAP预编译器指定了web服务的细节。远程方法被定义为函数ns1__getQuote，同时指定了客户端调用web服务所需的所有细节信息。
getQuote远程方法需要一个名为symbol的字符串作为输入参数，同时需要一个名为Result的浮点数作为输出参数。预编译器生成的远程方法调用函数中，最后一个参数必须是输出参数，该参数以引用方式传递或定义为指针类型。除此之外的所有参数都是输入参数，这些参数必须以传值方式传递。函数返回一个整型值，其值说明web服务调用成功或出现的错误。具体的错误代码信息参见10.2节。
函数名中命名空间前缀ns1__的细节信息将在8.1.2节中讨论。简单的说，命名空间前缀与函数名之间用两个下划线分割。比如，ns1__getQuote中，ns1为命名空间前缀，getQuote是函数名称。（函数名中单个下划线将在XML中解释为破折号-，因为在XML中破折号比下划线更常用，细节请参见10.3节）
用下面命令执行预编译器：
soapcpp2 getQuote.h
预编译器根据getQuote.h中定义的信息来生成存根例程的代码框架。这个存根例程可以在客户端程序中随处调用。存根例程被声明为下面的样子：
int soap_call_ns1__getQuote(struct soap *soap, char *URL, char *action, char *symbol, float &Result);
存根例程保存在soapClient.cpp文件中；soapC.cpp文件包含了序列化、反序列化数据的函数。你可以用 -c编译选项来生成纯C的代码。
注意，soap_call_ns1__getQuote在ns1__getQuote的参数基础上又增加了三个参数：soap必须是指向一个gSOAP运行环境的合法指针；URL是web服务的URL；action指明了web服务需要的SOAP action。XMethods Delayed Stock Quote服务的URL是http://66.28.98.121:9090/soap，action是"" (2 quotes)。你可以动态的改变URL及action。如果上述两个变量定义为NULL，则会使用头文件中定义的信息。
下面的例子调用远程方法获取IBM的股票信息：
#include "soapH.h" // 包含生成的存根例程定义
#include "net_DOT_xmethods_DOT_services_DOT_stockquote_DOT_StockQuoteBinding.nsmap" // 包含命名空间表
int main()
{
struct soap soap; // gSOAP运行环境
float quote;
soap_init(&soap); // 初始化运行环境（只执行一次）
if (soap_call_ns1__getQuote(&soap, NULL, NULL, "IBM", "e) == SOAP_OK)
std::cout << "Current IBM Stock Quote = " << quote << std::endl;
else // an error occurred
soap_print_fault(&soap, stderr); // 在stderr中显示错误信息
soap_destroy(&soap); // 删除类实例（仅用于C++中）
soap_end(&soap); // 清楚运行环境变量
soap_done(&soap); // 卸载运行环境变量
return 0;
}
调用成功后，存根例程返回SOAP_OK同时quote变量保存着股票信息；如果调用失败则产生一个错误，同时通过soap_print_fault函数显示错误信息。
gSOAP编译器同时为C++客户端程序生成了一个代理类。
#include "soapnet_DOT_xmethods_DOT_services_DOT_stockquote_DOT_StockQuoteBindingProxy.h" // 获得代理
#include "net_DOT_xmethods_DOT_services_DOT_stockquote_DOT_StockQuoteBinding.nsmap" // 包含命名空间表
int main()
{
net q; // "net" 是这个服务代理类的短名称
float r;
上一篇:Apache APR可移植运行库简介(4)
下一篇:CSDN社区结贴给分器
|
精品推荐