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字符所用
网络权限：<uses-permission android:name="android.permission.INTERNET" />
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<ResponseBody> getData();
//获取Retrofit对象
Retrofit retrofit = new Retrofit.Builder().baseUrl(MyServer.baseURL).build();
//通过Retrofit获取接口服务对象
MyServer server = retrofit.create(MyServer.class);
//接口对象调用其方法获取call对象
Call<ResponseBody> data = server.getData();
//call执行请求
data.enqueue(new Callback<ResponseBody>() {
@Override
public void onResponse(Call<ResponseBody> call, Response<ResponseBody> response) {
try {
String json = response.body().string();
Log.e(TAG, "onFailure: " + response.body().string());
} catch (Exception e) {
e.printStackTrace();
}
}
@Override
public void onFailure(Call<ResponseBody> 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<ResponseBody> postData1(@Field("key") String appKey,@Field("name") String appKey);
@POST("search")
@FormUrlEncoded
Call<ResponseBody> postData2(@FieldMap Map<String,Object> 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<ResponseBody> call1 = myServer.postData1("908ca46881994ffaa6ca20b31755b675");
//方式二
//不用切换主线程了,因为Retrofit帮我们切过了
//okHttpClient需要自己切换主线程
Map<String,Object> map = new HashMap<>();
map.put("appKey","908ca46881994ffaa6ca20b31755b675");
Call<ResponseBody> call = myServer.postData2(map);
//4.Call对象执行请求
call.enqueue(new Callback<ResponseBody>() {
@Override
public void onResponse(Call<ResponseBody> call,Response<ResponseBody> 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<ResponseBody> call, Throwable t) {
Log.e("retrofit", "onFailure: "+t.getMessage());
}
});
}
6.Retrofit的注解
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<GetBean> getData();
//post
@POST("data/%E7%A6%8F%E5%88%A9/20/2")
Call<GetBean> getData2();
//field
@POST("register")
@FormUrlEncoded
Call<PostBean> getData3(@Field("username") String username,
@Field("password") String password,
@Field("phone") String phone,
@Field("verify") String verify);
//query
@GET("project/list/1/json")
Call<QueryBean> getData4(@Query("cid") int cid);
//fieldMap
@POST("register")
@FormUrlEncoded
Call<PostBean> getData5(@FieldMap Map<String, String> map);
//queryMap
@GET("project/list/1/json?")
Call<QueryBean> getData6(@QueryMap Map<String, Object> map);
//body
@POST("user/login")
Call<BodyBean> getData7(@Body RequestBody requestBody);
//path
@GET("data/%E7%A6%8F%E5%88%A9/20/{page}")
Call<GetBean> getData8(@Path("page") int page);
//url
@GET
Call<GetBean> getData9(@Url String url_query);
//headers
@POST("cart/add")
@FormUrlEncoded
@Headers("X-Nideshop-Token:eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX2lkIjo1LCJpYXQiOjE1ODMxNjgzMDB9.aqdQNPdW8anMSqaqfAGWNPZxbb6j39tAaV-fOuzNhUM")
Call<CartBean> getData10(@Field("goodsId") String goodsId,
@Field("number") String number,
@Field("productId") String productId);
//header
@POST("cart/add")
@FormUrlEncoded
Call<CartBean> 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'
