VC++ 调用java 编写的webService
Java 端编写的WebService 程序略。
java 端WebService 路径 : http://localhost:8080/Axis2WSTest/services/Converte
java 端 SoapAction urn:sayHello
public void sayHello(String userName, String message) { System.err.println("Hello!" + userName + " and he said: " + message); }
C++ 端如果要调用webService 需要安装工具包soapsdk.exe
下载地址为http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=13456
在此之前,必需先导入所需的类型库,然后程序才能够使用SOAP的类。
#import "msxml4.dll" #import "C:\Program Files\Common Files\MSSoap\Binaries\mssoap30.dll" \ exclude("IStream", "IErrorInfo", "ISequentialStream", "_LARGE_INTEGER", \ "_ULARGE_INTEGER", "tagSTATSTG", "_FILETIME") using namespace MSSOAPLib30;
说明:
mssoap30.dll :SOAP中使用的对象和接口都在mssoap30.dll文件中
msxml4.dll:因为SOAP完全依赖于XML,因此必需用Microsoft XML Parser来处理XML
建立SOAP客户端应用有以下三步骤:
1- 指定和连接Web服务器。
2- 准备和发送消息。
3- 读取服务端返回的信息。
1- SoapConnector:
在客户/服务模式下,首先要做的事就是连接服务器。SoapConnector类执行客户端与服务端之间的消息传送协议。 SoapConnector是一个抽象类,定义了协议执行的接口。事实上, SoapConnector类不定义执行某种特定的传送协议,例如:MSMQ, MQ Series, SMTP 和 TCP/IP等。 为简便起见,本文只说明使用HTTP传送协议,
SoapConnector类使用步骤如下:[/
a) 创建SoapConnector类对象:
ISoapConnectorPtr connector; Connector.CreateInstance(__uuidof(HttpConnector30));
b) 指定Web服务器地址:
指定服务器,要做二件事:选择HttpConnector的属性和相应的属性值。本文示例选用EndPointURL属性:
Connector->Property ["EndPointURL"] = "http://localhost:8080/Axis2WSTest/services/Converte";
以下是属性选项说明(属性名是大小写敏感的):
AuthPassword:客户口令
AuthUser:客户名
EndPointURL :客户URL
ProxyPassword: 代理(proxy)口令
ProxyPort :代理断口
ProxyServer :代理服务器的IP地址或主机名
ProxyUser :代理用户名
SoapAction:HTTP的抬头值。这个属性只使用于低级API。它将忽略SoapClient接口(高级API)中的ConnectorProperty属性 。
SSLClientCertificateName:指定使用Secure Sockets Layer (SSL)加密协议。语法如下:
[CURRENT_USER | LOCAL_MACHINE\[store-name\]]cert-name with the defaults being CURRENT_USER\MY (与Microsoft Internet Explorer用法相同)。
Timeout:HttpConnector的超时限制,以毫秒为单位。
UseProxy:定义是否使用代理(proxy)。缺省值为False。如果将这个属性为真(True),又没有设置上面的ProxyServer值,代理服务器将使用IE里的代理服务器。此时HttpConnector将不理会IE的"Bypass Proxy"(绕道)设置。
UseSSL:定义是否使用SSL(True 或 False)。此值设置为真时,HttpConnector对象不管WSDL设置是HTTP或HTTPS都用SSL连接方式。若此值设置为非真,HttpConnector对象只在WSDL设置为HTTPS时才用SSL方式连接。
c) 与Web服务器连接:
Connector->Connect();
d) 指定动作:
Connector->Property ["SoapAction"] = "urn:sayHello";
e) 启动消息句柄:
必需在SoapSerializer(消息准备函数)之前先启动消息处理机制 Connector->BeginMessage(); 在消息处理完毕之后,用EndMessage()函数将消息送往服务器。 . . [ 消息准备代码 ] . . Connector->EndMessage();
SoapSerializer:
用于建立送往服务器的SOAP消息。在与服务器通讯之前,SoapSerializer对象必需先与SoapConnector对象连接。SoapSerializer的初始化函数将建立这个内部连接。初始化代入的参数是InputStream (数据流):
// 创建SoapSerializer对象,并用InputSTream进行初始化。 ISoapSerializerPtr Serializer; Serializer.CreateInstance(_uuidof(SoapSerializer30)); Serializer->Init(_variant_t((IUnknown*)Connector->InputStream));
下面是SOAP请求代码:
<SOAP: Envelope xmlns:SOAP="soap namespace"> <SOAP:Body> <m:someMethodName xmlns:m="some namespace"> <someParameter> someParameterValue </someParameter> <m:someMethodName> </SOAP:Body> </SOAP: Envelope>
SOAP请求被安放在标记之中。<Envelope>是SOAP文件的主标记。SOAP信息通常都安放在”信封“(Envelope)里。信封里的<Body>标记中安放信息体,其中包含具体请求。在C++里,用相应的方法来解释这些标记并定义有关的值。
下面的代码说明如何使用这些方法:
Serializer->startEnvelope("","",""); // 开始处理SOAP消息。第一个参数是命名空间,缺省为SOAP-ENV。 // 第二个参数定义URI。第三个参数定义Serialzier->startBody("")函数的编码方式。 // 开始处理<Body>元素,第一个参数是URI的编码类型,缺省为NONE。 Serializer->StartBody(""); Serializer->StartElement("sayHello","http://wtp","","m"); // 开始处理Body里的子元素。 // 第一个参数是元素名。第二个参数是URI。 // 第三个参数编码类型。第四个参数是元素的命名空间。 Serializer->StartElement("userName","","",""); Serializer->WriteString("laghari78"); // 写入元素值 Serializer->EndElement(); Serializer->StartElement("message","","",""); Serializer->WriteString("i say something"); // 写入元素值 Serializer->EndElement(); Serializer->EndElement(); Serializer->EndBody(); Serializer->EndEnvelope(); 在上面的每个startXXX函数后都要又相应的endXXX函数来结尾。消息做完之后,连接器就调用endMessage()方法将消息发送到服务器。