Review recent documentation and default servlet changes
- Relocate and fix typos in interface-based @RequestMapping tip (SPR-7537) - Fix typos in constructor-arg 'name' disambiguation section (SPR-7443) - Polish whitespace in DefaultServletHttpRequestHandler (SPR-7553)
This commit is contained in:
parent
c1d2c36f32
commit
562747ef41
|
|
@ -171,8 +171,8 @@ public class ExampleBean {
|
||||||
</bean></programlisting>
|
</bean></programlisting>
|
||||||
|
|
||||||
<para>Keep in mind that to make this work out of the box your code
|
<para>Keep in mind that to make this work out of the box your code
|
||||||
has to be compiled with the debug flag enabled so that Spring can
|
must be compiled with the debug flag enabled so that Spring can
|
||||||
lookup the parameter name from the constructor. If you can't compile
|
look up the parameter name from the constructor. If you can't compile
|
||||||
your code with debug flag (or don't want to) you can use
|
your code with debug flag (or don't want to) you can use
|
||||||
<interfacename><ulink
|
<interfacename><ulink
|
||||||
url="http://download.oracle.com/javase/6/docs/api/java/beans/ConstructorProperties.html">@ConstructorProperties</ulink></interfacename>
|
url="http://download.oracle.com/javase/6/docs/api/java/beans/ConstructorProperties.html">@ConstructorProperties</ulink></interfacename>
|
||||||
|
|
|
||||||
|
|
@ -667,18 +667,6 @@ public class HelloWorldController {
|
||||||
|
|
||||||
</beans></programlisting>
|
</beans></programlisting>
|
||||||
|
|
||||||
<para>A common pitfall when working with annotated controller classes is
|
|
||||||
a scenario where you want apply functionality to it that involves
|
|
||||||
creating a proxy for the controller object (transactional controllers
|
|
||||||
e.g.). Usually you will introduce an interface for the controller then
|
|
||||||
to use JDK dynamic proxies. To make this work you have to move the
|
|
||||||
<interfacename>@RequestMapping</interfacename> annotations to the
|
|
||||||
interface as well as the mapping lookup only "sees" the interface
|
|
||||||
exposed by the proxy then. An alternative might be to activate
|
|
||||||
<code>proxy-target-class="true"</code> in the configuration for the
|
|
||||||
functionality applied to the controller (in our transaction scenario in
|
|
||||||
<code><tx:annotation-driven /></code>). For more information on
|
|
||||||
various proxying mechanisms see <xref linkend="aop-proxying" />.</para>
|
|
||||||
</section>
|
</section>
|
||||||
|
|
||||||
<section id="mvc-ann-requestmapping">
|
<section id="mvc-ann-requestmapping">
|
||||||
|
|
@ -777,6 +765,25 @@ public class ClinicController {
|
||||||
|
|
||||||
}</programlisting>
|
}</programlisting>
|
||||||
|
|
||||||
|
<tip>
|
||||||
|
<title>Working with interface-based @Controller classes</title>
|
||||||
|
<para>A common pitfall when working with annotated controller classes
|
||||||
|
happens when applying functionality that requires creating a proxy
|
||||||
|
proxy for the controller object (e.g.
|
||||||
|
<interfacename>@Transactional</interfacename> methods). Usually you
|
||||||
|
will introduce an interface for the controller in order to use JDK
|
||||||
|
dynamic proxies. To make this work you must move the
|
||||||
|
<interfacename>@RequestMapping</interfacename> annotations to the
|
||||||
|
interface as as the mapping mechanism can only "see" the interface
|
||||||
|
exposed by the proxy. As an alternative, you may choose to activate
|
||||||
|
<code>proxy-target-class="true"</code> in the configuration for the
|
||||||
|
functionality applied to the controller (in our transaction scenario
|
||||||
|
in <code><tx:annotation-driven /></code>). Doing so indicates
|
||||||
|
that CGLIB-based subclass proxies should be used instead of
|
||||||
|
interface-based JDK proxies. For more information on various proxying
|
||||||
|
mechanisms see <xref linkend="aop-proxying"/>.</para>
|
||||||
|
</tip>
|
||||||
|
|
||||||
<section id="mvc-ann-requestmapping-uri-templates">
|
<section id="mvc-ann-requestmapping-uri-templates">
|
||||||
<title>URI Templates</title>
|
<title>URI Templates</title>
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue