类 AbstractUrlHandlerMapping

构造器详细资料

• AbstractUrlHandlerMapping

  public AbstractUrlHandlerMapping()

方法详细资料

• setRootHandler

  public void setRootHandler​(@Nullable
                             Object rootHandler)

  Set the root handler for this handler mapping, that is, the handler to be registered for the root path ("/").

  Default is null, indicating no root handler.

• getRootHandler

  @Nullable
  public Object getRootHandler()

  Return the root handler for this handler mapping (registered for "/"), or null if none.

• setUseTrailingSlashMatch

  public void setUseTrailingSlashMatch​(boolean useTrailingSlashMatch)

  Whether to match to URLs irrespective of the presence of a trailing slash. If enabled a URL pattern such as "/users" also matches to "/users/".

  The default value is false.

• useTrailingSlashMatch

  public boolean useTrailingSlashMatch()

  Whether to match to URLs irrespective of the presence of a trailing slash.

• setLazyInitHandlers

  public void setLazyInitHandlers​(boolean lazyInitHandlers)

  Set whether to lazily initialize handlers. Only applicable to singleton handlers, as prototypes are always lazily initialized. Default is "false", as eager initialization allows for more efficiency through referencing the controller objects directly.

  If you want to allow your controllers to be lazily initialized, make them "lazy-init" and set this flag to true. Just making them "lazy-init" will not work, as they are initialized through the references from the handler mapping in this case.

• getHandlerInternal

  @Nullable
  protected Object getHandlerInternal​(HttpServletRequest request)
                               throws Exception

  Look up a handler for the URL path of the given request.

  指定者:

  getHandlerInternal 在类中 AbstractHandlerMapping

  参数:

  request - current HTTP request

  返回:

  the handler instance, or null if none found

  抛出:

  Exception - if there is an internal error

• lookupHandler

  @Nullable
  protected Object lookupHandler​(String urlPath,
                                 HttpServletRequest request)
                          throws Exception

  Look up a handler instance for the given URL path.

  Supports direct matches, e.g. a registered "/test" matches "/test", and various Ant-style pattern matches, e.g. a registered "/t*" matches both "/test" and "/team". For details, see the AntPathMatcher class.

  Looks for the most exact pattern, where most exact is defined as the longest path pattern.

  参数:

  urlPath - the URL the bean is mapped to

  request - current HTTP request (to expose the path within the mapping to)

  返回:

  the associated handler instance, or null if not found

  抛出:

  Exception

  另请参阅:

  exposePathWithinMapping(java.lang.String, java.lang.String, javax.servlet.http.HttpServletRequest), AntPathMatcher

• validateHandler

  protected void validateHandler​(Object handler,
                                 HttpServletRequest request)
                          throws Exception

  Validate the given handler against the current request.

  The default implementation is empty. Can be overridden in subclasses, for example to enforce specific preconditions expressed in URL mappings.

  参数:

  handler - the handler object to validate

  request - current HTTP request

  抛出:

  Exception - if validation failed

• buildPathExposingHandler

  protected Object buildPathExposingHandler​(Object rawHandler,
                                            String bestMatchingPattern,
                                            String pathWithinMapping,
                                            @Nullable
                                            Map<String,​String> uriTemplateVariables)

  Build a handler object for the given raw handler, exposing the actual handler, the HandlerMapping.PATH_WITHIN_HANDLER_MAPPING_ATTRIBUTE, as well as the HandlerMapping.URI_TEMPLATE_VARIABLES_ATTRIBUTE before executing the handler.

  The default implementation builds a HandlerExecutionChain with a special interceptor that exposes the path attribute and uri template variables

  参数:

  rawHandler - the raw handler to expose

  pathWithinMapping - the path to expose before executing the handler

  uriTemplateVariables - the URI template variables, can be null if no variables found

  返回:

  the final handler object

• exposePathWithinMapping

  protected void exposePathWithinMapping​(String bestMatchingPattern,
                                         String pathWithinMapping,
                                         HttpServletRequest request)

  Expose the path within the current mapping as request attribute.

  参数:

  pathWithinMapping - the path within the current mapping

  request - the request to expose the path to

  另请参阅:

  HandlerMapping.PATH_WITHIN_HANDLER_MAPPING_ATTRIBUTE

• exposeUriTemplateVariables

  protected void exposeUriTemplateVariables​(Map<String,​String> uriTemplateVariables,
                                            HttpServletRequest request)

  Expose the URI templates variables as request attribute.

  参数:

  uriTemplateVariables - the URI template variables

  request - the request to expose the path to

  另请参阅:

  HandlerMapping.PATH_WITHIN_HANDLER_MAPPING_ATTRIBUTE

• match

  @Nullable
  public RequestMatchResult match​(HttpServletRequest request,
                                  String pattern)

  从接口复制的说明: MatchableHandlerMapping
  Determine whether the given request matches the request criteria.

  指定者:

  match 在接口中 MatchableHandlerMapping

  参数:

  request - the current request

  pattern - the pattern to match

  返回:

  the result from request matching, or null if none

• registerHandler

  protected void registerHandler​(String[] urlPaths,
                                 String beanName)
                          throws BeansException,
                                 IllegalStateException

  Register the specified handler for the given URL paths.

  参数:

  urlPaths - the URLs that the bean should be mapped to

  beanName - the name of the handler bean

  抛出:

  BeansException - if the handler couldn't be registered

  IllegalStateException - if there is a conflicting handler registered

• registerHandler

  protected void registerHandler​(String urlPath,
                                 Object handler)
                          throws BeansException,
                                 IllegalStateException

  Register the specified handler for the given URL path.

  参数:

  urlPath - the URL the bean should be mapped to

  handler - the handler instance or handler bean name String (a bean name will automatically be resolved into the corresponding handler bean)

  抛出:

  BeansException - if the handler couldn't be registered

  IllegalStateException - if there is a conflicting handler registered

• getHandlerMap

  public final Map<String,​Object> getHandlerMap()

  Return the registered handlers as an unmodifiable Map, with the registered path as key and the handler object (or handler bean name in case of a lazy-init handler) as value.

  另请参阅:

  AbstractHandlerMapping.getDefaultHandler()

• supportsTypeLevelMappings

  protected boolean supportsTypeLevelMappings()

  Indicates whether this handler mapping support type-level mappings. Default to false.