先是,本篇是依照这个的下结论、思考和进展,这篇作者由浅入深,徐徐道来,读起来感觉很棒。

** 1、使用Retrofit来展开网络请求 **

a、网络接口使用豆瓣电影的top250,我们遵照它回到的json格式封装为一个MovieEntity。

https://api.douban.com/v2/movie/top250?start=0&count=10

b、然后创建接口Movie瑟维斯(Service):

public interface MovieService {
    /** 以Get方法访问接口,参数start和count分别是对接口地址的传参 **/
    @GET("top250")
    Call<MovieEntity> getTopMovie(@Query("start") int start, @Query("count") int count);
}

c、接着,在界面中采取Retrofit举办网络请求:

private void getMovie() {
        String baseUrl = "https://api.douban.com/v2/movie/";
        /** 创建Retrofit对象,数据转换使用Gson **/
        Retrofit retrofit = new Retrofit.Builder()
                .baseUrl(baseUrl)
                .addConverterFactory(GsonConverterFactory.create())
                .build();
        /** 通过MoviceService得到Call,然后加入请求队列并,并在Callback接口方法中处理返回结果 **/
        MovieService movieService = retrofit.create(MovieService.class);
        Call<MovieEntity> call = movieService.getTopMovie(0, 10);
        call.enqueue(new Callback<MovieEntity>() {
            @Override
            public void onResponse(Call<MovieEntity> call, Response<MovieEntity> response) {
                resultTV.setText(response.body().toString());
            }

            @Override
            public void onFailure(Call<MovieEntity> call, Throwable t) {
                resultTV.setText(t.getMessage());
            }
        });
    }

正确,以上措施便得以做到请求,可是看起来不美,我们可以通过包装请求方法,在Activity或Fragment中只保留更新UI相关的逻辑。OK,单纯的包装相比较简单,我们联合插手Rxjava来看看。

** 2、添加Rxjava并对请求过程进展封装 **

a、大家前面定义的瑟维斯(Service)(Service)重临值就由Call变为Observable了。

public interface MovieService {
    /** 返回的Observable正是被观察者,我们用来通知观察者对象(这里我们通知UI更新) **/
    @GET("top250")
    Observable<MovieEntity> getTopMovie(@Query("start") int start, @Query("count") int count);
}

b、把请求的长河封装到HttpMethods类里面,

public class HttpMethods {
    public static final String BASE_URL = "https://api.douban.com/v2/movie/";
    private static final int DEFAULT_TIMEOUT = 5;

    private Retrofit retrofit;
    private MovieService movieService;

    //构造方法私有
    private HttpMethods() {
        //手动创建一个OkHttpClient并设置超时时间
        OkHttpClient.Builder httpClientBuilder = new OkHttpClient.Builder();
        httpClientBuilder.connectTimeout(DEFAULT_TIMEOUT, TimeUnit.SECONDS);

        retrofit = new Retrofit.Builder()
                .client(httpClientBuilder.build())
                .addConverterFactory(GsonConverterFactory.create())
                //此处添加RxJavaCallAdapterFactory,把请求结果直接映射为
                //MovieService接口方法返回的具体类型MovieEntity
                .addCallAdapterFactory(RxJavaCallAdapterFactory.create())
                .baseUrl(BASE_URL)
                .build();

        movieService = retrofit.create(MovieService.class);
    }

    //在访问HttpMethods时创建单例
    private static class SingletonHolder{
        private static final HttpMethods INSTANCE = new HttpMethods();
    }

    //获取单例
    public static HttpMethods getInstance(){
        return SingletonHolder.INSTANCE;
    }

    /**
     * 用于获取豆瓣电影Top250的数据
     * @param subscriber  由调用者传过来的观察者对象
     * @param start 起始位置
     * @param count 获取长度
     */
    public void getTopMovie(Subscriber<MovieEntity> subscriber, int start, int count){
        movieService.getTopMovie(start, count)
                //指定subscribe()发生在io调度器(读写文件、读写数据库、网络信息交互等)
                .subscribeOn(Schedulers.io())
                .unsubscribeOn(Schedulers.io())
                //指定subscriber的回调发生在主线程
                .observeOn(AndroidSchedulers.mainThread())
                //实现订阅关系
                .subscribe(subscriber);
    }
}

c、那么getMovie()方法直接调用封装过的getTopMovie()即可。从中,我们看来使用Rxjava带来两点变化:一个是将呼吁封装进Observable;此外是通过实现Subscriber中的五个接口方法来打招呼请求状态(即UI更新)。

   private void getMovie() {
        subscriber = new Subscriber<MovieEntity>() {
            @Override
            public void onCompleted() {
                Toast.makeText(MainActivity.this, "Get Top Movie Completed", Toast.LENGTH_SHORT).show();
            }

            @Override
            public void onError(Throwable e) {
                resultTV.setText(e.getMessage());
            }

            @Override
            public void onNext(MovieEntity movieEntity) {
                /** 这里得到的请求结果直接是我们想要的java对象 **/
                resultTV.setText(movieEntity.toString());
            }
        };
        HttpMethods.getInstance().getTopMovie(subscriber, 0, 10);
    }

从上边我们清楚Retrofit会把再次回到的json对象映射为大家需要的java对象,我们的运用中肯定会用到众多网络接口,大家现在是呼吁的摄像列表,我们还会呈请电影详情,演员详情等等,这我们就需要定义MovieDetail、Actor等等Entity。问题是我们的劳动普通会给大家回到一个定点样式的数据,形如:

{
 "resultCode": 1,
 "resultMsg": "成功",
 "data": {}
}

并且我们通常会先去判断resultCode,以便可以统一处理错误音讯。至于data中的结构,则是浮动的,它可以是影视列表Movies,也足以是艺人信息Actor,那么此时我们就会记念使用泛型来进展打包:

public class HttpResult<T> {
    private int resultCode;
    private String resultMsg;
    private T data;
}

假如data是Actor对象的话,那么定义瑟维斯(Service)方法重返值就可以写成:

observable<HttpResult<Actor>>

如若data是影视列表,那么大家得以这么写:

observable<HttpResult<List<Movie>>>

考虑到一般列表的数码都会有分页音信,大家照例能够继续封装:

/** 支持分页的json结构 **/
{
 "start": 0,
 "count": 20,
 "total": 250
 "list": []
}
/** 封装后带分页的泛型对象 **/
public class HttpResList<T> {
    private int start;
    private int count;
    private int total;
    private T list;
}

那么电影列表,就需要这样写了:

observable<HttpResult<HttpResList<List<Movie>>>>

啊啊啊,是不是有一种碟中谍、局中局的感觉…当然,为了减小层级,我们得以把分页的连带信息涉及resultCode这一个层级来,这多少个需要我们跟服务端协定好一个条条框框。

这就是说封装为泛型后的代码跟下边的相距不大,只是把Observable相关的参数或回到类型由MovieEntity改为HttpResult<List<Movie>>(注意,我们所利用的测试接口跟我们上述商量的布局有出入),所有就不再贴出代码。

因此,协定好一个正经、好用的数据结构,是何等的酸爽。

实质上,我一向有个疑惑,为啥要用Rxjava呢?没看出代码简洁、好用啊,是呀,Why?请移步
煮 Retrofit 论 RxJava(二)

转载请标明出处:http://www.jianshu.com/p/86cf7de684b3

相关文章

网站地图xml地图