巧妙注入的奥秘：在 Spring 中优雅地使用 List 和 Map

文章目录

- - 一、注入 List：同类项，一次拿下
  - 二、注入 Map：当键值对遇上多态
  - 三、进阶：使用 Qualifier 灵活注入
  - 四、总结
  - 总结
  - 推荐阅读文章

在 Spring 框架里，我们经常需要将不同的组件组织到集合中，比如在注入多个服务实例时，将它们置于一个 List 或 Map 集合中供后续灵活调用。这种设计不仅简洁且可扩展，同时也让代码更具可维护性。今天，我们就来一起看看如何在 Spring 中用最优雅的方式注入这些集合！

一、注入 List：同类项，一次拿下

在 Spring 中，List 注入可以让我们轻松地将一组同类的 Bean 注入到一个集合中。假设我们有多个实现了 OrderService 接口的类：

public interface OrderService {
    void processOrder();
}

@Component
public class RegularOrderService implements OrderService {
    public void processOrder() {
        System.out.println("Processing regular order");
    }
}

@Component
public class SpecialOrderService implements OrderService {
    public void processOrder() {
        System.out.println("Processing special order");
    }
}

我们可以在使用这些实现的类中通过 List<OrderService> 来一键注入：

@Component
public class OrderProcessor {
    private final List<OrderService> orderServices;

    public OrderProcessor(List<OrderService> orderServices) {
        this.orderServices = orderServices;
    }

    public void processAllOrders() {
        orderServices.forEach(OrderService::processOrder);
    }
}

通过这种方式，Spring 会自动把实现 OrderService 的所有 Bean 注入到 orderServices 列表中。这样一来，不管有多少个实现，只要实现 OrderService，我们就不需要额外修改代码，非常灵活。

二、注入 Map：当键值对遇上多态

如果我们希望按名称获取服务，比如用 Map<String, OrderService>，也是很容易实现的。假如 RegularOrderService 和 SpecialOrderService 分别需要按名称访问，那么我们只需改写注入为 Map 类型：

@Component
public class OrderProcessorWithMap {
    private final Map<String, OrderService> orderServiceMap;

    public OrderProcessorWithMap(Map<String, OrderService> orderServiceMap) {
        this.orderServiceMap = orderServiceMap;
    }

    public void processOrderByType(String type) {
        OrderService service = orderServiceMap.get(type);
        if (service != null) {
            service.processOrder();
        } else {
            System.out.println("Unknown order type");
        }
    }
}

在使用时，只需指定名称即可找到对应的 OrderService。Spring 会自动将 Bean 名称作为 Map 的键，实例作为值，非常方便地按需调用！

三、进阶：使用 Qualifier 灵活注入

当我们想要对注入的集合进行精确控制时，可以使用 @Qualifier 注解。比如我们只希望注入特殊的 OrderService 实现类：

@Component
public class FilteredOrderProcessor {
    private final List<OrderService> specialServices;

    public FilteredOrderProcessor(@Qualifier("special") List<OrderService> specialServices) {
        this.specialServices = specialServices;
    }

    public void processSpecialOrders() {
        specialServices.forEach(OrderService::processOrder);
    }
}