Retrofit简单使用

最新推荐文章于 2026-07-10 11:41:21 发布

原创最新推荐文章于 2026-07-10 11:41:21 发布 · 697 阅读

0 ·

本内容遵循CC 4.0 BY-SA版权协议

收录于

Android进阶

4.获取网络请求实例，发送网络请求，并异步处理返回数据

非官方：OkHttp3.0

非官方：详细Retrofit介绍

非官方：Retrofit源码设计模式解读

一次简单完整的网络请求处理

0.前置工作：添加依赖、权限

retrofit依赖：

implementation 'com.squareup.retrofit2:retrofit:2.4.0'

gson github

gson依赖：

implementation 'com.google.code.gson:gson:2.8.5'

网络权限：

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

demo文件结构：

1.创建返回数据Model

Repo：这里我只获取了 name 字段，其他数据都没有获取

package com.lsh123.retrofitdemo.api;

import com.lsh123.retrofitdemo.bean.Repo;

import java.util.List;

import retrofit2.Call;
import retrofit2.http.GET;
import retrofit2.http.Path;

/**
 * 每个模块创建一个网络Service
 */
public interface GitHubService {

    @GET("users/{user}/repos")
    Call<List<Repo>> listRepos(
            @Path("user") String user
    );
}

2.创建请求参数接口

GitHubService：每个模块创建一个具体的网络请求Service

package com.lsh123.retrofitdemo.api;

import com.lsh123.retrofitdemo.bean.Repo;

import java.util.List;

import retrofit2.Call;
import retrofit2.http.GET;
import retrofit2.http.Path;

/**
 * 每个模块创建一个网络Service
 */
public interface GitHubService {

    @GET("users/{user}/repos")
    Call<List<Repo>> listRepos(
            @Path("user") String user
    );
}

3.创建Retrofit对象，初始化配置

HttpUtils：获取Service实例工具类，或者Service工厂

package com.lsh123.retrofitdemo.api;

import retrofit2.Retrofit;
import retrofit2.converter.gson.GsonConverterFactory;

/**
 * 网络工具类
 */
public class HttpUtils {

    public static final String BASE_URL = "https://api.github.com/";

    public static <T> T get(Class<T> tClass){
        // 创建Retrofit
        Retrofit.Builder builder = new Retrofit.Builder();
        Retrofit retrofit = builder.baseUrl(BASE_URL)
                .addConverterFactory(GsonConverterFactory.create())
                .build();
        // 根据网络接口 获取Service
        T t = retrofit.create(tClass);
        return t;
    }
}

4.获取网络请求实例，发送网络请求，并异步处理返回数据

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        GitHubService gitHubService = HttpUtils.get(GitHubService.class);
        Call<List<Repo>> call = gitHubService.listRepos("meybeBlank");

        call.enqueue(new Callback<List<Repo>>() {
            @Override
            public void onResponse(Call<List<Repo>> call, Response<List<Repo>> response) {
                for (Repo name : response.body()) {
                    System.out.println("fengzhen  " + name.getName());
                }
                System.out.println("fengzhen  " + Thread.currentThread().getName());
            }

            @Override
            public void onFailure(Call<List<Repo>> call, Throwable t) {
                System.out.println("fengzhen  " + t.getMessage());
            }
        });
    }
}

添加请求头

拦截器 Interceptor 方式

适用于统一添加请求头。

package com.lsh123.retrofitdemo.api;

import java.io.IOException;

import okhttp3.Interceptor;
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;
import retrofit2.Retrofit;
import retrofit2.converter.gson.GsonConverterFactory;

/**
 * 网络工具类
 */
public class HttpUtils {

    public static final String BASE_URL = "https://api.github.com/";

    public static <T> T get(Class<T> tClass) {

        // 获取到OkHttpClient.Builder
        OkHttpClient.Builder httpClientBuilder = new OkHttpClient.Builder();
        // 创建拦截器
        Interceptor interceptor = new Interceptor() {
            @Override
            public Response intercept(Chain chain) throws IOException {
                Request.Builder builder = chain.request().newBuilder();
                Request newRequest = builder.header("1", "2").build();
                Response proceed = chain.proceed(newRequest);
                return proceed;
            }
        };
        // 添加请求头拦截器
        httpClientBuilder.addInterceptor(interceptor);

        // 创建Retrofit
        Retrofit.Builder builder = new Retrofit.Builder();
        Retrofit retrofit = builder.baseUrl(BASE_URL)
                .client(httpClientBuilder.build())
                .addConverterFactory(GsonConverterFactory.create())
                .build();
        // 根据网络接口 获取Service
        T t = retrofit.create(tClass);
        return t;
    }
}

Retrofit 注解方式

适用于添加单个请求的请求头。

public interface GitHubService {

    @Headers("header:123")
    @GET("users/{user}/repos")
    Call<List<Repo>> listRepos(
            @Path("user") String user
    );

}