参考文献：
Retrofit2.0使用详解
Retrofit 2.0 注解篇
1.Retrofit2的简单使用：
1.不用说关联类库：
compile 'com.squareup.retrofit2:retrofit:2.3.0'
这里我引入的是最新的你也可以看看最新的是什么版本
2.定义接口
这个接口主要写请求是用到的一些数据
public interface RetrofitApi {
@GET("repos/{owner}/{repo}/contributors")
Call<String> contributorsBySimpleGetCall(@Part("owner") String owner, @Path("repo") String repo);
}
这里面是采用注释的形式去关联网络请求的，其实关于Retrofit2的网络请求都是基于注释去进行了，具体的原理我也不太清楚，等到自己技术层次提升的时候在去进行研究把。。。
3.创建Retrofit对象
Retrofit retrofit = new Retrofit.Builder()
.baseUrl("https://api.github.com/")
.build();
这里注意Url地址后面的"/"号这个一定要有！如果你想要在那个接口中加是不行的！
4.构建请求接口的实体
RetrofitApi retrofitApi = retrofit.create(RetrofitApi.class);
这个实体是根据上面那个接口生成的；
5.创建请求
Call<ResponseBody> responseBodyCall = retrofitApi.contributorsBySimpleGetCall("square", "retrofit");
这里主要是完善请求的参数，或者请求的具体内容
6.创建回调
responseBodyCall.enqueue(new Callback<ResponseBody>() {
@Override
public void onResponse(Call<ResponseBody> call, Response<ResponseBody> response) {
Log.e(TAG, "onResponse: 成功" + response.body());
}
@Override
public void onFailure(Call<ResponseBody> call, Throwable t) {
Log.e(TAG, "onFailure: 失败" + t.toString());
}
});
7.清除请求
responseBodyCall.cancel();
以上就完成了基本的请求，回调是回调到主线程的，这点的话比OkHttp3好点！
下面来说说常用的注解：
1.请求方法注解
| 序号 | 名称 |
|---|---|
| @GET | get请求 |
| @POST | post请求 |
常用的请求就这两个，其他的我就没写，这些注解都是用在方法体前面的，用于标明请求的方法
@GET("repos/{owner}/{repo}/contributors")
Call<String> contributorsBySimpleGetCall(@Part("owner") String owner, @Path("repo") String repo);
2.@path注解
这个的作用和占位符的作用类似，
@GET("repos/{owner}/{repo}/contributors")
Call<String> contributorsBySimpleGetCall(@Part("owner") String owner, @Path("repo") String repo);
还是那这个方法举例，上面用或括号括起来的就相当于占位，具体的定义值实在下面进行的通过@Path替换花括号内的名称。
3.@Query和@QueryMap（用于GET请求的注解）
这两个是将请求参数加载末尾的方法；
@GET("users/stven0king/repos")
Call<List<Repo>> listRepos(@Query("time") long time);
@GET("users/stven0king/repos")
Call<List<Repo>> listRepos(@QueryMap Map<String, String> params);
区别在于@Query后面跟的是一个参数而@Query后面跟的是一个数组，也就是多个参数
4.@Field和@FieldMap（用于POST请求的注解）
@FormUrlEncoded
@POST("users/stven0king/repos")
Call<List<Repo>> listRepos(@Field("time") long time);
@FormUrlEncoded
@POST("users/stven0king/repos")
Call<List<Repo>> listRepos(@FieldMap Map<String, String> params);
这里要注意上面的@FormUrlEncoded如果没有这个的话会抛异常的
5.@Url（用于动态的Url地址请求）
@GET
Call<List<Repo>> listRepos(@Url String user);
其他操作符的话以后用到的时候再去研究把。。。
