Spring 5 中文解析测试篇-WebTestClient

3.7 WebTestClient

WebTestClient是围绕WebClient的薄壳，可用于执行请求并公开专用的流利API来验证响应。 WebTestClient经过使用模拟请求和响应绑定到WebFlux应用程序，或者它能够经过HTTP链接测试任何Web服务器。html

Kotlin用户：请参阅本节与WebTestClient的使用有关。java

3.7.1 安装

要建立WebTestClient，必须选择多个服务器设置选项之一。实际上，你是在配置WebFlux应用程序以绑定到该URL，仍是使用URL链接到正在运行的服务器。react

绑定到控制器git

如下示例显示如何建立服务器设置以一次测试一个@Controller：github

client = WebTestClient.bindToController(new TestController()).build();

前面的示例加载WebFlux Java配置并注册给定的控制器。使用模拟请求和响应对象，能够在没有HTTP服务器的状况下测试生成的WebFlux应用程序。构建器上有更多方法能够定制默认WebFlux Java配置。web

绑定到路由器功能spring

如下示例显示了如何经过RouterFunction设置服务器：编程

RouterFunction<?> route = ...
client = WebTestClient.bindToRouterFunction(route).build();

在内部，配置被传递到RouterFunctions.toWebHandler。使用模拟请求和响应对象，能够在没有HTTP服务器的状况下测试生成的WebFlux应用程序。json

绑定到ApplicationContextapi

如下示例显示了如何经过应用程序或其部分子集的Spring配置来设置服务器：

@SpringJUnitConfig(WebConfig.class) //1
class MyTests {

    WebTestClient client;

    @BeforeEach
    void setUp(ApplicationContext context) {  //2
        client = WebTestClient.bindToApplicationContext(context).build(); //3
    }
}

指定要加载的配置
注入配置
建立WebTestClient

在内部，配置被传递到WebHttpHandlerBuilder以创建请求处理链。有关更多详细信息，请参见WebHandler API。使用模拟请求和响应对象，能够在没有HTTP服务器的状况下测试生成的WebFlux应用程序。

绑定到服务器

如下服务器设置选项使你能够链接到正在运行的服务器：

client = WebTestClient.bindToServer().baseUrl("http://localhost:8080").build();

客户端构建者

除了前面介绍的服务器设置选项以外，你还能够配置客户端选项、包括基本URL、默认标头，客户端过滤器等。这些选项在bindToServer以后很容易得到。对于全部其余服务器，你须要使用configureClient()从服务器配置过渡到客户端配置，以下所示：

client = WebTestClient.bindToController(new TestController())
        .configureClient()
        .baseUrl("/test")
        .build();

3.7.2 写测试

WebTestClient提供了与WebClient相同的API，直到使用exchange()执行请求为止。 exchange()以后是连接的API工做流，用于验证响应。

一般，首先声明响应状态和标头，以下所示：

client.get().uri("/persons/1")
            .accept(MediaType.APPLICATION_JSON)
            .exchange()
            .expectStatus().isOk()
            .expectHeader().contentType(MediaType.APPLICATION_JSON)

而后，你指定如何解码和使用响应主体：

ExpectBody(Class <T>)：解码为单个对象。
ExpectBodyList(Class <T>)：解码并将对象收集到List <T>。
ExpectBody()：解码为byte []以获取JSON内容或一个空的正文。

而后，你能够为主体使用内置的断言。如下示例显示了一种方法：

client.get().uri("/persons")
        .exchange()
        .expectStatus().isOk()
        .expectBodyList(Person.class).hasSize(3).contains(person);

你还能够超越内置的断言并建立本身的断言，如如下示例所示：

import org.springframework.test.web.reactive.server.expectBody

client.get().uri("/persons/1")
        .exchange()
        .expectStatus().isOk()
        .expectBody(Person.class)
        .consumeWith(result -> {
            // custom assertions (e.g. AssertJ)...
        });

你还能够退出工做流程并得到结果，以下所示：

EntityExchangeResult<Person> result = client.get().uri("/persons/1")
        .exchange()
        .expectStatus().isOk()
        .expectBody(Person.class)
        .returnResult();

当你须要使用泛型解码为目标类型时，请寻找接受ParameterizedTypeReference而不是Class <T>的重载方法。

无内容

若是响应没有内容（或者你不在意），请使用Void.class，以确保释放资源。如下示例显示了如何执行此操做：

client.get().uri("/persons/123")
        .exchange()
        .expectStatus().isNotFound()
        .expectBody(Void.class);

或者，若是要断言没有响应内容，则能够使用相似于如下内容的代码：

client.post().uri("/persons")
        .body(personMono, Person.class)
        .exchange()
        .expectStatus().isCreated()
        .expectBody().isEmpty();

JSON内容

当你使用ExpectBody()时，响应以byte[]的形式使用。这对于原始内容声明颇有用。例如，你能够使用JSONAssert来验证JSON内容，以下所示：

client.get().uri("/persons/1")
        .exchange()
        .expectStatus().isOk()
        .expectBody()
        .json("{\"name\":\"Jane\"}")

你还能够使用JSONPath表达式，以下所示：

client.get().uri("/persons")
        .exchange()
        .expectStatus().isOk()
        .expectBody()
        .jsonPath("$[0].name").isEqualTo("Jane")
        .jsonPath("$[1].name").isEqualTo("Jason");

流式响应

要测试无限流（例如，“ text/event-stream”或“ application/stream + json”），你须要在响应状态和响应头断言以后当即退出连接的API（经过使用returnResult），以下所示示例显示：

FluxExchangeResult<MyEvent> result = client.get().uri("/events")
        .accept(TEXT_EVENT_STREAM)
        .exchange()
        .expectStatus().isOk()
        .returnResult(MyEvent.class);

如今，你能够使用Flux <T>，在到达解码对象时对其进行断言，而后在达到测试目标时在某个时候取消。咱们建议使用反应堆测试模块中的StepVerifier进行此操做，如如下示例所示：

Flux<Event> eventFlux = result.getResponseBody();

StepVerifier.create(eventFlux)
        .expectNext(person)
        .expectNextCount(4)
        .consumeNextWith(p -> ...)
        .thenCancel()
        .verify();

请求体

当涉及到构建请求时，WebTestClient提供了与WebClient相同的API，实现主要是简单的传递。请参阅WebClient文档，以获取有关如何使用正文准备请求的示例，包括提交表单数据，多部分请求等。

做者

我的从事金融行业，就任过易极付、思建科技、某网约车平台等重庆一流技术团队，目前就任于某银行负责统一支付系统建设。自身对金融行业有强烈的爱好。同时也实践大数据、数据存储、自动化集成和部署、分布式微服务、响应式编程、人工智能等领域。同时也热衷于技术分享创立公众号和博客站点对知识体系进行分享。关注公众号：青年IT男 获取最新技术文章推送！

博客地址： http://youngitman.tech

CSDN： https://blog.csdn.net/liyong1028826685

微信公众号：

技术交流群：