Ksoap使用详解.doc

[j2me]kSOAP的运用 1．概述 对于J2ME访问远端的Web Service，除了官方标准JSR 172，我们还有两种选择： ??????????kSOAP ??????????Wingfoot Wingfoot是由Wingfoot Software()出品的一款J2ME(CLDC/CDC) SOAP1.1的轻量级实现方案。 kSOAP是E的一个开源作品，是EnhydraME项目的一部分。基于E出品的开源通用XML解析器kXML，kSOAP完成了J2ME/MIDP平台上的SOAP解析和调用工作。 Stefan Haustein领导的kSOAP开发小组于2001年5月17日推出了Alhpa版本。之后又经过了一年的开发，2002年6月6日推出的kSOAP 1.2支持了SOAP1.2规范。2003年8月25日推出的kSOAP2，对SOAP序列化规范支持得更好了。 大多数人选择kSOAP的原因是，kSOAP虽然在2003年8月之后就不再维护了，但它是Open Source的，很容易加入增强特性，比如说默认情况下kSOAP2仅仅支持cmnet接入点，可以修改kSOAP2的HttpTransport.java代码增加对cmwap接入点的支持。 下载提示： kSOAP当前有两个版本：1.2和2.0。 官方网站：/ kSOAP2.0还有一个优点是，改进了对Microsoft dotNET的兼容。以前有很多人抱怨kSOAP调用dotNET编写的Web Service时遇到了不少的困扰。 本章节我们将使用kSOAP 2.0的例子来讲解。 为了使用kSOAP 2.0，必须还要下载工具包kXML2。 下载提示： kXML当前有两个版本：1.21和2.0。 官方网站：/ kXML2比kXML更小更快。 2．kSOAP2接口 让我们先熟悉一下即将用到的kSOAP2的常用接口。 接口 org.ksoap2. SoapEnvelope org.ksoap2. SoapSerializationEnvelope：序列化 org.ksoap2. SoapObject：SOAP调用 org.ksoap2.transport. HttpTransport SoapEnvelope对应于SOAP规范中的SOAP Envelope，封装了head和body对象。 SoapSerializationEnvelope是kSOAP2新增加的类，是对SoapEnvelope的扩展，对SOAP序列化(Serialization)格式规范提供了支持，能够对简单对象自动进行序列化(simple object serialization)。而kSOAP1.x则是通过org.ksoap.ClassMap来做序列化的，不太好操作，也不利于扩展。 SoapObject让你自如地构造SOAP调用； HttpTransport为你屏蔽了Internet访问/请求和获取服务器SOAP的细节。 ? 下面我们通过一个最简单的webservice调用，来看看kSOAP是如何做到SOAP解析的： 2．1．kSOAP和Web Service之间传递String webservice传递String给MIDP是一件很简单的事情。首先在服务器端，不管你是用Microsft ASP.NET创建webservice，还是由Tomcat+AXIS1.2支撑的webservice，都可以这么编写主服务类： 服务器端 public class SimpleKSoapWS { public SimpleKSoapWS () { } public String foo(String username, String password) { return “fooResult”; } } 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方法