Retrofit学习笔记

*翻译自官方文档（https://square.github.io/retrofit/）

Quickstart

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请求。

API声明

请求方法

支持HTTP、GET、POST等所有HTTP方法。

@GET("users/list")
// 加上请求参数
@GET("users/list?sort=desc") 

URL填充

支持动态URL，可以通过{}来包裹需要填充的字符串（数字和字母）。在参数中用@Path来指定。

@GET("group/{id}/users")
Call<List<User>> groupList(@Path("id") int groupId);

也支持请求参数（用@Query指定）

@GET("group/{id}/users")
Call<List<User>> groupList(@Path("id") int group