Retrofit官方使用说明翻译——不准确之处请指出

Introduction（简介）

Retrofit 将你的HTTP API转换成Java接口。

public interface GitHubService {
  @GET("users/{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都可以向远程Web服务器发出同步或者异步Http请求。

Call<List<Repo>> repos = service.listRepos("octocat");

使用注解来描述HTTP请求：

• URL参数替换和查询参数支持
• 请求主体的对象转换（例如：json，协议缓冲区）
• 多部分请求主体和文件上传

API Declaration（API声明）

REQUEST METHOD（请求方法）

每一个方法必须有一个HTTP注解，这个注解提供请求方法和相对URL。Retrofit有5个内置注解：GET，POST，PUT，DELETE和HEAD。相对URL在注解中指定。

@GET("users/list")

同时也可以在URL中指定查询参数。

@GET("users/list?sort=desc")

URL MANIPULATION（URL处理）

请求URL可以使用方法上的代替块和参数动态的更新。代替块是用{和}包起来的字符串ÿ