Retrofit2 学习总结

原文链接：
http://www.jianshu.com/p/a8b88c7fe831
http://blog.csdn.net/qq_24889075/article/details/52181133

概述

在学习 Retrofit2 的过程中受到了一些阻力，现 Retrofit2 学会使用了，特此写此文验证所学知识。同时也希望帮助和我一样在学习Retrofit2遇到困难的猿们。

当我在刚开始学习 Retrofit2 的时候并不知道Retrofit2是什么东西，后来逐渐了解 “它可能是一个方便我们网络请求的库，可以帮我们让请求网络变得更灵活、易于维护”。然后还可以和时下比较火热的RxJava进行完美融合。

先看看如何使用，如何进行一个简单的Get/Post请求

Retrofit2 入门

首先在build.gradle中添加如下代码，添加Retrofit2库

compile 'com.squareup.retrofit2:retrofit:2.1.0'

有的教程里写要手动添加okhttp的库，其实是不需要的，因为retrofit2封装了okhttp,不信自己编译下看看:

gradle

External libraries

添加完库，我们开始正文。

我们在项目中进行网络请求时，肯定不是一个地址吧，那么这些请求地址存放在哪呢？是在哪个类里请求就在哪个类里存放，还是统一放在一个专门存地址的类中呢？
我在学习Android期间就是哪里有请求就放哪里，后来有人告诉我要集中存放。于是后来就建立一个AppURL.java所有地址都存放这里。
然而Retrofit2这里也可以这么理解：专门有一个‘地方’来存储链接地址（也可以创建多个‘地方’存储）。这个‘地方’不是类而是接口，在这个接口中可以设定请求地址的一些信息。就像这样：

public interface AppURL { 
    @GET("index") 
    Call<ResponseBody> getIndex();
    ...
    ...
//  可以存储多个连接地址
}

说明：
接口名“AppURL ”可以随意定义，根据自己喜好。
第一行：代表get请求,请求地址为“设定的BaseURL/index” (BaseURL设定在下面介绍如何设定)
第二行：getIndex是方法名;Call<ResponseBody>是默认返回类型，暂且不要管能干什么。

下面我们看下如何使用这些地址进行网络请求：

创建Retrofit对象，并设定BaseURL

Retrofit retrofit = new Retrofit.Builder()
                .baseUrl("https://www.这里是BaseURL.com/")
                .build();

需要注意的是BaseURL必须以‘/’结尾

获取“AppURL”对象（创建请求服务）

AppURL url= retrofit.create(AppURL.class);

用AppURL对象得到具体请求对象（获取请求服务方法）

Call<ResponseBody> call = url.getIndex();

后期也会在这一步中进行设置链接参数、请求头等

开始(异步)请求

call.enqueue(new Callback<ResponseBody>() {
            @Override
            public void onResponse(Call<ResponseBody> call, Response<ResponseBody> response) {
                Log.e("tag", response.body().toString());//获得数据
            }
            @Override
            public void onFailure(Call<ResponseBody> call, Throwable t) {
                Log.e("tag", t.getMessage());//请求失败
            }
        });

好了，现在一个简单的网络请求就写完了。不是很难吧（当时我可是觉得挺难 ^_）

单单会这些是远远不够的，那么我们如何来满足项目中各种各样的需求呢？请继续看

Retrofit2 进阶

自动解析

其实在Retrofit2中，我们不用自己来解析数据，Retrofit2可以帮我们自动解析，怎么做呢？请看：

添加
在Retrofit2中是用Gson解析的，所以我们要在build.gradle中添加。

compile 'com.squareup.retrofit2:converter-gson:2.1.0'

有写教程说还有添加gosn库，经过测试是不需要的，converter-gson中已经封装了gson库。
需要注意的是converter-gson和retrofit版本号应为一致，在这里我都用2.1.0

创建Bean
创建一个JavaBean，用于解析服务器返回数据。就和我们平常自己解析创建的Bean一样，推荐用As的插件JsonFormat，挺方便的。
我们创建一个Bean起名为MBean.java(随便起的)
为retrofit添加addConverterFactory
添加后的代码如下：

Retrofit retrofit = new Retrofit.Builder()
                .baseUrl("https://www.这里是BaseURL.com/")
                .addConverterFactory(GsonConverterFactory.create())
                .build();

修改泛型

//在AppURL 接口中修改：
@GET("index")
    Call<MBean> getIndex();
 Call<MBean> call = url.getIndex();
//调用服务请求时的修改
        call.enqueue(new Callback<MBean>() {
            @Override
            public void onResponse(Call<MBean> call, Response<MBean> response) {
                Log.e("tag", response.body().toString());//解析好的数据
            }

            @Override
            public void onFailure(Call<MBean> call, Throwable t) {
                Log.e("tag", t.getMessage());
            }
        });

这样输出的就直接是用Gson解析好的MBean数据了。

retrofit不仅仅只支持gson，还支持其他许多json解析库。如：
Jackson、Moshi、Protobuf、Wire、Simple XML、Scalars (primitives, boxed, and String) 具体请看官网

固定地址/路径替换

说到固定地址了，那么固定地址长什么样呢？

http://www.BaseURL.com/index
http://www.BaseURL.com/user
http://www.BaseURL.com/login
http://www.BaseURL.com/register/qq
http://www.BaseURL.com/register/wechat

那么应该如何请求呢？除了上面例子中的写法还可以这样写：

    @请求类型（"{name}"）
    Call<返回类型> 方法名(@path("name") String name);
如：

  @GET("{name}")
    Call<MBean> get(@Path("name") String urlName);

//如果想访问登录的链接，在使用时就直接url.get("login");就可以。这样请求的地址就是http://www.BaseURL.com/login 是不是很方便
//注意@Path和{}中的参数名要一致

@Path的应该作用暂且理解为为上面的GET请求传值吧

带参地址

带参地址长这样子：

www.BaseURL.com/login?page=1
www.BaseURL.com/movieTop?start=1&count=5
www.BaseURL.com/login?username=testuser&password=123456

上个用的是@Path，这回用的是@Query其实和@Path一样
直接看例子：

@GET("movieTop")
    Call<MBean> get(@Query("start") int start, @Query("count") int count);
//假设想查询电影排行榜的第1-5名，则使用时候是这样：
Call<MBean> call = url.get(1, 5);
//请求的地址是这样：www.BaseURL.com/movieTop?start=1&count=5

Post带Body请求

使用@Body来声明即可，如下：

 @POST("/aaa")
 Call<MBean> send( @Body UserInfo body);
//使用
Call<MBean> call=url.send();

这里的UserInfo就是要发送的实体，Retrofit2 会自动转成Gson

学到这里，一般的网络请求都可以了进行，可以应付一阵子了。
还有一些要求较高的请求，请看下节。

Retrofit2 大成

如果看到这里，相信对Retrofit2的基本请求会用了，那么这节就说一说其他的网络请求。

表单(FormUrlEncoded)

我们可以使用@FormUrlEncoded注解来发送表单数据。使用 @Field注解和参数来指定每个表单项的Key，value为参数的值。

@FormUrlEncoded
@POST("user/login")
Call<User> updateUser(@Field("username") String name, @Field("password") String pass);

单文件上传(Multipart)

 @Multipart
    @POST("register")
    Call<User> registerUser(
      @Part MultipartBody.Part headPhoto, 
      @Part("username") RequestBody userName, 
      @Part("password") RequestBody passWord
  );
//使用
MediaType textType = MediaType.parse("text/plain");
RequestBody name = RequestBody.create(textType, "二傻子");
RequestBody pass = RequestBody.create(textType, "123456");

RequestBody photoRequestBody = RequestBody.create(MediaType.parse("image/png"), 文件对象);
MultipartBody.Part photo = MultipartBody.Part.createFormData("上传的key", "文件名.png", photoRequestBody);

Call<User> call = url.registerUser(photo,name, pass);

@Part 后面支持三种类型，{@link RequestBody}、{@link okhttp3.MultipartBody.Part} 、任意类型；

动手测试：username的RequestBody 换成String是否可以

多文件上传

@Multipart
@POST("register")
Call<User> registerUser(@PartMap Map<String, RequestBody> params,  @Part("password") RequestBody password);
//使用
RequestBody photo = RequestBody.create(MediaType.parse("image/png"), 文件对象2);
RequestBody photo = RequestBody.create(MediaType.parse("image/png"), 文件对象2);
Map<String,RequestBody> photos = new HashMap<>();
photos.put("对应的key1"; filename=\"文件名1.png", photo1);
photos.put("对应的key2"; filename=\"文件名2.png", photo2);
photos.put("username",  RequestBody.create(null, "二傻子"));

Call<User> call = userBiz.registerUser(photos, RequestBody.create(null, "123456"));

也可以都塞Map里上传，也可以只在Map中上传文件，随你喽~
文章结尾有参考链接。不一样的上传方式。

文件和参数混合上传

比如修改用户信息:头像、用户名

    @Multipart
    @POST("地址")
    Call<User> head(@Part("key") RequestBody username,
                              @Part("key\"; filename=\"完整的用户名") RequestBody img,
                              @Part("key") RequestBody  sex,
                              @Part("key") RequestBody  key
    );
//使用
Call<User> call =url.head(
                RequestBody.create(MediaType.parse("text/plain"),  username),
                RequestBody.create(MediaType.parse("image/*"),  图片对象),
                RequestBody.create(MediaType.parse("text/plain"),  sex),
                RequestBody.create(MediaType.parse("text/plain"),  key)));

不知道还有没有其他方法 以后有时间研究下

请求头

固定请求头

     @GET("地址")
     @Headers("Accept-Encoding: application/json")
     Call<返回类型> 方法名();
    // 请求结果：
    // GET 地址 HTTP/1.1
    // Accept-Encoding: application/json

动态请求头

     @GET("地址")
     Call<返回类型> 方法名(@Header("Location") String location);
    //使用
    url.方法名("参数");
    // 请求结果：
    // GET 地址 HTTP/1.1
    // Location: 参数

固定+动态

     @GET("地址")
     @Headers("Accept-Encoding: application/json")
     Call<返回类型> 方法名(@Header("Location") String location);
    //使用
    url.方法名("参数");
    // 请求结果：
    // GET 地址 HTTP/1.1
    // Accept-Encoding: application/json
    // Location: 参数

其他

注意XXXMap的使用，比如@PathMap，@FieldMap等，具体怎么使用，可以自己研究，研究不出来的可以参考结尾处的文章。
下载文件得说说，在Retrofit2中下载文件是默认存储到缓存中，也就是说不能进行大的文件下载，如果要下载大文件要用 @streaming 。但话说回来了，下载文件我们可以不用Retrofit2啊，直接用okhttp不就得啦
我们是可以添加 okhttpclient 到retrofit中去，这样可以来统一的log管理，给每个请求添加统一的header等，那么我们没有添加为什么没有报错呢？因为在build()方法中会判断是否为空，如果我们没有添加okhttpclient 则就是空了，那么retrofit会自动给我们添加了一个new OkHttpClient();
execute是同步执行需要在子线程中执行、enqueue是异步执行。
看下我这几个图，整理一下思路吧

HTTP请求方法

以上表格中的除HTTP以外都对应了HTTP标准中的请求方法，而HTTP注解则可以代替以上方法中的任意一个注解,有3个属性：method、path、hasBody, 这里是用HTTP注解实现的例子

public interface BlogService {
    /**
     * method 表示请的方法，不区分大小写
     * path表示路径
     * hasBody表示是否有请求体
     */
    @HTTP(method = "get", path = "blog/{id}", hasBody = false)
    Call<ResponseBody> getFirstBlog(@Path("id") int id);
}

标记类

参数类

注1：{占位符}和PATH尽量只用在URL的path部分，url中的参数使用Query和QueryMap 代替，保证接口定义的简洁
注2：Query、Field和Part这三者都支持数组和实现了Iterable接口的类型，如List，Set等，方便向后台传递数组。

    Call<ResponseBody> foo(@Query("ids[]") List<Integer> ids);
    //结果：ids[]=0&ids[]=1&ids[]=2

Retrofit2 独断万古

首先说下如何和当前火热的RxJava进行配合使用。

引入RxJava支持 (版本号要一致)

compile 'com.squareup.retrofit2:adapter-rxjava:2.1.0'

写接口

@GET(" ^_^ ")
    Observable<MBean> get();

通过RxJavaCallAdapterFactory为Retrofit添加RxJava支持

Retrofit retrofit = new Retrofit.Builder()
      .baseUrl("http://www.BaseURL.com/")
      .addConverterFactory(GsonConverterFactory.create())//自动通过Gson转josn，上面有提到
      .addCallAdapterFactory(RxJavaCallAdapterFactory.create())//添加RxJava支持
      .build();

使用

url.get()
        .subscribeOn(Schedulers.io())
        .subscribe(new Subscriber<MBean>() {
            @Override
            public void onCompleted() {
            }
            @Override
            public void onError(Throwable e) {
            }
            @Override
            public void onNext(MBean mBean) {
            }
        });

根据需要添加RxAndroid，这个版本号没有要求。

剩下的内容讲的主要是进行自定义 Converter 和 自定义CallAdapter。还有就是源码的解析。
这里可以参考结尾处的链接，不献丑了。

Retrofit2 + RxJava 第一次使用出现的问题

忘记添加

.addConverterFactory(GsonConverterFactory.create())
.addCallAdapterFactory(RxJavaCallAdapterFactory.create())

.subscribeOn(Schedulers.io())
.observeOn(AndroidSchedulers.mainThread())

好的Retrofit2 + RxJava Demo参考：
https://github.com/rengwuxian/RxJavaSamples

参考地址

这些是我在学习过程中收集的一些资料，个人感觉还不错。
本文部分内容来自于下面部分文章

鸿洋：http://blog.csdn.net/lmj623565791/article/details/51304204#t1
图片来源（经过作者授权拿的图）：http://www.jianshu.com/p/308f3c54abdd

其他博客：
http://blog.csdn.net/ljd2038/article/details/51046512
http://blog.csdn.net/biezhihua/article/details/49232289
多文件上传参考：
http://www.chenkaihua.com/2016/04/02/retrofit2-upload-multipart-files.html
http://www.jianshu.com/p/acfefb0a204f

https://futurestud.io/blog/retrofit-getting-started-and-android-client

小说看多了，起的名有些怪。。。见谅啊 ^_

最后编辑于：2017.12.04 01:29:10

人面猴
序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
沈念sama阅读 200,738评论 5赞 472
死咒
序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
沈念sama阅读 84,377评论 2赞 377
救了他两次的神仙让他今天三更去死
文/潘晓璐我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
开封第一讲书人阅读 147,774评论 0赞 333
道士缉凶录：失踪的卖姜人
文/不坏的土叔我叫张陵，是天一观的道长。经常有香客问我，道长，这世上最难降的妖魔是什么？我笑而不...
开封第一讲书人阅读 54,032评论 1赞 272
港岛之恋（遗憾婚礼）
正文为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
茶点故事阅读 63,015评论 5赞 361
恶毒庶女顶嫁案：这布局不是一般人想出来的
文/花漫我一把揭开白布。她就那样静静地躺着，像睡着了一般。火红的嫁衣衬着肌肤如雪。梳的纹丝不乱的头发上，一...
开封第一讲书人阅读 48,239评论 1赞 278
城市分裂传说
那天，我揣着相机与录音，去河边找鬼。笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。我是一名探鬼主播，决...
沈念sama阅读 37,724评论 3赞 393
双鸳鸯连环套：你想象不到人心有多黑
文/苍兰香墨我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
开封第一讲书人阅读 36,374评论 0赞 255
万荣杀人案实录
序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
沈念sama阅读 40,508评论 1赞 294
护林员之死
正文独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋以下内容为张勋视角年9月15日...
茶点故事阅读 35,410评论 2赞 317
白月光启示录
正文我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
茶点故事阅读 37,457评论 1赞 329
活死人
序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
沈念sama阅读 33,132评论 3赞 316
日本核电站爆炸内幕
正文年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
茶点故事阅读 38,733评论 3赞 303
男人毒药：我在死后第九天来索命
文/蒙蒙一、第九天我趴在偏房一处隐蔽的房顶上张望。院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
开封第一讲书人阅读 29,804评论 0赞 19
一桩弑父案，背后竟有这般阴谋
文/苍兰香墨我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。一阵脚步声响...
开封第一讲书人阅读 31,022评论 1赞 255
情欲美人皮
我被黑心中介骗来泰国打工，没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。一个月前我还...
沈念sama阅读 42,515评论 2赞 346
代替公主和亲
正文我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
茶点故事阅读 42,116评论 2赞 341