程序包 cn.taketoday.web.handler.function

接口 ServerRequest

所有超级接口:
ServerResponse.Context
所有已知实现类:
DefaultServerRequest, DefaultServerRequestBuilder.BuiltServerRequest, RequestPredicates.SubPathServerRequestWrapper
public interface ServerRequest extends ServerResponse.Context
Represents a server-side HTTP request, as handled by a HandlerFunction. Access to headers and body is offered by ServerRequest.Headers and body(Class), respectively.
从以下版本开始:
4.0
作者:
Arjen Poutsma, Harry Yang

  • 方法详细资料

    • method

      HttpMethod method()
      Get the HTTP method.
      返回:
      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.
      返回:
      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.
      返回:
      a URI builder

    • path

      default String path()
      Get the request path.

    • requestPath

      default RequestPath requestPath()
      Get the request path as a PathContainer.

    • headers

      ServerRequest.Headers headers()
      Get the headers of this request.

    • cookies

      cn.taketoday.util.MultiValueMap<String,HttpCookie> cookies()
      Get the cookies of this request.

    • remoteAddress

      Optional<InetSocketAddress> remoteAddress()
      Get the remote address to which this request is connected, if available.

    • messageConverters

      List<HttpMessageConverter<?>> messageConverters()
      Get the readers used to convert the body of this request.
      指定者:
      messageConverters 在接口中 ServerResponse.Context
      返回:
      the list of message writers

    • body

      <T> T body(Class<T> bodyType) throws IOException
      Extract the body as an object of the given type.
      类型参数:
      T - the body type
      参数:
      bodyType - the type of return value
      返回:
      the body
      抛出:
      IOException

    • body

      <T> T body(cn.taketoday.core.ParameterizedTypeReference<T> bodyType) throws IOException
      Extract the body as an object of the given type.
      类型参数:
      T - the body type
      参数:
      bodyType - the type of return value
      返回:
      the body
      抛出:
      IOException

    • bind

      default <T> T bind(Class<T> bindType) throws cn.taketoday.validation.BindException
      Bind to this request and return an instance of the given type.
      类型参数:
      T - the type to bind to
      参数:
      bindType - the type of class to bind this request to
      返回:
      a constructed and bound instance of bindType
      抛出:
      cn.taketoday.validation.BindException - in case of binding errors

    • bind

      <T> T bind(Class<T> bindType, Consumer<WebDataBinder> dataBinderCustomizer) throws cn.taketoday.validation.BindException
      Bind to this request and return an instance of the given type.
      类型参数:
      T - the type to bind to
      参数:
      bindType - the type of class to bind this request to
      dataBinderCustomizer - used to customize the data binder, e.g. set (dis)allowed fields
      返回:
      a constructed and bound instance of bindType
      抛出:
      cn.taketoday.validation.BindException - in case of binding errors

    • attribute

      default Optional<Object> attribute(String name)
      Get the request attribute value if present.
      参数:
      name - the attribute name
      返回:
      the attribute value

    • attributes

      Map<String,Object> attributes()
      Get a mutable map of request attributes.
      返回:
      the request attributes

    • param

      default Optional<String> param(String name)
      Get the first parameter with the given name, if present. parameters are contained in the query string or posted form data.
      参数:
      name - the parameter name
      返回:
      the parameter value
      另请参阅:

    • params

      default List<String> params(String name)
      Get the parameters with the given name.

      parameters are contained in the query string or posted form data.

      参数:
      name - the parameter name
      返回:
      the parameter value
      另请参阅:

    • params

      cn.taketoday.util.MultiValueMap<String,String> params()
      Get all parameters for this request. parameters are contained in the query string or posted form data.
      另请参阅:

    • multipartData

      cn.taketoday.util.MultiValueMap<String,Multipart> multipartData() throws IOException
      Get the parts of a multipart request, provided the Content-Type is "multipart/form-data", or an exception otherwise.
      返回:
      the multipart data, mapping from name to part(s)
      抛出:
      IOException - if an I/O error occurred during the retrieval
      NotMultipartRequestException - if this request is not of type "multipart/form-data"
      另请参阅:

    • pathVariable

      default String pathVariable(String name)
      Get the path variable with the given name, if present.
      参数:
      name - the variable name
      返回:
      the variable value
      抛出:
      IllegalArgumentException - if there is no path variable with the given name

    • pathVariables

      Map<String,String> pathVariables()
      Get all path variables for this request.

    • exchange

      RequestContext exchange()
      Get the request that this request is based on.

    • checkNotModified

      default Optional<ServerResponse> checkNotModified(Instant lastModified)
      Check whether the requested resource has been modified given the supplied last-modified timestamp (as determined by the application). If not modified, this method returns a response with corresponding status code and headers, otherwise an empty result.

      Typical usage: 

      
 public ServerResponse myHandleMethod(ServerRequest request) {
   Instant lastModified = // application-specific calculation
 	 return request.checkNotModified(lastModified)
 	   .orElseGet(() -> {
 	     // further request processing, actually building content
 		 return ServerResponse.ok().body(...);
     });
 }

      This method works with conditional GET/HEAD requests, but also with conditional POST/PUT/DELETE requests.

      Note: you can use either this #checkNotModified(Instant) method; or checkNotModified(String). If you want to enforce both a strong entity tag and a Last-Modified value, as recommended by the HTTP specification, then you should use checkNotModified(Instant, String).

      参数:
      lastModified - the last-modified timestamp that the application determined for the underlying resource
      返回:
      a corresponding response if the request qualifies as not modified, or an empty result otherwise.

    • checkNotModified

      default Optional<ServerResponse> checkNotModified(String etag)
      Check whether the requested resource has been modified given the supplied ETag (entity tag), as determined by the application. If not modified, this method returns a response with corresponding status code and headers, otherwise an empty result.

      Typical usage: 

      
 public ServerResponse myHandleMethod(ServerRequest request) {
   String eTag = // application-specific calculation
 	 return request.checkNotModified(eTag)
 	   .orElseGet(() -> {
 	     // further request processing, actually building content
 		 return ServerResponse.ok().body(...);
     });
 }

      This method works with conditional GET/HEAD requests, but also with conditional POST/PUT/DELETE requests.

      Note: you can use either this checkNotModified(Instant) method; or #checkNotModified(String). If you want to enforce both a strong entity tag and a Last-Modified value, as recommended by the HTTP specification, then you should use checkNotModified(Instant, String).

      参数:
      etag - the entity tag that the application determined for the underlying resource. This parameter will be padded with quotes (") if necessary.
      返回:
      a corresponding response if the request qualifies as not modified, or an empty result otherwise.

    • checkNotModified

      default Optional<ServerResponse> checkNotModified(Instant lastModified, String etag)
      Check whether the requested resource has been modified given the supplied ETag (entity tag) and last-modified timestamp, as determined by the application. If not modified, this method returns a response with corresponding status code and headers, otherwise an empty result.

      Typical usage: 

      
 public ServerResponse myHandleMethod(ServerRequest request) {
   Instant lastModified = // application-specific calculation
   String eTag = // application-specific calculation
 	 return request.checkNotModified(lastModified, eTag)
 	   .orElseGet(() -> {
 	     // further request processing, actually building content
 		 return ServerResponse.ok().body(...);
     });
 }

      This method works with conditional GET/HEAD requests, but also with conditional POST/PUT/DELETE requests.

      参数:
      lastModified - the last-modified timestamp that the application determined for the underlying resource
      etag - the entity tag that the application determined for the underlying resource. This parameter will be padded with quotes (") if necessary.
      返回:
      a corresponding response if the request qualifies as not modified, or an empty result otherwise.

    • create

      static ServerRequest create(RequestContext context, List<HttpMessageConverter<?>> messageReaders)
      Create a new ServerRequest based on the given RequestContext and message converters.
      参数:
      context - the request
      messageReaders - the message readers
      返回:
      the created ServerRequest

    • from

      static ServerRequest.Builder from(ServerRequest other)
      Create a builder with the status, headers, and cookies of the given request.
      参数:
      other - the response to copy the status, headers, and cookies from
      返回:
      the created builder

    • find

      @Nullable static ServerRequest find(RequestContext context)

    • findRequired

      static ServerRequest findRequired(RequestContext context)