基本概念
Retrofit是对http网络请求框架的封装,一般由okhttp来负责网络请求,retrofit对请求接口进行封装。retrofit通过接口和注解来描述我们的网络请求,然后通过client去调用okhttp框架,输入baseurl,通过addConverterFactory来实现对返回的json数据进行处理,转换成我们需要的数据类型,如果搭配rxjava的话还会加上addCallAdapterFactory来转换成其他数据类型。
接口部分
@GET("news")
Call<NewsList> getNews();
这里get里面的news是请求地址的一部分,是在你的baseurl的基础上添加的后续地址,而call里面就是自己定义的数据类
数据类要根据返回的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方法来发起请求并得到回调后的结果并进行处理。