ServerRequest (Spring Framework 5.0.19.RELEASE API)

All Known Implementing Classes:

MockServerRequest, ServerRequestWrapper
```
public interface ServerRequest
```
Represents a server-side HTTP request, as handled by a HandlerFunction.
Access to headers and body is offered by ServerRequest.Headers and body(BodyExtractor), respectively.

Since:

5.0

Author:

Arjen Poutsma, Sebastien Deleuze

Nested Class Summary

Nested Classes
Modifier and Type Interface and Description

static interface ServerRequest.Headers
Represents the headers of the HTTP request.

Nested Classes
Modifier and Type	Interface and Description
`static interface`	`ServerRequest.Headers` Represents the headers of the HTTP request.

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method and Description
`default Optional<Object>`	`attribute(String name)` Get the request attribute value if present.
`Map<String,Object>`	`attributes()` Get a mutable map of request attributes.
`<T> T`	`body(BodyExtractor<T,? super ServerHttpRequest> extractor)` Extract the body with the given `BodyExtractor`.
`<T> T`	`body(BodyExtractor<T,? super ServerHttpRequest> extractor, Map<String,Object> hints)` Extract the body with the given `BodyExtractor` and hints.
`<T> reactor.core.publisher.Flux<T>`	`bodyToFlux(Class<? extends T> elementClass)` Extract the body to a `Flux`.
`<T> reactor.core.publisher.Flux<T>`	`bodyToFlux(ParameterizedTypeReference<T> typeReference)` Extract the body to a `Flux`.
`<T> reactor.core.publisher.Mono<T>`	`bodyToMono(Class<? extends T> elementClass)` Extract the body to a `Mono`.
`<T> reactor.core.publisher.Mono<T>`	`bodyToMono(ParameterizedTypeReference<T> typeReference)` Extract the body to a `Mono`.
`MultiValueMap<String,HttpCookie>`	`cookies()` Get the cookies of this request.
`static ServerRequest`	`create(ServerWebExchange exchange, List<HttpMessageReader<?>> messageReaders)` Create a new `ServerRequest` based on the given `ServerWebExchange` and message readers.
`reactor.core.publisher.Mono<MultiValueMap<String,String>>`	`formData()` Get the form data from the body of the request if the Content-Type is `"application/x-www-form-urlencoded"` or an empty map otherwise.
`ServerRequest.Headers`	`headers()` Get the headers of this request.
`default HttpMethod`	`method()` Get the HTTP method.
`String`	`methodName()` Get the name of the HTTP method.
`reactor.core.publisher.Mono<MultiValueMap<String,Part>>`	`multipartData()` Get the parts of a multipart request if the Content-Type is `"multipart/form-data"` or an empty map otherwise.
`default String`	`path()` Get the request path.
`default PathContainer`	`pathContainer()` Get the request path as a `PathContainer`.
`default String`	`pathVariable(String name)` Get the path variable with the given name, if present.
`Map<String,String>`	`pathVariables()` Get all path variables for this request.
`reactor.core.publisher.Mono<? extends Principal>`	`principal()` Get the authenticated user for the request, if any.
`default Optional<String>`	`queryParam(String name)` Get the first query parameter with the given name, if present.
`MultiValueMap<String,String>`	`queryParams()` Get all query parameters for this request.
`reactor.core.publisher.Mono<WebSession>`	`session()` Get the web session for this request.
`URI`	`uri()` Get the request URI.
`UriBuilder`	`uriBuilder()` Get a `UriBuilderComponents` from the URI associated with this `ServerRequest`, while also overlaying with values from the headers "Forwarded" (RFC 7239), or "X-Forwarded-Host", "X-Forwarded-Port", and "X-Forwarded-Proto" if "Forwarded" is not found.

- Method Detail
  - method
```
@Nullable
default HttpMethod method()
```
    Get the HTTP method.
    
    Returns:
    
    the HTTP method as an HttpMethod enum value, or null if not resolvable (e.g. in case of a non-standard HTTP method)
  - methodName
```
String methodName()
```
    Get the name of the HTTP method.
    
    Returns:
    
    the HTTP method as a String
  - uri
```
URI uri()
```
    Get the request URI.
  - uriBuilder
```
UriBuilder uriBuilder()
```
    Get a UriBuilderComponents from the URI associated with this ServerRequest, while also overlaying with values from the headers "Forwarded" (RFC 7239), or "X-Forwarded-Host", "X-Forwarded-Port", and "X-Forwarded-Proto" if "Forwarded" is not found.
    
    Returns:
    
    a URI builder
  - path
```
default String path()
```
    Get the request path.
  - pathContainer
```
default PathContainer pathContainer()
```
    Get the request path as a PathContainer.
  - headers
```
ServerRequest.Headers headers()
```
    Get the headers of this request.
  - cookies
```
MultiValueMap<String,HttpCookie> cookies()
```
    Get the cookies of this request.
  - body
```
<T> T body(BodyExtractor<T,? super ServerHttpRequest> extractor)
```
    Extract the body with the given BodyExtractor.
    
    Type Parameters:
    
    T - the type of the body returned
    
    Parameters:
    
    extractor - the BodyExtractor that reads from the request
    
    Returns:
    
    the extracted body
    
    See Also:
    
    body(BodyExtractor, Map)
  - body
```
<T> T body(BodyExtractor<T,? super ServerHttpRequest> extractor,
           Map<String,Object> hints)
```
    Extract the body with the given BodyExtractor and hints.
    
    Type Parameters:
    
    T - the type of the body returned
    
    Parameters:
    
    extractor - the BodyExtractor that reads from the request
    
    hints - the map of hints like Jackson2CodecSupport.JSON_VIEW_HINT to use to customize body extraction
    
    Returns:
    
    the extracted body
  - bodyToMono
```
<T> reactor.core.publisher.Mono<T> bodyToMono(Class<? extends T> elementClass)
```
    Extract the body to a Mono.
    
    Type Parameters:
    
    T - the element type
    
    Parameters:
    
    elementClass - the class of element in the Mono
    
    Returns:
    
    the body as a mono
  - bodyToMono
```
<T> reactor.core.publisher.Mono<T> bodyToMono(ParameterizedTypeReference<T> typeReference)
```
    Extract the body to a Mono.
    
    Type Parameters:
    
    T - the element type
    
    Parameters:
    
    typeReference - a type reference describing the expected response request type
    
    Returns:
    
    a mono containing the body of the given type T
  - bodyToFlux
```
<T> reactor.core.publisher.Flux<T> bodyToFlux(Class<? extends T> elementClass)
```
    Extract the body to a Flux.
    
    Type Parameters:
    
    T - the element type
    
    Parameters:
    
    elementClass - the class of element in the Flux
    
    Returns:
    
    the body as a flux
  - bodyToFlux
```
<T> reactor.core.publisher.Flux<T> bodyToFlux(ParameterizedTypeReference<T> typeReference)
```
    Extract the body to a Flux.
    
    Type Parameters:
    
    T - the element type
    
    Parameters:
    
    typeReference - a type reference describing the expected request body type
    
    Returns:
    
    a flux containing the body of the given type T
  - attribute
```
default Optional<Object> attribute(String name)
```
    Get the request attribute value if present.
    
    Parameters:
    
    name - the attribute name
    
    Returns:
    
    the attribute value
  - attributes
```
Map<String,Object> attributes()
```
    Get a mutable map of request attributes.
    
    Returns:
    
    the request attributes
  - queryParam
```
default Optional<String> queryParam(String name)
```
    Get the first query parameter with the given name, if present.
    
    Parameters:
    
    name - the parameter name
    
    Returns:
    
    the parameter value
  - queryParams
```
MultiValueMap<String,String> queryParams()
```
    Get all query parameters for this request.
  - pathVariable
```
default String pathVariable(String name)
```
    Get the path variable with the given name, if present.
    
    Parameters:
    
    name - the variable name
    
    Returns:
    
    the variable value
    
    Throws:
    
    IllegalArgumentException - if there is no path variable with the given name
  - pathVariables
```
Map<String,String> pathVariables()
```
    Get all path variables for this request.
  - session
```
reactor.core.publisher.Mono<WebSession> session()
```
    Get the web session for this request.
    Always guaranteed to return an instance either matching the session id requested by the client, or with a new session id either because the client did not specify one or because the underlying session had expired.
    Use of this method does not automatically create a session.
  - principal
```
reactor.core.publisher.Mono<? extends Principal> principal()
```
    Get the authenticated user for the request, if any.
  - formData
```
reactor.core.publisher.Mono<MultiValueMap<String,String>> formData()
```
    Get the form data from the body of the request if the Content-Type is "application/x-www-form-urlencoded" or an empty map otherwise.
    Note: calling this method causes the request body to be read and parsed in full, and the resulting MultiValueMap is cached so that this method is safe to call more than once.
  - multipartData
```
reactor.core.publisher.Mono<MultiValueMap<String,Part>> multipartData()
```
    Get the parts of a multipart request if the Content-Type is "multipart/form-data" or an empty map otherwise.
    Note: calling this method causes the request body to be read and parsed in full, and the resulting MultiValueMap is cached so that this method is safe to call more than once.
  - create
```
static ServerRequest create(ServerWebExchange exchange,
                            List<HttpMessageReader<?>> messageReaders)
```
    Create a new ServerRequest based on the given ServerWebExchange and message readers.
    
    Parameters:
    
    exchange - the exchange
    
    messageReaders - the message readers
    
    Returns:
    
    the created ServerRequest

Interface ServerRequest

Nested Class Summary

Method Summary

Method Detail

method

methodName

uri

uriBuilder

path

pathContainer

headers

cookies

body

body

bodyToMono

bodyToMono

bodyToFlux

bodyToFlux

attribute

attributes

queryParam

queryParams

pathVariable

pathVariables

session

principal

formData

multipartData

create