eclipse使用CXF3.1.*创建webservice服务端客户端以及客户端手机APP（二）

接上篇博客，本篇博客主要包含两个内容：

4.使用Android studio创建webservice客户端APP访问服务端。

5.开发过程中可能出现的一些错误。

闲话少叙，直奔主题。

4.使用Android studio创建webservice 客户端APP访问服务端

先介绍操作，再介绍原理。

手机端运行时，必须和电脑端在同一局域网下。

使用Android studio创建一个项目，使用这个下载链接 https://storage.googleapis.com/google-code-archive-downloads/v2/code.google.com/ksoap2-android/ksoap2-android-assembly-2.4-jar-with-dependencies.jar 下载soap的jar包。

在AndroidManifest.xml中加入网络访问权限代码：

1. <!-- 访问网络的权限 -->
2. <uses-permission android:name="android.permission.INTERNET" />

左边列表使用project，项目名称-----app----libs，然后把上面地址下载的jar包复制进去，在jar包上右击，选择下面的add as library即可导入包。

这是我的项目目录结构图，

下面依然粘贴代码：

界面代码Activity_main.xml，只有一个输入框，一个显示textView，一个按钮，

1. <?xml version="1.0" encoding="utf-8"?>
2. <LinearLayout
3.     xmlns:android="http://schemas.android.com/apk/res/android"
4.     xmlns:app="http://schemas.android.com/apk/res-auto"
5.     xmlns:tools="http://schemas.android.com/tools"
6.     android:layout_width="match_parent"
7.     android:layout_height="match_parent"
8.     tools:context="com.dyf.sharedpsclient.MainActivity">
9.  
10.     <EditText
11.         android:id="@+id/id_et_input"
12.         android:layout_width="148dp"
13.         android:layout_height="wrap_content"
14.         android:ems="10"
15.         android:inputType="textPersonName"
16.         />
17.  
18.     <TextView
19.         android:id="@+id/id_tv_show"
20.         android:layout_width="wrap_content"
21.         android:layout_height="wrap_content"
22.         android:text="Hello World!"
23.         app:layout_constraintBottom_toBottomOf="parent"
24.         app:layout_constraintLeft_toLeftOf="parent"
25.         app:layout_constraintRight_toRightOf="parent"
26.         app:layout_constraintTop_toTopOf="parent"/>
27.  
28.     <Button
29.         android:id="@+id/id_btn_get"
30.         android:layout_width="wrap_content"
31.         android:layout_height="wrap_content"
32.         android:text="获取信息"
33.         tools:layout_editor_absoluteX="147dp"
34.         tools:layout_editor_absoluteY="321dp"/>
35.  
36. </LinearLayout>

操作代码MainActivity.java，主要包括初始化控件，按钮的点击操作，开启新线程发送webservice请求，接收返回结果，使用Handler修改界面信息。

1. package com.dyf.sharedpsclient;
2.  
3. import android.app.Activity;
4. import android.os.Bundle;
5. import android.os.Handler;
6. import android.os.Message;
7. import android.util.Log;
8. import android.view.View;
9. import android.widget.Button;
10. import android.widget.EditText;
11. import android.widget.TextView;
12.  
13. import org.ksoap2.SoapEnvelope;
14. import org.ksoap2.serialization.SoapObject;
15. import org.ksoap2.serialization.SoapSerializationEnvelope;
16. import org.ksoap2.transport.HttpTransportSE;
17.  
18. public class MainActivity extends Activity implements View.OnClickListener
19. {
20.     private TextView tv = null;
21.     private Button btn_Get = null;
22.     private EditText et_Input = null;
23.  
24.     @Override
25.     protected void onCreate(Bundle savedInstanceState)
26.     {
27.         super.onCreate(savedInstanceState);
28.         setContentView(R.layout.activity_main);
29.         tv = (TextView) findViewById(R.id.id_tv_show);
30.         btn_Get = (Button) findViewById(R.id.id_btn_get);
31.         et_Input = (EditText) findViewById(R.id.id_et_input);
32.         //直接调用webservice中的getParklotName方法
33.         btn_Get.setOnClickListener(this);
34.     }
35.  
36.     private String callService()
37.     {
38.         //命名空间
39.         String nameSpace = "http://dao.diy.com";
40.         //serviceURL
41.         String serviceURL = "http://10.201.23.77:8080/webservice";
42.         //调用的方法名称
43.         String methodName = "sayHello";
44.         //创建HttpTransportSE传输对象
45.         HttpTransportSE transport = new HttpTransportSE(serviceURL);
46.         //transport.debug = true;
47.  
48.         //使用Soap1.1创建SoapSerializationEnvelope对象
49.         SoapSerializationEnvelope envelop = new SoapSerializationEnvelope(SoapEnvelope.VER11);
50.         //实例化SoapObject对象
51.         SoapObject request = new SoapObject(nameSpace, methodName);
52.         String soapAction = nameSpace +"/"+ methodName;
53.         String inputText = et_Input.getText().toString();
54.         Log.i("inputText:",inputText);
55.         request.addProperty("arg0", inputText);
56.         envelop.dotNet = true;
57.         envelop.bodyOut = request;
58.         envelop.setOutputSoapObject(request);
59.         envelop.encodingStyle = "UTF-8";
60.         //调用webservice
61.         try
62.         {
63.             transport.call(soapAction, envelop);
64.             Log.i("envelop.getresponse:", envelop.getResponse().toString());
65.             if (envelop.getResponse().toString() != null)
66.             {
67.                 SoapObject result = (SoapObject) envelop.bodyIn;
68.                 String word = result.getProperty(0).toString();
69.                 return word;
70.                 //tv.setText(word);
71.             }
72.         } catch (Exception e)
73.         {
74.             Log.i("调用webservice出错：",e.toString());
75.             e.printStackTrace();
76.             return "no";
77.         }
78.         return null;
79.     }
80.  
81.     //定义Handler对象
82.     private Handler handler = new Handler(){
83.  
84.         @Override
85.         public void handleMessage(Message msg)
86.         {
87.             String str= null;
88.             switch (msg.what)
89.             {
90.                 case 1:
91.                     str = msg.obj.toString();
92.                     tv.setText(str);
93.             }
94.         }
95.     };
96.  
97.     /**
98.      * Called when a view has been clicked.
99.      *
100.      * @param v The view that was clicked.
101.      */
102.     @Override
103.     public void onClick(View v)
104.     {
105.         switch (v.getId())
106.         {
107.             case R.id.id_btn_get:
108.                 new Thread() {
109.                     @Override
110.                     public void run() {
111.                         // 你要执行的方法
112.                         Log.i("tag","new thread");
113.                         Message message = new Message();
114.                         message.what = 1;
115.                         message.obj = callService();
116.                         Log.i("message.what", String.valueOf(message.what));
117.                         Log.i("message.obj",message.obj.toString());
118.                         // 执行完毕后给handler发送消息
119.                         handler.sendMessage(message);
120.                     }
121.                 }.start();
122.                 break;
123.         }
124.     }
125. }

运行之后的结果：左边是软件一进入的界面，右边是输入框输入之后，点击获取信息按钮，然后显示服务端返回的内容。

下面介绍一下这个程序中的代码。

按照程序流程一步步进行，首先是103行的点击按钮的click事件，定义一个Message对象，接收返回结果使用，115行的message.obj = callService();使用callService方法，得到服务端返回结果，然后由handler发送消息，82行判断之后，修改主界面信息。其中callService方法是一个主要过程，下面重点说明一下。

首先39行声明命名空间nameSpace，值就是服务器端提供服务接口所在包倒写，最后不加 "/" ，否则下面运行时eclipse服务端会报 下面这个错误，（主要看第二行，楼主就在这个地方坑了两天）

1. 警告: Interceptor for {http://dao.diy.com}SayHelloService#{http://dao.diy.com}sayHello has thrown exception, unwinding now
2. org.apache.cxf.interceptor.Fault: Unexpected wrapper element {http://dao.diy.com/}sayHello found. Expected {http://dao.diy.com}sayHello.
3.    at org.apache.cxf.wsdl.interceptors.DocLiteralInInterceptor.handleMessage(DocLiteralInInterceptor.java:107)
4.    at org.apache.cxf.phase.PhaseInterceptorChain.doIntercept(PhaseInterceptorChain.java:308)
5.    at org.apache.cxf.transport.ChainInitiationObserver.onMessage(ChainInitiationObserver.java:121)
6.    at org.apache.cxf.transport.http.AbstractHTTPDestination.invoke(AbstractHTTPDestination.java:267)
7.    at org.apache.cxf.transport.http_jetty.JettyHTTPDestination.doService(JettyHTTPDestination.java:234)
8.    at org.apache.cxf.transport.http_jetty.JettyHTTPHandler.handle(JettyHTTPHandler.java:76)
9.    at org.eclipse.jetty.server.handler.ContextHandler.doHandle(ContextHandler.java:1129)
10.    at org.eclipse.jetty.server.handler.ContextHandler.doScope(ContextHandler.java:1065)
11.    at org.eclipse.jetty.server.handler.ScopedHandler.handle(ScopedHandler.java:141)
12.    at org.eclipse.jetty.server.handler.ContextHandlerCollection.handle(ContextHandlerCollection.java:215)
13.    at org.eclipse.jetty.server.handler.HandlerWrapper.handle(HandlerWrapper.java:97)
14.    at org.eclipse.jetty.server.Server.handle(Server.java:499)
15.    at org.eclipse.jetty.server.HttpChannel.handle(HttpChannel.java:311)
16.    at org.eclipse.jetty.server.HttpConnection.onFillable(HttpConnection.java:258)
17.    at org.eclipse.jetty.io.AbstractConnection$2.run(AbstractConnection.java:544)
18.    at org.eclipse.jetty.util.thread.QueuedThreadPool.runJob(QueuedThreadPool.java:635)
19.    at org.eclipse.jetty.util.thread.QueuedThreadPool$3.run(QueuedThreadPool.java:555)
20.    at java.lang.Thread.run(Thread.java:745)

然后41行定义服务访问的serviceURL，值就是服务端发布时的发布地址，结尾不要加 "/" ，不加 "?wsdl"。

43行定义调用的方法名称，注意名称和大小写别写错。

52行的soapAction ，注意是nameSpace+"/"+methodName，别忘了这个 "/" ，如果没有，服务端控制台那里报错，会打出这个soapaction，自己一看就明白了。

55行的request.addProperty（key ,value），这句是添加参数的，因为上面的sayHello方法只有一个参数，所以这里写了一次，如果有多个参数，则这里写对应个数的参数即可。

63行发起请求。

65行判断返回值不为空的情况，在67行可能会出现一个问题，使用SoapObject类时，Android studio控制台可能会报

java.lang.ClassCastException: org.ksoap2.serialization.SoapPrimitive cannot be cast to org.ksoap2.serialization.SoapObject ， 类转换错误，出现这个错误的话，把SoapObject改为Object就可以了，网上有人说是版本的问题，楼主也不是很清楚，但是如果出现这个错误，改为Object就可以了。

另外67行还有一个坑，有的使用envelop.getResponse() 的时候，也可能会报错，改为使用 envelop.bodyIn即可。

上面就是Android studio主要代码中的一些说明了。

下面是项目中，可能会遇到的一些错误。

5.开发过程中可能会出现的一些错误

（1）java.lang.ClassCastException: org.ksoap2.serialization.SoapPrimitive，类转换错误。

参考： https://www.cnblogs.com/gushandujian/p/3495191.html ，

http://blog.csdn.net/whybiang/article/details/6533051 ，解释很详细，感谢作者。

在服务器端返回值是String类型的数值的时候使用SoapObject soapObject = (SoapObject) envelope.getResponse();和 SoapObject result = (SoapObject)envelope.bodyIn;这两种方法来接受值都会报出 java.lang.ClassCastException: org.ksoap2.serialization.SoapPrimitive这样的错误。 我们可以使用 Object object = (Object)envelope.getResponse();就可以解决这种错误。

（2）org.apache.cxf.interceptor.Fault: The given SOAPAction http://wsservice.abc.com/icService does not match an operation. 或者是 org.apache.cxf.interceptor.Fault: Unexpected wrapper element {http://wsservice.abc.com}icService found. Expected {http://wsservice.abc.com/}icService.

参考： http://www.yyjjssnn.cn/articles/706.html ，解释很详细，感谢作者。

这两种错误都是因为服务端编写时，没有在服务和方法上加入或者编写注解不对导致的，请详细查看注解是否正确，以及网页中的wsdl 描述的soapaction是否正确，详细可以查看我的上一篇博客，查看webservice服务端代码如何编写。

新增demo源码下载地址：链接：https://pan.baidu.com/s/1sm1w3ud  密码：0n40，链接失效的话，请评论区留言个人百度账号，给你分享一下。

由于编者水平有限，文章中如有不妥之处或者有什么疑问，可直接在下面评论指出，不胜感激。