Spring高级装配(一) profile

Spring高级装配要学习的内容包括：

Spring profile
条件化的bean声明
自动装配与歧义性
bean的作用域
Spring表达式语言

以上属于高级一点的bean装配技术，如果你没有啥特别的需求的话用的还比较少。但是用于解决变态一点的需求还是要学一下留个备份。

环境与Profile

直接上情形吧，一个项目现在有三个阶段，不同阶段使用的dataSource的来源不一样，分别是：

开发阶段：使用嵌入式的Hypersonic数据库
QA阶段：使用不同DataSource配置，比如Common DBCP连接池
生产阶段：从JNDI容器中获取一个DataSource

这三种DataSource bean的生成代码分别是：

嵌入式的Hypersonic数据库：

 @Bean(destroyMethod="shutdown")

 public DataSource dataSource() {

     return new EmbeddedDataSourceBuilder()

         .addScript("classpath:schema.sql")

         .addScript("classpath:test-data.sql")

         .build();

 }

JNDI：

 @Bean

 public DataSource dataSource() {

     JndiObjectFactoryBean jndiObjectFactoryBean = new JndiObjectFactoryBean();

     jndiObjectFactoryBean.setJndiName("jdbc/myDS");

     jndiObjectFactoryBean.setResourceRef(true);

     jndiObjectFactoryBean.setProxyInterface(javax.sql.DataSource.class);

     return (DataSource) jndiObjectFactoryBean.getObject();

 }

Common DBCP：

 @Bean(destroyMethod="close")

 public DataSource dataSource() {

     BasicDataSource dataSource = new BasicDataSource();

     dataSource.setUrl("jdbc:h2:tcp://dbserver/~/test");

     dataSource.setDriverClassName("org.h2.Driver");

     dataSource.setUserName("sa");

     dataSource.setPassword("password");

     dataSource.setInitialSize(20);

     dataSource.setMaxActive(30);

     return dataSource;

 }

也就是说每个阶段都是用了完全不同的策略来生成DataSource的bean。现在有一个需求是：如何优雅地切换这三种DataSource？

如果只用到基础的Spring bean的装配知识的话，我们必须每次手动的加上要转入的阶段对应的DataSource bean定义代码。这样的话容易引入bug，而且不优雅。这种情况其实可以抽象一下：根据不同的情况，生成不同的bean。

Spring针对这种根据环境来决定创建哪个bean和不创建哪个bean提供了了一种解决方案：profile。profile使用的大致流程：

配置profile bean

Spring利用profile来感觉环境决定创建哪个bean和不创建哪个bean，并不是在构建的时候做出决策，而是在运行时再决定。这样的话代码就可以适用于所有的环境，而不是需要额外重构。

在使用profile的时候（since 3.1），首先要把不同的bean定义整理到一个或者多个profile中，在将应用部署到每个环境时，要确保对应的profile处于激活（active）状态。

在Java配置中使用@Profile指定某个bean属于哪个profile。先来一个直接一点的例子：

 @Configuration

 @Profile("dev")

 public class DevelopmentProfileConfig {

     @Bean(destroyMethod="shutdown")

     public DataSource dataSource() {

         return new EmbeddedDataSourceBuilder()

             .addScript("classpath:schema.sql")

             .addScript("classpath:test-data.sql")

             .build();

     }

 }

解释说明：

@Profile应用在了类级别上
这个配置类中的bean只有在dev profile被激活的时候才会被创建。
如果dev profile没有被激活，那么带有@Bean注解的方法都会被忽略。

在给出一个适用于生产环境的配置：

 @Configuration

 @Profile("prod")

 public class ProductionProfileConfig {

     @Bean

     public DataSource dataSource() {

         JndiObjectFactoryBean jndiObjectFactoryBean = new JndiObjectFactoryBean();

         jndiObjectFactoryBean.setJndiName("jdbc/myDS");

         jndiObjectFactoryBean.setResourceRef(true);

         jndiObjectFactoryBean.setProxyInterface(javax.sql.DataSource.class);

         return (DataSource) jndiObjectFactoryBean.getObject();

     }

 }

在Spring 3.1中只能在类级别上使用@Profile注解，3.2开始，也可以在方法级别上使用@Profile注解，与@Bean注解一同使用；这样的话可以把这两个bean的声明放到同一个配置类中：

 @Configuration

 public class DataSourceConfig {

     @Bean(destroyMethod="shutdown")

     @Profile("dev")

     public DataSource dataSource() {

         return new EmbeddedDataSourceBuilder()

             .addScript("classpath:schema.sql")

             .addScript("classpath:test-data.sql")

             .build();

     }

     @Bean

     @Profile("prod")

     public DataSource dataSource() {

         JndiObjectFactoryBean jndiObjectFactoryBean = new JndiObjectFactoryBean();

         jndiObjectFactoryBean.setJndiName("jdbc/myDS");

         jndiObjectFactoryBean.setResourceRef(true);

         jndiObjectFactoryBean.setProxyInterface(javax.sql.DataSource.class);

         return (DataSource) jndiObjectFactoryBean.getObject();

     }

 }

这样一来每个DataSource的bean都被声明在配置类中，并且只有当规定的profile激活时，相应的bean才会被创建；没有指定profile的bean始终都会被创建，与激活哪个profile没有关系。

在XML中配置profile

通过<beans>元素的profile属性，在XML中配置profile bean：

 <beans profile="dev">

     <jdbc:embedded-database id="dataSource">

         <jdbc:script location="classpath:schema.sql" />

         <jdbc:script location="classpath:test-data.sql" />

     </jdbc:embedded-database>

 </beans>

同理，可以通过把profile设置为prod，创建适用于生产环境的从JNDI获取的DataSource bean；也可以创建基于连接池定义的dataSource bean，将其放在另一个XML文件中，并标注为qa profile。所有的配置文件都会放在部署单元之中（如WAR文件），但是只有profile属性与当前激活的profile相匹配的配置文件才会被用到。

如果觉得定义的配置文件太多，你可以在根<beans>中嵌套定义<beans>元素，而是不是为每个环境创建一个profile XML文件，配置代码如下：

 <beans>

     <beans profile="dev">

         <jdbc:embedded-database id="dataSource">

             <jdbc:script location="classpath:schema.sql" />

             <jdbc:script location="classpath:test-data.sql" />

         </jdbc:embedded-database>

     </beans>

     <beans profile="qa">

         <bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource" destroy-method="close"

             p:url="jdbc:h2:tcp://dbserver/~/test"

             p:driverClassName="org.h2.Driver"

             p:username="sa"

             p:password="password"

             p:initialSize="20"

             p:maxActive="30" />

     </beans>

     <beans profile="prod">

         <jee:jndi-lookup id="dataSource" jndi-name="jdbc/myDatabase"

             resource-ref="true" proxy-interface="javax.sql.DataSource" />

     </beans>

 </beans>

激活profle

把profile配置好了之后，问题是怎么激活这些profile？

Spring在确定哪个profile处于激活状态时，需要依赖两个独立的属性：

spring.profiles.active
spring.profiles.default

如果设置了spring.profiles.active属性的话，那么它的值就会用来确定哪个profile是激活的。

如果没有设置spring.profiles.active属性的话，那Spring将会查找spring.profiles.default的值。

如果active和default都没有设置，那么就没有激活的profile，因此只会激活那些没有定义在profile中的bean。

设置激活属性的方法：

作为DispatcherServlet的初始化参数
作为Web应用的上下文参数
作为JNDI条目
作为环境变量
作为JVM的系统属性
在集成测试类上，使用@ActiveProfiles注解设置

推荐的方式使用时DispatcherServlet的参数将spring.profiles.default设置为开发环境的profile，会在Servlet上下文中进行设置，在web.xml中：

 <web-app>

     <!-- 为上下文设置默认的profile -->

     <context-param>

         <param-name>spring.profiles.default</param-name>

         <param-value>dev</param-value>

     </context-param>

     <!-- 为Servlet设置默认的profile -->

     <servlet>

         <servlet-name>appServlet</servlet-name>

         <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>

         <init-param>

             <param-name>spring.profiles.default</param-name>

             <param-value>dev</param-value>

         </init-param>

         <load-on-startup>1</load-on-startup>

 </web-app>

可以通过列出多个profile名称并以逗号分隔来同时激活多个profile。不过同时启用dev和prod可能没有太大的意义，但是可以同时设置多个彼此不相关的profile。

集成测试时使用@ActiveProfiles注解来指定测试时要激活的profile。

@RunWith(SpringJUnit4ClassRunner.class)

@ContextConfiguration(classes={PersistenceTestConfig.class})

@ActiveProfiles("dev")

public class PersistenceTest {

}

Spring的profile提供了一种很好的条件化创建bean的方法，这里的条件是基于哪个profile处于激活状态来判断。Spring 4.0提供了一种更为通用的机制来实现条件化的bean定义。

巴特西

Spring高级装配(一) profile

环境与Profile

配置profile bean

在XML中配置profile

激活profle

最新文章

热门文章