Android从零开搞系列：网络框架系列（3）Retrofit+RxJava+MVP（上）Retrofit

转载请注意：http://blog.csdn.net/wjzj000/article/details/54287823

本菜开源的一个自己写的Demo，希望能给Androider们有所帮助，水平有限，见谅见谅…

https://github.com/zhiaixinyang/PersonalCollect （拆解GitHub上的优秀框架于一体，全部拆离不含任何额外的库导入）

https://github.com/zhiaixinyang/MyFirstApp（Retrofit+RxJava+MVP）

写在前面

今天没人约也没人请吃饭，所以只能蹲在家里自己跟自己玩…

今天是微信小程序公测的一天，水平有限暂时就不对小程序做过多的评价，坐的业内大神开撕…

今天记录的内容是Retrofit+RxJava+MVP的梳理。之前一直没感觉到他们的强大之处，所以还是比较抵触。直到越来越感觉很难去维护自己写的代码，半个月再回来看自己的代码，真刺激…

所以对他们的记录就得搞起来….

之前写过一篇Retrofit的简单用法，比较水但也比较直接，感兴趣的看官可以瞅一瞅。

http://blog.csdn.net/wjzj000/article/details/52806822

先让我们，来一发Retrofit。

Retrofit

简单来说它是一个网络请求框架。但从这一点上来说我们有很多可以选择的方案，比如：原生的HttpURLConnection，还有几年前谷歌推荐Volley…当然肯定还有其他大神写的格式各样的框架。

但从网络请求上来说，这些方案都是不错的选择。

但是我要考虑异步，要考虑耦合性，要考虑七大姑八大姨等等一系列问题！因此让我们感受未知的力量…

结合Gson进行最简单的请求

一切的最开始肯定是Gradle配置：

//这是我们的Retrofit依赖
compile 'com.squareup.retrofit2:retrofit:2.1.0'
//这个的作用是直接将Json返回值转成JavaBean
compile 'com.squareup.retrofit2:converter-gson:2.1.0'
//这个的作用是直接放回String类型的服务器返回值
compile 'com.squareup.retrofit2:converter-scalars:2.1.0'
//当然还有很多其他的方式...不够用的时候百度一下，没毛病...

先看一下服务器的返回值：

很简单的一组数据，对应了三个键值对。这里的key要和我们的JavaBean一一对应。

[

{“name”:”齐天大圣”,”content”:”我要这铁棒有何用！”,”imgpath”:”http://120.27.4.196:8080/image/img1.png“},

{“name”:”吕布”,”content”:”人中吕布，马中赤兔！”,”imgpath”:”http://120.27.4.196:8080/image/img2.jpg“},

{“name”:”霍去病”,”content”:”犯我强汉者，虽远必诛！”,”imgpath”:”http://120.27.4.196:8080/image/img3.jpg“},

{“name”:”又帅又长的作者”,”content”:”妈的，智障。”,”imgpath”:”http://120.27.4.196:8080/image/img4.png“}

]

Retrofit最大的使用不同：

使用时要先创建一个！接口！

public interface RetrofitApi {
//此URL就是我们需要访问的地址，注意结尾必须是/
String URL = "http://www.ohonor.xyz/strutstest/";

//GET注解标识用GET方法请求服务器
//这里的注解中的参数retrofit，会在真正使用的时候拼接在我们的URL上形成真正的访问服务器的URL。为什么要这样？简单来说这样我们就可以动态的去替换我们的URL了。
@GET("retrofit")
//这里的Call对应OkHttp中的Call，RetrofitBean就是我们的JavaBean。泛型是一List也就是说我们从服务器取到的返回值是一个数组。
Call<List<RetrofitBean>> getRetrofitDatas();
}

JavaBean如下，没啥好看，就是对应服务器Json的key：

public class RetrofitBean {
private String name;
private String content;
private String imgpath;

public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getContent() {
return content;
}
public void setContent(String content) {
this.content = content;
}
public String getImgpath() {
return imgpath;
}
public void setImgpath(String imgpath) {
this.imgpath = imgpath;
}
}

请求的过程：

Retrofit retrofit = new Retrofit.Builder()
//此处必须要调用baseUrl传递一个URL
.baseUrl(RetrofitApi.URL)
//这里就是对应我们Gradle引入处理Json的库
.addConverterFactory(GsonConverterFactory.create())
.build();
RetrofitApi retrofitApi = retrofit.create(RetrofitApi.class);
Call<List<RetrofitBean>> call = retrofitApi.getRetrofitDatas();
call.enqueue(new Callback<List<RetrofitBean>>(){
@Override
public void onResponse(Call<List<RetrofitBean>> call, Response<List<RetrofitBean>> response){
//OK，在此我们通过response.body。就拿到了Gson帮我们解析好的List<RetrofitBean>
}

@Override
public void onFailure(Call<List<RetrofitBean>> call, Throwable t){
//如果请求出错，这里将返回错误内容。比如：404，500之类的。
}
});

我们可以比较清晰的看出，整个的请求过程和OkHttp过程很类似。没错Retrofit的底层网络请求就是基于OkHttp在做。

在这里我们会发现，一套代码些下来，除了使用封装了Gson比较方便的解析了Json好像也没有太好用很多…

妈的，你咋不上天和神舟十一肩并肩！它就是一个网络请求框架，你还想要它怎样？怪它没能力跟随，你去的方向。你还要它怎样，要怎样，你突然来的短信就够它悲伤。

我们的题目是Retrofit+RxJava+MVP，我们把Retrofit和另外这俩货在一起使用的时候，我们才会感受到那快要压不住的棺材盖…

当然现在先不谈，本篇就是搞Retrofit，做人要专一，不要搞事情…

POST相关

第一步肯定还是接口:

//这里注解使用POSTjiu
@POST("retrofitPost")
//下边会有介绍
@FormUrlEncoded
/**
* 此时我们需要往服务器POST数据，因此我们势必要传参
* 而Field注解就是以键值对方式传递的意思
* 当然还有其他方式，下文会一一展开
*/
Call<String> postRetrofit(@Field("username") String suername,
@Field("password") String password);

使用过程非常的简单：

//过程还是这个过程...
Retrofit retrofit=new Retrofit.Builder()
.baseUrl(RetrofitApi.URL)
//唯一的不同就是ScalarsConverterFactory
//它的效果是直接以String类型获取服务器返回值
.addConverterFactory(ScalarsConverterFactory.create())
.build();
RetrofitApi retrofitApi=retrofit.create(RetrofitApi.class);
Call<String> call = retrofitApi.postRetrofit("abc","abc");
call.enqueue(new Callback<String>() {
@Override
public void onResponse(Call<String> call, final Response<String> response) {
runOnUiThread(new Runnable() {
@Override
public void run() {
tvContent.setText(response.body());
}
});
}

@Override
public void onFailure(Call<String> call, Throwable t) {
}
});

效果如下：

部分注解解释：

@Field注解：

表单编码请求的命名对。
简单示例：
@FormUrlEncoded
@POST（“/”）
Call<ResponseBody>示例（@Field（“name”）字符串名称，@Field（“occupation”）字符串占用）;

使用
{@code foo.example（“Bob Smith”，“President”）}调用会产生一个请求正文
{@code name = Bob + Smith＆occupation = President}。

@FormUrlEncoded注解：

表示请求正文将使用表单URL编码。 字段(Field)应该声明为参数，并用{@Field}注释。 使用此注释发出的请求将具有{application / x-www-form-urlencoded} MIME类型。 字段名称和值将在根据URI编码之前进行UTF-8编码

www-form-urlencoded是POST数据默认编码格式，POST过去的key-value会被编码成QueryString.
格式如下:
?username=123&password=123

@Part注解：

表示多部分请求的单个部分。
此注释存在的参数类型将以下列三种方式之一进行处理：
如果类型是{okhttp3.MultipartBody.Part}，内容将被直接使用。
从注释中省略名称（即{@Part MultipartBody.Part part}）。
如果类型是{okhttp3.RequestBody RequestBody}，则该值将直接与其内容类型一起使用。
在注释中提供Part名称（例如{@Part（“foo”）RequestBody foo}）。
使用{plain Converter a converter}将其他对象类型转换为适当的表示形式。
在注释中提供Part名称（例如，
{@Part（“foo”）Image photo}）。 值可以是{null}，它将从请求正文中省略它们。
@Multipart
@POST（“/”）
Call<ResponseBody> example（@Part（“description”）字符串描述，
@Part（value =“image”，encoding =“8-bit”）RequestBody image）;
Part参数可能不是{null}。

@Multipart注解：

表示请求正文是多部分的。 Part应声明为参数并注释为{@Part}。

写在最后

关于Retrotfit的使用，暂时就整这么多，因为用法这种东西是死的，这里主要是为了记录各框架间的彼此协作，而不是它们每个人的具体用法…

如果还不是很清楚，可以参考鸿洋大神的博客：

http://blog.csdn.net/lmj623565791/article/details/51304204

最后希望各位看官可以star我的GitHub，三叩九拜，满地打滚求star：

https://github.com/zhiaixinyang/PersonalCollect

https://github.com/zhiaixinyang/MyFirstApp