客户端和服务端通讯的N种方式（一）

1. "getName");??

SoapObject类的第1个参数表示WebService的命名空间，可以从WSDL文档中找到WebService的命名空间。第2个参数表示要调用的WebService方法名。

2.? 设置调用方法的参数值，这一步是可选的，如果方法没有参数，可以省略这一步。设置方法的参数值的代码如下：

"value1");?request.addProperty("param2",?"value2");??

要注意的是，addProperty方法的第1个参数虽然表示调用方法的参数名，但该参数值并不一定与服务端的WebService类中的方法参数名一致，只要设置参数的顺序一致即可。

3.? 生成调用WebService方法的SOAP请求信息。该信息由SoapSerializationEnvelope对象描述，代码如下：

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

创建SoapSerializationEnvelope对象时需要通过SoapSerializationEnvelope类的构造方法设置SOAP协议的版本号。该版本号需要根据服务端WebService的版本号设置。在创建SoapSerializationEnvelope对象后，不要忘了设置SoapSerializationEnvelope类的bodyOut属性，该属性的值就是在第1步创建的SoapObject对象。

4.? 创建HttpTransportSE对象。通过HttpTransportSE类的构造方法可以指定WebService的WSDL文档的URL，代码如下：

HttpTransportSE?ht?=?new?HttpTransportSE("http://192.168.17.156:8080/axis2/services/SearchProductService?wsdl");??

5.? 使用call方法调用WebService方法，代码如下：

?

call方法的第1个参数一般为null，第2个参数就是在第3步创建的SoapSerializationEnvelope对象。

6.? 使用getResponse方法获得WebService方法的返回结果，代码如下：

?

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

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

使用WebService传输简单的数据

为了演示WebService的使用，首先需要编写一个WebService。读者可直接将服务端程序（axis2目录）复制到<Tomcat安装目录>/webapps目录中，然后启动Tomcat，并在浏览器地址栏中输入如下的URL：

http://localhost:8080/axis2

如果在浏览器中显示如图2所示的页面，说明服务端程序已经安装成功。

图2? 测试WebService是否安装成功

这个服务端WebService程序是SearchProductService，实际上SearchProductService是一个Java类，只是利用Axis2将其映射成WebService。在该类中有一个getProduct方法。这个方法有一个String类型的参数，表示产品名称。该方法返回一个Product对象，该对象有3个属性：name、price和productNumber。SearchProduct类的代码如下：

package?service;?import?java.util.HashMap;?import?java.util.Map;?public?class?SearchProductService?{?private?static?Map<String,153); background-color:inherit; font-weight:bold">new?HashMap<String,?Product>();?static?{?Product?product?=?new?Product();?product.setName("ACA烤箱?");?product.setProductNumber(200);?product.setPrice(299);?products.put("ACA烤箱",?product);?product?=?new?Product();?product.setName("HTC?Hero手机");?product.setProductNumber(12);?product.setPrice(3210);?products.put("htc?hero",153); background-color:inherit; font-weight:bold">new?Product();?product.setName("iphone手机");?product.setProductNumber(20);?product.setPrice(5100);?products.put("iphone",?product);?}?public?Product?getProduct(String?productName)?{?return?products.get(productName);?}?}?其中Product表示产品类，代码如下：?import?java.io.Serializable;?class?Product?{?private?String?name;?int?productNumber;?float?price;?public?String?getName()?{?return?name;?}?void?setName(String?name)?{?this.name?=?name;?}?int?getProductNumber()?{?return?productNumber;?}?void?setProductNumber(int?productNumber)?{?this.productNumber?=?productNumber;?}?float?getPrice()?{?return?price;?}?void?setPrice(float?price)?{?this.price?=?price;?}?}??

我们可以使用如下的URL来查看SearchProductService的WSDL文档。

http://localhost:8080/axis2/services/SearchProductService?wsdl

显示WSDL文档的页面如图3所示。

在图3中顶层节点的targetNamespace属性值就是WebService的命名空间，也是SoapObject类的构造方法的第1个参数值。这个WebService程序可以直接使用如下的URL进行测试。
http://localhost:8080/axis2/services/SearchProductService/getProduct?args0=iphone

测试的结果如图4所示。

图4? WebService测试结果

从图4所示的测试结果可以看出，Axis2将getProduct方法返回的Product对象直接转换成了XML文档（实际上是SOAP格式）返回。
下面我们来根据前面介绍的使用KSOAP2的步骤来编写调用WebService的Android客户端程序，代码如下：

package?ws.client?;?import?org.ksoap2.SoapEnvelope;?import?org.ksoap2.serialization.SoapObject;?import?org.ksoap2.serialization.SoapSerializationEnvelope;?import?org.ksoap2.transport.HttpTransportSE;?import?android.app.Activity;?import?android.os.Bundle;?import?android.view.View;?import?android.view.View.OnClickListener;?import?android.widget.Button;?import?android.widget.EditText;?import?android.widget.TextView;?class?Main?extends?Activity?implements?OnClickListener?{?@Override?void?onClick(View?view)?{?EditText?etProductName?=?(EditText)findViewById(R.id.etProductName);?TextView?tvResult?=?(TextView)findViewById(R.id.tvResult);?//?WSDL文档的URL，192.168.176为PC的ID地址?String?serviceUrl?=?"http://192.168.17.86:8080/axis2/services/SearchProductService?wsdl";?//?定义调用的WebService方法名?String?methodName?=?"getProduct";?//?第1步：创建SoapObject对象，并指定WebService的命名空间和调用的方法名?SoapObject?request?=?new?SoapObject("http://service",?methodName);?//?第2步：设置WebService方法的参数?request.addProperty("productName",?etProductName.getText().toString());?//?第3步：创建SoapSerializationEnvelope对象，并指定WebService的版本?SoapSerializationEnvelope?envelope?=?new?SoapSerializationEnvelope(SoapEnvelope.VER11);?//?设置bodyOut属性?envelope.bodyOut?=?request;?//?第4步：创建HttpTransportSE对象，并指定WSDL文档的URL?HttpTransportSE?ht?=?new?HttpTransportSE(serviceUrl);?try?{?//?第5步：调用WebService?ht.call(null,?envelope);?if?(envelope.getResponse()?!=?null)?{?//?第6步：使用getResponse方法获得WebService方法的返回结果?SoapObject?soapObject?=?(SoapObject)?envelope.getResponse();?//?通过getProperty方法获得Product对象的属性值?String?result?=?"产品名称："?+?soapObject.getProperty("name")?+?"/n";?result?+=?"产品数量："?+?soapObject.getProperty("productNumber")?+?"/n";?result?+=?"产品价格："?+?soapObject.getProperty("price");?tvResult.setText(result);?}?else?{?tvResult.setText("无此产品.");?}?}?catch?(Exception?e)?{?}?}?@Override?public?void?onCreate(Bundle?savedInstanceState)?{?super.onCreate(savedInstanceState);?setContentView(R.layout.main);?Button?btnSearch?=?(Button)?findViewById(R.id.btnSearch);?btnSearch.setOnClickListener(this);?}?}??

在编写上面代码时应注意如下两点：

1. 在第2步中addProperty方法的第1个参数值是productName，该值虽然是getProduct方法的参数名，但addProperty方法的第1个参数值并不限于productName，读者可以将这个参数设为其他的任何字符串（但该值必须在XML中是合法的，例如，不是设为“<”、“>”等XML预留的字符串）。
2. 通过SoapObject类的getProperty方法可以获得Product对象的属性值，这些属性名就是图4所示的测试结果中的属性名。

运行程序，在文本框中输入“htc hero”，单击【查询】按钮，会在按钮下方显示如图5所示的查询结果。

图5?? 调用WebService

总结 在本文为读者介绍了如何在OPhone中通过KSOAP2调用WebService，并传递简单的数据。然而，通过KSOAP不仅可以传递简单的数据，也可以传递更复杂的数据，在下一篇文章中将会为读者揭示这一切。

（编辑：李大同）

【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容!