關於Spring的配置文件的註解使用 Spring 3.1新特性之二：@Enable*註解的源碼,spring源碼分析之定時任務Scheduled註解

從Spring3.0，@Configuration用於定義配置類，可替換xml配置文件，被註解的類內部包含有一個或多個被@Bean註解的方法，

這些方法將會AnnotationConfigApplicationContext類進行掃描，並用於構建bean定義，

初始化Spring容器。@Configuration標註在類上，相當於把該類作爲spring的xml配置文件中的<beans>，作用爲：配置spring容器(應用上下文)

當然也可爲了便於分類配置多個類配置文件。

注意：@Configuration註解的配置類有如下要求：

1. @Configuration不可以是final類型；
2. @Configuration不可以是匿名類；
3. 嵌套的configuration必須是靜態類。

一、@Configuration配置spring並啓動spring容器

@Configuration
public class TestConfiguration {
    public TestConfiguration(){
        System.out.println("spring容器啓動初始化。。。");
    }
}

相當於：

<?xml version="1.0" encoding="UTF-8"?>
<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" xmlns:jdbc="http://www.springframework.org/schema/jdbc"  
    xmlns:jee="http://www.springframework.org/schema/jee" xmlns:tx="http://www.springframework.org/schema/tx"
    xmlns:util="http://www.springframework.org/schema/util" xmlns:task="http://www.springframework.org/schema/task" xsi:schemaLocation="
        http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-4.0.xsd
        http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.0.xsd
        http://www.springframework.org/schema/jdbc http://www.springframework.org/schema/jdbc/spring-jdbc-4.0.xsd
        http://www.springframework.org/schema/jee http://www.springframework.org/schema/jee/spring-jee-4.0.xsd
        http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-4.0.xsd
        http://www.springframework.org/schema/util http://www.springframework.org/schema/util/spring-util-4.0.xsd
        http://www.springframework.org/schema/task http://www.springframework.org/schema/task/spring-task-4.0.xsd" default-lazy-init="false">
</beans>

主方法進行測試：

public class TestMain {
    public static void main(String[] args) {

        //@Configuration註解的spring容器加載方式，用AnnotationConfigApplicationContext替換ClassPathXmlApplicationContext
        ApplicationContext context = new AnnotationConfigApplicationContext(TestConfiguration.class);

        //如果加載spring-context.xml文件：
        //ApplicationContext context = new ClassPathXmlApplicationContext("spring-context.xml");
    }
}

運行結果：

二、@Configuration啓動容器+@Bean註冊Bean，@Bean標註在方法上(返回某個實例的方法)，等價於spring的xml配置文件中的<bean>，作用爲：註冊bean對象

bean類：

public class TestBean {
    private String username;
    private String url;
    private String password;
    public void sayHello(){
        System.out.println("TestBean sayHello...");
    }

    public String toString(){
        return "username:"+this.username+",url:"+this.url+",password:"+this.password;
    }

    public void start(){
        System.out.println("TestBean 初始化。。。");
    }

    public void cleanUp(){
        System.out.println("TestBean 銷燬。。。");
    }
}

配置類：

@Configuration
public class TestConfiguration {
        public TestConfiguration(){
            System.out.println("spring容器啓動初始化。。。");
        }

    //@Bean註解註冊bean,同時可以指定初始化和銷燬方法
    //@Bean(name="testNean",initMethod="start",destroyMethod="cleanUp")
    @Bean
    @Scope("prototype")
    public TestBean testBean() {
        return new TestBean();
    }
}

主方法測試類：

package com.dxz.demo.configuration;

import org.springframework.context.ApplicationContext;
import org.springframework.context.annotation.AnnotationConfigApplicationContext;

public class TestMain {
    public static void main(String[] args) {

        // @Configuration註解的spring容器加載方式，用AnnotationConfigApplicationContext替換ClassPathXmlApplicationContext
        ApplicationContext context = new AnnotationConfigApplicationContext(TestConfiguration.class);

        // 如果加載spring-context.xml文件：
        // ApplicationContext context = new
        // ClassPathXmlApplicationContext("spring-context.xml");
        
         //獲取bean
        TestBean tb = (TestBean) context.getBean("testBean");
        tb.sayHello();
    }
}

@Bean下管理bean的生命週期

可以使用基於 Java 的配置來管理 bean 的生命週期。@Bean 支持兩種屬性，即 initMethod 和destroyMethod，這些屬性可用於定義生命週期方法。在實例化 bean 或即將銷燬它時，容器便可調用生命週期方法。生命週期方法也稱爲回調方法，因爲它將由容器調用。使用 @Bean 註釋註冊的 bean 也支持 JSR-250 規定的標準 @PostConstruct 和 @PreDestroy 註釋。如果您正在使用 XML 方法來定義 bean，那麼就應該使用 bean 元素來定義生命週期回調方法。以下代碼顯示了在 XML 配置中通常使用 bean 元素定義回調的方法。

@Configuration
@ComponentScan(basePackages = "com.dxz.demo.configuration")
public class TestConfiguration {
    public TestConfiguration() {
        System.out.println("TestConfiguration容器啓動初始化。。。");
    }

    //@Bean註解註冊bean,同時可以指定初始化和銷燬方法
    @Bean(name="testBean",initMethod="start",destroyMethod="cleanUp")
    @Scope("prototype")
    public TestBean testBean() {
        return new TestBean();
    }
}

啓動類：

public class TestMain {
    public static void main(String[] args) {

        ApplicationContext context = new AnnotationConfigApplicationContext(TestConfiguration.class);

        TestBean tb = (TestBean) context.getBean("testBean");
        tb.sayHello();
        System.out.println(tb);
        
        TestBean tb2 = (TestBean) context.getBean("testBean");
        tb2.sayHello();
        System.out.println(tb2);
    }
}

 

分析：

結果中的1：表明initMethod生效

結果中的2：表明@Scope("prototype")生效

注： 
(1)、@Bean註解在返回實例的方法上，如果未通過@Bean指定bean的名稱，則默認與標註的方法名相同； 
(2)、@Bean註解默認作用域爲單例singleton作用域，可通過@Scope(“prototype”)設置爲原型作用域； 
(3)、既然@Bean的作用是註冊bean對象，那麼完全可以使用@Component、@Controller、@Service、@Ripository等註解註冊bean，

       當然需要配置@ComponentScan註解進行自動掃描。

三、@Configuration啓動容器+@Component註冊Bean

bean類：

package com.test.spring.configuration;

//添加註冊bean的註解
@Component
public class TestBean {

    public void sayHello(){
        System.out.println("TestBean sayHello...");
    }

    public String toString(){
        return "username:"+this.username+",url:"+this.url+",password:"+this.password;
    }
}

配置類：

@Configuration
//添加自動掃描註解，basePackages爲TestBean包路徑
@ComponentScan(basePackages = "com.test.spring.configuration")
public class TestConfiguration {
    public TestConfiguration(){
        System.out.println("spring容器啓動初始化。。。");
    }

    //取消@Bean註解註冊bean的方式
    //@Bean
    //@Scope("prototype")
    //public TestBean testBean() {
    //  return new TestBean();
    //}
}

主方法測試獲取bean對象：

public class TestMain {
    public static void main(String[] args) {
        ApplicationContext context = new AnnotationConfigApplicationContext(TestConfiguration.class);
        //獲取bean
        TestBean tb = context.getBean("testBean");
        tb.sayHello();
    }
}

 sayHello()方法都被正常調用。

四、使用 AnnotationConfigApplicationContext 註冊 AppContext 類的兩種方法

 　　1. 配置類的註冊方式是將其傳遞給 AnnotationConfigApplicationContext 構造函數

public static void main(String[] args) {

        // @Configuration註解的spring容器加載方式，用AnnotationConfigApplicationContext替換ClassPathXmlApplicationContext
        ApplicationContext context = new AnnotationConfigApplicationContext(TestConfiguration.class);

        //獲取bean
        TestBean tb = (TestBean) context.getBean("testBean");
        tb.sayHello();
    }

　　2.AnnotationConfigApplicationContext 的register 方法傳入配置類來註冊配置類

@Test
public void startSpringContext() {
    AnnotationConfigRegistry ctx = new AnnotationConfigApplicationContext();
    ctx.register(TestConfiguration.class);
}

　　3. 配置Web應用程序(web.xml中配置AnnotationConfigApplicationContext)

 　　過去，您通常要利用 XmlWebApplicationContext 上下文來配置 Spring Web 應用程序，即在 Web 部署描述符文件 web.xml 中指定外部 XML 上下文文件的路徑。XMLWebApplicationContext 是 Web 應用程序使用的默認上下文類。以下代碼描述了 web.xml 中指向將由 ContextLoaderListener 監聽器類載入的外部 XML 上下文文件的元素。

<!-- 加載spring容器 -->
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:applicationContext-*.xml</param-value>
    </context-param>
    <listener>
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
    </listener>

現在，您要將 web.xml 中的上述代碼更改爲使用 AnnotationConfigApplicationContext 類。切記，XmlWebApplicationContext 是 Spring 爲 Web 應用程序使用的默認上下文實現，因此您永遠不必在您的web.xml 文件中顯式指定這個上下文類。現在，您將使用基於 Java 的配置，因此在配置 Web 應用程序時，需要在web.xml 文件中指定 AnnotationConfigApplicationContext 類。上述代碼將修改如下：

<context-param>
        <param-name>contextClass</param-name>
        <param-value>    org.springframework.web.context.support.AnnotationConfigWebApplicationContext
        </param-value>
    </context-param>
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>
            com.itwang.config.TestConfiguration  //這裏需要些你的配置類所在位置
        </param-value>
    </context-param>
    <listener>
        <listener-class>
            org.springframework.web.context.ContextLoaderListener
        </listener-class>
    </listener>

五、組合多個配置類

1. 在@configuration中引入spring的xml配置文件

@Configuration
@ImportResource("spring.xml")
public class WebConfig {
}

新建一個spring.xml配置文件

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:context="http://www.springframework.org/schema/context" 
    xmlns:p="http://www.springframework.org/schema/p"
    xmlns:aop="http://www.springframework.org/schema/aop" 
    xmlns:tx="http://www.springframework.org/schema/tx"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://www.springframework.org/schema/beans 
    http://www.springframework.org/schema/beans/spring-beans-4.0.xsd
    http://www.springframework.org/schema/context 
    http://www.springframework.org/schema/context/spring-context-4.0.xsd
    http://www.springframework.org/schema/aop 
    http://www.springframework.org/schema/aop/spring-aop-4.0.xsd 
    http://www.springframework.org/schema/tx 
    http://www.springframework.org/schema/tx/spring-tx-4.0.xsd
    http://www.springframework.org/schema/util 
    http://www.springframework.org/schema/util/spring-util-4.0.xsd">

    <bean id="testBean2" class="com.itwang.config.TestBean2"></bean>
</beans>

測試

    @Test
    public void testSpring() {
        ApplicationContext applicationContext =
                new AnnotationConfigApplicationContext(WebConfig.class);
        TestBean2 testBean2 = (TestBean2) applicationContext.getBean("testBean2");
        testBean2.sayHello();
    }

結果：

2. 在@configuration中引入其它註解配置

@Configuration
@ImportResource("classpath:spring.xml")
@Import(TestConfiguration.class)
public class WebConfig {
}

測試：

public class TestMain2 {
    public static void main(String[] args) {

        // @Configuration註解的spring容器加載方式，用AnnotationConfigApplicationContext替換ClassPathXmlApplicationContext
        ApplicationContext context = new AnnotationConfigApplicationContext(WebConfig.class);

        // 如果加載spring-context.xml文件：
        // ApplicationContext context = new
        // ClassPathXmlApplicationContext("spring-context.xml");

        // 獲取bean
        TestBean2 tb2 = (TestBean2) context.getBean("testBean2");
        tb2.sayHello();
        
        TestBean tb = (TestBean) context.getBean("testBean");
        tb.sayHello();
    }
}

3.  @configuration嵌套（嵌套的Configuration必須是靜態類）

通過配置類嵌套的配置類，達到組合多個配置類的目的。但注意內部類必須是靜態類。

上代碼：

@Component
public class TestBean {

    private String username;
    private String url;
    private String password;

    public void sayHello() {
        System.out.println("TestBean sayHello...");
    }

    public String toString() {
        return "username:" + this.username + ",url:" + this.url + ",password:" + this.password;
    }

    public void start() {
        System.out.println("TestBean start");
    }

    public void cleanUp() {
        System.out.println("TestBean destory");
    }
}

public class DataSource {

    private String dbUser;
    private String dbPass;
    public String getDbUser() {
        return dbUser;
    }
    public void setDbUser(String dbUser) {
        this.dbUser = dbUser;
    }
    public String getDbPass() {
        return dbPass;
    }
    public void setDbPass(String dbPass) {
        this.dbPass = dbPass;
    }
    @Override
    public String toString() {
        return "DataSource [dbUser=" + dbUser + ", dbPass=" + dbPass + "]";
    }
}

//配置類
@Configuration
@ComponentScan(basePackages = "com.dxz.demo.configuration3")
public class TestConfiguration {
    public TestConfiguration() {
        System.out.println("TestConfiguration容器啓動初始化。。。");
    }
    
    @Configuration
    static class DatabaseConfig {
        @Bean
        DataSource dataSource() {
            return new DataSource();
        }
    }
}

啓動類：

public class TestMain {
    public static void main(String[] args) {

        // @Configuration註解的spring容器加載方式，用AnnotationConfigApplicationContext替換ClassPathXmlApplicationContexts
        ApplicationContext context = new AnnotationConfigApplicationContext(TestConfiguration.class);

         //bean
        TestBean tb = (TestBean) context.getBean("testBean");
        tb.sayHello();
        
        DataSource ds = (DataSource) context.getBean("dataSource");
        System.out.println(ds);
    }
}

結果：

TestConfiguration容器啓動初始化。。。
TestBean sayHello...
DataSource [dbUser=null, dbPass=null]

六、@EnableXXX註解

配合@Configuration使用，包括 @EnableAsync, @EnableScheduling, @EnableTransactionManagement, @EnableAspectJAutoProxy, @EnableWebMvc。

@EnableAspectJAutoProxy---《spring AOP 之：@Aspect註解》

@EnableScheduling--《Spring 3.1新特性之二：@Enable*註解的源碼,spring源碼分析之定時任務Scheduled註解》