Android 网络编程——SOAP

 

简单对象访问协议(Simple Object Access Protocol,SOAP)可以使网页服务器(Web Server)从XML 数据库中提取数据时,无需花时间去格式化页面,并能够让不同应用程序之间通过HTTP 协议,以 XML 格式互相交换彼此的数据,使这个交换过程与编程语言、平台和硬件无关。

SOAP 基于 XML 标准,用于在分布式环境中发送消息,并执行远程过程调用。使用SOAP,不用考虑任何特定的传输协议(尽管通常选用 HTTP 协议),就能使数据序列化。

SOAP 的优点如下:
1.SOAP 是可扩展的。SOAP 无需中断已有的应用程序,SOAP 客户端、服务器和协议自身都能发展。而且 SOAP 能极好地支持中间介质和层次化的体系结构。
2.SOAP 是简单的。客户端发送一个请求,调用相应的对象,然后服务器返回结果。这些消息是 XML 格式的,并且封装成符合 HTTP 协议的消息。因此,它符合任何路由器、防火墙或代理服务器的要求。
3.SOAP 是完全和厂商无关的。SOAP 可以相对于平台、操作系统、目标模型和编程语言独立实现。另外,传输和语言绑定以及数据编码的参数选择都是由具体的实现决定的。
4.SOAP 与编程语言无关。SOAP可以使用任何语言来完成,只要客户端发送正确SOAP 请求(也就是说,传递一个合适的参数给一个实际的远端服务器)。
5.SOAP 没有对象模型,应用程序可以捆绑在任何对象模型中。

一. SOAP 消息实例

请求时候发送的消息内容如下:

<soapenv:Envelope
	xmlns:soapenv="http:// schemas.xmlsoap.org/soap/envelope/"
	xmlns:xsd="http:// www.w3.org/2001/XMLSchema"
	xmlns:xsi="http:// www.w3.org/2001/XMLSchema-instance">
	<soapenv:Body>
		<req:echo xmlns:req="http:// localhost:8080/axis2/services/MySer-vice/">
			<req:category>classifieds</req:category>
		</req:echo>
	</soapenv:Body>
</soapenv:Envelope>

响应时候发送的消息内容如下:

<soapenv:Envelope
	xmlns:soapenv="http:// schemas.xmlsoap.org/soap/envelope/"
	xmlns:wsa="http:// schemas.xmlsoap.org/ws/2004/08/addressing">
	<soapenv:Header>
		<wsa:ReplyTo>
			<wsa:Address>http:// schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous</wsa:Address>
		</wsa:ReplyTo>
		<wsa:From>
			<wsa:Address>http:// localhost:8080/axis2/services/MyService</wsa:Address>
		</wsa:From>
		<wsa:MessageID>ECE5B3F187F29D28BC11433905662036</wsa:MessageID>
	</soapenv:Header>
	<soapenv:Body>
		<req:echo xmlns:req="http:// localhost:8080/axis2/services/MyService/">
			<req:category>classifieds</req:category>
		</req:echo>
	</soapenv:Body>
</soapenv:Envelope>

二. 调用 WebService

步骤1  添加 ksoap2 包。
步骤2  指定 WebService 的命名空间和调用的方法名,如:

SoapObject request =new SoapObject(http:// service,"getName");

 第一个参数表示 WebService 的命名空间,可以从 WSDL 文档中找到;
 第二个参数表示要调用的 WebService 方法名。
步骤3  设置调用方法的参数值。设置方法的参数值的代码如下:

request.addProperty("param1","value");
request.addProperty("param2","value");

 只要设置参数的顺序一致即可。

步骤4  生成调用 WebService 方法的 SOAP 请求信息。该信息由 SoapSerializationEnvelope对象描述,代码如下:

SoapSerializationEnvelope envelope = new SoapSerializationEnvelope(SoapEnvelope.VER11);
Envelope.bodyOut = request;

步骤5  创建HttpTransportsSE对象。通过HttpTransportsSE类的构造方法可以指定WebService的WSDL文档的URL。

HttpTransportSE ht=new HttpTransportSE("http:// fy.webxml.com.cn/webservices/EnglishChinese.asmx?wsdl");

步骤6  使用 call 方法调用 WebService 方法,代码如下:

ht.call(null,envelope);

步骤7  使用 getResponse 方法获得 WebService 方法的返回结果,代码如下

SoapObject soapObject =(SoapObject)envelope.getResponse();

步骤8  解析返回的内容。


补充

中国气象局的WebService地址 
http://www.webxml.com.cn/WebServices/WeatherWebService.asmx