Retrofit简介

作者: 乐小文 | 来源:发表于2017-03-08 22:51 被阅读158次

    首先分享一首最近很喜欢的歌,可惜简书不支持嵌入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。今天就不记录了,后面文章再记录下来。

    相关文章

      网友评论

        本文标题:Retrofit简介

        本文链接:https://www.haomeiwen.com/subject/pffbgttx.html