【Spring】19 @Autowired注解使用详解

文章目录

- - 构造函数注入
  - Setter方法注入
  - 字段注入
  - 数组和集合注入
  - 特殊情况处理
  - 特殊接口类型的注入
  - 异常处理
  - 结语

Spring 框架的 @Autowired 注解是实现依赖注入的一种强大而灵活的方式。在本文中，我们将介绍 @Autowired 注解的多种用法，包括构造函数、setter方法、字段、集合和特殊情况的处理。

构造函数注入

@Autowired 注解可以用于构造函数，例如：

public class MovieRecommender {private final CustomerPreferenceDao customerPreferenceDao;@Autowiredpublic MovieRecommender(CustomerPreferenceDao customerPreferenceDao) {this.customerPreferenceDao = customerPreferenceDao;}// ...
}

从 Spring Framework 4.3 版本开始，如果目标 bean 的构造函数只有一个，就不再需要在该构造函数上添加@Autowired 注解。但如果存在多个构造函数，且没有主/默认构造函数，则至少要在其中一个构造函数上添加@Autowired 注解。

Setter方法注入

@Autowired 注解同样可以用于传统的 setter 方法：

public class SimpleMovieLister {private MovieFinder movieFinder;@Autowiredpublic void setMovieFinder(MovieFinder movieFinder) {this.movieFinder = movieFinder;}// ...
}

此外，注解还可以用于具有任意名称和多个参数的方法：

public class MovieRecommender {private MovieCatalog movieCatalog;private CustomerPreferenceDao customerPreferenceDao;@Autowiredpublic void prepare(MovieCatalog movieCatalog, CustomerPreferenceDao customerPreferenceDao) {this.movieCatalog = movieCatalog;this.customerPreferenceDao = customerPreferenceDao;}// ...
}

字段注入

@Autowired 注解还可以用于字段，并且可以与构造函数混用：

public class MovieRecommender {private final CustomerPreferenceDao customerPreferenceDao;@Autowiredprivate MovieCatalog movieCatalog;@Autowiredpublic MovieRecommender(CustomerPreferenceDao customerPreferenceDao) {this.customerPreferenceDao = customerPreferenceDao;}// ...
}

需要确保目标组件的声明类型与 @Autowired 注解的注入点类型一致，以避免在运行时出现 “no type match found” 错误。

数组和集合注入

通过 @Autowired 注解，你可以将容器中所有特定类型的 bean 注入到数组或集合中：

public class MovieRecommender {@Autowiredprivate MovieCatalog[] movieCatalogs;// 或者private Set<MovieCatalog> movieCatalogs;@Autowiredpublic void setMovieCatalogs(Set<MovieCatalog> movieCatalogs) {this.movieCatalogs = movieCatalogs;}// ...
}

如果希望数组或集合中的元素按照特定顺序排序，可以使用 @Order 注解或 Java 8 的 Optional、@Nullable 注解。

特殊情况处理

当没有匹配的候选 bean 可用于给定的注入点时，默认情况下，@Autowired 注解会导致注入失败。你可以通过将@Autowired 的 required 属性设置为 false 来更改此行为，使其变为非必需的：

public class SimpleMovieLister {private MovieFinder movieFinder;@Autowired(required = false)public void setMovieFinder(MovieFinder movieFinder) {this.movieFinder = movieFinder;}// ...
}

将 required 属性设置为 false 表示，如果无法进行自动装配，将跳过非必需的注入点，不会调用对应的方法或设置字段。

特殊接口类型的注入

@Autowired 注解还可以用于诸如 BeanFactory、ApplicationContext、Environment 等 Spring 容器内置的接口类型。这些接口和它们的扩展接口无需额外配置，Spring 会自动解析它们。

public class MovieRecommender {@Autowiredprivate ApplicationContext context;// ...
}

异常处理

在实际应用中，如果无法匹配到候选 bean，@Autowired 注解将导致注入失败。对于构造函数和工厂方法参数的注入，required 属性有不同的含义。可以使用 Java 8 的 Optional、@Nullable 注解，或者在 Spring Framework 5.0 中使用 @Nullable 注解。

public class SimpleMovieLister {@Autowiredpublic void setMovieFinder(Optional<MovieFinder> movieFinder) {// ...}// 或者@Autowiredpublic void setMovieFinder(@Nullable MovieFinder movieFinder) {// ...}
}