天天看點
傳回

Spring 2.5 注解 知識點

依賴注入

-------------------------------------------------

1.手工裝配依賴對象

 手工裝配依賴對象，有兩種程式設計方式

 (1) 在xml配置檔案中，通過在bean節點下配置，如

 <bean id="orderService" class="cn.itcast.service.OrderServiceBean">

  <constructor-arg index=“0” type=“java.lang.String” value=“xxx”/>//構造器注入

  <property name=“name” value=“zhao/>//屬性setter方法注入

 </bean>

 (2) 在java代碼中使用@Autowired或@Resource注解方式進行裝配。但我們需要在xml配置檔案中配置以下資訊：

 <beans xmlns="http://www.springframework.org/schema/beans"

     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

     xmlns:context="http://www.springframework.org/schema/context"

     xsi:schemaLocation="http://www.springframework.org/schema/beans

      http://www.springframework.org/schema/beans/spring-beans-2.5.xsd

      http://www.springframework.org/schema/context

      http://www.springframework.org/schema/context/spring-context-2.5.xsd">

     <context:annotation-config/>

 </beans>

 這個配置隐式注冊了多個對注釋進行解析處理的處理器:AutowiredAnnotationBeanPostProcessor，CommonAnnotationBeanPostProcessor，PersistenceAnnotationBeanPostProcessor，RequiredAnnotationBeanPostProcessor

    注： @Resource注解在spring安裝目錄的lib/j2ee/common-annotations.jar

  @Autowired 預設按類型裝配;

  @Resource預設按名稱裝配，當找不到與名稱比對的bean才會按類型裝配。

  可以寫在屬性上或者Set方法上

  依賴注入的自動裝配的方式  不建議使用，會出現不可遇見的裝配結果

  @Autowired

  private PersonDao  personDao;//用于字段上

  @Autowired

  public void setOrderDao(OrderDao orderDao) {//用于屬性的setter方法上

   this.orderDao = orderDao;

  }

 @Autowired注解是按類型裝配依賴對象，預設情況下它要求依賴對象必須存在，如果允許null值，可以設定它required屬性為false。如果我們想使用按名稱裝配，可以結合@Qualifier注解一起使用。如下：

  @Autowired  @Qualifier("personDaoBean")

  private PersonDao  personDao;

 @Resource注解和@Autowired一樣，也可以标注在字段或屬性的setter方法上，但它預設按名稱裝配。名稱可以通過@Resource的name屬性指定，如果沒有指定name屬性，當注解标注在字段上，即預設取字段的名稱作為bean名稱尋找依賴對象，當注解标注在屬性的setter方法上，即預設取屬性名作為bean名稱尋找依賴對象。

  @Resource(name=“personDaoBean”)

  private PersonDao  personDao;//用于字段上

 注意：如果沒有指定name屬性，并且按照預設的名稱找不到依賴對象時， @Resource注解會回退到按類型裝配。但一旦指定了name屬性，就隻能按名稱裝配了。

2.通過在classpath自動掃描方式把元件納入 spring容器中管理

 spring2.5引入了元件自動掃描機制，他可以在類路徑下尋找标注了@Component,@Service,@Controller,@Repository注解的類，

并把這些類納入進spring容器中管理，他的作用和在XML檔案中使用bean節點配置元件是一樣的，

要使用自動掃描機制，需要打開它的配置。

 <beans xmlns="http://www.springframework.org/schema/beans"

     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

     xmlns:context="http://www.springframework.org/schema/context"

     xsi:schemaLocation="http://www.springframework.org/schema/beans

      http://www.springframework.org/schema/beans/spring-beans-2.5.xsd

      http://www.springframework.org/schema/context

      http://www.springframework.org/schema/context/spring-context-2.5.xsd">

     <context:component-scan base-package="cn.test"/>

 </beans>

 其中base-package為需要掃描的包(含子包)。

      @Service 用于标注業務層元件。

      @Controller 用于标注控制層元件（如struts 中的 action）

      @Repository 用于标注資料通路元件（DAO元件）

      @Component 泛指元件，當元件不好歸納的時候，我們可以使用這個注解進行标注

基于注解方式聲明切面

-----------------------------------------------------

啟動對@Aspect注解的支援：

<beans xmlns="http://www.springframework.org/schema/beans"

       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

       xmlns:aop="http://www.springframework.org/schema/aop"

       xsi:schemaLocation="http://www.springframework.org/schema/beans

           http://www.springframework.org/schema/beans/spring-beans-2.5.xsd

           http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-2.5.xsd">

  <aop:aspectj-autoproxy/>

 <bean id="orderservice" class="cn.test.service.OrderServiceBean"/>

 <bean id="log" class="cn.test.service.LogPrint"/>

</beans>

@Aspect

public class LogPrint {

 @Pointcut("execution(* cn.test.service..*.*(..))")

 private void anyMethod() {}//聲明一個切入點 

 @Before("anyMethod() && args(userName)")//定義前置通知

 public void doAccessCheck(String userName) {

 } 

 @AfterReturning(pointcut="anyMethod()",returning="revalue")//定義後置通知

 public void doReturnCheck(String revalue) {

 }

 @AfterThrowing(pointcut="anyMethod()", throwing="ex")//定義例外通知

    public void doExceptionAction(Exception ex) {

 }

 @After("anyMethod()")//定義最終通知

 public void doReleaseAction() {

 }

 @Around("anyMethod()")//環繞通知

 public Object doBasicProfiling(ProceedingJoinPoint pjp) throws Throwable {

  return pjp.proceed();

 }

}

事務配置

-------------------------------------------------------------

spring配置檔案配置：

 <bean id="txManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">

  <property name="dataSource" ref="dataSource"/>

 </bean>

 <!– 采用@Transactional注解方式使用事務  -->

 <tx:annotation-driven transaction-manager="txManager"/>

@Service @Transactional

public class PersonServiceBean implements PersonService {

}

如果方法不使用事務（如get* find*）則在方法上用

      @Transactional(propagation=Propagation.NOT_SUPPORTED,readOnly=true)

   則該方法就不在使用事務控制

============================================================================

JavaEye上的一篇文章寫得不錯：

Spring注解入門

http://www.javaeye.com/topic/295348

1. 使用Spring注解來注入屬性

1.1. 使用注解以前我們是怎樣注入屬性的

類的實作：

Java代碼

Spring 2.5 注解 知識點
  1. public class UserManagerImpl implements UserManager {   
  2.     private UserDao userDao;   
  3.     public void setUserDao(UserDao userDao) {   
  4.         this.userDao = userDao;   
  5.     }   
  6.     ...   
  7. }   
public class UserManagerImpl implements UserManager {
	private UserDao userDao;
	public void setUserDao(UserDao userDao) {
		this.userDao = userDao;
	}
	...
}

配置檔案：

Java代碼

Spring 2.5 注解 知識點
  1. <bean id="userManagerImpl" class="com.kedacom.spring.annotation.service.UserManagerImpl">   
  2.     <property name="userDao" ref="userDao" />   
  3. </bean>   
  4. <bean id="userDao" class="com.kedacom.spring.annotation.persistence.UserDaoImpl">   
  5.     <property name="sessionFactory" ref="mySessionFactory" />   
  6. </bean>   
<bean id="userManagerImpl" class="com.kedacom.spring.annotation.service.UserManagerImpl">
	<property name="userDao" ref="userDao" />
</bean>
<bean id="userDao" class="com.kedacom.spring.annotation.persistence.UserDaoImpl">
	<property name="sessionFactory" ref="mySessionFactory" />
</bean>

1.2. 引入@Autowired注解（不推薦使用，建議使用@Resource）

類的實作（對成員變量進行标注）

Java代碼

Spring 2.5 注解 知識點
  1. public class UserManagerImpl implements UserManager {   
  2.     @Autowired  
  3.     private UserDao userDao;   
  4.     ...   
  5. }   
public class UserManagerImpl implements UserManager {
	@Autowired
	private UserDao userDao;
	...
}

或者（對方法進行标注）

Java代碼

Spring 2.5 注解 知識點
  1. public class UserManagerImpl implements UserManager {   
  2.     private UserDao userDao;   
  3.     @Autowired  
  4.     public void setUserDao(UserDao userDao) {   
  5.         this.userDao = userDao;   
  6.     }   
  7.     ...   
  8. }   
public class UserManagerImpl implements UserManager {
	private UserDao userDao;
	@Autowired
	public void setUserDao(UserDao userDao) {
		this.userDao = userDao;
	}
	...
}

配置檔案

Java代碼

Spring 2.5 注解 知識點
  1. <bean id="userManagerImpl" class="com.kedacom.spring.annotation.service.UserManagerImpl" />   
  2. <bean id="userDao" class="com.kedacom.spring.annotation.persistence.UserDaoImpl">   
  3.     <property name="sessionFactory" ref="mySessionFactory" />   
  4. </bean>   
<bean id="userManagerImpl" class="com.kedacom.spring.annotation.service.UserManagerImpl" />
<bean id="userDao" class="com.kedacom.spring.annotation.persistence.UserDaoImpl">
	<property name="sessionFactory" ref="mySessionFactory" />
</bean>

@Autowired可以對成員變量、方法和構造函數進行标注，來完成自動裝配的工作。以上兩種不同實作方式中，@Autowired的标注位置不同，它們都會在Spring在初始化userManagerImpl這個bean時，自動裝配userDao這個屬性，差別是：

  • 第一種實作中，Spring會直接将UserDao類型的唯一一個bean指派給userDao這個成員變量；
  • 第二種實作中，Spring會調用setUserDao方法來将UserDao類型的唯一一個bean裝配到userDao這個屬性。

1.3. 讓@Autowired工作起來

要使@Autowired能夠工作，還需要在配置檔案中加入以下代碼

Java代碼

Spring 2.5 注解 知識點
  1. <bean class="org.springframework.beans.factory.annotation.AutowiredAnnotationBeanPostProcessor" />   
<bean class="org.springframework.beans.factory.annotation.AutowiredAnnotationBeanPostProcessor" />

1.4. @Qualifier

@Autowired是根據類型進行自動裝配的。在上面的例子中，如果當Spring上下文中存在不止一個UserDao類型的bean時，就會抛出BeanCreationException異常；如果Spring上下文中不存在UserDao類型的bean，也會抛出BeanCreationException異常。我們可以使用@Qualifier配合@Autowired來解決這些問題。

1. 可能存在多個UserDao執行個體

Java代碼

Spring 2.5 注解 知識點
  1. @Autowired  
  2. public void setUserDao(@Qualifier("userDao") UserDao userDao) {   
  3.     this.userDao = userDao;   
  4. }   
@Autowired
	public void setUserDao(@Qualifier("userDao") UserDao userDao) {
		this.userDao = userDao;
	}

這樣，Spring會找到id為userDao的bean進行裝配。

2. 可能不存在UserDao執行個體

Java代碼

Spring 2.5 注解 知識點
  1. @Autowired(required = false)   
  2. public void setUserDao(UserDao userDao) {   
  3.     this.userDao = userDao;   
  4. }   
@Autowired(required = false)
	public void setUserDao(UserDao userDao) {
		this.userDao = userDao;
	}

1.5. @Resource（JSR-250标準注解，推薦使用它來代替Spring專有的@Autowired注解）

Spring 不但支援自己定義的@Autowired注解，還支援幾個由JSR-250規範定義的注解，它們分别是@Resource、@PostConstruct以及@PreDestroy。

@Resource的作用相當于@Autowired，隻不過@Autowired按byType自動注入，而@Resource預設按byName自動注入罷了。@Resource有兩個屬性是比較重要的，分别是name和type，Spring将@Resource注解的name屬性解析為bean的名字，而type屬性則解析為bean的類型。是以如果使用name屬性，則使用byName的自動注入政策，而使用type屬性時則使用byType自動注入政策。如果既不指定name也不指定type屬性，這時将通過反射機制使用byName自動注入政策。

@Resource裝配順序

  1. 如果同時指定了name和type，則從Spring上下文中找到唯一比對的bean進行裝配，找不到則抛出異常
  2. 如果指定了name，則從上下文中查找名稱（id）比對的bean進行裝配，找不到則抛出異常
  3. 如果指定了type，則從上下文中找到類型比對的唯一bean進行裝配，找不到或者找到多個，都會抛出異常
  4. 如果既沒有指定name，又沒有指定type，則自動按照byName方式進行裝配（見2）；如果沒有比對，則回退為一個原始類型（UserDao）進行比對，如果比對則自動裝配；

1.6. @PostConstruct（JSR-250）

在方法上加上注解@PostConstruct，這個方法就會在Bean初始化之後被Spring容器執行（注：Bean初始化包括，執行個體化Bean，并裝配Bean的屬性（依賴注入））。

它的一個典型的應用場景是，當你需要往Bean裡注入一個其父類中定義的屬性，而你又無法複寫父類的屬性或屬性的setter方法時，如：

Java代碼

Spring 2.5 注解 知識點
  1. public class UserDaoImpl extends HibernateDaoSupport implements UserDao {   
  2.     private SessionFactory mySessionFacotry;   
  3.     @Resource  
  4.     public void setMySessionFacotry(SessionFactory sessionFacotry) {   
  5.         this.mySessionFacotry = sessionFacotry;   
  6.     }   
  7.     @PostConstruct  
  8.     public void injectSessionFactory() {   
  9.         super.setSessionFactory(mySessionFacotry);   
  10.     }   
  11.     ...   
  12. }   
public class UserDaoImpl extends HibernateDaoSupport implements UserDao {
	private SessionFactory mySessionFacotry;
	@Resource
	public void setMySessionFacotry(SessionFactory sessionFacotry) {
		this.mySessionFacotry = sessionFacotry;
	}
	@PostConstruct
	public void injectSessionFactory() {
		super.setSessionFactory(mySessionFacotry);
	}
	...
}

這裡通過@PostConstruct，為UserDaoImpl的父類裡定義的一個sessionFactory私有屬性，注入了我們自己定義的sessionFactory（父類的setSessionFactory方法為final，不可複寫），之後我們就可以通過調用super.getSessionFactory()來通路該屬性了。

1.7. @PreDestroy（JSR-250）

在方法上加上注解@PreDestroy，這個方法就會在Bean初始化之後被Spring容器執行。由于我們目前還沒有需要用到它的場景，這裡不不去示範。其用法同@PostConstruct。

1.8. 使用<context:annotation-config />簡化配置

Spring2.1添加了一個新的context的Schema命名空間，該命名空間對注釋驅動、屬性檔案引入、加載期織入等功能提供了便捷的配置。我們知道注釋本身是不會做任何事情的，它僅提供中繼資料資訊。要使中繼資料資訊真正起作用，必須讓負責處理這些中繼資料的處理器工作起來。

AutowiredAnnotationBeanPostProcessor和CommonAnnotationBeanPostProcessor就是處理這些注釋中繼資料的處理器。但是直接在Spring配置檔案中定義這些Bean顯得比較笨拙。Spring為我們提供了一種友善的注冊這些BeanPostProcessor的方式，這就是<context:annotation-config />：

Java代碼

Spring 2.5 注解 知識點
  1. <beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context"  
  2.     xsi:schemaLocation="http://www.springframework.org/schema/beans   
  3.     http://www.springframework.org/schema/beans/spring-beans-2.5.xsd   
  4.     http://www.springframework.org/schema/context   
  5.     http://www.springframework.org/schema/context/spring-context-2.5.xsd">   
  6.     <context:annotation-config />   
  7. </beans>   
<beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context"
	xsi:schemaLocation="http://www.springframework.org/schema/beans
	http://www.springframework.org/schema/beans/spring-beans-2.5.xsd
	http://www.springframework.org/schema/context
	http://www.springframework.org/schema/context/spring-context-2.5.xsd">
	<context:annotation-config />
</beans>

<context:annotationconfig />将隐式地向Spring容器注冊AutowiredAnnotationBeanPostProcessor、CommonAnnotationBeanPostProcessor、 PersistenceAnnotationBeanPostProcessor以及RequiredAnnotationBeanPostProcessor這4個BeanPostProcessor。

2. 使用Spring注解完成Bean的定義

以上我們介紹了通過@Autowired或@Resource來實作在Bean中自動注入的功能，下面我們将介紹如何注解Bean，進而從XML配置檔案中完全移除Bean定義的配置。

2.1. @Component（不推薦使用）、@Repository、@Service、@Controller

隻需要在對應的類上加上一個@Component注解，就将該類定義為一個Bean了：

Java代碼

Spring 2.5 注解 知識點
  1. @Component  
  2. public class UserDaoImpl extends HibernateDaoSupport implements UserDao {   
  3.     ...   
  4. }   
@Component
public class UserDaoImpl extends HibernateDaoSupport implements UserDao {
	...
}

使用@Component注解定義的Bean，預設的名稱（id）是小寫開頭的非限定類名。如這裡定義的Bean名稱就是userDaoImpl。你也可以指定Bean的名稱：

@Component("userDao")

@Component是所有受Spring管理元件的通用形式，Spring還提供了更加細化的注解形式：

@Repository、@Service、@Controller，它們分别對應存儲層Bean，業務層Bean，和展示層Bean。

目前版本（2.5）中，這些注解與@Component的語義是一樣的，完全通用，在Spring以後的版本中可能會給它們追加更多的語義。是以，我們推薦使用@Repository、@Service、@Controller來替代@Component。

2.2. 使用<context:component-scan />讓Bean定義注解工作起來

Java代碼

Spring 2.5 注解 知識點
  1. <beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context"  
  2.     xsi:schemaLocation="http://www.springframework.org/schema/beans   
  3.     http://www.springframework.org/schema/beans/spring-beans-2.5.xsd   
  4.     http://www.springframework.org/schema/context   
  5.     http://www.springframework.org/schema/context/spring-context-2.5.xsd">   
  6.     <context:component-scan base-package="com.kedacom.ksoa" />   
  7. </beans>   
<beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context"
	xsi:schemaLocation="http://www.springframework.org/schema/beans
	http://www.springframework.org/schema/beans/spring-beans-2.5.xsd
	http://www.springframework.org/schema/context
	http://www.springframework.org/schema/context/spring-context-2.5.xsd">
	<context:component-scan base-package="com.kedacom.ksoa" />
</beans>

這裡，所有通過<bean>元素定義Bean的配置内容已經被移除，僅需要添加一行<context:component-scan />配置就解決所有問題了——Spring XML配置檔案得到了極緻的簡化（當然配置中繼資料還是需要的，隻不過以注釋形式存在罷了）。<context:component-scan />的base-package屬性指定了需要掃描的類包，類包及其遞歸子包中所有的類都會被處理。

      <context:component-scan />還允許定義過濾器将基包下的某些類納入或排除。

      Spring支援以下4種類型的過濾方式：

         過濾器類型         表達式範例                                                           說明

  • 注解                 org.example.SomeAnnotation                           将所有使用SomeAnnotation注解的類過濾出來
  • 類名指定           org.example.SomeClass                                    過濾指定的類
  • 正規表達式        com/.kedacom/.spring/.annotation/.web/..*     通過正規表達式過濾一些類
  • AspectJ表達式   org.example..*Service+                                    通過AspectJ表達式過濾一些類

以正規表達式為例，我列舉一個應用執行個體：

Java代碼

Spring 2.5 注解 知識點
  1. <context:component-scan base-package="com.casheen.spring.annotation">   
  2.     <context:exclude-filter type="regex" expression="com/.casheen/.spring/.annotation/.web/..*" />   
  3. </context:component-scan>   
<context:component-scan base-package="com.casheen.spring.annotation">
		<context:exclude-filter type="regex" expression="com/.casheen/.spring/.annotation/.web/..*" />
	</context:component-scan>

值得注意的是<context:component-scan />配置項不但啟用了對類包進行掃描以實施注釋驅動Bean定義的功能，同時還啟用了注釋驅動自動注入的功能（即還隐式地在内部注冊了AutowiredAnnotationBeanPostProcessor和CommonAnnotationBeanPostProcessor），是以當使用<context:component-scan />後，就可以将<context:annotation-config />移除了。

2.3. 使用@Scope來定義Bean的作用範圍

在使用XML定義Bean時，我們可能還需要通過bean的scope屬性來定義一個Bean的作用範圍，我們同樣可以通過@Scope注解來完成這項工作：

Java代碼

Spring 2.5 注解 知識點
  1. @Scope("session")   
  2. @Component()   
  3. public class UserSessionBean implements Serializable {   
  4.     ...   
  5. }   
@Scope("session")
@Component()
public class UserSessionBean implements Serializable {
	...
}

3. 參考

http://kingtai168.javaeye.com/blog/244002

http://www.javaeye.com/topic/244153

http://static.springframework.org/spring/docs/2.5.x/reference/beans.html#beans-annotation-config

http://static.springframework.org/spring/docs/2.5.x/reference/beans.html#beans-classpath-scanning

spring autowired Bean class java setter
上一篇: Spring 注解開發 3 聲明式事務聲明式事務
下一篇: 如何無痛降低 if else 面條代碼複雜度

繼續閱讀