Class UserWebtestClientConfigurer

java.lang.Object

org.springframework.test.web.reactive.server.UserWebtestClientConfigurer

All Implemented Interfaces:

WebtestClientConfigurer

public final class UserWebtestClientConfigurer
extends Object
implements WebtestClientConfigurer

WebtestClientConfigurer that modifies WebFlux mock server requests by setting their SslInfo.

You can apply the configurer to a WebtestClient.Builder:

WebtestClient client = webtestClientBuilder
        .apply(UserWebtestClientConfigurer.x509(certificate))
        .build();

Or mutate an already built WebtestClient:

WebtestClient newClient =
        client.mutateWith(UserWebtestClientConfigurer.x509(certificate));

Note: This configurer is applicable only to WebFlux mock server setup. For a WebtestClient.Builder with a live server setup, or a non-WebFlux, mock server, an IllegalStateException is raised.

For tests with a MockMvc server, refer to a similar facility to set the user identity per request through Spring Security's SecurityMockMvcRequestPostProcessors.

Since:

7.0

Author:

Rossen Stoyanchev

Method Summary

Modifier and Type	Method	Description
void	afterConfigurerAdded(WebtestClient.Builder builder, @Nullable WebHttpHandlerBuilder httpHandlerBuilder, @Nullable ClientHttpConnector connector)	Use methods on WebtestClient.Builder to modify test client settings.
static UserWebtestClientConfigurer	sslInfo(SslInfo info)	Create a configurer with the given SslInfo.
static UserWebtestClientConfigurer	x509(X509Certificate... certificates)	Create a configurer with the given X509 certificate(s).

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

afterConfigurerAdded

public void afterConfigurerAdded(WebtestClient.Builder builder,
 @Nullable WebHttpHandlerBuilder httpHandlerBuilder,
 @Nullable ClientHttpConnector connector)

Description copied from interface: WebtestClientConfigurer

Use methods on WebtestClient.Builder to modify test client settings. For a mock WebFlux server, use WebHttpHandlerBuilder to customize server configuration. For a MockMvc server, mutate the MockMvcHttpConnector and set it on WebtestClient.Builder.

Specified by:

afterConfigurerAdded in interface WebtestClientConfigurer

Parameters:

builder - the WebtestClient builder for test client changes

httpHandlerBuilder - for mock WebFlux server settings

connector - the connector in use

x509

public static UserWebtestClientConfigurer x509(X509Certificate... certificates)

Create a configurer with the given X509 certificate(s).

sslInfo

public static UserWebtestClientConfigurer sslInfo(SslInfo info)

Create a configurer with the given SslInfo.