需要注意的是,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
具体某一件商品
1. GET http://www.store.com/product/12345
2.
下单购买
1. POST http://www.store.com/order,
2.
3. <purchase-order>
4. <item> … </item>
5. </purchase-order>
6.
下面我们就以如上网络商店的Rest服务为例,看看我们通过Android客户端是如何进行调用的(这里只介绍如何发送请求,并获得服务器响应)。
Android类库中已经为我们提供了一切我们需要的东西。
Rest的原理就是向一个资源的URI发送GET、POST、PUT和DELETE进行获取、创建、保存、删除操作。
第一步我们看看如何请求获得所有商品信息:
1. //创建一个http客户端
2. HttpClient client=new DefaultHttpClient();
3. //创建一个GET请求
4. HttpGet httpGet=new HttpGet("http://www.store.com/products");
5. //向服务器发送请求并获取服务器返回的结果
6. HttpResponse response=client.execute(httpGet);
7. //返回的结果可能放到InputStream,http Header中等。
8. InputStream inputStream=response.getEntity().getContent();
9. Header[] headers=response.getAllHeaders();
10.
通过解析服务器返回的流,我们可以将它转为字符串,获取相应的数据。
第二步可以向服务器增加商品,同样的道理,我们创建一个POST请求,带上相关的商品信息即可。
1. //创建一个http客户端
2. HttpClient client=new DefaultHttpClient();
3. //创建一个POST请求
4. HttpPost httpPost=new HttpPost("http://www.store.com/product");
5. //组装数据放到HttpEntity中发送到服务器
6. final List dataList = new ArrayList();
7. dataList.add(new BasicNameValuePair("productName", "cat"));
8. dataList.add(new BasicNameValuePair("price", "14.87"));
9. HttpEntity entity = new UrlEncodedFormEntity(dataList, "UTF-8");
10. httpPost.setEntity(entity);
11. //向服务器发送POST请求并获取服务器返回的结果,可能是增加成功返回商品ID,或者失败等信息
12. HttpResponse response=client.execute(httpPost);
13.
第三步是如果修改商品信息,我们只需要创建一个PUT请求,带上要修改的参数即可。本例假设第三步中增加的商品返回ID为1234,下面将为商品的价格修改为11.99.
1. //创建一个http客户端
2. HttpClient client=new DefaultHttpClient();
3. //创建一个PUT请求
4. HttpPut httpPut=new HttpPut("http://www.store.com/product/1234");
5. //组装数据放到HttpEntity中发送到服务器
6. final List dataList = new ArrayList();
7. dataList.add(new BasicNameValuePair("price", "11.99"));
8. HttpEntity entity = new UrlEncodedFormEntity(dataList, "UTF-8");
9. httpPut.setEntity(entity);
10. //向服务器发送PUT请求并获取服务器返回的结果,可能是修改成功,或者失败等信息
11. HttpResponse response=client.execute(httpPut);
12.
第四步我们把上面增加的商品删除,只需要向服务器发送一个DELETE请求即可。
1. //创建一个http客户端
2. HttpClient client=new DefaultHttpClient();
3. //创建一个DELETE请求
4. HttpDelete httpDelete=new HttpDelete("http://www.store.com/product/1234");
5. //向服务器发送DELETE请求并获取服务器返回的结果,可能是删除成功,或者失败等信息
6. HttpResponse response=client.execute(httpDelete);
7.
好了,就这么简单,这样就实现了从android客户端调用Rest服务对资源进行增、删、改、查操作。