微服务架构之Spring Boot（五十八）

35.使用 WebClient 调用REST服务

如果您的类路径上有Spring WebFlux，您还可以选择使用 WebClient 来调用远程REST服务。与 RestTemplate 相比，该客户端具有更多功能

感并且完全被动。您可以在Spring框架文档的专用部分中了解有关 WebClient 的更多信息 。

Spring Boot为您创建并预先配置 WebClient.Builder ; 强烈建议将其注入您的组件并使用它来创建 WebClient 实例。Spring Boot正在配置该

构建器以共享HTTP资源，以与服务器相同的方式反映编解码器设置（请参阅 WebFlux HTTP编解码器自动配置）等。

以下代码显示了一个典型示例：

@Service

public class MyService {

private final WebClient webClient;

public MyService(WebClient.Builder webClientBuilder) {

this.webClient = webClientBuilder.baseUrl("http://example.org").build();

}

public Mono<Details> someRestCall(String name) {

return this.webClient.get().uri("/{name}/details", name)

.retrieve().bodyToMono(Details.class);

}

}

35.1 WebClient运行时

Spring Boot将自动检测用于驱动 WebClient 的 ClientHttpConnector ，具体取决于应用程序类路径上可用的库。目前，支持Reactor Netty

和Jetty RS客户端。

spring-boot-starter-webflux 启动程序默认依赖于 io.projectreactor.netty:reactor-netty ，它带来了服务器和客户端实现。如果您

选择将Jetty用作反应式服务器，则应该在Jetty Reactive HTTP客户端库 org.eclipse.jetty:jetty-reactive-httpclient 上添加依赖项。

对服务器和客户端使用相同的技术具有优势，因为它将自动在客户端和服务器之间共享HTTP资源。

开发人员可以通过提供自定义 ReactorResourceFactory 或 JettyResourceFactory bean覆盖Jetty和Reactor Netty的资源配置 - 这将应用

于客户端和服务器。

如果您希望覆盖客户端的该选项，您可以定义自己的 ClientHttpConnector bean并完全控制客户端配置。

35.2 WebClient自定义

WebClient 自定义有三种主要方法，具体取决于您希望自定义应用的广泛程度。

要使任何自定义的范围尽可能窄，请注入自动配置的 WebClient.Builder ，然后根据需要调用其方法。WebClient.Builder 实例是有状态

的：构建器上的任何更改都会反映在随后使用它创建的所有客户端中。如果要使用相同的构建器创建多个客户端，还可以考虑使

用 WebClient.Builder other = builder.clone(); 克隆构建器。

要对所有 WebClient.Builder 实例进行应用程序范围的附加自定义，您可以声明 WebClientCustomizer beans并在注入点本地更

改 WebClient.Builder 。

最后，您可以回退到原始API并使用 WebClient.create() 。在这种情况下，不应用自动配置或 WebClientCustomizer 。

36.验证

只要JSR-303实现（例如Hibernate验证器）在类路径上，Bean验证1.1支持的方法验证功能就会自动启用。这使得bean方法可以使

用 javax.validation 对其参数和/或返回值的约束进行注释。具有此类带注释方法的目标类需要在类型级别使用 @Validated 注释进行注释，

以便搜索其内联约束注释的方法。

例如，以下服务触发第一个参数的验证，确保其大小在8到10之间：

@Service

@Validated

public class MyBean {

public Archive findByCodeAndAuthor(@Size(min = 8, max = 10) String code,

Author author) {

...

}

}