Retrofit笔记 | 基本使用步骤

Retrofit使用基本步骤

1. 添加好依赖

    implementation 'com.squareup.okhttp3:okhttp:3.4.1'
    implementation 'com.squareup.retrofit2:retrofit:2.1.0'
    implementation 'com.squareup.retrofit2:converter-gson:2.1.0'

1.2添加权限

<uses-permission android:name="android.permission.INTERNET"/>

2. 创建接口，设置请求类型与参数

• 新建UserInfoModel类（一个根据服务端数据的格式，如json数据的格式字段，而设计的一个Java类，类中的成员字段对应着服务端数据的字段） 举个例子： 如服务器端数据格式如下：

则对应设计的UserInfoModel类：

• 以及UserMgrService接口， 常用参数注解：** @GET、@POST：确定请求方式； @Path：请求URL的字符替代； @Query：要传递的参数； @QueryMap：包含多个@Query注解参数； @Body：添加实体类对象 @FormUrlEncoded：URL编码； 示例：

@GET("login")
public Call<UserInfoModel> login(@Query("username") String username，@Query("pwd") String pwd);

3. 创建Retrofit对象，设置数据解释器

        Retrofit retrofit = new Retrofit.Builder()
                .baseUrl(url)
                .addConverterFactory(GsonConverterFactory.create())
                .build();

4. 生成接口对象

UserMgrService service = retrofit.create(UserMgrService.class);

5. 调用（刚刚在接口中定义过的）接口方法，返回Call（数据类）对象

Call<UserInfoModel> call = service.login("zhangsan","123456");

6. 发送请求（同步、异步）

• 只有发送了请求，以上至第五步才能真正获得数据； 同步：调用Call对象的execute()，返回结果的响应体； 异步：调用Call对象的enqueue()，参数是一个回调；
• 同步指程序调用请求方法后， 就一直等着返回数据，不干别的事情, 可能长时间阻塞线程； 异步指程序调用请求方法后， 直接干别的事情，不干等着数据返回了， 而是设置好回调，数据来时通过回调传讯， 不阻塞线程；
• 同步调用需要手动做一个防阻塞处理（设置等待响应时间，超过则认定无响应，阻塞线程）； 异步调用则不需要考虑这个问题；

7. 处理返回数据