diff --git a/src/reference/docbook/index.xml b/src/reference/docbook/index.xml
index 5ff08474ad8d9e64a837658b828c1810911a47f2..50b859a38a5cdc24069afbe9b4605e63d43fedbf 100644
--- a/src/reference/docbook/index.xml
+++ b/src/reference/docbook/index.xml
@@ -243,6 +243,7 @@
+
diff --git a/src/reference/docbook/new-in-3.2.xml b/src/reference/docbook/new-in-3.2.xml
new file mode 100644
index 0000000000000000000000000000000000000000..ab5baf5dfa2f527dca841f6206d7218cd4c42ffc
--- /dev/null
+++ b/src/reference/docbook/new-in-3.2.xml
@@ -0,0 +1,166 @@
+
+
+ New Features and Enhancements in Spring 3.2
+
+
+ Overview of new features
+
+
+ Support for Servlet 3 based asynchronous request processing
+
+ The Spring MVC programming model now provides explicit Servlet 3 async support.
+ @RequestMapping methods can return one of:
+
+
+
+ java.util.concurrent.Callable to
+ complete processing in a separate thread managed by a task executor
+ within Spring MVC.
+
+
+ org.springframework.web.context.request.async.DeferredResult
+ to complete processing at a later time from a thread not known to
+ Spring MVC, e.g. in response to some external event (JSM, AMQP, etc.)
+
+
+ org.springframework.web.context.request.async.AsyncTask
+ to wrap a Callable and
+ customize the timeout value or the task executor to use.
+
+
+
+ See
+ Introducing Servlet 3 Async Support (SpringSource team blog).
+
+
+
+
+ Content negotiation improvements
+
+ A ContentNeogtiationStrategy is now
+ available for resolving the requested media types from an incoming request.
+ The available implementations are based on path extension, request parameter,
+ 'Accept' header, and a fixed default content type. Equivalent options were
+ previously available only in the ContentNegotiatingViewResolver but are now
+ available throughout.
+
+ ContentNegotiationManager is the central class to
+ use when configuring content negotiation options. It accepts one or
+ more ContentNeogtiationStrategy instances and delegates to them. It can be
+ plugged into RequestMappingHandlerMapping,
+ RequestMappingHandlerAdapter,
+ ExceptionHandlerExceptionResolver,
+ and ContentNegotiatingViewResolver. The MVC
+ namespace and the MVC Java config provide convenient options to configure
+ all that.
+
+ The introduction of ContentNegotiationManger
+ also enables smart suffix pattern matching for incoming requests.
+ See
+ commit message
+
+
+
+
+ @ControllerAdvice annotation
+
+ Classes annotated with @ControllerAdvice
+ can contain @ExceptionHandler,
+ @InitBinder, and
+ @ModelAttribute methods and those will apply
+ to @RequestMapping methods across controller
+ hierarchies as opposed to the controller hierarchy within which they are declared.
+ @ControllerAdvice is
+ a component annotation allowing implementation classes to be auto-detected
+ through classpath scanning.
+
+
+
+
+ ExceptionHandlerSupport class
+
+ A convenient base class with an
+ @ExceptionHandler
+ method that handles standard Spring MVC exceptions, just as the
+ DefaultHandlerExceptionResolver does, but also
+ allowing you to prepare error content for the body of the response.
+
+
+
+
+ Support for generic types in the RestTemplate and in
+ @RequestBody arguments
+
+ The RestTemplate can now read an HTTP
+ response to a generic type (e.g. List<Account>
).
+ There are three new exchange()
methods that accept
+ ParameterizedTypeReference, a
+ new class that enables capturing and passing generic type info.
+
+ In support of this feature, the HttpMessageConverter
+ is extended by GenericHttpMessageConverter
+ adding a method for reading content given a specified parameterized type.
+ The new interface is implemented by the
+ MappingJacksonHttpMessageConverter and also
+ by a new Jaxb2CollectionHttpMessageConverter that can
+ read read a generic Collection where the
+ generic type is a JAXB type annotated with
+ @XmlRootElement or
+ @XmlType.
+
+
+
+
+ Jackson JSON 2 and related improvements
+
+ The Jackson Json 2 library is now supported. Due to packaging changes in
+ the Jackson library, there are separate classes in Spring MVC as well. Those are
+ MappingJackson2HttpMessageConverter and
+ MappingJackson2JsonView.
+ Other related configuration improvements include support for
+ pretty printing as well as a
+ JacksonObjectMapperFactoryBean for convenient
+ customization of an ObjectMapper in
+ XML configuration.
+
+
+
+
+ @RequestBody improvements
+
+ An @RequestBody or an
+ @RequestPart argument can now be followed by an
+ Errors argument making it possible to handle
+ validation errors (as a result of an @Valid
+ annotation) locally within the @RequestMapping method.
+ @RequestBody now also supports
+ a required flag.
+
+
+
+
+ HTTP PATCH method
+
+ The HTTP request method PATCH
may now be used in
+ @RequestMapping methods as well as in
+ the RestTemplate in conjunction with
+ Apache HttpComponents HttpClient version 4.2 or later.
+ The JDK HttpURLConnection does not support the
+ PATCH
method.
+
+
+
+
+ Excluded patterns in mapped interceptors
+
+ Mapped interceptors now support URL patterns to be excluded.
+ The MVC namespace and the MVC Java config both expose these options.
+
+
+
+
+