Retrofit简介

96
乐小文
2017.03.08 22:51* 字数 527

首先分享一首最近很喜欢的歌,可惜简书不支持嵌入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<CookListBean> getCookList(@Query("page") int page, @Query("rows") int rows);
}
  1. 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去做转换。

  1. Each Call from the created GitHubService can make a synchronous or asynchronous HTTP request to the remote webserver.
    通过第二步得到的ApiService实例,就可以通过同步或异步请求网络数据了。
Call<CookListBean> cookList = service.getCookList(1, 20);
cookList.enqueue(new Callback<CookListBean>() {
            @Override
            public void onResponse(Call<CookListBean> call, Response<CookListBean> response) {
                //获取数据
            }

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

以上就是Retrofit的简单使用。

REQUEST METHOD

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

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

@GET("users/list")

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

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


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


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

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

POST使用方法:

@FormUrlEncoded
@POST("user/edit")
Call<User> 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。今天就不记录了,后面文章再记录下来。
随笔
Web note ad 1