19 Profile
有的时候我们可能需要在不同的环境下使用不同的bean定义,如在开发环境直接使用直接定义的数据源,而在生产环境使用对应的JNDI数据源等。针对这种需求,Spring给我们引入了一个profile的概念,其允许我们将在特定环境下需要使用的bean定义为不同的profile,然后只有在对应的profile激活的情况下才使用对应的bean定义。打个比方我们有一个beanA需要在开发环境才启用,则可以定义其对应的profile为dev,然后另外有一个beanB需要在生产环境才启用,则可以定义其对应的profile为production。那么只有当我们指定对应的profile为dev时beanA才会被激活,只有profile为production时beanB才会被启用,其它情况下都是未启用的。
19.1 指定profile
针对不同的bean定义方式,对应的profile的指定方式也是不一样的。
19.1.1 基于XML配置定义的bean
对于这种形式的bean定义,对应的profile指定是通过在<beans/>
标签上的profile属性进行指定的。如下示例我们就通过在<beans/>
标签上指定了profile为dev,那么对应<beans/>
中定义的所有的bean都只有在profile为dev时才可用,这也包括其中通过<context:component-scan/>
定义扫描到的其它bean定义。
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
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.xsd"
profile="dev">
<bean id="hello" class="com.elim.learn.spring.bean.Hello"/>
</beans>
profile也可以定义在内置的标签上,如下我们指定了当前文件的profile为dev,但是在其内部定义了一个内置的<beans/>
标签,并指定其对应的profile为production,这样只有在dev和production两种profile都激活时,Spring才会扫描对应的类路径进行bean定义,因为我们在最顶层的<beans/>
上指定了profile为dev,在<context:component-scan/>
上级<beans/>
上指定了profile为production,对于这种嵌套指定profile的形式是需要同时激活多个profile里面的定义才会生效的。
<?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:p="http://www.springframework.org/schema/p"
xmlns:context="http://www.springframework.org/schema/context"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context.xsd"
profile="dev">
<!-- 只有profile为production时才进行扫描 -->
<beans profile="production">
<context:component-scan base-package="com.app">
<context:exclude-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
</context:component-scan>
</beans>
<!-- 只有profile为dev时才可用 -->
<beans>
<bean id="hello" class="com.elim.learn.spring.bean.Hello"/>
</beans>
</beans>
在上述示例中如果我们希望<context:component-scan/>
能够在production激活的情况就生效,而不用管dev,则可以取消最顶层的profile=”dev”。
此外,profile除了可以直接指定一个值以外,还可以同时指定多个profile,中间以逗号隔开,表示只要其中一个profile是激活状态即可启用当前的定义。如果profile是以感叹号“!”开始的,则表示需要对应的profile没有激活的情况下才可用。
<!-- 当p1或p2对应的profile为激活状态时,当前定义才是可用的 -->
<beans profile="p1,p2">
<!-- .... -->
</beans>
<!-- 当没有激活p1对应的profile时,当前定义才是可用的 -->
<beans profile="!p1">
<!-- .... -->
</beans>
19.1.2 自动扫描的bean定义
对于自动扫描的bean定义,如果我们是需要将所有的扫描类统一使用一种profile,则对于基于XML配置的bean容器定义我们可以使用<beans/>
标签包裹<context:component-scan/>
,并在<beans/>
标签上通过profile属性指定对应的profile。而对于基于Java类配置的自动扫描,如果需要将所有的扫描类统一使用一种profile,则可以在对应的配置类上使用@Profile进行标注,并通过其value属性指定对应的profile。
如果我们只是希望将自动扫描的某些类指定为特定的profile,则可以在对应的类上使用@Profile进行标注,并通过对应的value属性指定对应的profile。如下示例就指定了当前bean对应的profile为dev。
@Component
@Profile("dev")
public class Hello {
}
使用@Profile时也可以同时指定多个profile,这个时候多个profile之间的关系就是或,即只要其中的某个profile处于激活状态当前定义即为可用。如下示例即表示当p1或p2对应的profile处于激活状态时,如下定义才是可用的。
@Component
@Profile({"p1", "p2"})
public class Hello {
}
使用@Profile时也可以使用“!”前缀,表示只有在对应的profile不处于激活状态时当前定义才是可用的。如下示例即表示只有在p1对应的profile不处于激活状态时对应的定义才是可用的。
@Component
@Profile({"!p1"})
public class Hello {
}
此外,我们还可以自定义一个注解,然后使用@Profile进行标注,并指定对应的profile,这样我们就可以使用该自定义注解来替代特定的@Profile来使用。如在我们的应用中有许多bean需要使用@Profile(“production”)进行标注,那么我们就可以自定义如下这样一个@Production注解来代替@Profile(“production”)。
@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Profile("production")
public @interface Production {
}
如果原来我们有一个bean定义成如下这样。
@Component
@Profile("production")
public class Hello {
}
因为我们的自定义的@Production注解上使用了@Profile进行标注,并且指定了profile为production,那么可以用@Production来替代@Profile(“production”),所以上述定义也可以定义成如下这样。
@Component
@Production
public class Hello {
}
19.1.3 基于Java类配置定义的bean
对于基于Java类的配置我们可以在对应的配置类上使用@Profile来指定整个配置类对应的bean定义都必须在特定的profile下才可用,如下示例,我们指定了配置类SpringConfig只有在profile为dev的情况下才是可用的,这包括直接在SpringConfig中定义的bean,也包括通过@Import引入的其它配置类中定义的bean,还包括通过@ImportResource引入的XML文件中定义的bean,都只能在profile为dev时才可用。
@Configuration
@Profile("dev")
public class SpringConfig {
@Bean
public Hello hello() {
return new Hello();
}
@Bean
public World world() {
return new World();
}
}
当我们只需要指定某个bean对应的profile时,我们可以在对应的bean定义上使用@Profile进行定义。当Java配置类和实际的bean定义方法上都使用@Profile指定了profile时表示两者都需要满足才行。如下示例,表示hello是在profile为dev的情况下可用,它自己没有指定,而是从Java配置类SpringConfig继承来的。而world将需要dev和production两种profile都激活的情况下才是可用的。
@Configuration
@Profile("dev")
public class SpringConfig {
@Bean
public Hello hello() {
return new Hello();
}
@Bean
@Profile("production")
public World world() {
return new World();
}
}
当Java配置类上没有指定@Profile,而直接在bean定义上指定了@Profile时则表示当前的bean需要在指定的profile激活的情况下才可用。如下示例中hello将在任何profile下都是可用的,而world将只有在激活了production这种profile的情况下才是可用的。
@Configuration
public class SpringConfig {
@Bean
public Hello hello() {
return new Hello();
}
@Bean
@Profile("production")
public World world() {
return new World();
}
}