Generated by
JDiff

org.springframework.web.servlet.mvc.annotation Documentation Differences

This file contains all the changes in documentation in the package org.springframework.web.servlet.mvc.annotation as colored differences. Deletions are shown like this, and additions are shown like this.
If no deletions or additions are shown in an entry, the HTML tags will be what has changed. The new HTML tags are shown in the differences. If no documentation existed, and then some was added in a later version, this change is noted in the appropriate class pages of differences, but the change is not shown on this page. Only changes in existing text are shown here. Similarly, documentation which was inherited from another class or interface is not shown here.
Note that an HTML error in the new documentation may cause the display of other documentation changes to be presented incorrectly. For instance, failure to close a <code> tag will cause all subsequent paragraphs to be displayed differently.

Class AnnotationMethodHandlerAdapter

Implementation of the org.springframework.web.servlet.HandlerAdapter interface that maps handler methods based on HTTP paths, HTTP methods and request parameters expressed through the RequestMapping annotation.

Supports request parameter binding through the RequestParam annotation. Also supports the ModelAttribute annotation for exposing model attribute values to the view, as well as InitBinder for binder initialization methods and SessionAttributes for automatic session management of specific attributes.

This adapter can be customized through various bean properties. A common use case is to apply shared binder initialization logic through a custom WebBindingInitializer. @author Juergen Hoeller @author Arjen Poutsma @since 2.5 @see #setPathMatcher @see #setMethodNameResolver @see #setWebBindingInitializer @see #setSessionAttributeStoresetSessionAttributeStore @deprecated in Spring 3.2 in favor of RequestMappingHandlerAdapter


Class AnnotationMethodHandlerExceptionResolver

Implementation of the org.springframework.web.servlet.HandlerExceptionResolver interface that handles exceptions through the ExceptionHandler annotation.

This exception resolver is enabled by default in the org.springframework.web.servlet.DispatcherServlet. @author Arjen Poutsma @author Juergen Hoeller @since 3.00 @deprecated in Spring 3.2 in favor of ExceptionHandlerExceptionResolver


Class DefaultAnnotationHandlerMapping

Implementation of the org.springframework.web.servlet.HandlerMapping interface that maps handlers based on HTTP paths expressed through the RequestMapping annotation at the type or method level.

Registered by default in org.springframework.web.servlet.DispatcherServlet on Java 5+. NOTE: If you define custom HandlerMapping beans in your DispatcherServlet context, you need to add a DefaultAnnotationHandlerMapping bean explicitly, since custom HandlerMapping beans replace the default mapping strategies. Defining a DefaultAnnotationHandlerMapping also allows for registering custom interceptors:

 <bean class="org.springframework.web.servlet.mvc.annotation.DefaultAnnotationHandlerMapping">
   <property name="interceptors">
     ...
   </property>
 </bean>
Annotated controllers are usually marked with the Controller stereotype at the type level. This is not strictly necessary when RequestMapping is applied at the type level (since such a handler usually implements the org.springframework.web.servlet.mvc.Controller interface). However, Controller is required for detecting RequestMapping annotations at the method level if RequestMapping is not present at the type level.

NOTE: Method-level mappings are only allowed to narrow the mapping expressed at the class level (if any). HTTP paths need to uniquely map onto specific handler beans, with any given HTTP path only allowed to be mapped onto one specific handler bean (not spread across multiple handler beans). It is strongly recommended to co-locate related handler methods into the same bean.

The AnnotationMethodHandlerAdapter is responsible for processing annotated handler methods, as mapped by this HandlerMapping. For RequestMapping at the type level, specific HandlerAdapters such as org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter apply. @author Juergen Hoeller @author Arjen Poutsma @since 2.5 @see RequestMapping @see AnnotationMethodHandlerAdapterAnnotationMethodHandlerAdapter @deprecated in Spring 3.2 in favor of RequestMappingHandlerMapping