Retrofit2 的基本使用 （一）

概述

Android开发中我们常用的基本网络请求方式有OkHttp,HttpClient, HttpUrlConnection这三个都是基于http请求封装的一个网络请求客户端。
Retrofit2是由Square公司开发的一个网络请求调度框架，对OkHttp进行了外层封装，方便我们使用。

本文主要介绍内容：

- 基本的GET/POST请求的使用
- Gson与Converter

一 . 基本的GET/POST请求的使用

使用到的公共API http://www.tngou.net/api/cook/list http://www.tngou.net/api/top/list

1.要想使用Retrofit2框架，首先需要导包

Retrofit2的包：
compile 'com.squareup.retrofit2:retrofit:2.3.0'
GSON解析的包
compile 'com.squareup.retrofit2:converter-gson:2.3.0'

2.定义请求接口

public interface IRetrofitService {
/**
* 通过注解来设置请求方式（GET请求），括号里面参数是请求的子目录（{category} ,相当于一个占位符）
* @Path("category")String category 该参数用来填补{category}
* @Query("id") int id ，@Query("page") int page，@Query("rows") int rows ：GET请求参数，会自动按照Http协议格式添加到url上
*/
@GET("/api/{category}/list")
Call<Tngou> getList(@Path("category")String category,@Query("id") int id, @Query("page") int page, @Query("rows") int rows);

/**
* POST请求
* @FormUrlEncoded 该注解表示表单请求
* @Field("id") int id  表单数据（自动安装格式添加到请求头上）
*/
@POST("/api/{category}/list")
@FormUrlEncoded
Call<Tngou> postList(@Path("category") String category, @Field("id") int id,@Field("page") int page,@Field("rows") int rows);

3. 使用代码

//1.创建Retrofit实例
Retrofit retrofit = new Retrofit.Builder()
.baseUrl("http://www.tngou.net")// 设置baseUrl
// 设置数据转换器（使用Gosn解析JSON数据）
.addConverterFactory(GsonConverterFactory.create())
.build();

// 2.返回自定义接口的代理对象（内部使用了java动态代理）
IRetrofitService retrofitService = retrofit.create(IRetrofitService.class);

//3.使用代理对象调用自己定义的请求方法，得到一个执行请求的对象
Call<Tngou> call = retrofitService.getList("cook",0, 1, 10);
Call<Tngou> callPost = retrofitService.postList("cook",0, 1, 10);

//4.使用该请求对象发起异步或同步请求
call.enqueue(new Callback<Tngou>() {// 发起异步请求
// 请求成功，返回请求结果（在主线程，可以直接操作控件）
@Override
public void onResponse(Call<Tngou> call, Response<Tngou> response) {
adapter.addDatas(response.body().getTngou());
}
// 请求失败
@Override
public void onFailure(Call<Tngou> call, Throwable t) {
t.printStackTrace();// 输出失败信息
}
});
// callPost.enqueue(this);

4.什么是Converter

默认情况Retrofit只是将请求回来的数据转换为ResponseBody，而Converter就是Retrofit为我们提供用于将ResponseBody转换为我们想要的类型的一个转换器。结合GSON使用，提供了一个GsonConverter，我们只需要提供一个GSON解析需要使用的对象，就可以自动为我们解析GSON数据了。