Android SOAP协议学习中（一）

浏览数：19 / 时间：2015年06月11日

这个项目用到了android soap协议，简单说一下自己的心得，这也是从网上看资料学到的，

copy开始--------

kSOAP是如何调用这个webservice的呢？
首先要使用SoapObject，这是一个高度抽象化的类，完成SOAP调用。可以调用它的addProperty方法填写要调用的webservice方法的参数。如下面代码所示：
SoapObject request  = new SoapObject(serviceNamespace, methodName);
SoapObject构造函数的两个参数含义为：
serviceNamespace – 你的webservice的命名空间，既可以是
http://localhost:8088/flickrBuddy/services/Buddycast这样的，也可以是
urn:PI/DevCentral/SoapService这样的；
methodName – 你要调用方法的名字。
然后，按照webservice方法参数的顺序，依次调用
request.addProperty( "username", "user" );
request.addProperty( "password", "pass" );
来填充webservice参数。
注意：
建议webservice的方法传递的参数尽量用string类型。即使是int类型，kSOAP2与Java编写的webservice也有可能交互发生异常。
对于webservice方法返回String类型的情况，还用不着开发者做序列化(Serialization)定制工作。
要点：
kSOAP 1.X/2.0可以自动把四种SOAP类型映射为Java类型
SOAP type Java type
xsd:int  java.lang.Integer
xsd:long  java.lang.Long
xsd:string  java.lang.String
xsd:boolean java.lang.Boolean
除此之外，都需要开发者自己做类型映射。
然后要告诉SoapSerializationEnvelope把构造好的SoapObject封装进去：
SoapSerializationEnvelope envelope =
new SoapSerializationEnvelope(SoapEnvelope.VER11);
envelope.bodyOut = request;
要点：
你可以通过SoapSerializationEnvelope或者SoapEnvelope的构造函数来指明你要用SOAP的哪一个规范，可以是以下几种之一：
常量SoapEnvelope.VER10：对应于SOAP 1.0规范
常量SoapEnvelope.VER11：对应于SOAP 1.1规范
常量SoapEnvelope.VER12：对应于SOAP 1.2规范
这样，无论要调用的webservice采用了哪一个SOAP规范，你都可以轻松应对。
接下来就要声明
HttpTransport tx = new HttpTransport(serviceURL);
ht.debug = true;
HttpTransport构造函数的参数含义为：
serviceURL – 要投递SOAP数据的目标地址，譬如说
http://soap.amazon.com/onca/soap3 。
HttpTransport是一个强大的辅助类，来完成Http-call transport process，它封装了网络请求的一切，你完全不用考虑序列化消息。我们通过设置它的debug属性为true来打开调试信息。
方法HttpTransport.call()自己就能够发送请求给服务器、接收服务器响应并序列化SOAP消息，如下所示：
ht.call(null, envelope);
HttpTransport的call方法的两个参数含义为：
soapAction – SOAP 规范定义了一个名为 SOAPAction 的新 HTTP 标头，所有 SOAP HTTP 请求（即使是空的）都必须包含该标头。 SOAPAction 标头旨在表明该消息的意图。通常可以置此参数为null，这样HttpTransport就会设置HTTP标头SOAPAction为空字符串。
Envelope – 就是前面我们构造好的SoapSerializationEnvelope或SoapEnvelope对象。
注意：
对于HttpTransport的处理上，kSOAP2和kSOAP1.2的写法不一样。
对于kSOAP 1.2，HttpTransport的构造函数是HttpTransport (String url, String soapAction)，第二个参数soapAction可以是要调用的webservice方法名。
而kSOAP 2，构造函数是 HttpTransport(String url)。kSOAP2相当于把webservice方法名分离出去，完全交给SoapObject去封装，而HttpTransport仅仅负责把 SoapEnvelope发送出去并接收响应，这样更合理一些。
调用call方法是一个同步过程，需要等待它返回。
返回之后，就可以调用SoapSerializationEnvelope的getResult方法来获取结果了：
Object Response = envelope.getResult();
如果HttpTransport的debug属性为true，那么此时就可以通过
System.out.println("Response dump>>" + tx.responseDump);
打印出HttpTransport的调试信息。尤其当前面call方法和getResult方法发生异常时，这个调试信息是非常有用的。
前面我们的webservice方法由于是返回string，所以得到这个string值就非常简单了：
String sResponse = (String)Response;
注意：
由于HttpTransport类实际上是调用了HttpConnection作网络连接，所以必须另起一个线程来专门做kSOAP工作，否则会堵塞操作。