Android开发系列之调用WebService

我在学习Android开发过程中遇到的第一个疑问就是Android客户端是怎么跟服务器数据库进行交互的呢？这个问题是我当初初次接触Android时所困扰我的一个很大的问题，直到几年前的一天，我突然想到WebService是否可以呢？让WebService充当服务器端的角色，完成与服务器数据库操作相关的事情，而Android客户端只要按照WebService方法参数的要求去调用就行了。在当时我对这个解决方案的实现还没模糊，我想这个问题也是初学Android的朋友肯定会想到的问题。那么现在就让我们动手去实现它吧。

这个程序我们演示如何请求Web Service来获取服务端提供的数据。

由于我对C#比较熟悉，所以我优先使用自己熟悉的技术来搭建WebService的项目。很简单我们就用VS工具创建一个Web服务应用程序（VS2008，而从VS2010开始优先使用WCF来创建服务应用程序了，不过用WCF框架创建WebService也是很容易的）。

1. [WebMethod]
2. public string DataTableTest()
3. {
4. DataTable dt = new DataTable("userTable");
5. dt.Columns.Add("id",typeof(int));
6. dt.Columns.Add("name", typeof(string));
7. dt.Columns.Add("email", typeof(string));
8. dt.Rows.Add(1, "gary.gu", "guwei4037@sina.com");
9. dt.Rows.Add(2, "jinyingying", "345822155@qq.com");
10. dt.Rows.Add(3, "jinyingying", "345822155@qq.com");
11. dt.Rows.Add(4, "jinyingying", "345822155@qq.com");
12. return Util.CreateJsonParameters(dt);
13. }

这个WebService的方法很简单，就是组建一个DataTable的数据类型，并通过CreateJsonParameters方法转化为JSON字符串。这里面的DataTable可以修改成从数据库端读取数据到DataTable对象。

1. public static string CreateJsonParameters(DataTable dt)
2. {
3. StringBuilder JsonString = new StringBuilder();
4. if (dt != null && dt.Rows.Count > 0)
5. {
6. JsonString.Append("{ ");
7. JsonString.Append("\"Result_List\":[ ");
8. for (int i = 0; i < dt.Rows.Count; i++)
9. {
10. JsonString.Append("{ ");
11. for (int j = 0; j < dt.Columns.Count; j++)
12. {
13. if (j < dt.Columns.Count - 1)
14. {
15. JsonString.Append("\"" + dt.Columns[j].ColumnName.ToString() + "\":" + "\"" + dt.Rows[i][j].ToString() + "\",");
16. }
17. else if (j == dt.Columns.Count - 1)
18. {
19. JsonString.Append("\"" + dt.Columns[j].ColumnName.ToString() + "\":" + "\"" + dt.Rows[i][j].ToString() + "\"");
20. }
21. }
22. if (i == dt.Rows.Count - 1)
23. {
24. JsonString.Append("} ");
25. }
26. else
27. {
28. JsonString.Append("}, ");
29. }
30. }
31. JsonString.Append("]}");
32. return JsonString.ToString();
33. }
34. else
35. {
36. return null;
37. }
38. }

这个方法是我从网上随便找到的一个方法，比较土了，就是直接拼接JSON字符串（无所谓，这不是我们要关心的重点）。

WebService端准备好，就可以将其发布到IIS。发布方法跟网站一样，如果是本机的话，可以直接测试WebService方法返回得到的结果，比如调用后会得到如下结果：

这里肯定有人问，这外面是XML，里面又是JSON，这不是“四不像”吗？是的，我这样做是想说明一点，WebService是基于Soap的，数据传输的格式就是XML，所以这里得到XML文档是理所当然。如果你想得到纯净的JSON字符串，可以使用C#中的WCF框架（可以指定客户端返回JSON格式）或者Java中的Servlet（直接刷出JSON文本）。

好，接下来我们要做两件事：

1、请求这个WebService得到这个JSON字符串

2、格式化这个JSON字符串在Android中显示

我们先提供一个助手类，这是我自己动手封装了一下这两个操作所需要的方法。

1. /**
2. * @author gary.gu 助手类
3. */
4. public final class Util {
5. /**
6. * @param nameSpace  WS的命名空间
7. * @param methodName WS的方法名
8. * @param wsdl       WS的wsdl的完整路径名
9. * @param params     WS的方法所需要的参数
10. * @return           SoapObject对象
11. */
12. public static SoapObject callWS(String nameSpace, String methodName,
13. String wsdl, Map<String, Object> params) {
14. final String SOAP_ACTION = nameSpace + methodName;
15. SoapObject soapObject = new SoapObject(nameSpace, methodName);
16. if ((params != null) && (!params.isEmpty())) {
17. Iterator<Entry<String, Object>> it = params.entrySet().iterator();
18. while (it.hasNext()) {
19. Map.Entry<String, Object> e = (Map.Entry<String, Object>) it
20. .next();
21. soapObject.addProperty(e.getKey(), e.getValue());
22. }
23. }
24. SoapSerializationEnvelope envelope = new SoapSerializationEnvelope(
25. SoapEnvelope.VER11);
26. envelope.bodyOut = soapObject;
27. // 兼容.NET开发的Web Service
28. envelope.dotNet = true;
29. HttpTransportSE ht = new HttpTransportSE(wsdl);
30. try {
31. ht.call(SOAP_ACTION, envelope);
32. if (envelope.getResponse() != null) {
33. SoapObject result = (SoapObject) envelope.bodyIn;
34. return result;
35. } else {
36. return null;
37. }
38. } catch (Exception e) {
39. Log.e("error", e.getMessage());
40. }
41. return null;
42. }
43. /**
44. *
45. * @param result JSON字符串
46. * @param name   JSON数组名称
47. * @param fields JSON字符串所包含的字段
48. * @return       返回List<Map<String,Object>>类型的列表，Map<String,Object>对应于 "id":"1"的结构
49. */
50. public static List<Map<String, Object>> convertJSON2List(String result,
51. String name, String[] fields) {
52. List<Map<String, Object>> list = new ArrayList<Map<String, Object>>();
53. try {
54. JSONArray array = new JSONObject(result).getJSONArray(name);
55. for (int i = 0; i < array.length(); i++) {
56. JSONObject object = (JSONObject) array.opt(i);
57. Map<String, Object> map = new HashMap<String, Object>();
58. for (String str : fields) {
59. map.put(str, object.get(str));
60. }
61. list.add(map);
62. }
63. } catch (JSONException e) {
64. Log.e("error", e.getMessage());
65. }
66. return list;
67. }
68. }

Tips：我们都知道C#中给方法加注释，可以按3次“/”，借助于VS就可以自动生成。而在Eclipse当中，可以在方法上面输入“/**”然后按下回车就可以自动生成。

1. public class TestWS extends Activity {
2. @Override
3. protected void onCreate(Bundle savedInstanceState) {
4. super.onCreate(savedInstanceState);
5. RelativeLayout l = new RelativeLayout(this);
6. Button button = new Button(l.getContext());
7. button.setText("点击本机webservice");
8. l.addView(button);
9. setContentView(l);
10. button.setOnClickListener(new View.OnClickListener() {
11. @Override
12. public void onClick(View v) {
13. final String nameSpace = "http://tempuri.org/";
14. final String methodName = "DataTableTest";
15. final String wsdl = "http://10.77.137.119:8888/webserviceTest/Service1.asmx?WSDL";
16. //调用WebService返回SoapObject对象
17. SoapObject soapObject = Util.callWS(nameSpace, methodName,
18. wsdl, null);
19. if (soapObject != null) {
20. //获得soapObject对象的DataTableTestResult属性的值
21. String result = soapObject.getProperty(
22. "DataTableTestResult").toString();
23. Toast.makeText(TestWS.this, result, Toast.LENGTH_SHORT)
24. .show();
25. try {
26. //将JSON字符串转换为List的结构
27. List<Map<String, Object>> list = Util.convertJSON2List(
28. result, "Result_List", new String[] { "id",
29. "name", "email" });
30. //通过Intent将List传入到新的Activity
31. Intent newIntent = new Intent(TestWS.this,
32. GridViewTest.class);
33. Bundle bundle = new Bundle();
34. //List一定是一个Serializable类型
35. bundle.putSerializable("key", (Serializable) list);
36. newIntent.putExtras(bundle);
37. //启动新的Activity
38. startActivity(newIntent);
39. } catch (Exception e) {
40. e.printStackTrace();
41. }
42. } else {
43. System.out.println("This is null...");
44. }
45. }
46. });
47. }
48. }

这里面有两点需要注意：

1、这个Activity并没有加载layout布局文件，而是通过代码创建了一个Button，这也是一种创建视图的方法。

2、通过Intent对象，我们将List<Map<String,Object>>传入到了新的Activity当中，这种Intent之间的传值方式需要注意。

1. public class GridViewTest extends Activity {
2. GridView grid;
3. @Override
4. protected void onCreate(Bundle savedInstanceState) {
5. super.onCreate(savedInstanceState);
6. setContentView(R.layout.activity_gridview);
7. Intent intent = this.getIntent();
8. Bundle bundle = intent.getExtras();
9. //获得传进来的List<Map<String,Object>>对象
10. @SuppressWarnings("unchecked")
11. List<Map<String, Object>> list = (List<Map<String, Object>>) bundle
12. .getSerializable("key");
13. //通过findViewById方法找到GridView对象
14. grid = (GridView) findViewById(R.id.grid01);
15. //SimpleAdapter适配器填充
16. //1.context    当前上下文，用this表示，或者GridViewTest.this
17. //2.data       A List of Maps.要求是List<Map<String,Object>>结构的列表，即数据源
18. //3.resource   布局文件
19. //4.from       从哪里来，即提取数据源List中的哪些key
20. //5.to         到哪里去，即填充布局文件中的控件
21. SimpleAdapter adapter = new SimpleAdapter(this, list,
22. R.layout.list_item, new String[] { "id", "name", "email" },
23. new int[] { R.id.id, R.id.name, R.id.email });
24. //将GridView和适配器绑定
25. grid.setAdapter(adapter);
26. }
27. }

先获得传过来的List对象，然后通过SimpleAdapter绑定到GridView。

activity_gridview.xml 布局文件：

1. <?xml version="1.0" encoding="utf-8"?>
2. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
3. android:layout_width="match_parent"
4. android:layout_height="match_parent"
5. android:orientation="vertical" >
6. <GridView
7. android:id="@+id/grid01"
8. android:layout_width="fill_parent"
9. android:layout_height="wrap_content"
10. android:horizontalSpacing="1pt"
11. android:verticalSpacing="1pt"
12. android:numColumns="3"
13. android:gravity="center"/>
14. </LinearLayout>

list_item.xml 布局文件：

1. <?xml version="1.0" encoding="utf-8"?>
2. <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
3. android:layout_width="match_parent"
4. android:layout_height="wrap_content"
5. android:gravity="center_vertical"
6. android:orientation="vertical" >
7. <TextView
8. android:id="@+id/id"
9. android:layout_width="wrap_content"
10. android:layout_height="wrap_content" />
11. <TextView
12. android:id="@+id/name"
13. android:layout_width="wrap_content"
14. android:layout_height="wrap_content" />
15. <TextView
16. android:id="@+id/email"
17. android:layout_width="wrap_content"
18. android:layout_height="wrap_content" />
19. </LinearLayout>

AndroidManifest.xml完整配置：

1. <?xml version="1.0" encoding="utf-8"?>
2. <manifest xmlns:android="http://schemas.android.com/apk/res/android"
3. package="com.example.webservicedemo"
4. android:versionCode="1"
5. android:versionName="1.0" >
6. <uses-sdk
7. android:minSdkVersion="8"
8. android:targetSdkVersion="14" />
9. <uses-permission android:name="android.permission.INTERNET" />
10. <application
11. android:allowBackup="true"
12. android:icon="@drawable/ic_launcher"
13. android:label="@string/app_name"
14. android:theme="@style/AppTheme" >
15. <activity
16. android:name=".TestWS"
17. android:label="@string/app_name" >
18. <intent-filter>
19. <action android:name="android.intent.action.MAIN" />
20. <category android:name="android.intent.category.LAUNCHER" />
21. </intent-filter>
22. </activity>
23. <activity
24. android:name=".GridViewTest"
25. android:label="@string/app_name" >
26. </activity>
27. </application>
28. </manifest>

最终在模拟器上面显示出了从数据库服务器获得的数据：