Retrofit restful client（一）介绍

什么是REST？

REST (REpresentation State Transfer) 描述了一个架构样式的网络系统，比如 web 应用程序。它首次出现在 2000 年 Roy Fielding 的博士论文中，他是 HTTP 规范的主要编写者之一。REST 指的是一组架构约束条件和原则。满足这些约束条件和原则的应用程序或设计就是 RESTful。

Web 应用程序最重要的 REST 原则是，客户端和服务器之间的交互在请求之间是无状态的。从客户端到服务器的每个请求都必须包含理解请求所必需的信息。如果服务器在请求之间的任何时间点重启，客户端不会得到通知。此外，无状态请求可以由任何可用服务器回答，这十分适合云计算之类的环境。客户端可以缓存数据以改进性能。

在服务器端，应用程序状态和功能可以分为各种资源。资源是一个有趣的概念实体，它向客户端公开。资源的例子有：应用程序对象、数据库记录、算法等等。每个资源都使用 URI (Universal Resource Identifier) 得到一个惟一的地址。所有资源都共享统一的界面，以便在客户端和服务器之间传输状态。使用的是标准的 HTTP 方法，比如 GET、PUT、POST 和 DELETE。Hypermedia 是应用程序状态的引擎，资源表示通过超链接互联。

传统的Rest封装

传统的Rest封装是通过Httpclient实现Rest封装。通过HttpClient的API实现Rest的 GET、PUT、POST 和 DELETE操作。传统的HttpClient操作Rest的例子如下（Activiti Rest代码）：

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
 
import org.apache.http.HttpResponse;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.StringEntity;
import org.apache.http.impl.client.DefaultHttpClient;
 
public class TestLogin {
 
  public static void main(String[] args) throws Exception, IOException {
    DefaultHttpClient httpClient = new DefaultHttpClient();
    HttpPost postRequest = new HttpPost("http://localhost:8080/activiti-rest/service/login");
 
    StringEntity input = new StringEntity("{\"userId\":\"kermit\",\"password\":\"kermit\"}");
    input.setContentType("application/json");
    postRequest.setEntity(input);
 
    HttpResponse response = httpClient.execute(postRequest);
 
    BufferedReader br = new BufferedReader(new InputStreamReader((response.getEntity().getContent())));
 
    String output;
    System.out.println("Output from Server .... \n");
    while ((output = br.readLine()) != null) {
      System.out.println(output);
    }
 
    httpClient.getConnectionManager().shutdown();
  }
}

传统的Rest封装是通过存在一下一些缺点：

1）需要对输入输出参数进行组装，会存在大量的对象转换的代码；

2）需要处理一些连接性的源代码，对http connect进行close；

3）提高代码复杂度

Retrofit封装（http://square.github.io/retrofit/）

retrofit是对Restful的简洁封装，可以提高Restful的使用效率。提现模式为：

public interface GitHubService {
     @GET("/users/{user}/repos")
     List<Repo> listRepos(@Path("user") String user);
    }

生成源代码

RestAdapter restAdapter = new RestAdapter.Builder()
    .setServer("https://api.github.com")
    .build();

    GitHubService service = restAdapter.create(GitHubService.class);

Retrofit完整例子 http://blog.csdn.net/arjick/article/details/18263201