×

在Android 中使用KSOAP2调用WebService（2）

Kalet Kalet 发表于2013-12-25 22:45:03 浏览227 评论0

抢沙发发表评论

 
  • 在 第2步中addProperty方法的第1个参数值是productName，该值虽然是getProduct方法的参数名，但addProperty方 法的第1个参数值并不限于productName，读者可以将这个参数设为其他的任何字符串（但该值必须在XML中是合法的，例如，不是设为 “<”、“>”等XML预留的字符串）。
  • 通过SoapObject类的getProperty方法可以获得Product对象的属性值，这些属性名就是图4所示的测试结果中的属性名。
        运行本例，在文本框中输入“htc hero”，单击【查询】按钮，会在按钮下方显示如图5所示的查询结果。
 
surface view5.png
图5  显示查询结果
防止UI组件阻塞
        从功能上看，本文示例中给出的代码并没有任何问题。但可能有的读者会有这样的担心：如果调用WebService的用户很多，至使服务端响应迟缓；或服务 端的IP根本就不对，那么在这些情况下，用户界面的按钮和文本框组件岂不是象“死”了一样无法响应用户的其他动作。当然，发生这种情况的可能性是有的，尤 其是在复杂的网络环境中发生的可能性是很大的，一但发生这种事情，就会使整个软件系统在用户体验上变得非常糟糕。
用户和开发人员都希望改善这种糟糕的情况。最理想的状态是单击按钮调用WebService方法时，即使由于某种原因，WebService方法并未立即返回，界面上的组件仍然会处于活动状态，也就是说，用户仍然可以使用当前界面中的其他组件。
 
         在OPhone中可以采用异步的方式来达到这个目的。异步实际上就是通过多线程的方式来实现。一般使用new Thread(this).start()来创建和开始一个线程。但本节并不使用Thread来实现异步，而是通过AsyncTask类使要执行的任务 （调用WebService）在后台执行。
 
        下面先看看改进后的代码。
 
01package net.blogjava.mobile.wsclient;  
02    
03import org.ksoap2.SoapEnvelope;  
04import org.ksoap2.serialization.SoapObject;  
05import org.ksoap2.serialization.SoapSerializationEnvelope;  
06import org.ksoap2.transport.HttpTransportSE;  
07import android.app.Activity;  
08import android.os.AsyncTask;  
09import android.os.Bundle;  
10import android.view.View;  
11import android.view.View.OnClickListener;  
12import android.widget.Button;  
13import android.widget.EditText;  
14import android.widget.TextView;  
15    
16public class Main extends Activity implements OnClickListener  
17{  
18    private EditText etProductName;  
19    private TextView tvResult;  
20    
21    class WSAsyncTask extends AsyncTask  
22    {  
23        String result = "";  
24        @Override 
25        protected Object doInBackground(Object... params)  
26        {  
27            try 
28            {  
29                String serviceUrl = "http://192.168.17.156:8080/axis2/services/SearchProductService?wsdl";  
30                String methodName = "getProduct";  
31                SoapObject request = new SoapObject("http://service",  
32                        methodName);  
33                request.addProperty("productName", etProductName.getText().toString());  
34                SoapSerializationEnvelope envelope = new SoapSerializationEnvelope(  
35                        SoapEnvelope.VER11);  
36                envelope.bodyOut = request;  
37                HttpTransportSE ht = new HttpTransportSE(serviceUrl);  
38    
39                ht.call(null, envelope);  
40                if (envelope.getResponse() != null)  
41                {  
42                    SoapObject soapObject = (SoapObject) envelope.getResponse();  
43                    result = "产品名称：" + soapObject.getProperty("name") + "\n";  
44                    result += "产品数量：" + soapObject.getProperty("productNumber")  
45                            + "\n";  
46                    result += "产品价格：" + soapObject.getProperty("price");  
47    
48                }  
49                else 
50                {  
51                    result = "无此产品.";  
52                }  
53            }  
54            catch (Exception e)  
55            {  
56                result = "调用WebService错误.";  
57            }  
58            // 必须使用post方法更新UI组件  
59            tvResult.post(new Runnable()  
60            {  
61                @Override 
62                public void run()  
63                {  
64                    tvResult.setText(result);  
65    
66                }  
67            });  
68            return null;  
69        }  
70    
71    }  
72    @Override 
73    public void onClick(View view)  
74{  
75    // 异步执行调用WebService的任务    
76        new WSAsyncTask().execute();  
77    }  
78    @Override 
79    public void onCreate(Bundle savedInstanceState)  
80    {  
81        super.onCreate(savedInstanceState);  
82        setContentView(R.layout.main);  
83        Button btnSearch = (Button) findViewById(R.id.btnSearch);  
84        btnSearch.setOnClickListener(this);  
85        etProductName = (EditText) findViewById(R.id.etProductName);  
86        tvResult = (TextView) findViewById(R.id.tvResult);  
87    
88    }  
89}
     调用WebService的核心代码与示例中的代码完全一样，在这里就不再做具体的介绍了。但在编写上面的代码时还需要注意如下几点。
 
1. 一般需要编写一个AsyncTask的子类来完成后台执行任务的工作。
2.  AsyncTask的核心方法是doInBackground，当调用AsyncTask类的execute方法时，doInBackground方法会异步执行。因此，可以将执行任务的代码写在doInBackground方法中。
3. 由 于本例中的TextView组件是在主线程（UI线程）中创建的，因此，在其他的线程（doInBackground方法所在的线程）中不能直接更新 TextVew组件。为了更新TextView组件，需要使用TextView类的post方法。该方法的参数是一个Runnable对象，需要将更新 TextView组件的代码写在Runnable接口的run方法中。
4. 虽然不能在其他线程中更新UI组件，但可以从其他线程直接读取UI组件的值。例如，在doInBackground方法中直接读取了EditText组件的值。
5. 调用AsyncTask类的execute方法后会立即返回。execute方法的参数就是doInBackground方法的参数。doInBackground方法的返回值可以通过AsyncTask.execute(...).get()方法获得。
读者可以将本例中的IP改成其他的值，看看单击按钮后，是否还可在文本框中输入其他的内容。如果这个IP是正确的，并且WebService可访问，那么会在TextView组件中输出相应的返回值。
 
总结
       本文主要介绍了如何使用KSOAP2来调用WebService。KSOAP2是第三方开发的专门用于在移动设备调用WebService的类库。使用 KSOAP2调用WebService可分为6步来完成，其中主要使用了SoapObject对象来指定了要调用的方法，然后通过 HttpTransportSE对象的call方法来调用WebService的方法，最后通过getResponse方法返回结果。读者可以通过本文提 供的完整示例来体会使用KSOAP2调用WebService的完整过程。在最后还介绍了如何通过异步调用WebService的方式来防止因服务端故障 或其他原因导致的UI组件阻塞。

群贤毕至

访客