Android中调用Rest web服务

[转载请注明] 来源:www.ideasandroid.com 原文: http://www.ideasandroid.com/archives/429
首先从维基百科上拷贝一点Rest的基本概念给大家看看，然后我们再开始详解在 android中如何调用Rest服务。

表象化状态转变（英文：Representational State Transfer，简称REST）是Roy Fielding博士在2000年他的博士论文中提出来的一种软件架构风格。

目前在三种主流的Web服务实现方案中，因为REST模式的Web服务与复杂的SOAP和XML-RPC对比来讲明显的更加简洁，越来越多的web服务开始采用REST风格设计和实现。例如，Amazon.com提供接近REST风格的Web服务进行图书查找；雅虎提供的Web服务也是REST风格的。

REST 从资源的角度来观察整个网络，分布在各处的资源由URI确定，而客户端的应用通过URI来获取资源的表形。获得这些表形致使这些应用程序转变了其状态。随着不断获取资源的表形，客户端应用不断地在转变着其状态，所谓表形化的状态转变（Representational State Transfer）。

这一观点不是凭空臆造的，而是通过观察当前Web互联网的运作方式而抽象出来的。Roy Fielding 认为，

“设计良好的网络应用表现为一系列的网页，这些网页可以看作的虚拟的状态机，用户选择这些链接导致下一网页传输到用户端展现给使用的人，而这正代表了状态的转变。”

需要注意的是，REST是一种设计风格而不是一个标准。REST通常基于使用HTTP，URI，和XML以及HTML这些现有的广泛流行的协议和标准。

资源是由URI来指定。
对资源的操作包括获取、创建、修改和删除资源，这些操作正好对应HTTP协议提供的GET、POST、PUT和DELETE方法。
通过操作资源的表形来操作资源。
资源的表现形式则是XML或者HTML，取决于读者是机器还是人，是消费web服务的客户软件还是web浏览器。当然也可以是任何其他的格式。
REST的要求

客户端和服务器结构
连接协议具有无状态性
能够利用Cache机制增进性能
层次化的系统
Code On Demand – Javascript
实现举例

例如，一个简单的网络商店应用，

列举所有商品，

GET http://www.store.com/products

具体某一件商品，

GET http://www.store.com/product/12345

下单购买，

POST http://www.store.com/order，

<purchase-order>

  <item> … </item>

</purchase-order>

下面我们就以如上网络商店的Rest服务为例，看看我们通过Android客户端是如何进行调用的（这里只介绍如何发送请求，并获得服务器响应）。

Android类库中已经为我们提供了一切我们需要的东西。
Rest的原理就是向一个资源的URI发送GET、POST、PUT和DELETE进行获取、创建、保存、删除操作。

第一步我们看看如何请求获得所有商品信息：
//创建一个http客户端
HttpClient client=new DefaultHttpClient();
//创建一个GET请求
HttpGet httpGet=new HttpGet("http://www.store.com/products");
//向服务器发送请求并获取服务器返回的结果
HttpResponse response=client.execute(httpGet);
//返回的结果可能放到InputStream，http Header中等。
InputStream inputStream=response.getEntity().getContent();
Header[] headers=response.getAllHeaders();


通过解析服务器返回的流，我们可以将它转为字符串，获取相应的数据。

第二步可以向服务器增加商品，同样的道理，我们创建一个POST请求，带上相关的商品信息即可。
//创建一个http客户端
HttpClient client=new DefaultHttpClient();
//创建一个POST请求
HttpPost httpPost=new HttpPost("http://www.store.com/product");
//组装数据放到HttpEntity中发送到服务器
final List dataList = new ArrayList();
dataList.add(new BasicNameValuePair("productName", "cat"));
dataList.add(new BasicNameValuePair("price", "14.87"));
HttpEntity entity = new UrlEncodedFormEntity(dataList, "UTF-8");
httpPost.setEntity(entity);
//向服务器发送POST请求并获取服务器返回的结果，可能是增加成功返回商品ID，或者失败等信息
HttpResponse response=client.execute(httpPost);


第三步是如果修改商品信息，我们只需要创建一个PUT请求，带上要修改的参数即可。本例假设第三步中增加的商品返回ID为1234，下面将为商品的价格修改为11.99.

//创建一个http客户端
HttpClient client=new DefaultHttpClient();
//创建一个PUT请求
HttpPut httpPut=new HttpPut("http://www.store.com/product/1234");
//组装数据放到HttpEntity中发送到服务器
final List dataList = new ArrayList();
dataList.add(new BasicNameValuePair("price", "11.99"));
HttpEntity entity = new UrlEncodedFormEntity(dataList, "UTF-8");
httpPut.setEntity(entity);
//向服务器发送PUT请求并获取服务器返回的结果，可能是修改成功，或者失败等信息
HttpResponse response=client.execute(httpPut);

第四步我们把上面增加的商品删除，只需要向服务器发送一个DELETE请求即可。

//创建一个http客户端
HttpClient client=new DefaultHttpClient();
//创建一个DELETE请求
HttpDelete httpDelete=new HttpDelete("http://www.store.com/product/1234");
//向服务器发送DELETE请求并获取服务器返回的结果，可能是删除成功，或者失败等信息
HttpResponse response=client.execute(httpDelete);

好了，就这么简单，这样就实现了从android客户端调用Rest服务对资源进行增、删、改、查操作。