Class MockServerHttpRequest

java.lang.Object

org.springframework.http.server.reactive.AbstractServerHttpRequest

org.springframework.mock.http.server.reactive.MockServerHttpRequest

All Implemented Interfaces:

HttpMessage, HttpRequest, ReactiveHttpInputMessage, ServerHttpRequest

public final class MockServerHttpRequest
extends AbstractServerHttpRequest

Mock extension of AbstractServerHttpRequest for use in tests without an actual server. Use the static methods to obtain a builder.

Since:

5.0

Author:

Rossen Stoyanchev

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	MockServerHttpRequest.BaseBuilder<B extends MockServerHttpRequest.BaseBuilder<B>>	Request builder exposing properties not related to the body.
static interface	MockServerHttpRequest.BodyBuilder	A builder that adds a body to the request.

Nested classes/interfaces inherited from interface ServerHttpRequest

ServerHttpRequest.Builder

Method Summary

Modifier and Type	Method	Description
static MockServerHttpRequest.BaseBuilder<?>	delete(String urlTemplate, @Nullable Object... uriVars)	HTTP DELETE variant.
static MockServerHttpRequest.BaseBuilder<?>	get(String urlTemplate, @Nullable Object... uriVars)	Create an HTTP GET builder with the given URI template.
reactor.core.publisher.Flux<DataBuffer>	getBody()	Return the body of the message as a Publisher.
@Nullable InetSocketAddress	getLocalAddress()	Return the local address the request was accepted on, if available.
<T> T	getNativeRequest()	Return the underlying server response.
@Nullable InetSocketAddress	getRemoteAddress()	Return the remote address where this request is connected to, if available.
static MockServerHttpRequest.BaseBuilder<?>	head(String urlTemplate, @Nullable Object... uriVars)	HTTP HEAD variant.
protected MultiValueMap<String, HttpCookie>	initCookies()	Obtain the cookies from the underlying "native" request and adapt those to an HttpCookie map.
protected @Nullable SslInfo	initSslInfo()	Obtain SSL session information from the underlying "native" request.
static MockServerHttpRequest.BodyBuilder	method(HttpMethod method, String uri, @Nullable Object... vars)	Alternative to method(HttpMethod, URI) that accepts a URI template.
static MockServerHttpRequest.BodyBuilder	method(HttpMethod method, URI url)	Create a builder with the given HTTP method and a URI.
static MockServerHttpRequest.BaseBuilder<?>	options(String urlTemplate, @Nullable Object... uriVars)	HTTP OPTIONS variant.
static MockServerHttpRequest.BodyBuilder	patch(String urlTemplate, @Nullable Object... uriVars)	HTTP PATCH variant.
static MockServerHttpRequest.BodyBuilder	post(String urlTemplate, @Nullable Object... uriVars)	HTTP POST variant.
static MockServerHttpRequest.BodyBuilder	put(String urlTemplate, @Nullable Object... uriVars)	HTTP PUT variant.

Methods inherited from class AbstractServerHttpRequest

getAttributes, getCookies, getHeaders, getId, getMethod, getPath, getQueryParams, getSslInfo, getURI, initId, initLogPrefix, initQueryParams, setAttributesSupplier

Methods inherited from class Object

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

Methods inherited from interface ServerHttpRequest

mutate

Method Details

getLocalAddress

public @Nullable InetSocketAddress getLocalAddress()

Description copied from interface: ServerHttpRequest

Return the local address the request was accepted on, if available.

getRemoteAddress

public @Nullable InetSocketAddress getRemoteAddress()

Description copied from interface: ServerHttpRequest

Return the remote address where this request is connected to, if available.

initSslInfo

protected @Nullable SslInfo initSslInfo()

Description copied from class: AbstractServerHttpRequest

Obtain SSL session information from the underlying "native" request.

Specified by:

initSslInfo in class AbstractServerHttpRequest

Returns:

the session information, or null if none available

getBody

public reactor.core.publisher.Flux<DataBuffer> getBody()

Description copied from interface: ReactiveHttpInputMessage

Return the body of the message as a Publisher.

Returns:

the body content publisher

initCookies

protected MultiValueMap<String, HttpCookie> initCookies()

Description copied from class: AbstractServerHttpRequest

Obtain the cookies from the underlying "native" request and adapt those to an HttpCookie map. The return value is turned into an immutable map and cached.

Note that this method is invoked lazily on access to AbstractServerHttpRequest.getCookies(). Subclasses should synchronize cookie initialization if the underlying "native" request does not provide thread-safe access to cookie data.

Specified by:

initCookies in class AbstractServerHttpRequest

getNativeRequest

public <T> T getNativeRequest()

Description copied from class: AbstractServerHttpRequest

Return the underlying server response.

Note: This is exposed mainly for internal framework use such as WebSocket upgrades in the spring-webflux module.

Specified by:

getNativeRequest in class AbstractServerHttpRequest

get

public static MockServerHttpRequest.BaseBuilder<?> get(String urlTemplate,
 @Nullable Object... uriVars)

Create an HTTP GET builder with the given URI template. The given URI may contain query parameters, or those may be added later via queryParam builder methods.

Parameters:

urlTemplate - a URL template; the resulting URL will be encoded

uriVars - zero or more URI variables

Returns:

the created builder

head

public static MockServerHttpRequest.BaseBuilder<?> head(String urlTemplate,
 @Nullable Object... uriVars)

HTTP HEAD variant. See get(String, Object...) for general info.

Parameters:

urlTemplate - a URL template; the resulting URL will be encoded

uriVars - zero or more URI variables

Returns:

the created builder

post

public static MockServerHttpRequest.BodyBuilder post(String urlTemplate,
 @Nullable Object... uriVars)

HTTP POST variant. See get(String, Object...) for general info.

Parameters:

urlTemplate - a URL template; the resulting URL will be encoded

uriVars - zero or more URI variables

Returns:

the created builder

put

public static MockServerHttpRequest.BodyBuilder put(String urlTemplate,
 @Nullable Object... uriVars)

HTTP PUT variant. See get(String, Object...) for general info. queryParam builder methods.

Parameters:

urlTemplate - a URL template; the resulting URL will be encoded

uriVars - zero or more URI variables

Returns:

the created builder

patch

public static MockServerHttpRequest.BodyBuilder patch(String urlTemplate,
 @Nullable Object... uriVars)

HTTP PATCH variant. See get(String, Object...) for general info.

Parameters:

urlTemplate - a URL template; the resulting URL will be encoded

uriVars - zero or more URI variables

Returns:

the created builder

delete

public static MockServerHttpRequest.BaseBuilder<?> delete(String urlTemplate,
 @Nullable Object... uriVars)

HTTP DELETE variant. See get(String, Object...) for general info.

Parameters:

urlTemplate - a URL template; the resulting URL will be encoded

uriVars - zero or more URI variables

Returns:

the created builder

options

public static MockServerHttpRequest.BaseBuilder<?> options(String urlTemplate,
 @Nullable Object... uriVars)

HTTP OPTIONS variant. See get(String, Object...) for general info.

Parameters:

urlTemplate - a URL template; the resulting URL will be encoded

uriVars - zero or more URI variables

Returns:

the created builder

method

public static MockServerHttpRequest.BodyBuilder method(HttpMethod method,
 URI url)

Create a builder with the given HTTP method and a URI.

Parameters:

method - the HTTP method (GET, POST, etc)

url - the URL

Returns:

the created builder

method

public static MockServerHttpRequest.BodyBuilder method(HttpMethod method,
 String uri,
 @Nullable Object... vars)

Alternative to method(HttpMethod, URI) that accepts a URI template. The given URI may contain query parameters, or those may be added later via queryParam builder methods.

Parameters:

method - the HTTP method (GET, POST, etc)

uri - the URI template for the target URL

vars - variables to expand into the template

Returns:

the created builder