Android Retrofit 2

最新推荐文章于 2025-04-01 15:49:35 发布

您好_Ae

最新推荐文章于 2025-04-01 15:49:35 发布

阅读量1.8k

点赞数 31

文章标签： android retrofit

本文链接：https://blog.csdn.net/2401_89678804/article/details/144617759

版权

网络请求流程

App应用程序通过 Retrofit 请求网络，实际上是使用 Retrofit 接口层封装请求参数、Header、Url 等信息，之后由 OkHttp 完成后续的请求操作
在服务端返回数据之后，OkHttp 将原始的结果交给 Retrofit，Retrofit根据用户的需求对结果进行解析

[外链图片转存中…(img-Srx6GDYG-1734692654279)]

具体使用

1.添加Retrofit库的依赖

dependencies {
implementation ‘com.squareup.retrofit2:retrofit:2.5.0’
api ‘com.squareup.retrofit2:converter-gson:2.0.2’
}

2. 添加网络权限

3. 创建装载服务器返回数据的类

public class ResultData{
…
// 根据返回数据的格式和数据解析方式（Json、XML等）定义

}

4. 创建用于配置网络请求的接口

Retrofit将 Http请求抽象成 Java接口：采用注解描述网络请求参数和配置网络请求参数

public interface GetRequestInterface {

@GET(“openapi.do?keyfrom=Yanzhikai&key=2032414398&type=data&doctype=json&version=1.1&q=car”)
Call getCall();
// @GET注解的作用:采用Get方法发送网络请求

// getCall() = 接收网络请求数据的方法
// 其中返回类型为Call<*>，*是接收数据的类（即上面定义的Translation类）
// 如果想直接获得Responsebody中的内容，可以定义网络请求返回值为Call
}

注解说明

网络请求方法:@GET、@POST、@PUT、@DELETE、@HEAD(常用)
网络请求标记: @FormUrlEncoded、@Multipart、@Streaming
网络请求参数: @Header &、@Headers、 @Body、@Field 、 @FieldMap、@Part 、 @PartMap、@Query、@QueryMap、@Path、@Url

具体作用以及解释请自行前往官方文档查看,这里就不一一解释了

5. 创建 Retrofit 实例

Retrofit retrofit = new Retrofit.Builder()
.baseUrl(“http://fanyi.youdao.com/”) // 设置网络请求的公共Url地址
.addConverterFactory(GsonConverterFactory.create()) // 设置数据解析器
.addCallAdapterFactory(RxJavaCallAdapterFactory.create()) // 支持RxJava平台
.build();

数据解析器说明 Retrofit支持多种数据解析方式,使用时需要在Gradle添加依赖

数据解析器 Gradle依赖

Gson com.squareup.retrofit2:converter-gson:2.0.2

Jackson com.squareup.retrofit2:converter-jackson:2.0.2

Simple XML com.squareup.retrofit2:converter-simplexml:2.0.2

Protobuf com.squareup.retrofit2:converter-protobuf:2.0.2

Moshi com.squareup.retrofit2:converter-moshi:2.0.2

Wire com.squareup.retrofit2:converter-wire:2.0.2

Scalars com.squareup.retrofit2:converter-scalars:2.0.2

网络适配器说明 Retrofit支持多种网络请求适配器方式：guava、Java8和rxjava Android 提供默认的 CallAdapter，不需要添加网络请求适配器的依赖，若要使用其他网络适配器,则需要按照需求在Gradle添加依赖

网络请求适配器 Gradle依赖

guava com.squareup.retrofit2:adapter-guava:2.0.2

Java8 com.squareup.retrofit2:adapter-java8:2.0.2

rxjava com.squareup.retrofit2:adapter-rxjava:2.0.2

6.创建网络请求接口实例

// 创建网络请求接口的实例
GetRequestInterface request = retrofit.create(GetRequestInterface.class);

//对发送请求进行封装
Call call = request.getCall();

7. 发起网络请求（异步 / 同步）

/发送网络请求(异步)
call.enqueue(new Callback() {
//请求成功时回调
@Override
public void onResponse(Call call, Response response) {
//处理结果

}

//请求失败时候的回调
@Override
public void onFailure(Call call, Throwable throwable) {
//提示失败
}
});

// 发送网络请求（同步）
Response response = call.execute();

8. 处理返回数据

//发送网络请求(异步)
call.enqueue(new Callback() {
//请求成功时回调
@Override
public void onResponse(Call call, Response response) {
// 对返回数据进行处理
response.body();//拿到ResultData对象进行数据操作
}

//请求失败时候的回调
@Override
public void onFailure(Call call, Throwable throwable) {
System.out.println(“连接失败”);
}
});

// 发送网络请求（同步）
Response response = call.execute();
// 对返回数据进行处理
response.body().blabla;

总结

Retrofit 是一个 restful 的 HTTP 网络请求框架的封装。
网络请求的工作本质上是 OkHttp 完成，而 Retrofit 仅负责网络请求接口的封装
App应用程序通过 Retrofit 请求网络，实际上是使用 Retrofit 接口层封装请求参数、Header、Url 等信息，之后由 OkHttp 完成后续的请求操作
在服务端返回数据之后，OkHttp 将原始的结果交给 Retrofit，Retrofit根据用户的需求对结果进行解析
相对其他开源库而言代码简洁使用更加方便.