使用 OkHttp 实现 RESTful 接口请求转发

最新推荐文章于 2025-09-23 03:35:37 发布

原创最新推荐文章于 2025-09-23 03:35:37 发布 · 265 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#okhttp #restful #后端

以下是一个完整的 Java 示例，展示如何使用 OkHttp 将 RESTful 接口请求转发到另一个服务上。

依赖配置

确保项目中引入了 OkHttp 依赖（以 Maven 为例）：

<dependency>
    <groupId>com.squareup.okhttp3</groupId>
    <artifactId>okhttp</artifactId>
    <version>4.9.3</version>
</dependency>

实现请求转发

创建一个工具类 HttpForwarder，封装转发逻辑：

import okhttp3.*;
import java.io.IOException;

public class HttpForwarder {
    private final OkHttpClient client;
    private final String targetBaseUrl; // 目标服务的基础URL

    public HttpForwarder(String targetBaseUrl) {
        this.client = new OkHttpClient();
        this.targetBaseUrl = targetBaseUrl;
    }

    public Response forwardRequest(Request originalRequest) throws IOException {
        // 构建转发请求
        Request.Builder newRequestBuilder = originalRequest.newBuilder()
                .url(targetBaseUrl + originalRequest.url().encodedPath());

        // 复制原始请求的Headers（可选：过滤或修改特定Header）
        originalRequest.headers().forEach(pair -> 
            newRequestBuilder.addHeader(pair.getFirst(), pair.getSecond())
        );

        // 执行转发请求
        return client.newCall(newRequestBuilder.build()).execute();
    }
}

示例调用

假设需要将 /api/users 的请求转发到 http://backend-service:8080：

public class Main {
    public static void main(String[] args) throws IOException {
        HttpForwarder forwarder = new HttpForwarder("http://backend-service:8080");

        // 示例：转发GET请求
        Request getRequest = new Request.Builder()
                .url("http://your-service/api/users")
                .get()
                .build();

        Response response = forwarder.forwardRequest(getRequest);
        System.out.println(response.body().string());
    }
}

处理 POST 请求

对于包含请求体的方法（如 POST/PUT），OkHttp 会自动处理请求体转发：

// 示例：转发POST请求
RequestBody body = RequestBody.create(
    "{\"name\":\"John\"}", 
    MediaType.parse("application/json")
);

Request postRequest = new Request.Builder()
    .url("http://your-service/api/users")
    .post(body)
    .build();

Response postResponse = forwarder.forwardRequest(postRequest);

高级配置

超时设置

OkHttpClient client = new OkHttpClient.Builder()
    .connectTimeout(10, TimeUnit.SECONDS)
    .readTimeout(30, TimeUnit.SECONDS)
    .build();

拦截器

添加日志拦截器（需额外依赖 okhttp-logging-interceptor）：

HttpLoggingInterceptor logging = new HttpLoggingInterceptor();
logging.setLevel(HttpLoggingInterceptor.Level.BASIC);

OkHttpClient client = new OkHttpClient.Builder()
    .addInterceptor(logging)
    .build();