✅ 常用 Java HTTP 客户端汇总及使用示例

在 Java 开发中,HTTP 客户端是与服务端交互的关键组件。随着技术发展,出现了多种 HTTP 客户端库,本文汇总了常用的 Java HTTP 客户端,介绍其特点、适用场景,并附上简单使用示例,方便开发者快速选择和上手。


1.常用 HTTP 客户端一览

名称 简介 特点
HttpClient(JDK 自带) Java 11 引入的官方 HTTP 客户端 支持异步、HTTP/2,API 现代
RestTemplate Spring 提供的同步 HTTP 客户端(即将被淘汰) 简洁,适合小项目;被 WebClient 替代
WebClient Spring 5 提供的响应式 HTTP 客户端 支持响应式编程,推荐替代 RestTemplate
OkHttpClient Square 出品,轻量级高性能 HTTP 客户端 支持异步、连接池、拦截器
Apache HttpClient Apache 出品的经典 HTTP 客户端库 功能强大、稳定、支持各种高级特性
Feign 声明式 HTTP 客户端,适用于 Spring Cloud 开发效率高,集成 Ribbon/Hystrix
Retrofit Square 出品,封装 OkHttp 的声明式客户端 强大的 JSON 自动转换,适合 REST API
AsyncHttpClient 异步非阻塞 HTTP 客户端(如 Netty 实现) 高并发性能好,用于微服务场景
Vert.x WebClient Vert.x 框架的异步 HTTP 客户端 轻量级、响应式,非常适合微服务
Jetty HttpClient Jetty 提供的 HTTP 客户端实现 支持异步和 HTTP/2,常用于嵌入式

2.推荐选择场景

需求 推荐客户端
简单同步请求 RestTemplate(传统)或 HttpClient(Java 11+)
响应式或高并发 WebClient, AsyncHttpClient, Vert.x WebClient
简洁封装、声明式调用 Feign, Retrofit
高度可定制 OkHttp, Apache HttpClient

3.各客户端 GET 和 POST 示例


1. HttpClient(Java 11+)

java 复制代码
// GET 请求
HttpClient client = HttpClient.newHttpClient();

HttpRequest getRequest = HttpRequest.newBuilder()
        .uri(URI.create("https://jsonplaceholder.typicode.com/posts/1"))
        .GET()
        .build();

HttpResponse<String> getResponse = client.send(getRequest, HttpResponse.BodyHandlers.ofString());
System.out.println("GET response: " + getResponse.body());

// POST 请求
String json = "{\"title\":\"foo\",\"body\":\"bar\",\"userId\":1}";

HttpRequest postRequest = HttpRequest.newBuilder()
        .uri(URI.create("https://jsonplaceholder.typicode.com/posts"))
        .header("Content-Type", "application/json")
        .POST(HttpRequest.BodyPublishers.ofString(json))
        .build();

HttpResponse<String> postResponse = client.send(postRequest, HttpResponse.BodyHandlers.ofString());
System.out.println("POST response: " + postResponse.body());

2. RestTemplate

java 复制代码
RestTemplate restTemplate = new RestTemplate();

// GET 请求
String getResult = restTemplate.getForObject("https://jsonplaceholder.typicode.com/posts/1", String.class);
System.out.println("GET response: " + getResult);

// POST 请求
String url = "https://jsonplaceholder.typicode.com/posts";
Map<String, Object> postBody = new HashMap<>();
postBody.put("title", "foo");
postBody.put("body", "bar");
postBody.put("userId", 1);

String postResult = restTemplate.postForObject(url, postBody, String.class);
System.out.println("POST response: " + postResult);

3. WebClient

java 复制代码
WebClient client = WebClient.create();

// GET 请求
client.get()
      .uri("https://jsonplaceholder.typicode.com/posts/1")
      .retrieve()
      .bodyToMono(String.class)
      .subscribe(response -> System.out.println("GET response: " + response));

// POST 请求
String json = "{\"title\":\"foo\",\"body\":\"bar\",\"userId\":1}";

client.post()
      .uri("https://jsonplaceholder.typicode.com/posts")
      .header("Content-Type", "application/json")
      .bodyValue(json)
      .retrieve()
      .bodyToMono(String.class)
      .subscribe(response -> System.out.println("POST response: " + response));

4. OkHttpClient

java 复制代码
OkHttpClient client = new OkHttpClient();

// GET 请求
Request getRequest = new Request.Builder()
        .url("https://jsonplaceholder.typicode.com/posts/1")
        .build();

Response getResponse = client.newCall(getRequest).execute();
System.out.println("GET response: " + getResponse.body().string());

// POST 请求
MediaType JSON = MediaType.get("application/json; charset=utf-8");
String json = "{\"title\":\"foo\",\"body\":\"bar\",\"userId\":1}";

RequestBody body = RequestBody.create(json, JSON);
Request postRequest = new Request.Builder()
        .url("https://jsonplaceholder.typicode.com/posts")
        .post(body)
        .build();

Response postResponse = client.newCall(postRequest).execute();
System.out.println("POST response: " + postResponse.body().string());

5. Apache HttpClient

java 复制代码
CloseableHttpClient client = HttpClients.createDefault();

// GET 请求
HttpGet getRequest = new HttpGet("https://jsonplaceholder.typicode.com/posts/1");
CloseableHttpResponse getResponse = client.execute(getRequest);
System.out.println("GET response: " + EntityUtils.toString(getResponse.getEntity()));

// POST 请求
HttpPost postRequest = new HttpPost("https://jsonplaceholder.typicode.com/posts");
postRequest.setHeader("Content-Type", "application/json");
StringEntity entity = new StringEntity("{\"title\":\"foo\",\"body\":\"bar\",\"userId\":1}");
postRequest.setEntity(entity);

CloseableHttpResponse postResponse = client.execute(postRequest);
System.out.println("POST response: " + EntityUtils.toString(postResponse.getEntity()));

6. Feign

java 复制代码
interface JsonPlaceholderClient {
    @RequestLine("GET /posts/1")
    String getPost();

    @RequestLine("POST /posts")
    @Headers("Content-Type: application/json")
    String createPost(String json);
}

JsonPlaceholderClient client = Feign.builder()
        .target(JsonPlaceholderClient.class, "https://jsonplaceholder.typicode.com");

// GET 请求
String getResponse = client.getPost();
System.out.println("GET response: " + getResponse);

// POST 请求
String json = "{\"title\":\"foo\",\"body\":\"bar\",\"userId\":1}";
String postResponse = client.createPost(json);
System.out.println("POST response: " + postResponse);

7. Retrofit

java 复制代码
public interface ApiService {
    @GET("posts/1")
    Call<Post> getPost();

    @POST("posts")
    Call<Post> createPost(@Body Post post);
}

Retrofit retrofit = new Retrofit.Builder()
        .baseUrl("https://jsonplaceholder.typicode.com/")
        .addConverterFactory(GsonConverterFactory.create())
        .build();

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

// GET 请求
service.getPost().enqueue(new Callback<Post>() {
    public void onResponse(Call<Post> call, Response<Post> response) {
        System.out.println("GET response: " + response.body());
    }
    public void onFailure(Call<Post> call, Throwable t) {
        t.printStackTrace();
    }
});

// POST 请求
Post newPost = new Post("foo", "bar", 1);
service.createPost(newPost).enqueue(new Callback<Post>() {
    public void onResponse(Call<Post> call, Response<Post> response) {
        System.out.println("POST response: " + response.body());
    }
    public void onFailure(Call<Post> call, Throwable t) {
        t.printStackTrace();
    }
});

8. AsyncHttpClient

java 复制代码
AsyncHttpClient client = Dsl.asyncHttpClient();

// GET 请求
client.prepareGet("https://jsonplaceholder.typicode.com/posts/1")
      .execute()
      .toCompletableFuture()
      .thenAccept(response -> System.out.println("GET response: " + response.getResponseBody()))
      .join();

// POST 请求
String json = "{\"title\":\"foo\",\"body\":\"bar\",\"userId\":1}";

client.preparePost("https://jsonplaceholder.typicode.com/posts")
      .setHeader("Content-Type", "application/json")
      .setBody(json)
      .execute()
      .toCompletableFuture()
      .thenAccept(response -> System.out.println("POST response: " + response.getResponseBody()))
      .join();

9. Vert.x WebClient

Vert.x 是一个轻量级、响应式的应用框架,其 WebClient 是异步非阻塞的 HTTP 客户端,非常适合高并发和微服务场景。

java 复制代码
Vertx vertx = Vertx.vertx();
WebClient client = WebClient.create(vertx);

// GET 请求
client.getAbs("https://jsonplaceholder.typicode.com/posts/1")
      .send(ar -> {
          if (ar.succeeded()) {
              System.out.println("GET response: " + ar.result().bodyAsString());
          } else {
              ar.cause().printStackTrace();
          }
      });

// POST 请求
JsonObject json = new JsonObject()
        .put("title", "foo")
        .put("body", "bar")
        .put("userId", 1);

client.postAbs("https://jsonplaceholder.typicode.com/posts")
      .putHeader("Content-Type", "application/json")
      .sendJsonObject(json, ar -> {
          if (ar.succeeded()) {
              System.out.println("POST response: " + ar.result().bodyAsString());
          } else {
              ar.cause().printStackTrace();
          }
      });

10. Jetty HttpClient

Jetty 提供的 HTTP 客户端,支持异步和 HTTP/2,适合嵌入式和高性能场景。

java 复制代码
HttpClient client = new HttpClient();
client.start();

// GET 请求
ContentResponse getResponse = client.GET("https://jsonplaceholder.typicode.com/posts/1");
System.out.println("GET response: " + getResponse.getContentAsString());

// POST 请求
Request postRequest = client.POST("https://jsonplaceholder.typicode.com/posts");
postRequest.header("Content-Type", "application/json");
postRequest.content(new StringContentProvider("{\"title\":\"foo\",\"body\":\"bar\",\"userId\":1}"));

ContentResponse postResponse = postRequest.send();
System.out.println("POST response: " + postResponse.getContentAsString());

client.stop();

4.结语

随着 Java 生态的发展,HTTP 客户端的选择也愈发丰富和多样。无论是 JDK 自带的现代 HttpClient,还是功能强大的第三方库如 OkHttp、Apache HttpClient,以及适合响应式编程的 WebClient,都各有优势,满足不同场景需求。

选择合适的 HTTP 客户端,能极大提升开发效率和应用性能。希望本文的汇总与示例,能帮助你快速掌握各类客户端的基本用法,并根据项目需求做出最佳选择。

如果你有更多使用心得或想了解更深入的高级功能,欢迎留言交流,我们一起成长!

相关推荐
武昌库里写JAVA2 分钟前
【MySQL】MySQL数据库如何改名
java·vue.js·spring boot·sql·学习
钟离墨笺19 分钟前
Go 语言-->指针
开发语言·后端·golang
花落人散处1 小时前
SpringAI——接入高德MCP服务
java·后端
超浪的晨1 小时前
Java 代理机制详解:从静态代理到动态代理,彻底掌握代理模式的原理与实战
java·开发语言·后端·学习·代理模式·个人开发
天天摸鱼的java工程师1 小时前
🧠 MySQL 索引结构有哪些?优缺点是什么?【原理 + 场景实战】
java·后端·面试
咖啡の猫1 小时前
bash的特性-bash中的引号
开发语言·chrome·bash
java叶新东老师1 小时前
idea提交时忽略.class、.iml文件和文件夹或目录的方法
java·开发语言
飞翔的佩奇1 小时前
Java项目:基于SSM框架实现的社区团购管理系统【ssm+B/S架构+源码+数据库+毕业论文+答辩PPT+远程部署】
java·数据库·vue.js·毕业设计·mybatis·答辩ppt·社区团购
走过,莫回头1 小时前
在OpenMP中,#pragma omp的使用
开发语言·openmp
TDengine (老段)1 小时前
TDengine 转化函数 TO_TIMESTAMP 用户手册
java·大数据·数据库·物联网·时序数据库·tdengine·涛思数据