http://www.ibm.com/developerworks/cn/opensource/os-cn-spring-iocannt/
http://www.ibm.com/developerworks/cn/java/j-lo-spring25-ioc/
使用 @Repository、@Service、@Controller 和 @Component 將類標(biāo)識為 Bean
Spring 自 2.0 版本開始，陸續(xù)引入了一些注解用于簡化 Spring 的開發(fā)。@Repository 注解便屬于最先引入的一批，它用于將數(shù)據(jù)訪問層 (DAO 層 ) 的類標(biāo)識為 Spring Bean。具體只需將該注解標(biāo)注在 DAO 類上即可。同時，為了讓 Spring 能夠掃描類路徑中的類并識別出 @Repository 注解，需要在 XML 配置文件中啟用 Bean 的自動掃描功能，這可以通過 <context:component-scan/> 實(shí)現(xiàn)。如下所示：
// 首先使用 @Repository 將 DAO 類聲明為 Bean
package bookstore.dao;
@Repository
public class UserDaoImpl implements UserDao{ …… }
// 其次，在 XML 配置文件中啟動 Spring 的自動掃描功能
<beans … >
……
<context:component-scan base-package=”bookstore.dao” />
……
</beans>
|
如此，我們就不再需要在 XML 中顯式使用 <bean/> 進(jìn)行 Bean 的配置。Spring 在容器初始化時將自動掃描 base-package 指定的包及其子包下的所有 class 文件，所有標(biāo)注了 @Repository 的類都將被注冊為 Spring Bean。
為什么 @Repository 只能標(biāo)注在 DAO 類上呢？這是因?yàn)樵撟⒔獾淖饔貌恢皇菍㈩愖R別為 Bean，同時它還能將所標(biāo)注的類中拋出的數(shù)據(jù)訪問異常封裝為 Spring 的數(shù)據(jù)訪問異常類型。 Spring 本身提供了一個豐富的并且是與具體的數(shù)據(jù)訪問技術(shù)無關(guān)的數(shù)據(jù)訪問異常結(jié)構(gòu)，用于封裝不同的持久層框架拋出的異常，使得異常獨(dú)立于底層的框架。
Spring 2.5 在 @Repository 的基礎(chǔ)上增加了功能類似的額外三個注解：@Component、@Service、@Constroller，它們分別用于軟件系統(tǒng)的不同層次：
- @Component 是一個泛化的概念，僅僅表示一個組件 (Bean) ，可以作用在任何層次。
- @Service 通常作用在業(yè)務(wù)層，但是目前該功能與 @Component 相同。
- @Constroller 通常作用在控制層，但是目前該功能與 @Component 相同。
通過在類上使用 @Repository、@Component、@Service 和 @Constroller 注解，Spring 會自動創(chuàng)建相應(yīng)的 BeanDefinition 對象，并注冊到 ApplicationContext 中。這些類就成了 Spring 受管組件。這三個注解除了作用于不同軟件層次的類，其使用方式與 @Repository 是完全相同的。
另外，除了上面的四個注解外，用戶可以創(chuàng)建自定義的注解，然后在注解上標(biāo)注 @Component，那么，該自定義注解便具有了與所 @Component 相同的功能。不過這個功能并不常用。
當(dāng)一個 Bean 被自動檢測到時，會根據(jù)那個掃描器的 BeanNameGenerator 策略生成它的 bean 名稱。默認(rèn)情況下，對于包含 name 屬性的 @Component、@Repository、 @Service 和 @Controller，會把 name 取值作為 Bean 的名字。如果這個注解不包含 name 值或是其他被自定義過濾器發(fā)現(xiàn)的組件，默認(rèn) Bean 名稱會是小寫開頭的非限定類名。如果你不想使用默認(rèn) bean 命名策略，可以提供一個自定義的命名策略。首先實(shí)現(xiàn) BeanNameGenerator 接口，確認(rèn)包含了一個默認(rèn)的無參數(shù)構(gòu)造方法。然后在配置掃描器時提供一個全限定類名，如下所示：
<beans ...>
<context:component-scan
base-package="a.b" name-generator="a.SimpleNameGenerator"/>
</beans>
|
與通過 XML 配置的 Spring Bean 一樣，通過上述注解標(biāo)識的 Bean，其默認(rèn)作用域是"singleton"，為了配合這四個注解，在標(biāo)注 Bean 的同時能夠指定 Bean 的作用域，Spring 2.5 引入了 @Scope 注解。使用該注解時只需提供作用域的名稱就行了，如下所示：
@Scope("prototype")
@Repository
public class Demo { … }
|
如果你想提供一個自定義的作用域解析策略而不使用基于注解的方法，只需實(shí)現(xiàn) ScopeMetadataResolver 接口，確認(rèn)包含一個默認(rèn)的沒有參數(shù)的構(gòu)造方法。然后在配置掃描器時提供全限定類名：
<context:component-scan base-package="a.b"
scope-resolver="footmark.SimpleScopeResolver" />
|
回頁首
使用 @PostConstruct 和 @PreDestroy 指定生命周期回調(diào)方法
Spring Bean 是受 Spring IoC 容器管理，由容器進(jìn)行初始化和銷毀的（prototype 類型由容器初始化之后便不受容器管理），通常我們不需要關(guān)注容器對 Bean 的初始化和銷毀操作，由 Spring 經(jīng)過構(gòu)造函數(shù)或者工廠方法創(chuàng)建的 Bean 就是已經(jīng)初始化完成并立即可用的。然而在某些情況下，可能需要我們手工做一些額外的初始化或者銷毀操作，這通常是針對一些資源的獲取和釋放操作。 Spring 1.x 為此提供了兩種方式供用戶指定執(zhí)行生命周期回調(diào)的方法。
第一種方式是實(shí)現(xiàn) Spring 提供的兩個接口：InitializingBean 和 DisposableBean。如果希望在 Bean 初始化完成之后執(zhí)行一些自定義操作，則可以讓 Bean 實(shí)現(xiàn) InitializingBean 接口，該接口包含一個 afterPropertiesSet() 方法，容器在為該 Bean 設(shè)置了屬性之后，將自動調(diào)用該方法；如果 Bean 實(shí)現(xiàn)了 DisposableBean 接口，則容器在銷毀該 Bean 之前，將調(diào)用該接口的 destroy() 方法。這種方式的缺點(diǎn)是，讓 Bean 類實(shí)現(xiàn) Spring 提供的接口，增加了代碼與 Spring 框架的耦合度，因此不推薦使用。
第二種方式是在 XML 文件中使用 <bean> 的 init-method 和 destroy-method 屬性指定初始化之后和銷毀之前的回調(diào)方法，代碼無需實(shí)現(xiàn)任何接口。這兩個屬性的取值是相應(yīng) Bean 類中的初始化和銷毀方法，方法名任意，但是方法不能有參數(shù)。示例如下：
<bean id=”userService”
class=”bookstore.service.UserService”
init-method=”init” destroy-method=”destroy”>
…
</bean>
|
Spring 2.5 在保留以上兩種方式的基礎(chǔ)上，提供了對 JSR-250 的支持。JSR-250 規(guī)范定義了兩個用于指定聲明周期方法的注解：@PostConstruct 和 @PreDestroy。這兩個注解使用非常簡單，只需分別將他們標(biāo)注于初始化之后執(zhí)行的回調(diào)方法或者銷毀之前執(zhí)行的回調(diào)方法上。由于使用了注解，因此需要配置相應(yīng)的 Bean 后處理器，亦即在 XML 中增加如下一行：
<context:annotation-config />
|
比較上述三種指定生命周期回調(diào)方法的方式，第一種是不建議使用的，不但其用法不如后兩種方式靈活，而且無形中增加了代碼與框架的耦合度。后面兩種方式開發(fā)者可以根據(jù)使用習(xí)慣選擇其中一種，但是最好不要混合使用，以免增加維護(hù)的難度。
回頁首
使用 @Required 進(jìn)行 Bean 的依賴檢查
依賴檢查的作用是，判斷給定 Bean 的相應(yīng) Setter 方法是否都在實(shí)例化的時候被調(diào)用了。而不是判斷字段是否已經(jīng)存在值了。Spring 進(jìn)行依賴檢查時，只會判斷屬性是否使用了 Setter 注入。如果某個屬性沒有使用 Setter 注入，即使是通過構(gòu)造函數(shù)已經(jīng)為該屬性注入了值，Spring 仍然認(rèn)為它沒有執(zhí)行注入，從而拋出異常。另外，Spring 只管是否通過 Setter 執(zhí)行了注入，而對注入的值卻沒有任何要求，即使注入的 <null/>，Spring 也認(rèn)為是執(zhí)行了依賴注入。
<bean> 標(biāo)簽提供了 dependency-check 屬性用于進(jìn)行依賴檢查。該屬性的取值包括以下幾種：
- none -- 默認(rèn)不執(zhí)行依賴檢查?？梢栽?<beans> 標(biāo)簽上使用 default-dependency-check 屬性改變默認(rèn)值。
- simple -- 對原始基本類型和集合類型進(jìn)行檢查。
- objects -- 對復(fù)雜類型進(jìn)行檢查（除了 simple 所檢查類型之外的其他類型）。
- all -- 對所有類型進(jìn)行檢查。
舊版本使用 dependency-check 在配置文件中設(shè)置，缺點(diǎn)是粒度較粗。使用 Spring2.0 提供的 @Required 注解，提供了更細(xì)粒度的控制。@Required 注解只能標(biāo)注在 Setter 方法之上。因?yàn)橐蕾囎⑷氲谋举|(zhì)是檢查 Setter 方法是否被調(diào)用了，而不是真的去檢查屬性是否賦值了以及賦了什么樣的值。如果將該注解標(biāo)注在非 setXxxx() 類型的方法則被忽略。
為了讓 Spring 能夠處理該注解，需要激活相應(yīng)的 Bean 后處理器。要激活該后處理器，只需在 XML 中增加如下一行即可。
<context:annotation-config/>
|
當(dāng)某個被標(biāo)注了 @Required 的 Setter 方法沒有被調(diào)用，則 Spring 在解析的時候會拋出異常，以提醒開發(fā)者對相應(yīng)屬性進(jìn)行設(shè)置。
回頁首
使用 @Resource、@Autowired 和 @Qualifier 指定 Bean 的自動裝配策略
自動裝配是指，Spring 在裝配 Bean 的時候，根據(jù)指定的自動裝配規(guī)則，將某個 Bean 所需要引用類型的 Bean 注入進(jìn)來。<bean> 元素提供了一個指定自動裝配類型的 autowire 屬性，該屬性有如下選項(xiàng)：
- no -- 顯式指定不使用自動裝配。
- byName -- 如果存在一個和當(dāng)前屬性名字一致的 Bean，則使用該 Bean 進(jìn)行注入。如果名稱匹配但是類型不匹配，則拋出異常。如果沒有匹配的類型，則什么也不做。
- byType -- 如果存在一個和當(dāng)前屬性類型一致的 Bean ( 相同類型或者子類型 )，則使用該 Bean 進(jìn)行注入。byType 能夠識別工廠方法，即能夠識別 factory-method 的返回類型。如果存在多個類型一致的 Bean，則拋出異常。如果沒有匹配的類型，則什么也不做。
- constructor -- 與 byType 類似，只不過它是針對構(gòu)造函數(shù)注入而言的。如果當(dāng)前沒有與構(gòu)造函數(shù)的參數(shù)類型匹配的 Bean，則拋出異常。使用該種裝配模式時，優(yōu)先匹配參數(shù)最多的構(gòu)造函數(shù)。
- autodetect -- 根據(jù) Bean 的自省機(jī)制決定采用 byType 還是 constructor 進(jìn)行自動裝配。如果 Bean 提供了默認(rèn)的構(gòu)造函數(shù)，則采用 byType；否則采用 constructor 進(jìn)行自動裝配。
當(dāng)使用 byType 或者 constructor 類型的自動裝配的時候，自動裝配也支持引用類型的數(shù)組或者使用了泛型的集合，這樣，Spring 就會檢查容器中所有類型匹配的 Bean，組成集合或者數(shù)組后執(zhí)行注入。對于使用了泛型的 Map 類型，如果鍵是 String 類型，則 Spring 也會自動執(zhí)行裝配，將所有類型匹配的 Bean 作為值，Bean 的名字作為鍵。
我們可以給 <beans> 增加 default-autowire 屬性，設(shè)置默認(rèn)的自動封裝策略。默認(rèn)值為"no"。如果使用自動裝配的同時，也指定了 property 或者 constructor-arg 標(biāo)簽，則顯式指定的值將覆蓋自動裝配的值。目前的自動封裝不支持簡單類型，比如基本類型、String、Class，以及它們的數(shù)組類型。
在按類型匹配的時候 ( 可能是 byType、constructor、autodetect)，同一個類型可能存在多個 Bean，如果被注入的屬性是數(shù)組、集合或者 Map，這可能沒有問題，但是如果只是簡單的引用類型，則會拋出異常。解決方法有如下幾種：
- 取消該 Bean 的自動裝配特性，使用顯式的注入。我們可能不希望某個 Bean 被當(dāng)作其他 Bean 執(zhí)行自動封裝時的候選對象，我們可以給該 <bean> 增加 autowire-candidate="false"。(autowire-candidate 屬性和 autowire 屬性相互獨(dú)立，互不相干。某個 Bean 可以將 autowire-candidate 設(shè)置為 false，同時使用 autowire 特性。) 另外，我們可以設(shè)置 <beans> 的 default-autowire-candidates 屬性，可以在該屬性中指定可以用于自動裝配候選 Bean 的匹配模式，比如 default-autowire-candidates="*serv,*dao"，這表示所有名字以 serv 或者 dao 結(jié)尾的 Bean 被列為候選，其他則忽略，相當(dāng)于其他 Bean 都指定為 autowire-candidate="false"，此時可以顯式為 <bean> 指定 autowire-candidate="true"。在 <bean> 上指定的設(shè)置要覆蓋 <beans> 上指定的設(shè)置。
- 如果在多個類型相同的 Bean 中有首選的 Bean，那么可以將該 <bean> 的 primary 屬性設(shè)置為 "true" ，這樣自動裝配時便優(yōu)先使用該 Bean 進(jìn)行裝配。此時不能將 autowire-candidate 設(shè)為 false。
- 如果使用的是 Java 5 以上版本，可以使用注解進(jìn)行更細(xì)粒度的控制。
使用 @Autowired 和 @Qualifier 注解執(zhí)行自動裝配
使用 @Autowired 注解進(jìn)行裝配，只能是根據(jù)類型進(jìn)行匹配。@Autowired 注解可以用于 Setter 方法、構(gòu)造函數(shù)、字段，甚至普通方法，前提是方法必須有至少一個參數(shù)。@Autowired 可以用于數(shù)組和使用泛型的集合類型。然后 Spring 會將容器中所有類型符合的 Bean 注入進(jìn)來。@Autowired 標(biāo)注作用于 Map 類型時，如果 Map 的 key 為 String 類型，則 Spring 會將容器中所有類型符合 Map 的 value 對應(yīng)的類型的 Bean 增加進(jìn)來，用 Bean 的 id 或 name 作為 Map 的 key。
@Autowired 標(biāo)注作用于普通方法時，會產(chǎn)生一個副作用，就是在容器初始化該 Bean 實(shí)例的時候就會調(diào)用該方法。當(dāng)然，前提是執(zhí)行了自動裝配，對于不滿足裝配條件的情況，該方法也不會被執(zhí)行。
當(dāng)標(biāo)注了 @Autowired 后，自動注入不能滿足，則會拋出異常。我們可以給 @Autowired 標(biāo)注增加一個 required=false 屬性，以改變這個行為。另外，每一個類中只能有一個構(gòu)造函數(shù)的 @Autowired.required() 屬性為 true。否則就出問題了。如果用 @Autowired 同時標(biāo)注了多個構(gòu)造函數(shù)，那么，Spring 將采用貪心算法匹配構(gòu)造函數(shù) ( 構(gòu)造函數(shù)最長 )。
@Autowired 還有一個作用就是，如果將其標(biāo)注在 BeanFactory 類型、ApplicationContext 類型、ResourceLoader 類型、ApplicationEventPublisher 類型、MessageSource 類型上，那么 Spring 會自動注入這些實(shí)現(xiàn)類的實(shí)例，不需要額外的操作。
當(dāng)容器中存在多個 Bean 的類型與需要注入的相同時，注入將不能執(zhí)行，我們可以給 @Autowired 增加一個候選值，做法是在 @Autowired 后面增加一個 @Qualifier 標(biāo)注，提供一個 String 類型的值作為候選的 Bean 的名字。舉例如下：
@Autowired(required=false)
@Qualifier("ppp")
public void setPerson(person p){}
|
@Qualifier 甚至可以作用于方法的參數(shù) ( 對于方法只有一個參數(shù)的情況，我們可以將 @Qualifer 標(biāo)注放置在方法聲明上面，但是推薦放置在參數(shù)前面 )，舉例如下：
@Autowired(required=false)
public void sayHello(@Qualifier("ppp")Person p,String name){}
|
我們可以在配置文件中指定某個 Bean 的 qualifier 名字，方法如下：
<bean id="person" class="footmark.spring.Person">
<qualifier value="ppp"/>
</bean>
|
如果沒有明確指定 Bean 的 qualifier 名字，那么默認(rèn)名字就是 Bean 的名字。通常，qualifier 應(yīng)該是有業(yè)務(wù)含義的，例如 "domain"，"persistent" 等，而不應(yīng)該是類似 "person" 方式。
我們還可以將 @Qualifier 標(biāo)注在集合類型上，那么所有 qualifier 名字與指定值相同的 Bean 都將被注入進(jìn)來。
最后，配置文件中需要指定每一個自定義注解的屬性值。我們可以使用 <meta> 標(biāo)簽來代替 <qualifier/> 標(biāo)簽，如果 <meta> 標(biāo)簽和 <qualifier/> 標(biāo)簽同時出現(xiàn)，那么優(yōu)先使用 <qualifier> 標(biāo)簽。如果沒有 <qualifier> 標(biāo)簽，那么會用 <meta> 提供的鍵值對來封裝 <qualifier> 標(biāo)簽。示例如下：
<bean class="footmark.HelloWorld">
<qualifier type="MovieQualifier">
<attribute key="format" value="VHS"/>
<attribute key="genre" value="Comedy"/>
</qualifier>
</bean>
<bean class="footmark.HelloWorld">
<meta key="format" value="DVD"/>
<meta key="genre" value="Action"/>
</bean>
|
@Autowired 注解對應(yīng)的后處理注冊與前面相似，只需在配置文件中增加如下一行即可：
<context:annotation-config/>
|
如果 @Autowired 注入的是 BeanFactory、ApplicationContext、ResourceLoader 等系統(tǒng)類型，那么則不需要 @Qualifier，此時即使提供了 @Qualifier 注解，也將會被忽略；而對于自定義類型的自動裝配，如果使用了 @Qualifier 注解并且沒有名字與之匹配的 Bean，則自動裝配匹配失敗。
使用 JSR-250 中的 @Resource 和 @Qualifier 注解
如果希望根據(jù) name 執(zhí)行自動裝配，那么應(yīng)該使用 JSR-250 提供的 @Resource 注解，而不應(yīng)該使用 @Autowired 與 @Qualifier 的組合。
@Resource 使用 byName 的方式執(zhí)行自動封裝。@Resource 標(biāo)注可以作用于帶一個參數(shù)的 Setter 方法、字段，以及帶一個參數(shù)的普通方法上。@Resource 注解有一個 name 屬性，用于指定 Bean 在配置文件中對應(yīng)的名字。如果沒有指定 name 屬性，那么默認(rèn)值就是字段或者屬性的名字。@Resource 和 @Qualifier 的配合雖然仍然成立，但是 @Qualifier 對于 @Resource 而言，幾乎與 name 屬性等效。
如果 @Resource 沒有指定 name 屬性，那么使用 byName 匹配失敗后，會退而使用 byType 繼續(xù)匹配，如果再失敗，則拋出異常。在沒有為 @Resource 注解顯式指定 name 屬性的前提下，如果將其標(biāo)注在 BeanFactory 類型、ApplicationContext 類型、ResourceLoader 類型、ApplicationEventPublisher 類型、MessageSource 類型上，那么 Spring 會自動注入這些實(shí)現(xiàn)類的實(shí)例，不需要額外的操作。此時 name 屬性不需要指定 ( 或者指定為"")，否則注入失??；如果使用了 @Qualifier，則該注解將被忽略。而對于用戶自定義類型的注入，@Qualifier 和 name 等價，并且不被忽略。
<bean> 的 primary 和 autowire-candidate 屬性對 @Resource、@Autowired 仍然有效。
回頁首
使用 @Configuration 和 @Bean 進(jìn)行 Bean 的聲明
雖然 2.0 版本發(fā)布以來，Spring 陸續(xù)提供了十多個注解，但是提供的這些注解只是為了在某些情況下簡化 XML 的配置，并非要取代 XML 配置方式。這一點(diǎn)可以從 Spring IoC 容器的初始化類可以看出：ApplicationContext 接口的最常用的實(shí)現(xiàn)類是 ClassPathXmlApplicationContext 和 FileSystemXmlApplicationContext，以及面向 Portlet 的 XmlPortletApplicationContext 和面向 web 的 XmlWebApplicationContext，它們都是面向 XML 的。Spring 3.0 新增了另外兩個實(shí)現(xiàn)類：AnnotationConfigApplicationContext 和 AnnotationConfigWebApplicationContext。從名字便可以看出，它們是為注解而生，直接依賴于注解作為容器配置信息來源的 IoC 容器初始化類。由于 AnnotationConfigWebApplicationContext 是 AnnotationConfigApplicationContext 的 web 版本，其用法與后者相比幾乎沒有什么差別，因此本文將以 AnnotationConfigApplicationContext 為例進(jìn)行講解。
AnnotationConfigApplicationContext 搭配上 @Configuration 和 @Bean 注解，自此，XML 配置方式不再是 Spring IoC 容器的唯一配置方式。兩者在一定范圍內(nèi)存在著競爭的關(guān)系，但是它們在大多數(shù)情況下還是相互協(xié)作的關(guān)系，兩者的結(jié)合使得 Spring IoC 容器的配置更簡單，更強(qiáng)大。
之前，我們將配置信息集中寫在 XML 中，如今使用注解，配置信息的載體由 XML 文件轉(zhuǎn)移到了 Java 類中。我們通常將用于存放配置信息的類的類名以 “Config” 結(jié)尾，比如 AppDaoConfig.java、AppServiceConfig.java 等等。我們需要在用于指定配置信息的類上加上 @Configuration 注解，以明確指出該類是 Bean 配置的信息源。并且 Spring 對標(biāo)注 Configuration 的類有如下要求：
- 配置類不能是 final 的；
- 配置類不能是本地化的，亦即不能將配置類定義在其他類的方法內(nèi)部；
- 配置類必須有一個無參構(gòu)造函數(shù)。
AnnotationConfigApplicationContext 將配置類中標(biāo)注了 @Bean 的方法的返回值識別為 Spring Bean，并注冊到容器中，受 IoC 容器管理。@Bean 的作用等價于 XML 配置中的 <bean/> 標(biāo)簽。示例如下：
@Configuration
public class BookStoreDaoConfig{
@Bean
public UserDao userDao(){ return new UserDaoImpl();}
@Bean
public BookDao bookDao(){return new BookDaoImpl();}
}
|
Spring 在解析到以上文件時，將識別出標(biāo)注 @Bean 的所有方法，執(zhí)行之，并將方法的返回值 ( 這里是 UserDaoImpl 和 BookDaoImpl 對象 ) 注冊到 IoC 容器中。默認(rèn)情況下，Bean 的名字即為方法名。因此，與以上配置等價的 XML 配置如下：
<bean id=”userDao” class=”bookstore.dao.UserDaoImpl”/>
<bean id=”bookDao” class=”bookstore.dao.BookDaoImpl”/>
|
@Bean 具有以下四個屬性：
- name -- 指定一個或者多個 Bean 的名字。這等價于 XML 配置中 <bean> 的 name 屬性。
- initMethod -- 容器在初始化完 Bean 之后，會調(diào)用該屬性指定的方法。這等價于 XML 配置中 <bean> 的 init-method 屬性。
- destroyMethod -- 該屬性與 initMethod 功能相似，在容器銷毀 Bean 之前，會調(diào)用該屬性指定的方法。這等價于 XML 配置中 <bean> 的 destroy-method 屬性。
- autowire -- 指定 Bean 屬性的自動裝配策略，取值是 Autowire 類型的三個靜態(tài)屬性。Autowire.BY_NAME，Autowire.BY_TYPE，Autowire.NO。與 XML 配置中的 autowire 屬性的取值相比，這里少了 constructor，這是因?yàn)?constructor 在這里已經(jīng)沒有意義了。
@Bean 沒有直接提供指定作用域的屬性，可以通過 @Scope 來實(shí)現(xiàn)該功能，關(guān)于 @Scope 的用法已在上文列舉。
下面講解基于注解的容器初始化。AnnotationConfigApplicationContext 提供了三個構(gòu)造函數(shù)用于初始化容器。
- AnnotationConfigApplicationContext()：該構(gòu)造函數(shù)初始化一個空容器，容器不包含任何 Bean 信息，需要在稍后通過調(diào)用其 register() 方法注冊配置類，并調(diào)用 refresh() 方法刷新容器。
- AnnotationConfigApplicationContext(Class<?>... annotatedClasses)：這是最常用的構(gòu)造函數(shù)，通過將涉及到的配置類傳遞給該構(gòu)造函數(shù)，以實(shí)現(xiàn)將相應(yīng)配置類中的 Bean 自動注冊到容器中。
- AnnotationConfigApplicationContext(String... basePackages)：該構(gòu)造函數(shù)會自動掃描以給定的包及其子包下的所有類，并自動識別所有的 Spring Bean，將其注冊到容器中。它不但識別標(biāo)注 @Configuration 的配置類并正確解析，而且同樣能識別使用 @Repository、@Service、@Controller、@Component 標(biāo)注的類。
除了使用上面第三種類型的構(gòu)造函數(shù)讓容器自動掃描 Bean 的配置信息以外，AnnotationConfigApplicationContext 還提供了 scan() 方法，其功能與上面也類似，該方法主要用在容器初始化之后動態(tài)增加 Bean 至容器中。調(diào)用了該方法以后，通常需要立即手動調(diào)用 refresh() 刷新容器，以讓變更立即生效。
需要注意的是，AnnotationConfigApplicationContext 在解析配置類時，會將配置類自身注冊為一個 Bean，因?yàn)?@Configuration 注解本身定義時被 @Component 標(biāo)注了。因此可以說，一個 @Configuration 同時也是一個 @Component。大多數(shù)情況下，開發(fā)者用不到該 Bean，并且在理想情況下，該 Bean 應(yīng)該是對開發(fā)者透明的。@Configuration 的定義如下所示：
@Target({ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Component
public @interface Configuration {
String value() default "";
}
|
在一般的項(xiàng)目中，為了結(jié)構(gòu)清晰，通常會根據(jù)軟件的模塊或者結(jié)構(gòu)定義多個 XML 配置文件，然后再定義一個入口的配置文件，該文件使用 <import/> 將其他的配置文件組織起來。最后只需將該文件傳給 ClassPathXmlApplicationContext 的構(gòu)造函數(shù)即可。針對基于注解的配置，Spring 也提供了類似的功能，只需定義一個入口配置類，并在該類上使用 @Import 注解引入其他的配置類即可，最后只需要將該入口類傳遞給 AnnotationConfigApplicationContext。具體示例如下：
@Configuration
@Import({BookStoreServiceConfig.class,BookStoreDaoConfig.class})
public class BookStoreConfig{ … }
|
回頁首
混合使用 XML 與注解進(jìn)行 Bean 的配置
設(shè)計(jì) @Configuration 和 @Bean 的初衷，并不是為了完全取代 XML，而是為了在 XML 之外多一種可行的選擇。由于 Spring 自發(fā)布以來，Spring 開發(fā)小組便不斷簡化 XML 配置，使得 XML 配置方式已經(jīng)非常成熟，加上 Spring 2.0 以后出現(xiàn)了一系列命名空間的支持，使得 XML 配置方式成為了使用簡單、功能強(qiáng)大的 Bean 定義方式。而且，XML 配置的一些高級功能目前還沒有相關(guān)注解能夠直接支持。因此，在目前的多數(shù)項(xiàng)目中，要么使用純粹的 XML 配置方式進(jìn)行 Bean 的配置，要么使用以注解為主，XML 為輔的配置方式進(jìn)行 Bean 的配置。
之所以會出現(xiàn)兩者共存的情況，主要?dú)w結(jié)為三個原因：其一，目前絕大多數(shù)采用 Spring 進(jìn)行開發(fā)的項(xiàng)目，幾乎都是基于 XML 配置方式的，Spring 在引入注解的同時，必須保證注解能夠與 XML 和諧共存，這是前提；其二，由于注解引入較晚，因此功能也沒有發(fā)展多年的 XML 強(qiáng)大，因此，對于復(fù)雜的配置，注解還很難獨(dú)當(dāng)一面，在一段時間內(nèi)仍然需要 XML 的配合才能解決問題。除此之外，Spring 的 Bean 的配置方式與 Spring 核心模塊之間是解耦的，因此，改變配置方式對 Spring 的框架自身是透明的。Spring 可以通過使用 Bean 后處理器 (BeanPostProcessor) 非常方便的增加對于注解的支持。這在技術(shù)實(shí)現(xiàn)上非常容易的事情。
要使用混合配置方式，首先需要判斷以哪一種配置方式為主。對這個問題的不同回答將會直接影響到實(shí)現(xiàn)的方式。然而大可不必為此傷腦筋，因?yàn)椴徽撌且?XML 為主，還是以注解為主，配置方式都是簡單而且容易理解的。這里不存在錯誤的決定，因?yàn)閮H僅是表現(xiàn)方式不一樣。我們首先假設(shè)以 XML 配置為主的情況。
對于已經(jīng)存在的大型項(xiàng)目，可能初期是以 XML 進(jìn)行 Bean 配置的，后續(xù)逐漸加入了注解的支持，這時我們只需在 XML 配置文件中將被 @Configuration 標(biāo)注的類定義為普通的 <bean>，同時注冊處理注解的 Bean 后處理器即可。示例如下：
// 假設(shè)存在如下的 @Configuration 類：
package bookstore.config;
import bookstore.dao.*;
@Configuration
public class MyConfig{
@Bean
public UserDao userDao(){
return new UserDaoImpl();
}
}
此時，只需在 XML 中作如下聲明即可：
<beans … >
……
<context:annotation-config />
<bean class=”demo.config.MyConfig”/>
</beans>
|
由于啟用了針對注解的 Bean 后處理器，因此在 ApplicationContext 解析到 MyConfig 類時，會發(fā)現(xiàn)該類標(biāo)注了 @Configuration 注解，隨后便會處理該類中標(biāo)注 @Bean 的方法，將這些方法的返回值注冊為容器總的 Bean。
對于以上的方式，如果存在多個標(biāo)注了 @Configuration 的類，則需要在 XML 文件中逐一列出。另一種方式是使用前面提到的自動掃描功能，配置如下：
<context:component-scan base-package=”bookstore.config” />
|
如此，Spring 將掃描所有 demo.config 包及其子包中的類，識別所有標(biāo)記了 @Component、@Controller、@Service、@Repository 注解的類，由于 @Configuration 注解本身也用 @Component 標(biāo)注了，Spring 將能夠識別出 @Configuration 標(biāo)注類并正確解析之。
對于以注解為中心的配置方式，只需使用 @ImportResource 注解引入存在的 XML 即可，如下所示：
@Configuration
@ImportResource(“classpath:/bookstore/config/spring-beans.xml”)
public class MyConfig{
……
}
// 容器的初始化過程和純粹的以配置為中心的方式一致：
AnnotationConfigApplicationContext ctx =
new AnnotationConfigApplicationContext(MyConfig.class);
……
|
回頁首
結(jié)束語
從 2.0 版本開始，Spring 的每一次更新都會提供更多新的注解供開發(fā)者使用。這滿足了注解愛好者的胃口。但是正如前面所說，Spring 提供更多的注解并不是為了有朝一日取代 XML 配置方式，而是為了給開發(fā)者多一種選擇。兩種聲明 Bean 的方式各有特色，XML 方式更加靈活，并且發(fā)展的相對成熟，這種配置方式為大多數(shù) Spring 開發(fā)者熟悉；注解方式使用起來非常簡潔，但是尚處于發(fā)展階段。我們很難說兩種配置方式孰優(yōu)孰劣，但是如果能夠靈活搭配兩種方式，一定能夠進(jìn)一步提升開發(fā)效率。
參考資料
關(guān)于作者
張建平，長期專注于 Java 技術(shù)，精通 SpringSource 框架集 (Spring Framework，Spring Security，Spring Roo 等 )，善于使用基于 Spring 和 Hibernate 為中心的輕量級框架進(jìn)行項(xiàng)目開發(fā)，并對 Java EE 規(guī)范有深入研究，擅長使用 EJB 和 JPA 進(jìn)行復(fù)雜業(yè)務(wù)的架構(gòu)和開發(fā)。
posted on 2010-12-15 22:08
SIMONE 閱讀(587)
評論(0) 編輯 收藏 所屬分類:
JAVA