Retrofit + OkHttp

caesarlew

378人浏览 · 2026-03-30 13:46:10

caesarlew · 2026-03-30 13:46:10 发布

1. 先定义接口（你写的 ApiService）
interface ApiService {
// 定义一个请求
@GET("user/info")
suspend fun getUserInfo(): UserBean
}
2. 构建 Retrofit + 拿到 ApiService实例


object RetrofitManager {
    val okHttpClient = OkHttpClient.Builder()
        .connectTimeout(10, TimeUnit.SECONDS)
        .readTimeout(10, TimeUnit.SECONDS)
        .writeTimeout(10, TimeUnit.SECONDS)

        // 1. RetryAndFollowUpInterceptor（重试、重定向）
        .addInterceptor(RetryAndFollowUpInterceptorBuilder().build())

        // 2. BridgeInterceptor（补全头、编码、Cookie）
        .addInterceptor(BridgeInterceptor())

        // 3. CacheInterceptor（HTTP 缓存）
        .addInterceptor(CacheInterceptor())

        // 4. ConnectInterceptor（建立 TCP/TLS 连接）
        .addInterceptor(ConnectInterceptor())

        // 5. CallServerInterceptor（真正发请求）
        .addInterceptor(CallServerInterceptor())

        // 可选：你自己的拦截器（日志、Token 等）
        .addInterceptor(LogInterceptor())
        .build()

    private val retrofit = Retrofit.Builder()
        .baseUrl("https://api.xxx.com/")
        .addCallAdapterFactory(DefaultCallAdapterFactory()) // CallAdapter 包装成协程挂起函数
        .addConverterFactory(GsonConverterFactory.create())
        .client(okHttpClient)
        .build()

    val apiService = retrofit.create(ApiService::class.java) 
}

ConverterFactory 数据解析工厂（必须）

GsonConverterFactory（最常用）
JacksonConverterFactory
MoshiConverterFactory（谷歌推荐）
ScalarsConverterFactory（返回 String / 基本类型）
ProtoConverterFactory（Protocol Buffers）

CallAdapterFactory 回调适配工厂（根据需求加）

负责：把默认的 Call<T> 转成你想要的返回值类型

LiveDataCallAdapterFactory（返回 LiveData）
FlowCallAdapterFactory（返回 Kotlin Flow）
~~DefaultCallAdapterFactory（内置，支持 suspend）~~
~~RxJava3CallAdapterFactory（返回 Observable / Flowable）~~
~~CoroutinesCallAdapterFactory（老版协程用）~~

3. create 方法内部：反射创建动态代理，生成一个接口的实现类对象
public <T> T create(final Class<T> service) {
return (T) Proxy.newProxyInstance(
service.getClassLoader(),
new Class<?>[]{service},
new InvocationHandler() {
@Override
public Object invoke(Object proxy, Method method, Object[] args) {
// 4. 解析方法上的注解：@GET、参数…
Request request = parseAnnotations(method, args);

// 5. 创建 OkHttp Call
okhttp3.Call okCall = okHttpClient.newCall(request);

// 6. 返回 Retrofit 的 Call
return new Call<>(okCall, converterFactory);
}
}
);
}

7.调用 call.enqueue() 异步请求，OkHttp 在子线程发请求，拿到 Response 原始字符串

8.Converter 把 ResponseBody （Json）转成对象

真正调用的地方（Activity / ViewModel 里）

lifecycleScope.launch {
val userInfo = RetrofitManager.apiService.getUserInfo()
// 拿到数据，更新 UI
}