Retrofit2

1.Retrofit2的简述

Retrofit其实我们可以理解为OkHttp的加强版，它也是一个网络加载框架。
底层是使用OKHttp封装的。准确来说,网络请求的工作本质上是OkHttp完成，
而 Retrofit 仅负责网络请求接口的封装。它的一个特点是包含了特别多注解，
方便简化你的代码量。并且还支持很多的开源库(著名例子：Retrofit + RxJava)。
Retrofit和OkHttp都是square公司写的.

2.Retrofit2的优点

①超级解耦
②可以配置不同HttpClient来实现网络请求
③支持同步、异步和RxJava
④可以配置不同的反序列化工具来解析数据，如：json、xml
⑤请求速度快，使用非常方便灵活

3.Retrofit2配置

官网
依赖：implementation 'com.squareup.retrofit2:retrofit:2.5.0'//Retrofit依赖
implementation 'com.squareup.retrofit2:converter-gson:2.5.0'//可选依赖，解析json字符所用
网络权限：

4.Retrofit2的使用步骤

①定义接口类（封装URL地址和数据请求）
②实例化Retrofit
③通过Retrofit实例创建接口服务对象
④接口服务对象调用接口中的方法，获取Call对象
⑤Call对象执行请求（异步，同步请求）

5.Retrofit2get、post请求（同步，异步）

get请求

//baseURL(从头开始到任意一个斜杠结束)
    String baseURL="https://www.wanandroid.com/article/list/0/";
    @GET("json?cid=60")
    Call getData();

//获取Retrofit对象
Retrofit retrofit = new Retrofit.Builder().baseUrl(MyServer.baseURL).build();
//通过Retrofit获取接口服务对象
MyServer server = retrofit.create(MyServer.class);
//接口对象调用其方法获取call对象
Call data = server.getData();
//call执行请求
data.enqueue(new Callback() {
    @Override
        public void onResponse(Call call, Response response) {
           try {
               String json = response.body().string();
               Log.e(TAG, "onFailure: " +  response.body().string());
               } catch (Exception e) {
                    e.printStackTrace();
               }
           }
           @Override
           public void onFailure(Call call, Throwable t) {
               Log.e(TAG, "onFailure: " + t.getMessage());
           }
});

post请求

String URL = "http://apicloud.mob.com/appstore/health/";//必须以反斜杠结尾
public interface MyServer {
//POST("search?")    POST("search")相同
//@Field("key") String value post请求用来提交参数的
    //@FormUrlEncoded post请求提交form表单的时候如果有参数,需要填加这个注解,用来将提交的参数编码
    //post请求不提交参数,不要加,
    //如果有提交的参数,没有加@FormUrlEncoded
    //@Field和@FieldMap一样，@FieldMap只不过是把一个一个的参数,合成一个map
    @POST("search?")
    @FormUrlEncoded
    Call postData1(@Field("key") String appKey,@Field("name") String appKey);
    @POST("search")  
    @FormUrlEncoded
    Call postData2(@FieldMap Map map);
}
//POST异步
private void initPostEnqueue() {
    //1.创建Retrofit对象
    Retrofit retrofit = new Retrofit.Builder()
            .baseUrl(MyServer.URL)
            .build();
    //2.获取MyServer接口服务对象
    MyServer myServer = retrofit.create(MyServer.class);
    //3.获取Call对象
    //方式一
    Call call1 = myServer.postData1("908ca46881994ffaa6ca20b31755b675");
    //方式二
    //不用切换主线程了,因为Retrofit帮我们切过了
    //okHttpClient需要自己切换主线程
    Map map = new HashMap<>();
    map.put("appKey","908ca46881994ffaa6ca20b31755b675");
    Call call = myServer.postData2(map);
    //4.Call对象执行请求
    call.enqueue(new Callback() {
        @Override
        public void onResponse(Call call,Response response) {
            try {
                String result = response.body().string();
                Log.e("retrofit", "onResponse: "+result);
                tv.setText(result);//默认直接回调主线程
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
        @Override
        public void onFailure(Call call, Throwable t) {
            Log.e("retrofit", "onFailure: "+t.getMessage());
        }
    });
}

6.Retrofit的注解

Retrofit的注解.png

String url_get = "http://gank.io/api/";
String url_post = "http://yun918.cn/study/public/index.php/";
String url_query = "https://www.wanandroid.com/";
String url_body = "https://www.wanandroid.com/";
String url_headers = "https://cdwan.cn/api/";

//get
@GET("data/%E7%A6%8F%E5%88%A9/20/2")
Call getData();

//post
@POST("data/%E7%A6%8F%E5%88%A9/20/2")
Call getData2();

//field
@POST("register")
@FormUrlEncoded
Call getData3(@Field("username") String username,
                        @Field("password") String password,
                        @Field("phone") String phone,
                        @Field("verify") String verify);

//query
@GET("project/list/1/json")
Call getData4(@Query("cid") int cid);

//fieldMap
@POST("register")
@FormUrlEncoded
Call getData5(@FieldMap Map map);

//queryMap
@GET("project/list/1/json?")
Call getData6(@QueryMap Map map);

//body
@POST("user/login")
Call getData7(@Body RequestBody requestBody);

//path
@GET("data/%E7%A6%8F%E5%88%A9/20/{page}")
Call getData8(@Path("page") int page);

//url
@GET
Call getData9(@Url String url_query);

//headers
@POST("cart/add")
@FormUrlEncoded
@Headers("X-Nideshop-Token:eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX2lkIjo1LCJpYXQiOjE1ODMxNjgzMDB9.aqdQNPdW8anMSqaqfAGWNPZxbb6j39tAaV-fOuzNhUM")
Call getData10(@Field("goodsId") String goodsId,
                             @Field("number") String number,
                             @Field("productId") String productId);

//header
@POST("cart/add")
@FormUrlEncoded
Call getData11(@Header("X-Nideshop-Token") String header);

7.Retrofit和OkHttp3的对比

•准确来说，Retrofit 是一个 RESTful 的 HTTP 网络请求框架的封装。
•原因：网络请求的工作本质上是 OkHttp 完成，而 Retrofit 仅负责 网络请求接口的封装
•App应用程序通过 Retrofit 请求网络，实际上是使用 Retrofit 接口层封装请求参数、Header、Url 等信息，之后由 OkHttp 完成后续的请求操作
•在服务端返回数据之后，OkHttp 将原始的结果交给 Retrofit，Retrofit根据用户的需求对结果进行解析

8.数据解析器（Converter）

•Retrofit 支持多种方式数据解析
•需要在Geadle中添加依赖
Gson：implementation 'com.squareup.retrofit2:converter-gson:2.0.2'
Jackson：implementation 'com.squareup.retrofit2:converter-jackson:2.0.2'