原文：一种针对 Android 和 Java 的类型安全的 HTTP 代理
简介
Retrofit 可以将 HTTP API 转换为 Java 接口。
public interface GithubService{
@GET("/user/{user}/repos")
Call<List<Repo> listRepos(@Path("user") String user);
}
Retrofit 类生成 GitHubService 接口的实现。
Retrofit retrofit = new Retrofit.Builder()
.baseUrl("https://api.github.com")
.build();
GitHubService service = retrofit.create(GitHubService.class);
每个 GitHubService 的 Call 方法能进行一个到远程服务器的同步或异步的 HTTP 请求。
Call<List<Repo>> repos = service.listRepos("octocat");
使用注解来描述 HTTP 请求：
- URL 参数替代和查询参数的支持
- 将对象转换为请求体（例如：JSON，协议缓冲等）
- 多部分的请求体和文件上传
注释：这个网页仍然为了新的2.0的API在扩展。
API 声明
接口和其参数上的注解表明了这个请求将被如何处理。
请求方法
每个方法都必须有一个 HTTP 注解用来定义请求方法和相关的 URL。共有五种内置的注解：GET、POST、PUT、DELETE，和 HEAD。相关的 URL 资源定义在注解内。
@GET("/user/list")
你也可以在 URL 中定义查询参数。
@GET("/user/list?sort=desc")
URL 处理
请求 URL 可以通过使用方法中的替换区块和参数来动态更改。替换区块是指被 ｛ 和 ｝ 包围的字母数字串。合适的参数必须以相同的字符串的@Path 注解来标识。
@GET("/group/{id}/users")
List<User> groupList(@Path("id") int groupId);
也可以添加查询参数。
@GET("/group/{id}/users")
List<User> groupList(@Path("id") int groupId, @Query("sort") String sort);
对于复杂的查询条件可以使用 Map。
@GET("/group/{id}/users")
List<User> groupList(@Path("id") int groupId, @QueryMap Map<String, String> options);
请求体
通过 @Body 注解来声明一个对象可以用作 HTTP 请求体。
@POST("/users/new")
Call<User> createUser(@Body User user);
该对象会被定义在 Retrofit 实例中的转换器转换。如果没有已添加的转换器，那么只有 RequestBody 可以被用于请求体。
实在翻译不下来了，以后再尝试吧。
初次翻译，好难。
