root
/
spring-framework
mirror of https://github.com/spring-projects/spring-framework.git
1
0
Fork 0
Code Issues Actions Packages Projects Releases Wiki Activity

SPR-7858 

removed references to JSR 330  since there is now a dedicated JSR 330 section inside beans-standard-annotations.xml
This commit is contained in:
Michael Isvy 2011-07-06 06:15:27 +00:00
parent a590318b3c
commit 4aeaaa083f
1 changed files with 16 additions and 35 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

51
spring-framework-reference/src/beans-annotation-config.xml
View File

@ -39,21 +39,18 @@
annotations is a common means of extending the Spring IoC container. For annotations is a common means of extending the Spring IoC container. For
example, Spring 2.0 introduced the possibility of enforcing required example, Spring 2.0 introduced the possibility of enforcing required
properties with the <link linkend="beans-required-annotation" properties with the <link linkend="beans-required-annotation"
>@Required</link> annotation. As of Spring 2.5, it is now possible to follow >@Required</link> annotation. Spring 2.5 made it possible to follow
that same general approach to drive Spring's dependency injection. that same general approach to drive Spring's dependency injection.
Essentially, the <interfacename>@Autowired</interfacename> annotation Essentially, the <interfacename>@Autowired</interfacename> annotation
provides the same capabilities as described in <xref provides the same capabilities as described in <xref
linkend="beans-factory-autowire"/> but with more fine-grained control and linkend="beans-factory-autowire"/> but with more fine-grained control and
wider applicability. Spring 2.5 also adds support for JSR-250 annotations wider applicability. Spring 2.5 also added support for JSR-250 annotations
such as <interfacename>@Resource</interfacename>, such as <interfacename>@PostConstruct</interfacename>, and
<interfacename>@PostConstruct</interfacename>, and <interfacename>@PreDestroy</interfacename>. Spring 3.0 added support for
<interfacename>@PreDestroy</interfacename>. Spring 3.0 adds support for
JSR-330 (Dependency Injection for Java) annotations contained in the JSR-330 (Dependency Injection for Java) annotations contained in the
javax.inject package such as <classname>@Inject</classname>, javax.inject package such as <classname>@Inject</classname> and
<literal>@Qualifier, @Named, and @Provider</literal> if the JSR330 jar is <literal> @Named</literal>. Details about those annotations can be found in the <link linkend="beans-standard-annotations"
present on the classpath. Use of these annotations also requires that >relevant section</link>. <note> Annotation injection is performed
certain <interfacename>BeanPostProcessors</interfacename> be registered
within the Spring container. <note> Annotation injection is performed
<emphasis>before</emphasis> XML injection, thus the latter configuration <emphasis>before</emphasis> XML injection, thus the latter configuration
will override the former for properties wired through both approaches. will override the former for properties wired through both approaches.
</note> As always, you can register them as individual bean definitions, but </note> As always, you can register them as individual bean definitions, but
@ -127,21 +124,13 @@
</section> </section>
<section id="beans-autowired-annotation"> <section id="beans-autowired-annotation">
<title><interfacename>@Autowired and @Inject</interfacename></title> <title><interfacename>@Autowired</interfacename></title>
<para>As expected, you can apply the <para>As expected, you can apply the
<interfacename>@Autowired</interfacename> annotation to "traditional" <interfacename>@Autowired</interfacename> annotation to "traditional"
setter methods:</para> setter methods:</para>
<note>
<para>JSR 330's @Inject annotation can be used in place of Spring's
<interfacename>@Autowired</interfacename> in the examples below.
<interfacename>@Inject</interfacename> does not have a required property
unlike Spring's <interfacename>@Autowired</interfacename> annotation
which has a <literal>required</literal> property to indicate if the
value being injected is optional. This behavior is enabled automatically
if you have the JSR 330 JAR on the classpath.</para>
</note>
<programlisting language="java">public class SimpleMovieLister { <programlisting language="java">public class SimpleMovieLister {
@ -155,6 +144,13 @@
<lineannotation>// ...</lineannotation> <lineannotation>// ...</lineannotation>
}</programlisting> }</programlisting>
<note>
<para>JSR 330's @Inject annotation can be used in place of Spring's
<interfacename>@Autowired</interfacename> annotation in the examples below. See <link linkend="beans-standard-annotations"
>here</link> for more details</para>
</note>
<para>You can also apply the annotation to methods with arbitrary names <para>You can also apply the annotation to methods with arbitrary names
and/or multiple arguments:</para> and/or multiple arguments:</para>
@ -324,14 +320,6 @@
matches so that a specific bean is chosen for each argument. In the matches so that a specific bean is chosen for each argument. In the
simplest case, this can be a plain descriptive value:</para> simplest case, this can be a plain descriptive value:</para>
<note>
<para>JSR 330's <interfacename>@Qualifier</interfacename> annotation can
only be applied as a meta-annotation unlike Spring's @Qualifier which
takes a string property to discriminate among multiple injection
candidates and can be placed on annotations as well as types, fields,
methods, constructors, and parameters.</para>
</note>
<programlisting language="java">public class MovieRecommender { <programlisting language="java">public class MovieRecommender {
@Autowired @Autowired
@ -444,13 +432,6 @@
annotation and provide the <interfacename>@Qualifier</interfacename> annotation and provide the <interfacename>@Qualifier</interfacename>
annotation within your definition:</para> annotation within your definition:</para>
<note>
<para>You can use JSR 330's <interfacename>@Qualifier
</interfacename>annotation in the manner described below in place of
Spring's <interfacename>@Qualifier</interfacename> annotation. This
behavior is enabled automatically if you have the JSR 330 jar on the
classpath.</para>
</note>
<programlisting language="java">@Target({ElementType.FIELD, ElementType.PARAMETER}) <programlisting language="java">@Target({ElementType.FIELD, ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME) @Retention(RetentionPolicy.RUNTIME)