【Spring】高级装配

前言

前面讲解了bean的核心装配技术，其可应付很多中装配情况，但Spring提供了高级装配技术，以此实现更为高级的bean装配功能。

高级装配

配置profile bean

将所有不同bean定义放置在一个或多个profile中，在将应用部署到每个环境时，要确保对应的profile处于激活状态。如配置了如下数据源，并使用profile注解定义。

JavaConfig配置profile

• 开发环境中的数据源配置

package com.hust.grid.leesf.ch3;

import javax.activation.DataSource;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Profile;
import org.springframework.jdbc.datasource.embedded.EmbeddedDatabaseBuilder;
import org.springframework.jdbc.datasource.embedded.EmbeddedDatabaseType;

@Configuratoin
@Profile("dev")
public class DevelopmentProfileConcifg {
    @Bean(destroyMethod = "shutdown")
    public DataSource embeddedDataSource() {
        return new EmbeddedDatabaseBuilder()
            .setType(EmbeddedDatabaseType.H2)
            .addScript("classpath:schema.sql")
            .addScript("classpath:test-data.sql")
            .build();
    }   
}

• 生产环境下的数据源配置

package com.hust.grid.leesf.ch3;

import javax.sql.DataSource;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Profile;
import org.springframework.jndi.JndiObjectFactoryBean;

@Configuration
public class ProductionProfileConfig {
 
  @Bean
  @Profile("prod")
  public DataSource jndiDataSource() {
    JndiObjectFactoryBean jndiObjectFactoryBean = new JndiObjectFactoryBean();
    jndiObjectFactoryBean.setJndiName("jdbc/myDS");
    jndiObjectFactoryBean.setResourceRef(true);
    jndiObjectFactoryBean.setProxyInterface(javax.sql.DataSource.class);
    return (DataSource) jndiObjectFactoryBean.getObject();
  }

}

只有在prod profile激活时，才会创建对应的bean。在Spring 3.1之前只能在类级别上使用@Profile注解，从Spring 3.2之后，可以从方法级别上使用@Profile注解，与@Bean注解一起使用，上述放在两个不同配置类可以转化为两个方法放在同一个配置类中。

package com.hust.grid.leesf.ch3;

import javax.sql.DataSource;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Profile;
import org.springframework.jdbc.datasource.embedded.EmbeddedDatabaseBuilder;
import org.springframework.jdbc.datasource.embedded.EmbeddedDatabaseType;
import org.springframework.jndi.JndiObjectFactoryBean;

@Configuration
public class DataSourceConfig {
  
  @Bean(destroyMethod = "shutdown")
  @Profile("dev")
  public DataSource embeddedDataSource() {
    return new EmbeddedDatabaseBuilder()
        .setType(EmbeddedDatabaseType.H2)
        .addScript("classpath:schema.sql")
        .addScript("classpath:test-data.sql")
        .build();
  }

  @Bean
  @Profile("prod")
  public DataSource jndiDataSource() {
    JndiObjectFactoryBean jndiObjectFactoryBean = new JndiObjectFactoryBean();
    jndiObjectFactoryBean.setJndiName("jdbc/myDS");
    jndiObjectFactoryBean.setResourceRef(true);
    jndiObjectFactoryBean.setProxyInterface(javax.sql.DataSource.class);
    return (DataSource) jndiObjectFactoryBean.getObject();
  }

}

注意：尽管配置类中配置了不同的Profile，但只有规定的profile激活时，对应的bean才会被激活。

XML配置profile

或者使用beans元素定义多个profile。

三个bean的ID都是dataSource，在运行时会动态创建一个bean，这取决激活的哪个profile。

激活profile

Spring依赖spring.profiles.active和spring.profiles.default两个属性确定哪个profile处于激活状态，如果设置了spring.profiles.active，那么其值用于确定哪个profile是激活状态，如果未设置，则查找spring.profiles.defaults的值；如果均未设置，则没有激活的profile，只会创建那些没有定义在profile中的bean。如下是在web.xml中设置spring.profiles.default。

    spring.profiles.default
    dev




    
        spring.profiles.default
        dev
    

Spring提供了@ActiveProfiles注解启用profile。

@Runwith(SpringJUnit4ClassRunner.class)
@ContextConfiguration(classes={PersistenceTestConfig.class})
@ActiveProfiles("dev")
public class PersistenceTest {
    ...
}

条件化的bean

使用@Conditional注解，如果给定条件计算结果为true，那么创建bean，否则不创建。

• MagicBean

@Bean
@Condition(MagicExistsCondition.class)
public MagicBean magicBean() {
    return new MagicBean();
}

• MagicExistsCondition

package com.hust.grid.leesf.ch3;

import org.springframework.context.annotation.Condition;
import org.springframework.context.annotation.ConditionContext;
import org.springframework.core.type.AnnotatedTypeMetadata;
import org.springframework.util.ClassUtils;

public class MagicExistsCondition implements Condition {
    public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
        Environment env = context.getEnvironment();
        return env.containsProperty("magic");
    }
}

处理自动装配的歧义性

如下代码

@Autowired
public void setDessert(Dessert dessert) {
    this.dessert = dessert;
}

其中Dessert为一个接口，其有多个子类。

@Component
public class Cake implements Dessert {}

@Component
public class Cookies implements Dessert {}

@Component
public class IceCream implements Dessert {}

此时，会发现不止一个bean可以匹配，Spring会抛出异常，可以将某个bean设置为首选的bean或使用限定符。

标识首选bean

使用Primary注解标识首选bean。

@Component
@Primary
public class IceCream implements Dessert {}

或者使用xml配置首选bean

如果配置多个首选bean，那么也将无法工作。

限定自动装配的bean

使用@Qualifier注解进行限定。

@Autowired
@Qualifier("iceCream")
pulbic void setDessert(Dessert dessert) {
    this.dessert = dessert;
}

• 创建自定义限定符

可以为bean设置自己的限定符，而不依赖将bean ID作为限定符，在bean的声明上使用@Qualifier注解，其可以与@Component组合使用。

@Component
@Qualifier("cold")
public class IceCream implements Dessert {}

这样，使用如下。

@Autowired
@Qualifier("cold")
pulbic void setDessert(Dessert dessert) {
    this.dessert = dessert;
}

• 使用自定义的限定符注解

如果多个bean都具备相同特性的话，那么也会出现问题，无法确定唯一bean，如定义@Cold注解

@Target({ElementType.CONSTRUCTOR, ElementType.FIELD,
            ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
#Qualifier
public @interface Cold {}

这样就可以使用如下注解进行定义

@Component
@Cold
@Creamy
public class IceCream implements Dessert {} 

通过自定义注解后，然后可以通过多个注解的组合确定唯一一个符合条件的bean。

@Autowired
@Cold
@Creamy
pulbic void setDessert(Dessert dessert) {
    this.dessert = dessert;
}

bean的作用域

默认情况下，Spring上下文中所有bean都是作为以单例形式创建的。但有时候需要多个不同的bean实例，Spring定义了多种作用域，包括：

• 单例，整个应用中，只创建一个bean实例。
• 原型，每次注入或者通过Spring应用上下文获取时，都会创建一个新的bean实例。
• 会话，在Web应用中，为每个会话创建一个bean实例。
• 请求，在Web应用中，为每个请求创建一个bean实例。

使用@Scope注解确定bean的作用域，如将如下bean声明为原型。

@Component
@Scope(ConfigurableBeanFactory.SCOPE_PROTOTYPE)
public class NotePad {}

当使用xml文件配置时如下

使用会话和请求作用域

在Web应用中，可能需要实例化在会话和请求范围内共享的bean，如电商网站，需要会话作用域。

@Component
@Scope(
    value=WebApplicationContext.SCOPE_SESSION,
    proxyMode=ScopedProxyMode.INTERFACES)
public ShoppingCart cart() {}

需要将ShoppingCart bean注入到单例StoreService bean中。

@Component
public class StoreService {
    @Autowired
    public void setShoppingCart(ShoppingCart shoppingCart) {
        this.shoppingCart = shoppingCart;
    }
}

此时，由于ShoppingCart是会话作用域，直到某个用户创建了会话后，才会出现ShoppingCart实例，并且Spring会注入一个代理至StoreService中，这个代理与ShoppingCart有相同的方法，当处理时需要将调用委托给会话作用域内真正的ShoppingCart。

在XML中声明作用域代理

需要使用Spring aop命名空间的新元素

上述情况会使用CGLib创建目标类的代理，但也可将proxy-target-class属性设置为false，进而要求它生成基于接口的代理。

为使用元素，需要在XML中声明spring-aop.xsd命名空间。

运行时值注入

不使用硬编码注入，想让值在运行时确定，Spring提供了如下两种方式。

• 属性占位符
• Spring表达式语言

注入外部的值

声明属性源并通过Spring的Environment来检索属性。

...
@Configuration
@PropertySource("classpath:/com/hust/gird/leesf/app.properties")
public class ExpressiveConfig {
    @Autowired
    Environment env;
    
    @Bean
    public BlankDisc disc() {
        return new BlankDisc(
            env.getProperty("disc.title"),
            env.getProperty("disc.artist"));
    }
}

通过在app.properties中配置对应的属性完成注入。还可使用占位符完成注入。

public BlankDisc(
    @Value("${disc.title}") String title,
    @Value("${disc.artist}") String artist) {
  this.title = title; 
  this.artist = artist;
}

为使用占位符，需要配置PropertySourcesPlaceholderConfigurer。

@Bean
public static PropertySourcesPlaceholderConfigurer placeholderConfigurer() {
    return new PropertySourcesPlaceholderConfigurer();
}

或者在XML配置文件中使用，这样会生成一个PropertySourcesPlaceholderConfigurer的bean。

总结

本篇学习了更为高级的装配技巧，如Spring profile，还有条件化装配bean，以及bean的作用域等等。