@Resource注解
@Resource 注解被用來激活一個命名資源(named resource)的依賴注入,在JavaEE應用程序中,該注解被典型地轉換為綁定於JNDI context中的一個對象。 Spring確實支持使用@Resource通過JNDI lookup來解析對象,默認地,擁有與@Resource注解所提供名字相匹配的“bean name(bean名字)”的Spring管理對象會被注入。 在下面的例子中,Spring會向加了注解的setter方法傳遞bean名為“dataSource”的Spring管理對象的引用。
@Resource(name="dataSource")
public void setDataSource(DataSource dataSource) {
this.dataSource = dataSource;
}
直接使用@Resource注解一個域(field)同樣是可能的。通過不暴露setter方法,代碼愈發緊湊並且還提供了域不可修改的額外益處。正如下面將要證明的,@Resource注解甚至不需要一個顯式的字符串值,在沒有提供任何值的情況下,域名將被當作默認值。
@Resource
private DataSource dataSource; // inject the bean named 'dataSource'
該方式被應用到setter方法的時候,默認名是從相應的屬性衍生出來,換句話說,命名為'setDataSource'的方法被用來處理名為'dataSource'的屬性。
private DataSource dataSource;
@Resource
public void setDataSource(DataSource dataSource) {
this.dataSource = dataSource;
}
當@Resource沒有顯式提供名字的時候,如果根據默認名字找不到對應的Spring管理對象,注入機制會回滾至類型匹配(type-match)。如果剛好只有一個Spring管理對象符合該依賴的類型,那么它會被注入。通過設置CommonAnnotationBeanPostProcessor 的‘fallbackToDefaultTypeMatch’屬性為“false”(默認值是“true”)可以禁用這一特性。
<bean class="org.springframework.context.annotation.CommonAnnotationBeanPostProcessor">
<property name="fallbackToDefaultTypeMatch" value="false"/>
</bean>
正如上文所提到的,在解析標有@Resource注解的依賴時,Spring支持JNDI-lookup。如若要強制對所有使用@Resource注解的依賴進行JNDI lookup,那也只要將CommonAnnotationBeanPostProcessor的'alwaysUseJndiLookup' 標識設置為true就可以了(默認值是false)。
<bean class="org.springframework.context.annotation.CommonAnnotationBeanPostProcessor">
<property name="alwaysUseJndiLookup" value="true"/>
</bean>
另一個選擇是,激活指定為‘resource-ref-mappings’的依據全局JNDI名的查找,在@Resource注解內提供‘mappedName’屬性。即使目標對象實際上是一個JNDI資源,仍然推薦引入一個Spring管理對象,這樣可以提供一個間接層並且因此降低耦合程度。自Spring2.0開始添加命名空間以來,定義一個委托Spring處理JNDI lookup的bean也變得愈發簡練:
<jee:jndi-lookup id="dataSource" jndi-name="java:comp/env/jdbc/petclinic"/>
這個方法的優點在於間接層帶來了巨大的部署彈性。比如說,一個單獨的系統測試環境應該不再需要JNDI注冊。在這種情況下,在系統測試配置中可以提供如下的bean定義:
<bean id="dataSource" class="org.springframework.jdbc.datasource.DriverManagerDataSource"
p:driverClassName="${jdbc.driverClassName}"
p:url="${jdbc.url}"
p:username="${jdbc.username}"
p:password="${jdbc.password}"/>
順便提一下,上面的例子中,實際的JDBC連接屬性從一個屬性文件(properties file)解析而來,在這個屬性文件里,關鍵字與提供的${占位符}互相對應,這需要注冊一個名為PropertyPlaceholderConfigurer的BeanFactoryPostProcessor實現來完成。這是具體化那些屬性(通常是針對特定環境的屬性)常用的技術,這些屬性可能比其他配置修改得更為頻繁。
<bean class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer">
<property name="location" value="classpath:jdbc.properties"/>
</bean>
Srping2.5中新加入了‘context’命名空間,這個命名空間讓我們能夠得到更為簡潔的方式來實現屬性占位符(property placeholder)的配置:
<context:property-placeholder location="classpath:jdbc.properties"/>