Retrofit简介

首先分享一首最近很喜欢的歌，可惜不支持嵌入ifram。所以分享链接，不能在看文章的页面听了。

All The Time

• Tips

众所周知，Retrofit、RxJava对于Android开发比较火。所以大家都开始用这两个东西，网络上也有很多关于这方面的文章：
张鸿洋 Retrofit2 完全解析 探索与okhttp之间的关系
抛物线 给 Android 开发者的 RxJava 详解

Retrofit

我们根据Retrofit官方文档。来一步一步使用Retrofit

1. Retrofit turns your HTTP API into a Java interface.
   简单来说，Retrofit将HTTP API转化成Java的接口：

public interface ApiService {
    @GET("/api/cook/list")
    Observable getCookList(@Query("page") int page, @Query("rows") int rows);
}

2. The Retrofit class generates an implementation of the GitHubService interface.
   这句话大概说的是Retrofit这个类可以根据第一步定义的接口做具体的实现。
   官方文档是定义的GitHubService这个接口，我们自己定义的是ApiService，不影响使用。

Retrofit retrofit = new Retrofit.Builder()
                .baseUrl(ApiContancts.BASE_URL)
                .addConverterFactory(GsonConverterFactory.create())
                .build();
ApiService service = retrofit.create(ApiService.class);

这里Retrofit使用了构造者模式来构建Retrofit的对象，通过Retrofit的对象去实现我们之前定义的接口
(1) baseUrl() 是定义请求主地址
(2) addConverterFactory() 是完成对象的转化，一般情况下，服务器返回的是Json数据，我们需要利用Gson去做转换。

3. Each Call from the created GitHubService can make a synchronous or asynchronous HTTP request to the remote webserver.
   通过第二步得到的ApiService实例，就可以通过同步或异步请求网络数据了。

Call cookList = service.getCookList(1, 20);
cookList.enqueue(new Callback() {
            @Override
            public void onResponse(Call call, Response response) {
                //获取数据
            }

            @Override
            public void onFailure(Call call, Throwable t) {
                //请求失败回调
                t.printStackTrace();
            }
        });

以上就是Retrofit的简单使用。

REQUEST METHOD

Retrofit给我们提供了5种method：GET, POST, PUT, DELETE, and HEAD
下面主要讲讲常用的GET和POST方法

• GET
  GET作为请求方法来讲不安全且提交的数据不能太大，因为GET方法提交的数据是作为URL请求的一部分。
  使用很简单：

@GET("users/list")

@GET("users/list?sort=desc")

//可以通过{}中参数替换GET中的参数，动态的去更新请求URL
@GET("group/{id}/users")
Call> groupList(@Path("id") int groupId);

从以上就能看出，我们将提交的数据作为url请求的一部分，相当于明文传输。所以，我们用表单提交用户信息时就不安全，比如用户的用户名和密码。


- **POST**
POST主要用来向服务器提交表单数据且能携带大量的数据。
> HTTP 协议是以 ASCII 码传输，建立在 TCP/IP 协议之上的应用层规范。规范把 HTTP 请求分为三个部分：状态行、请求头、消息主体。

> 而POST 提交的数据必须放在消息主体（entity-body）中，不会是明文传输，所以POST比GET更安全。

POST使用方法：

@FormUrlEncoded
@POST("user/edit")
Call updateUser(@Field("first_name") String first, @Field("last_name") String last);

> 关于Retrofit的注解就不一一阐述了，已经为各位看官准备好了链接
[Retrofit各个注解的含义及作用](http://blog.csdn.net/qiang_xi/article/details/53959437)

> 本篇文章旨在记录，也是自己使用Retrofit的一个梳理。
简单的介绍了Retrofit官网的一些东西，具体的代码实现请移驾[RetrofitDemo](https://github.com/LeXiaoWen/RetrofitDemo)，Demo中包含注册登录模块和列表数据请求，里面简单用到了RxJava。今天就不记录了，后面文章再记录下来。