Retrofit的基本使用

基本概念

Retrofit是对http网络请求框架的封装，一般由okhttp来负责网络请求，retrofit对请求接口进行封装。retrofit通过接口和注解来描述我们的网络请求，然后通过client去调用okhttp框架，输入baseurl，通过addConverterFactory来实现对返回的json数据进行处理，转换成我们需要的数据类型，如果搭配rxjava的话还会加上addCallAdapterFactory来转换成其他数据类型。

接口部分

@GET("news")
    Call<NewsList> getNews();

这里get里面的news是请求地址的一部分，是在你的baseurl的基础上添加的后续地址，而call里面就是自己定义的数据类
数据类要根据返回的JSON数据进行处理，比如这里是

JSON数据

可以看到是一个jsonarray，里面是多个jsonobject，如果是以前的话是要自己写代码去解析，现在都交给retrofit来处理。

数据类

public class NewsList {
    @SerializedName("data")
    private List<News> news ;
    public List<News> getNews() {
        return news;
    }
    public void setNews(List<News> news) {
        this.news = news;
    }
}

这里需要注意的是@SerializedName注解，这个意思就是可以属性重命名，把json里面的数据名字重新命名成我们自己定义的名字，然后News类就是我获取到的新闻的部分数据，如下

    @SerializedName("id")
    private int id;
    @SerializedName("title")
    private String title;
    @SerializedName("summary")
    private String summary;

retrofit实例

retrofit的创建是非常简单的，只需要告诉baseurl然后添加convertfactory就行，然后代码如下

                Retrofit retrofit = new Retrofit.Builder()
                        .addConverterFactory(GsonConverterFactory.create())
                        .baseUrl("https://api.readhub.cn")
                        .build();
                MyService request = retrofit.create(MyService.class);
                Call<NewsList> call = request.getNews2();
                call.enqueue(new Callback<NewsList>() {
                    @Override
                    public void onResponse(Call<NewsList> call, Response<NewsList> response) {
                        textView.setText("");
                        for (News news:response.body().getNews()){
                            Log.e(TAG, "onResponse: "+news.getTitle() );
                        }
                    }

                    @Override
                    public void onFailure(Call<NewsList> call, Throwable t) {
                        Log.e(TAG, "onFailure: "+t);
                    }
                });

这里就是获取到请求头之后，数据都存放在response.body().getNews()中，通过遍历取出来后在日志打印每个新闻的title，结果如下图

打印日志

这样子就成功取出来数据了。

取出原始的json数据

如果想要最原始的json数据，不要处理后的结果，接口就要改成

    @GET("news")
    Call<ResponseBody> getNews();

之后的和前面没什么区别，如果要查看的话返回的数据就是在response.body().bytes()中，可以直接打印查看。

总结

基本使用过程：先建立接口，然后通过builder模式建立一个retrofit，添加baseurl和convertFactory等基本信息，通过retrofit.create方法来获取网络接口对象，调用这个接口的方法，得到一个网络工作对象，然后调用enqueue方法来发起请求并得到回调后的结果并进行处理。