Spring 中 @Value 注解多实例配置方案详解

news2025/6/5 21:02:28

引言

在使用 Spring 框架进行开发时，我们经常会使用 @Value 注解来注入配置值。然而，当我们需要创建同一个类的多个实例，并且每个实例需要使用不同的配置值时，直接在类中使用 @Value 注解就会遇到问题。本文将深入探讨这个问题，并提供几种灵活的解决方案。

问题背景

假设我们有一个 Product 类，使用 @Value 注解直接注入属性值：

@Component
public class Product {
    private String name;
    private int age;

    @Value("隔壁老王")
    public void setName(String name) {
        this.name = name;
    }

    @Value("33")
    public void setAge(int age) {
        this.age = age;
    }

    @Override
    public String toString() {
        return "Product{" +
                "name='" + name + '\'' +
                ", age=" + age +
                '}';
    }
}

这样配置会导致所有 Product Bean 都使用相同的 "隔壁老王" 和 33 作为属性值。如果我们需要创建多个 Product 实例，每个实例使用不同的名称和年龄，该怎么办呢？

解决方案

方案一：使用配置文件和 @Bean 方法

这是最常用的方法，通过 Java 配置类创建多个 Bean 实例，每个实例使用不同的配置值。

@Configuration
public class ProductConfig {

    @Bean("product1")
    public Product product1() {
        Product product = new Product();
        product.setName("张三");
        product.setAge(25);
        return product;
    }

    @Bean("product2")
    public Product product2() {
        Product product = new Product();
        product.setName("李四");
        product.setAge(30);
        return product;
    }
}

在使用时，通过 @Qualifier 注解指定要注入的 Bean 名称：

@Autowired
@Qualifier("product1")
private Product product1;

@Autowired
@Qualifier("product2")
private Product product2;

这种方法的优点是清晰明了，每个 Bean 的配置都集中在配置类中。缺点是当需要创建大量实例时，配置类会变得冗长。

方案二：结合配置文件和占位符

将配置值外部化到 properties 或 yaml 文件中，使用占位符引用这些值：

# application.properties
product1.name=张三
product1.age=25
product2.name=李四
product2.age=30

java

@Configuration
public class ProductConfig {

    @Bean("product1")
    public Product product1(@Value("${product1.name}") String name, 
                           @Value("${product1.age}") int age) {
        Product product = new Product();
        product.setName(name);
        product.setAge(age);
        return product;
    }

    @Bean("product2")
    public Product product2(@Value("${product2.name}") String name, 
                           @Value("${product2.age}") int age) {
        Product product = new Product();
        product.setName(name);
        product.setAge(age);
        return product;
    }
}

这种方法的优点是配置和代码分离，便于维护和修改。

方案三：使用 @ConfigurationProperties

当需要配置的属性较多时，可以使用 @ConfigurationProperties 注解将配置映射到一个类中：

@Configuration
@ConfigurationProperties(prefix = "products")
public class ProductProperties {
    private Map<String, Product> configs = new HashMap<>();

    public Map<String, Product> getConfigs() {
        return configs;
    }

    public void setConfigs(Map<String, Product> configs) {
        this.configs = configs;
    }
}

在配置文件中：

products.configs.p1.name=王五
products.configs.p1.age=35
products.configs.p2.name=赵六
products.configs.p2.age=40

使用时直接注入配置属性：

@Autowired
private ProductProperties productProperties;

public void printProducts() {
    Product p1 = productProperties.getConfigs().get("p1");
    Product p2 = productProperties.getConfigs().get("p2");
    System.out.println(p1); // Product{name='王五', age=35}
    System.out.println(p2); // Product{name='赵六', age=40}
}

方案四：使用原型作用域和 ObjectProvider

如果需要在运行时动态创建多个实例，可以将 Product 类标记为原型作用域，并使用 ObjectProvider 来获取实例：

@Component
@Scope("prototype")
public class Product {
    // 类定义保持不变
}

java

@Autowired
private ObjectProvider<Product> productProvider;

public void createProducts() {
    Product p1 = productProvider.getObject();
    p1.setName("动态创建1");
    p1.setAge(100);

    Product p2 = productProvider.getObject();
    p2.setName("动态创建2");
    p2.setAge(200);

    System.out.println(p1); // Product{name='动态创建1', age=100}
    System.out.println(p2); // Product{name='动态创建2', age=200}
}

方案五：使用工厂方法

创建一个工厂类来生成 Product 实例：

@Component
public class ProductFactory {

    public Product createProduct(String name, int age) {
        Product product = new Product();
        product.setName(name);
        product.setAge(age);
        return product;
    }
}

@Autowired
private ProductFactory productFactory;

public void useFactory() {
    Product p1 = productFactory.createProduct("工厂创建1", 101);
    Product p2 = productFactory.createProduct("工厂创建2", 102);
}

方案对比与选择建议

方案	优点	缺点	适用场景
配置类 @Bean 方法	简单直观，易于理解	配置类可能冗长	实例数量较少且固定
配置文件 + 占位符	配置与代码分离，便于修改	需要额外的配置文件	配置值需要经常修改
@ConfigurationProperties	适合批量配置大量属性	需要额外的配置类	属性较多的复杂配置
原型作用域 + ObjectProvider	运行时动态创建实例	需要理解作用域概念	需要动态创建多个实例
工厂方法	灵活控制对象创建过程	需要额外的工厂类	创建过程复杂的对象