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>
最终在模拟器上面显示出了从数据库服务器获得的数据：