Interface WebTestClient.Builder

Enclosing interface:
WebTestClient
public static interface WebTestClient.Builder
Steps to customize the underlying WebClient via WebClient.Builder.
Since:
5.0
Author:
Rossen Stoyanchev, Brian Clozel, Sam Brannen, Michał Rowicki

  • Method Details

    • baseUrl

      WebTestClient.Builder baseUrl(String baseUrl)
      Configure a base URI as described in WebClient.create(String).

    • uriBuilderFactory

      WebTestClient.Builder uriBuilderFactory(UriBuilderFactory uriBuilderFactory)
      Provide a pre-configured UriBuilderFactory instance as an alternative to and effectively overriding baseUrl(String).

    • defaultHeader

      WebTestClient.Builder defaultHeader(String headerName, String... headerValues)
      Add the given header to all requests that haven't added it.
      Parameters:
      headerName - the header name
      headerValues - the header values

    • defaultHeaders

      WebTestClient.Builder defaultHeaders(Consumer<HttpHeaders> headersConsumer)
      Manipulate the default headers with the given consumer. The headers provided to the consumer are "live", so that the consumer can be used to overwrite existing header values, remove values, or use any of the other HttpHeaders methods.
      Parameters:
      headersConsumer - a function that consumes the HttpHeaders
      Returns:
      this builder

    • defaultCookie

      WebTestClient.Builder defaultCookie(String cookieName, String... cookieValues)
      Add the given cookie to all requests that haven't already added it.
      Parameters:
      cookieName - the cookie name
      cookieValues - the cookie values

    • defaultCookies

      WebTestClient.Builder defaultCookies(Consumer<MultiValueMap<String,String>> cookiesConsumer)
      Manipulate the default cookies with the given consumer. The map provided to the consumer is "live", so that the consumer can be used to overwrite existing header values, remove values, or use any of the other MultiValueMap methods.
      Parameters:
      cookiesConsumer - a function that consumes the cookies map
      Returns:
      this builder

    • defaultApiVersion

      WebTestClient.Builder defaultApiVersion(Object version)
      Global option to specify an API version to add to every request, if not already set.
      Parameters:
      version - the version to use
      Returns:
      this builder
      Since:
      7.0

    • apiVersionInserter

      WebTestClient.Builder apiVersionInserter(@Nullable ApiVersionInserter apiVersionInserter)
      Configure an ApiVersionInserter to abstract how an API version specified via WebTestClient.RequestHeadersSpec.apiVersion(Object) is inserted into the request.

      ApiVersionInserter exposes shortcut methods for several built-in inserter implementation types. See the class-level Javadoc of ApiVersionInserter for a list of choices.

      Parameters:
      apiVersionInserter - the inserter to use
      Since:
      7.0

    • filter

      WebTestClient.Builder filter(ExchangeFilterFunction filter)
      Add the given filter to the filter chain.
      Parameters:
      filter - the filter to be added to the chain

    • filters

      WebTestClient.Builder filters(Consumer<List<ExchangeFilterFunction>> filtersConsumer)
      Manipulate the filters with the given consumer. The list provided to the consumer is "live", so that the consumer can be used to remove filters, change ordering, etc.
      Parameters:
      filtersConsumer - a function that consumes the filter list
      Returns:
      this builder

    • codecs

      WebTestClient.Builder codecs(Consumer<ClientCodecConfigurer> configurer)
      Configure the codecs for the WebClient in the underlying ExchangeStrategies.
      Parameters:
      configurer - the configurer to apply
      Since:
      5.1.13

    • exchangeStrategies

      WebTestClient.Builder exchangeStrategies(ExchangeStrategies strategies)
      Configure the ExchangeStrategies to use.

      For most cases, prefer using codecs(Consumer) which allows customizing the codecs in the ExchangeStrategies rather than replace them. That ensures multiple parties can contribute to codecs configuration.

      By default this is set to ExchangeStrategies.withDefaults().

      Parameters:
      strategies - the strategies to use

    • responseTimeout

      WebTestClient.Builder responseTimeout(Duration timeout)
      Max amount of time to wait for responses.

      By default 5 seconds.

      Parameters:
      timeout - the response timeout value

    • clientConnector

      WebTestClient.Builder clientConnector(ClientHttpConnector connector)
      Set the ClientHttpConnector to use.

      By default, this is initialized and set internally. However, the connector may also be prepared externally and passed via WebTestClient.bindToServer(ClientHttpConnector) such as for MockMvcWebTestClient tests, and in that case you can use this from WebTestClient.mutateWith(WebTestClientConfigurer) to replace it.

      Parameters:
      connector - the connector to use
      Since:
      6.1

    • entityExchangeResultConsumer

      WebTestClient.Builder entityExchangeResultConsumer(Consumer<EntityExchangeResult<?>> consumer)
      Configure an EntityExchangeResult callback that is invoked every time after a response is fully decoded to a single entity, to a List of entities, or to a byte[]. In effect, equivalent to each and all of the below but registered once, globally: 
      client.get().uri("/accounts/1")
        .exchange()
        .expectBody(Person.class).consumeWith(exchangeResult -> ... ));

client.get().uri("/accounts")
        .exchange()
        .expectBodyList(Person.class).consumeWith(exchangeResult -> ... ));

client.get().uri("/accounts/1")
        .exchange()
        .expectBody().consumeWith(exchangeResult -> ... ));

      Note that the configured consumer does not apply to responses decoded to Flux<T> which can be consumed outside the workflow of the test client, for example via reactor.test.StepVerifier.

      Parameters:
      consumer - the consumer to apply to entity responses
      Returns:
      the builder
      Since:
      5.3.5

    • apply

      WebTestClient.Builder apply(WebTestClientConfigurer configurer)
      Apply the given configurer to this builder instance.

      This can be useful for applying pre-packaged customizations.

      Parameters:
      configurer - the configurer to apply

    • build

      WebTestClient build()
      Build the WebTestClient instance.