程序包 cn.taketoday.web

类 WebContentGenerator

java.lang.Object
cn.taketoday.context.support.ApplicationObjectSupport
cn.taketoday.web.WebContentGenerator
所有已实现的接口:
cn.taketoday.beans.factory.Aware, cn.taketoday.context.ApplicationContextAware
直接已知子类:
AbstractController, AbstractHandlerMethodAdapter, ResourceHttpRequestHandler, WebContentInterceptor
public abstract class WebContentGenerator extends cn.taketoday.context.support.ApplicationObjectSupport
Convenient superclass for any kind of web content generator

Supports HTTP cache control options. The usage of corresponding HTTP headers can be controlled via the "cacheSeconds" and "cacheControl" properties.

从以下版本开始:
4.0 2022/1/29 10:25
作者:
Rod Johnson, Juergen Hoeller, Brian Clozel, Rossen Stoyanchev, Harry Yang
另请参阅:

  • 字段详细资料

    • METHOD_GET

      public static final String METHOD_GET
      HTTP method "GET".
      另请参阅:

    • METHOD_HEAD

      public static final String METHOD_HEAD
      HTTP method "HEAD".
      另请参阅:

    • METHOD_POST

      public static final String METHOD_POST
      HTTP method "POST".
      另请参阅:

    • HEADER_PRAGMA

      private static final String HEADER_PRAGMA
      另请参阅:

    • HEADER_EXPIRES

      private static final String HEADER_EXPIRES
      另请参阅:

    • HEADER_CACHE_CONTROL

      protected static final String HEADER_CACHE_CONTROL
      另请参阅:

    • supportedMethods

      @Nullable private Set<String> supportedMethods
      Set of supported HTTP methods.

    • allowHeader

      @Nullable private String allowHeader

    • requireSession

      private boolean requireSession

    • cacheControl

      @Nullable private CacheControl cacheControl

    • cacheSeconds

      private int cacheSeconds

    • varyByRequestHeaders

      @Nullable private String[] varyByRequestHeaders

  • 构造器详细资料

    • WebContentGenerator

      public WebContentGenerator()
      Create a new WebContentGenerator which supports HTTP methods GET, HEAD and POST by default.

    • WebContentGenerator

      public WebContentGenerator(boolean restrictDefaultSupportedMethods)
      Create a new WebContentGenerator.
      参数:
      restrictDefaultSupportedMethods - true if this generator should support HTTP methods GET, HEAD and POST by default, or false if it should be unrestricted

    • WebContentGenerator

      public WebContentGenerator(String... supportedMethods)
      Create a new WebContentGenerator.
      参数:
      supportedMethods - the supported HTTP methods for this content generator

  • 方法详细资料

    • setSupportedMethods

      public final void setSupportedMethods(@Nullable String... methods)
      Set the HTTP methods that this content generator should support.

      Default is GET, HEAD and POST for simple form controller types; unrestricted for general controllers and interceptors.

    • getSupportedMethods

      @Nullable public final String[] getSupportedMethods()
      Return the HTTP methods that this content generator supports.

    • initAllowHeader

      private void initAllowHeader()

    • getAllowHeader

      @Nullable protected String getAllowHeader()
      Return the "Allow" header value to use in response to an HTTP OPTIONS request based on the configured supported methods also automatically adding "OPTIONS" to the list even if not present as a supported method. This means subclasses don't have to explicitly list "OPTIONS" as a supported method as long as HTTP OPTIONS requests are handled before making a call to checkRequest(RequestContext).

    • setRequireSession

      public final void setRequireSession(boolean requireSession)
      Set whether a session should be required to handle requests.

    • isRequireSession

      public final boolean isRequireSession()
      Return whether a session is required to handle requests.

    • setCacheControl

      public final void setCacheControl(@Nullable CacheControl cacheControl)
      Set the CacheControl instance to build the Cache-Control HTTP response header.

    • getCacheControl

      @Nullable public final CacheControl getCacheControl()
      Get the CacheControl instance that builds the Cache-Control HTTP response header.

    • setCacheSeconds

      public final void setCacheSeconds(int seconds)
      Cache content for the given number of seconds, by writing cache-related HTTP headers to the response:
      • seconds == -1 (default value): no generation cache-related headers
      • seconds == 0: "Cache-Control: no-store" will prevent caching
      • seconds > 0: "Cache-Control: max-age=seconds" will ask to cache content

      For more specific needs, a custom CacheControl should be used.

      另请参阅:

    • getCacheSeconds

      public final int getCacheSeconds()
      Return the number of seconds that content is cached.

    • setVaryByRequestHeaders

      public final void setVaryByRequestHeaders(@Nullable String... varyByRequestHeaders)
      Configure one or more request header names (e.g. "Accept-Language") to add to the "Vary" response header to inform clients that the response is subject to content negotiation and variances based on the value of the given request headers. The configured request header names are added only if not already present in the response "Vary" header.
      参数:
      varyByRequestHeaders - one or more request header names

    • getVaryByRequestHeaders

      @Nullable public final String[] getVaryByRequestHeaders()
      Return the configured request header names for the "Vary" response header.

    • checkRequest

      protected final void checkRequest(RequestContext request)
      Check the given request for supported methods and a required session, if any.
      参数:
      request - current HTTP request

    • prepareResponse

      protected final void prepareResponse(RequestContext response)
      Prepare the given response according to the settings of this generator. Applies the number of cache seconds specified for this generator.
      参数:
      response - current HTTP response

    • applyCacheControl

      protected final void applyCacheControl(RequestContext response, CacheControl cacheControl)
      Set the HTTP Cache-Control header according to the given settings.
      参数:
      response - current HTTP response
      cacheControl - the pre-configured cache control settings

    • applyCacheSeconds

      protected final void applyCacheSeconds(RequestContext response, int cacheSeconds)
      Apply the given cache seconds and generate corresponding HTTP headers, i.e. allow caching for the given number of seconds in case of a positive value, prevent caching if given a 0 value, do nothing else. Does not tell the browser to revalidate the resource.
      参数:
      response - current HTTP response
      cacheSeconds - positive number of seconds into the future that the response should be cacheable for, 0 to prevent caching

    • getVaryRequestHeadersToAdd

      private Collection<String> getVaryRequestHeadersToAdd(RequestContext response, String[] varyByRequestHeaders)