架构视界
主页
企业架构
  • 方案总览
  • 业财一体
  • 企业中台
  • 组织与绩效
  • 流程治理
数据收集与分析
  • 转型总览
  • 信息化阶段
  • 数字化解决方案
  • 智数化解决方案
  • 智能化解决方案
  • 产品设计
  • 项目管理
全栈软件工程
AI 原生软件工程
方法论
博客
  • 资源导航
  • 效率工具
  • 展示专区
主页
企业架构
  • 方案总览
  • 业财一体
  • 企业中台
  • 组织与绩效
  • 流程治理
数据收集与分析
  • 转型总览
  • 信息化阶段
  • 数字化解决方案
  • 智数化解决方案
  • 智能化解决方案
  • 产品设计
  • 项目管理
全栈软件工程
AI 原生软件工程
方法论
博客
  • 资源导航
  • 效率工具
  • 展示专区
  • 标签索引
  • 2024年

    • 勇闯大A:美债与美元周期
    • 勇闯大A:交易纪律与自我管理
    • 勇闯大A:交易系统分层
    • 勇闯大A:买卖点与止损规则
    • 勇闯大A:债券与资金流向
    • 勇闯大A:微观、宏观与周期
    • Mac 开发环境:新机配置清单
    • 勇闯大A:内外盘与换手率
    • 会计管理:财报阅读与管理报表
    • 会计基础:记账原理与分录
    • 财务入门:财务体系全景
  • 2023年

    • 境外投资:泰国 BOI 申请实务
  • 2022年

    • 企业架构:故障管理与分级响应
    • 企业架构:技术债务的识别、度量与偿还
  • 2021年

    • Python 数据分析:员工分布可视化
    • Python 数据分析:IP 访问折线图
    • Python 数据分析:IP 词云图
    • Redis:RediSearch 全文检索
    • Rust 基础:第一个 CLI 程序
    • Rust 基础:所有权机制
    • Rust 基础:函数与控制流
    • Rust 基础:变量与数据类型
    • Rust 基础:入门与开发环境
    • 企业架构:分布式系统设计
    • 企业架构:编程式权限设计
    • JVM 调优:启动参数与 GC 日志
    • MyBatis 批量插入:三种写法对比
    • 测试:Spring Boot 分层 Mock
    • Redis:布隆过滤器判断元素存在
    • Jenkins:安装配置与应用部署
    • WebClient:非阻塞 HTTP 客户端
    • Drone:Docker 部署轻量 CI
    • Spring AOP:操作审计日志落库
    • Redisson:分布式锁与 RedLock
    • MyBatis 拦截器:雪花算法主键
    • Netty:线程模型与网络编程
    • Redis:SCAN 游标遍历大键空间
    • Jenkins:单机部署与升级脚本
    • Mac:Neo4j 与 Jupyter 安装
    • JavaFX:OpenJDK 11 环境配置
    • Mac:用 jenv 管理 JDK 版本
    • Redis:有序集合实现延时队列
    • Spring Boot 日志:MDC 串联链路
    • 定时任务:Spring 调度与 Cron
    • GoAccess:Nginx 日志分析
    • MyBatis 拦截器:慢 SQL 分析
    • Lucene:倒排索引与中文分词
    • 分布式锁:三种实现方案对比
    • 学习技巧:减少学习排斥心理
    • 动态数据源:多租户数据路由
    • Compose:Spring Boot 三件套
    • Java 阻塞队列:源码与用法
    • Redis:Docker Compose 哨兵
    • Redis:Docker Compose 主从
    • 网络通信:TCP/IP 与 HTTP 基础
  • 2020年

    • 延时队列:DelayQueue 与 Redis 实现
    • MySQL 基础:员工库导入实践
    • 雪花算法:分布式 ID 生成
    • Redis:地理位置查询
    • 抓包:Wireshark 与 Tcpdump
    • SPI:JDK 与 Spring 扩展机制
    • ZooKeeper:概念与集群搭建
    • Spring Boot:集成 JMH 基准测试
    • Wireshark:抓包工具入门
    • Compose:Redis 与 MySQL
    • CentOS 7:Docker 安装部署
    • Netty:源码阅读环境搭建
    • MySQL 基础:SQL 常见用法
    • CentOS 7:Selenium 运行环境
    • Nginx:HTTPS 证书配置
    • JMH:基准测试与 Spring Boot 集成
    • Spring Boot:指定 Tomcat 版本
    • Eureka:实例上下线告警
    • 钉钉告警:应用异常与实例上下线
    • JVM:内存布局、类加载与调优
    • Git:rebase 合并多次提交
    • CentOS 7:OpenResty 部署
  • 2019年

    • Redis CLI:macOS 安装与使用
    • Nginx:访问日志格式
    • 工程规范:可维护代码的写法
    • IntelliJ IDEA:常用插件
    • SkyWalking:源码阅读环境搭建
    • Spring Boot:Redis 超时配置
    • gRPC:ProtoBuf 定义与代码生成
    • Arthas:Java 线上问题诊断
    • Redis:缓存穿透与击穿防护
    • Docker 部署:Elasticsearch
    • Docker 部署:MySQL 5.7 单机
    • Spring Redis:字符串命令封装
    • Docker 部署:ZooKeeper 运行
    • Docker 部署:Redis 单机运行
    • Dubbo:Spring Boot 微服务集成
    • CentOS 7:CMake 源码编译安装
    • 性能度量:吞吐量与 QPS 指标
    • Java 递归:从笔试题到经典问题
    • CentOS 7:ELK 日志平台部署
    • CentOS 7:SonarQube 部署
    • Selenium:Chrome 浏览器自动化
    • JJWT:令牌生成与解析测试
    • Spring 源码:阅读环境搭建
    • JUnit 4:注解、断言与参数化
    • JWT:令牌结构与签名机制
    • FastDFS:架构与文件存取机制
    • XPath:XML 文档节点定位
    • Redis 基础:锁、队列与事务
    • Redis 基础:数据类型与命令
    • MyBatis:Slf4j 日志接入
    • MyBatis:H2 单元测试与 SQL 日志
    • 源码阅读:开源项目环境搭建
    • Git 配置:命令清单与作用域
    • Java 核心:面向对象与基础类型
    • Java 核心:关键字、异常与反射
    • Java 核心:多线程基础
    • Java 核心:同步关键字与线程池
    • Java 核心:锁与并发工具
    • Java 核心:语言基础与并发
    • Dubbo:远程调用与服务治理
    • Java 集合:框架总览与实现对比
    • Maven:生命周期与常用命令
    • MyBatis:执行流程与插件机制
    • Spring:IoC 容器与依赖注入
    • Spring:AOP 与自动装配
    • Spring:事务与启动流程
    • Spring:IoC、AOP 与事务
    • Spring MVC:请求分发与注解
    • MySQL:架构与索引
    • MySQL:事务、锁与 MVCC
    • MySQL:日志与 SQL 优化
    • MySQL:架构、事务与优化
    • Redis 基础:持久化与线程模型
  • 2018年

    • Java HashMap:扩容机制与哈希冲突
    • Java 集合:HashSet 去重原理
    • Java 基础:交换两个变量的值
    • Spring MVC:零 web.xml 改造
    • Mac 开发环境:新机配置清单
    • Log4j:日志分级与按业务拆分
    • Modbus:工业通信协议与 RTU 帧
    • MySQL 基础:子查询与连接查询
    • MySQL 基础:库与表操作
    • MySQL 基础:表操作与查询
    • MySQL 基础:约束、引擎与数据类型
    • MySQL 基础:库表、约束与类型
    • Java 集合:Vector 与 Stack
    • Java 集合:Vector 与 Stack
    • RabbitMQ:CentOS 7 单机部署
    • Redis:CentOS 7 单机部署
    • MongoDB:CentOS 7 单机部署
    • Linux:常用系统与运维命令
    • 注册中心:Eureka 与 ZooKeeper
    • MySQL:CentOS 7 单机部署
    • Git 分支:主分支与临时分支
    • CentOS 7:Java 开发环境部署
    • Java 集合:LinkedList 双向链表
    • Java 集合:ArrayList 动态数组
    • Spring AOP:注解方式实现切面
← 返回博客

WebClient:非阻塞 HTTP 客户端

2021年5月18日 #后端开发 #Spring #Java

WebClient

Spring 有两个web客户端的实现,一个是RestTemplate另一个是spring5的响应代替WebClient。

WebClient是一个以Reactive方式处理HTTP请求的非阻塞客户端。

  • RestTemplate是阻塞客户端

    • 它基于thread-pre-requset模型。
    • 这意味着线程将阻塞,直到 Web 客户端收到响应。阻塞代码的问题是由于每个线程消耗了一些内存和 CPU 周期。当出现慢速请求的时候,等待结果的线程会堆积起来,将导致创建更多的线程、消耗更多的资源。频繁切换CPU资源也会降低性能。
  • WebClient是异步、非阻塞的方案。

    • WebClient将为每个事件创建类似于“任务”的东西。在幕后,Reactive 框架会将这些“任务”排队并仅在适当的响应可用时执行它们。

    • WebClient是Spring WebFlux库的一部分。因此,我们还可以使用具有反应类型(Mono和Flux的功能性、流畅的 API 作为声明性组合来编写客户端代码。

    • 底层支持的库

      • Reactor Netty - ReactorClientHttpConnector
      • Jetty ReactiveStream HttpClient - JettyHttpConnector
  • 关于IDEA开启 Reactive Streams DEBUG

演示代码

基础用法

创建WebClient

WebClient.create();
WebClient.builder();

请求方法

   WebClient webClient =   WebClient.create();
        webClient.get();
        webClient.post();
        webClient.delete();
        webClient.put();
        webClient.patch();
        webClient.options();

获取结果

// exchangeToMono方法 
// exchangeToFlux方法
Mono<Object> entityMono = webClient.get()
                .uri("/persons/1")
                .accept(MediaType.APPLICATION_JSON)
                .exchangeToMono(response -> {
                    if (response.statusCode().equals(HttpStatus.OK)) {
                        return response.bodyToMono(Object.class);
                    } else if (response.statusCode().is4xxClientError()) {
                        return response.bodyToMono(Object.class);
                    } else {
                        return Mono.error((Supplier<? extends Throwable>) response.createException());
                    }
                });

        Flux<Object> entityFlux = webClient.get()
                .uri("/persons")
                .accept(MediaType.APPLICATION_JSON)
                .exchangeToFlux(response -> {
                    if (response.statusCode().equals(HttpStatus.OK)) {
                        return response.bodyToFlux(Object.class);
                    } else if (response.statusCode().is4xxClientError()) {
                        return response.bodyToMono(Object.class).flux();
                    } else {
                        return Flux.error((Supplier<? extends Throwable>) response.createException());
                    }
                });

异常处理

   .doOnError(t -> log.error("Error: ", t)) // 异常回调
   .doFinally(s -> log.info("Finally ")) // Finally 回调

请求体

// 直接使用bodyValue方法
RequestHeadersSpec<?> headersSpec = bodySpec.bodyValue("data");
// 或者Publisher
RequestHeadersSpec<?> headersSpec = bodySpec.body(Mono.just(new Foo("name")), Foo.class);
  

代码演示

@SpringBootApplication(exclude = {DataSourceAutoConfiguration.class})
public class AppApplication {

    public static void main(String[] args) {
        ApplicationContext applicationContext = SpringApplication.run(AppApplication.class, args);
    }
    // 声明默认的WebClient
    @Bean
    public WebClient register() {
        return WebClient.create();
    }
}

@RestController
@RequestMapping("/")
@Slf4j
public class AppController {

    @Autowired
    private WebClient webClient;

    @PostMapping("/list")
    public Flux<UserVo> list() {
        List<UserVo> userList = new ArrayList<>();
        userList.add(new UserVo("1", "张三"));
        userList.add(new UserVo("2", "王五"));
        return Flux.fromIterable(userList);
    }

    @GetMapping("/{id}")
    public Mono<UserVo> info(@PathVariable(value = "id") String id) {
        return Mono.just(new UserVo(id, "某某"));
    }

    @GetMapping("/ip/info")
    public Mono<String> ip() {
        String url = "https://myip.ipip.net/";
        Mono<String> body = webClient.get()
                .uri(url)
                .header(HttpHeaders.CONTENT_TYPE, MediaType.APPLICATION_JSON_VALUE) // 响应的格式json
                .acceptCharset(StandardCharsets.UTF_8) // 编码集 utf-8
                .exchangeToMono(response -> {
                    if (response.statusCode().equals(HttpStatus.OK)) {
                        return response.bodyToMono(String.class);
                    } else {
                        return response.createException().flatMap(Mono::error);
                    }
                })
                .doOnError(t -> log.error("Error: ", t)) // 异常回调
                .doFinally(s -> log.error("Finally ")) // Finally 回调
                .subscribeOn(Schedulers.single());
        return body;
    }

}

@Data
@AllArgsConstructor
@NoArgsConstructor
public class UserVo {

    private String uid;

    private String name;
}

接口Mock测试

  • 添加@WebFluxTest注解
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@BootstrapWith(WebFluxTestContextBootstrapper.class)
@ExtendWith(SpringExtension.class)
@OverrideAutoConfiguration(enabled = false)
@TypeExcludeFilters(WebFluxTypeExcludeFilter.class)
@AutoConfigureCache
@AutoConfigureJson
@AutoConfigureWebFlux // 自动装配WebFlux
@AutoConfigureWebTestClient // 自动装配WebTestClient
@ImportAutoConfiguration
public @interface WebFluxTest {
  • 代码
@Slf4j
@ExtendWith(SpringExtension.class)
@ActiveProfiles("dev")
@WebFluxTest
public class AppApplicationMockTest {

    @Autowired
    private WebTestClient webTestClient;

    @MockBean
    private AppController appController;

    @Test
    @Disabled
    public void get() {
        UserVo user = new UserVo("1", "张三");
        Mockito.when(appController.info("1")).thenReturn(Mono.just(user));
        EntityExchangeResult<UserVo> result = webTestClient.get()
                .uri("/1")
                .exchange()
                .expectStatus().isOk()
                .expectBody(UserVo.class)
                .returnResult();
        log.info("{}", result);
    }

    @Test
    @Disabled
    public void list() {
        List<UserVo> userList = new ArrayList<>();
        userList.add(new UserVo("1", "张三"));
        userList.add(new UserVo("2", "王武"));
        Mockito.when(appController.list()).thenReturn(Flux.fromIterable(userList));
        EntityExchangeResult<List<UserVo>> result = webTestClient.post()
                .uri("/list")
                .exchange()
                .expectStatus().isOk()
                .expectBodyList(UserVo.class)
                .returnResult();
        log.info("{}", result);
    }

}
  • Console
[main]  
> GET /1
> WebTestClient-Request-Id: [1]

No content

< 200 OK OK
< Content-Type: [application/json]
< Content-Length: [27]

{"uid":"1","name":"张三"}

[main]  
> POST /list
> WebTestClient-Request-Id: [1]

No content

< 200 OK OK
< Content-Type: [application/json]

[{"uid":"1","name":"张三"},{"uid":"2","name":"王武"}]

接口测试

  • 添加@AutoConfigureWebTestClient 启用WebTestClient。
@Slf4j
@ExtendWith(SpringExtension.class)
@SpringBootTest(classes = AppApplication.class, webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
@ActiveProfiles("dev")
@AutoConfigureWebTestClient
public class AppApplicationTest {

    @Autowired
    private WebTestClient webTestClient;

    @Test
    @Disabled
    public void get() {
        EntityExchangeResult<UserVo> result = webTestClient.get()
                .uri("/1")
                .exchange()
                .expectStatus().isOk()
                .expectBody(UserVo.class)
                .returnResult();
        log.info("{}", result);
    }

    @Test
    @Disabled
    public void ip() {
        EntityExchangeResult<String> result = webTestClient.get()
                .uri("/ip/info")
                .exchange()
                .expectStatus().isOk()
                .expectBody(String.class)
                .returnResult();
        log.info("{}", result);
    }

    @Test
    @Disabled
    public void list() {
        EntityExchangeResult<List<UserVo>> result = webTestClient.post()
                .uri("/list")
                .exchange()
                .expectStatus().isOk()
                .expectBodyList(UserVo.class)
                .returnResult();
        log.info("{}", result);
    }

}
  • Console
[main]  
> GET /1
> WebTestClient-Request-Id: [1]

No content

< 200 OK OK
< Content-Type: [application/json]
< Content-Length: [27]

{"uid":"1","name":"某某"}

[reactor-http-nio-3]  Finally 
[main]  
> GET /ip/info
> WebTestClient-Request-Id: [1]

No content

< 200 OK OK
< Content-Type: [text/plain;charset=UTF-8]
< Content-Length: [67]

当前 IP:000.000.00.0  来自于:中国 浙江 杭州  电信

[main]  
> POST /list
> WebTestClient-Request-Id: [1]

No content

< 200 OK OK
< Content-Type: [application/json]

[{"uid":"1","name":"张三"},{"uid":"2","name":"王五"}]


小结

WebClient 基于 Reactor Netty 做非阻塞调用,用 exchangeToMono 按状态码分流,4xx 读响应体、其余经 createException 转错误流;Mock 用 @WebFluxTest 加 WebTestClient,起真实容器则改 @AutoConfigureWebTestClient。

最近更新: 2026/11/20 22:16
Contributors: 庆峰
Prev
Jenkins:安装配置与应用部署
Next
Drone:Docker 部署轻量 CI