Android服务开发——WebService

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

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

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

        [WebMethod]
        public string DataTableTest()
        {
            DataTable dt = new DataTable("userTable");
            dt.Columns.Add("id",typeof(int));
            dt.Columns.Add("name", typeof(string));
            dt.Columns.Add("email", typeof(string));

            dt.Rows.Add(1, "gary.gu", "guwei4037@sina.com");
            dt.Rows.Add(2, "jinyingying", "345822155@qq.com");
            dt.Rows.Add(3, "jinyingying", "345822155@qq.com");
            dt.Rows.Add(4, "jinyingying", "345822155@qq.com");

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

        public static string CreateJsonParameters(DataTable dt)
        {
            StringBuilder JsonString = new StringBuilder();
            if (dt != null && dt.Rows.Count > 0)
            {
                JsonString.Append("{ ");
                JsonString.Append("\"Result_List\":[ ");
                for (int i = 0; i < dt.Rows.Count; i++)
                {
                    JsonString.Append("{ ");
                    for (int j = 0; j < dt.Columns.Count; j++)
                    {
                        if (j < dt.Columns.Count - 1)
                        {
                            JsonString.Append("\"" + dt.Columns[j].ColumnName.ToString() + "\":" + "\"" + dt.Rows[i][j].ToString() + "\",");
                        }
                        else if (j == dt.Columns.Count - 1)
                        {
                            JsonString.Append("\"" + dt.Columns[j].ColumnName.ToString() + "\":" + "\"" + dt.Rows[i][j].ToString() + "\"");
                        }
                    }
                    if (i == dt.Rows.Count - 1)
                    {
                        JsonString.Append("} ");
                    }
                    else
                    {
                        JsonString.Append("}, ");
                    }
                }
                JsonString.Append("]}");
                return JsonString.ToString();
            }
            else
            {
                return null;
            }
        }
这个方法是我从网上随便找到的一个方法,比较土了,就是直接拼接JSON字符串(无所谓,这不是我们要关心的重点)。

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

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

好,接下来我们要做两件事:

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

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

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

/**
 * @author gary.gu 助手类
 */
public final class Util {
	/**
	 * @param nameSpace  WS的命名空间
	 * @param methodName WS的方法名
	 * @param wsdl       WS的wsdl的完整路径名
	 * @param params     WS的方法所需要的参数
	 * @return           SoapObject对象
	 */
	public static SoapObject callWS(String nameSpace, String methodName,
			String wsdl, Map<String, Object> params) {
		final String SOAP_ACTION = nameSpace + methodName;
		SoapObject soapObject = new SoapObject(nameSpace, methodName);

		if ((params != null) && (!params.isEmpty())) {
			Iterator<Entry<String, Object>> it = params.entrySet().iterator();
			while (it.hasNext()) {
				Map.Entry<String, Object> e = (Map.Entry<String, Object>) it
						.next();
				soapObject.addProperty(e.getKey(), e.getValue());
			}
		}

		SoapSerializationEnvelope envelope = new SoapSerializationEnvelope(
				SoapEnvelope.VER11);
		envelope.bodyOut = soapObject;
		
		// 兼容.NET开发的Web Service
		envelope.dotNet = true;

		HttpTransportSE ht = new HttpTransportSE(wsdl);
		try {
			ht.call(SOAP_ACTION, envelope);
			if (envelope.getResponse() != null) {
				SoapObject result = (SoapObject) envelope.bodyIn;
				return result;
			} else {
				return null;
			}
		} catch (Exception e) {
			Log.e("error", e.getMessage());
		}
		return null;
	}

	/**
	 * 
	 * @param result JSON字符串
	 * @param name   JSON数组名称
	 * @param fields JSON字符串所包含的字段
	 * @return       返回List<Map<String,Object>>类型的列表,Map<String,Object>对应于 "id":"1"的结构
	 */
	public static List<Map<String, Object>> convertJSON2List(String result,
			String name, String[] fields) {
		List<Map<String, Object>> list = new ArrayList<Map<String, Object>>();
		try {
			JSONArray array = new JSONObject(result).getJSONArray(name);

			for (int i = 0; i < array.length(); i++) {
				JSONObject object = (JSONObject) array.opt(i);
				Map<String, Object> map = new HashMap<String, Object>();
				for (String str : fields) {
					map.put(str, object.get(str));
				}
				list.add(map);
			}
		} catch (JSONException e) {
			Log.e("error", e.getMessage());
		}
		return list;
	}
}
Tips:我们都知道C#中给方法加注释,可以按3次“/”,借助于VS就可以自动生成。而在Eclipse当中,可以在方法上面输入“/**”然后按下回车就可以自动生成。

public class TestWS extends Activity {

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);

		RelativeLayout l = new RelativeLayout(this);
		Button button = new Button(l.getContext());
		button.setText("点击本机webservice");
		l.addView(button);
		setContentView(l);

		button.setOnClickListener(new View.OnClickListener() {

			@Override
			public void onClick(View v) {

				final String nameSpace = "http://tempuri.org/";
				final String methodName = "DataTableTest";
				final String wsdl = "http://10.77.137.119:8888/webserviceTest/Service1.asmx?WSDL";

				//调用WebService返回SoapObject对象
				SoapObject soapObject = Util.callWS(nameSpace, methodName,
						wsdl, null);
				if (soapObject != null) {
					
					//获得soapObject对象的DataTableTestResult属性的值
					String result = soapObject.getProperty(
							"DataTableTestResult").toString();

					Toast.makeText(TestWS.this, result, Toast.LENGTH_SHORT)
							.show();

					try {
						//将JSON字符串转换为List的结构
						List<Map<String, Object>> list = Util.convertJSON2List(
								result, "Result_List", new String[] { "id",
										"name", "email" });

						//通过Intent将List传入到新的Activity
						Intent newIntent = new Intent(TestWS.this,
								GridViewTest.class);
						Bundle bundle = new Bundle();
						
						//List一定是一个Serializable类型
						bundle.putSerializable("key", (Serializable) list);
						newIntent.putExtras(bundle);
						
						//启动新的Activity
						startActivity(newIntent);

					} catch (Exception e) {
						e.printStackTrace();
					}
				} else {
					System.out.println("This is null...");
				}
			}
		});
	}

}

这里面有两点需要注意:

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

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

public class GridViewTest extends Activity {

	GridView grid;

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_gridview);

		Intent intent = this.getIntent();
		Bundle bundle = intent.getExtras();

		//获得传进来的List<Map<String,Object>>对象
		@SuppressWarnings("unchecked")
		List<Map<String, Object>> list = (List<Map<String, Object>>) bundle
				.getSerializable("key");

		//通过findViewById方法找到GridView对象
		grid = (GridView) findViewById(R.id.grid01);
		
		//SimpleAdapter适配器填充
		//1.context    当前上下文,用this表示,或者GridViewTest.this
		//2.data       A List of Maps.要求是List<Map<String,Object>>结构的列表,即数据源
		//3.resource   布局文件
		//4.from       从哪里来,即提取数据源List中的哪些key
		//5.to         到哪里去,即填充布局文件中的控件
		SimpleAdapter adapter = new SimpleAdapter(this, list,
				R.layout.list_item, new String[] { "id", "name", "email" },
				new int[] { R.id.id, R.id.name, R.id.email });
		
		//将GridView和适配器绑定
		grid.setAdapter(adapter);
	}

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

activity_gridview.xml 布局文件:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical" >
    
    <GridView 
        android:id="@+id/grid01"
        android:layout_width="fill_parent"
        android:layout_height="wrap_content"
        android:horizontalSpacing="1pt"
        android:verticalSpacing="1pt"
        android:numColumns="3"
        android:gravity="center"/>

</LinearLayout>
list_item.xml 布局文件:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:gravity="center_vertical"
    android:orientation="vertical" >

    <TextView
        android:id="@+id/id"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />

    <TextView
        android:id="@+id/name"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />

    <TextView
        android:id="@+id/email"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />

</LinearLayout>
AndroidManifest.xml完整配置:

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.webservicedemo"
    android:versionCode="1"
    android:versionName="1.0" >

    <uses-sdk
        android:minSdkVersion="8"
        android:targetSdkVersion="14" />

    <uses-permission android:name="android.permission.INTERNET" />

    <application
        android:allowBackup="true"
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name"
        android:theme="@style/AppTheme" >
        <activity
            android:name=".TestWS"
            android:label="@string/app_name" >
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
        <activity
            android:name=".GridViewTest"
            android:label="@string/app_name" >
        </activity>
    </application>

</manifest>

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




上一篇:高并发服务器开发与配置


下一篇:从编程小白到全栈开发:服务的调用