org.springframework.mock.http.server.reactive

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 class MockServerHttpRequest
extends AbstractServerHttpRequest

Mock extension of AbstractServerHttpRequest for use in tests without an actual server.

Use the static builder methods in this class to create an instance possibly further creating a MockServerWebExchange via toExchange().

Since:

5.0

Author:

Rossen Stoyanchev

Nested Class Summary

Nested Classes

Modifier and Type	Class and 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 org.springframework.http.server.reactive.ServerHttpRequest

ServerHttpRequest.Builder

Method Summary

Modifier and Type	Method and Description
static MockServerHttpRequest.BaseBuilder<?>	delete(String urlTemplate, Object... uriVars) Create an HTTP DELETE builder with the given url.
static MockServerHttpRequest.BaseBuilder<?>	get(String urlTemplate, Object... uriVars) Create an HTTP GET builder with the given url.
reactor.core.publisher.Flux<DataBuffer>	getBody() Return the body of the message as a Publisher.
HttpMethod	getMethod() Return the HTTP method of the request.
String	getMethodValue() Return the HTTP method of the request as a String
InetSocketAddress	getRemoteAddress() Return the remote address where this request is connected to, if available.
static MockServerHttpRequest.BaseBuilder<?>	head(String urlTemplate, Object... uriVars) Create an HTTP HEAD builder with the given url.
protected MultiValueMap<String,HttpCookie>	initCookies() Obtain the cookies from the underlying "native" request and adapt those to an HttpCookie map.
static MockServerHttpRequest.BodyBuilder	method(HttpMethod method, String urlTemplate, 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, Object... uriVars) Creates an HTTP OPTIONS builder with the given url.
static MockServerHttpRequest.BodyBuilder	patch(String urlTemplate, Object... uriVars) Create an HTTP PATCH builder with the given url.
static MockServerHttpRequest.BodyBuilder	post(String urlTemplate, Object... uriVars) Create an HTTP POST builder with the given url.
static MockServerHttpRequest.BodyBuilder	put(String urlTemplate, Object... uriVars) Create an HTTP PUT builder with the given url.
MockServerWebExchange	toExchange() Shortcut to wrap the request with a MockServerWebExchange.

Methods inherited from class org.springframework.http.server.reactive.AbstractServerHttpRequest

getCookies, getHeaders, getPath, getQueryParams, getURI, initQueryParams

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.springframework.http.server.reactive.ServerHttpRequest

mutate

Method Detail

getMethod

public HttpMethod getMethod()

Description copied from interface: HttpRequest

Return the HTTP method of the request.

Returns:

the HTTP method as an HttpMethod enum value, or null if not resolvable (e.g. in case of a non-standard HTTP method)

getMethodValue

public String getMethodValue()

Description copied from interface: HttpRequest

Return the HTTP method of the request as a String

Returns:

the HTTP method as a String

getRemoteAddress

@Nullable
public InetSocketAddress getRemoteAddress()

Description copied from interface: ServerHttpRequest

Return the remote address where this request is connected to, if 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(). Sub-classes should synchronize cookie initialization if the underlying "native" request does not provide thread-safe access to cookie data.

Specified by:

initCookies in class AbstractServerHttpRequest

toExchange

public MockServerWebExchange toExchange()

Shortcut to wrap the request with a MockServerWebExchange.

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 urlTemplate,
                                                       Object... vars)

Alternative to method(HttpMethod, URI) that accepts a URI template.

Parameters:

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

urlTemplate - the URL template

vars - variables to expand into the template

Returns:

the created builder

get

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

Create an HTTP GET builder with the given url.

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,
                                                        Object... uriVars)

Create an HTTP HEAD builder with the given url.

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,
                                                     Object... uriVars)

Create an HTTP POST builder with the given url.

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,
                                                    Object... uriVars)

Create an HTTP PUT builder with the given url.

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,
                                                      Object... uriVars)

Create an HTTP PATCH builder with the given url.

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,
                                                          Object... uriVars)

Create an HTTP DELETE builder with the given url.

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,
                                                           Object... uriVars)

Creates an HTTP OPTIONS builder with the given url.

Parameters:

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

uriVars - zero or more URI variables

Returns:

the created builder