org.springframework.web.server

Interface ServerWebExchange

All Known Implementing Classes:

DefaultServerWebExchange

public interface ServerWebExchange

Contract for an HTTP request-response interaction. Provides access to the HTTP request and response and also exposes additional server-side processing related properties and features such as request attributes.

Since:

5.0

Author:

Rossen Stoyanchev

Method Summary

Modifier and Type	Method and Description
boolean	checkNotModified(Instant lastModified) An overloaded variant of checkNotModified(String, Instant) with a last-modified timestamp only.
boolean	checkNotModified(String etag) An overloaded variant of checkNotModified(String, Instant) with an ETag (entity tag) value only.
boolean	checkNotModified(String etag, Instant lastModified) Check whether the requested resource has been modified given the supplied ETag (entity tag) and last-modified timestamp as determined by the application.
<T> Optional<T>	getAttribute(String name) Return the request attribute value if present.
Map<String,Object>	getAttributes() Return a mutable map of request attributes for the current exchange.
ServerHttpRequest	getRequest() Return the current HTTP request.
ServerHttpResponse	getResponse() Return the current HTTP response.
reactor.core.publisher.Mono<WebSession>	getSession() Return the web session for the current request.
boolean	isNotModified() Returns true if the one of the checkNotModified methods in this contract were used and they returned true.

Method Detail

getRequest

ServerHttpRequest getRequest()

Return the current HTTP request.

getResponse

ServerHttpResponse getResponse()

Return the current HTTP response.

getAttributes

Map<String,Object> getAttributes()

Return a mutable map of request attributes for the current exchange.

getAttribute

<T> Optional<T> getAttribute(String name)

Return the request attribute value if present.

Type Parameters:

T - the attribute type

Parameters:

name - the attribute name

Returns:

the attribute value

getSession

reactor.core.publisher.Mono<WebSession> getSession()

Return the web session for the current request. Always guaranteed to return an instance either matching to 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. See WebSession for more details.

isNotModified

boolean isNotModified()

Returns true if the one of the checkNotModified methods in this contract were used and they returned true.

checkNotModified

boolean checkNotModified(Instant lastModified)

An overloaded variant of checkNotModified(String, Instant) with a last-modified timestamp only.

Parameters:

lastModified - the last-modified time

Returns:

whether the request qualifies as not modified

checkNotModified

boolean checkNotModified(String etag)

An overloaded variant of checkNotModified(String, Instant) with an ETag (entity tag) value only.

Parameters:

etag - the entity tag for the underlying resource.

Returns:

true if the request does not require further processing.

checkNotModified

boolean checkNotModified(String etag,
                         Instant lastModified)

Check whether the requested resource has been modified given the supplied ETag (entity tag) and last-modified timestamp as determined by the application. Also transparently prepares the response, setting HTTP status, and adding "ETag" and "Last-Modified" headers when applicable. This method works with conditional GET/HEAD requests as well as with conditional POST/PUT/DELETE requests.

Note: The HTTP specification recommends setting both ETag and Last-Modified values, but you can also use #checkNotModified(String) or checkNotModified(Instant).

Parameters:

etag - the entity tag that the application determined for the underlying resource. This parameter will be padded with quotes (") if necessary.

lastModified - the last-modified timestamp that the application determined for the underlying resource

Returns:

true if the request does not require further processing.