ps:本文仅适合不了解Retrofit&&RXJava的初学者
既然是傻瓜式入门,我们就讲得尽量最简洁最白化,不带任何官话。
嘴哥说得好,一篇没有gif的文章不是一篇好文章,那我们先来看一下本文主要实现的效果(通过网络请求获取豆瓣提供的电影title和imageuri,简单显示):
什么是Retrofit?
Retrofit是square公司的一个网络开源库,能帮助我们方便地处理网络请求。
在使用前,我们要先添加网络权限
<uses-permission android:name="android.permission.INTERNET"></uses-permission>
如果是使用AS的话,添加以下几句compile
compile 'com.squareup.retrofit2:retrofit:2.1.0'
compile 'com.squareup.retrofit2:converter-gson:2.1.0'
compile 'com.squareup.retrofit2:adapter-rxjava:2.1.0'
compile 'io.reactivex:rxjava:1.1.0'
compile 'io.reactivex:rxandroid:1.1.0'
怎么简单使用Retrofit?
根据Retrofit官网的介绍文档,我们在使用Retrofit前,只需要简单的三步即可。
这里以获取豆瓣电影信息为例:
- 1.创建一个http API接口
public interface DoubanAPI {
@GET("v2/movie/us_box")
Call<MovieInfo> getUSMovie();
}
注解@GET标识为get请求方式(还有POST, PUT, DELETE, and HEAD),@GET中所填写的"v2/movie/us_box"是完整httpurl中的一部分,<MovieInfo>即为我们从网络端请求返回解析后的数据bean,可以通过很多插件工具自动生成。
- 2.通过构造模式build我们需要的retrofit对象,然后获取第一步中API接口的实现实例
retrofit=new Retrofit.Builder().baseUrl("https://api.douban.com/")
.addConverterFactory(GsonConverterFactory.create())
//.addCallAdapterFactory(RxJavaCallAdapterFactory.create())
.client(new OkHttpClient.Builder().connectTimeout(5, TimeUnit.SECONDS).build()).build();
doubanService=retrofit.create(DoubanAPI.class);
这里的baseUrl就可以与第一步中的"v2/movie/us_box"组成一个完整的url路径"https://api.douban.com/v2/movie/us_box" ,建议baseUrl以"/"结尾,而@GET()中的不以"/"开头或结尾。
addConverterFactory(GsonConverterFactory.create())表示将服务端返回的json数据通过GsonConverterFactory完成解析转化。
addCallAdapterFactory(RxJavaCallAdapterFactory.create())就是RXJava与Retrofit结合的部分了,此处先不用加这句话。
- 3.利用http接口的方法生成Call对象,然后就可以愉快地进行同步或者异步请求了,同时retrofit也给我们提供了一个十分简单的取消请求事务的方法,直接call.cancel()即可
Call<Movieinfo> result=doubanService.getUSMovie();
result.enqueue(new Callback() {
@Override
public void onResponse(Call call, Response response) {
Toast.makeText(MainActivity.this,"Call Back Success",Toast.LENGTH_SHORT).show();
Log.e("***", "normalGet:" + response.body().toString() + "");
Movieinfo bean = (Movieinfo) response.body();
Log.e("***","beanAnal:"+bean.date);
Log.e("***","beanAnal:"+bean.title);
}
@Override
public void onFailure(Call call, Throwable t) {
Toast.makeText(MainActivity.this,"Call Back Failed",Toast.LENGTH_SHORT).show();
}
});
我们也可以将上述步骤简单封装成一个util。类似于
public class RetrofitUtil {
private Retrofit retrofit;
private DoubanAPI doubanService;
private static RetrofitUtil instance;
private RetrofitUtil() {
retrofit=new Retrofit.Builder().baseUrl("https://api.douban.com/")
.addConverterFactory(GsonConverterFactory.create())
.addCallAdapterFactory(RxJavaCallAdapterFactory.create())
.client(new OkHttpClient.Builder().connectTimeout(5, TimeUnit.SECONDS).build())
.build();
doubanService=retrofit.create(DoubanAPI.class);
}
//singleton
public static RetrofitUtil getInstance(){
if (instance == null) {
synchronized (RetrofitUtil.class){
if (instance == null) {
instance=new RetrofitUtil();
}
}
}
return instance;
}
public void getUSMovie (Subscriber<MovieInfo> subscriber){
doubanService.getUSMovie().subscribeOn(Schedulers.io())
.unsubscribeOn(Schedulers.io())
.observeOn(AndroidSchedulers.mainThread())
.subscribe(subscriber);
}
}
好,关于Retrofit的简单使用就先到这,想详细了解的话可以参考鸿洋大神的Retrofit2完全解析
下篇将会采用傻瓜式的方法讲解如何使用RXJava及Retrofit与RXJava的结合使用!
Retrofit&&RXJava傻瓜式入门(下)已更新~
网友评论