xinrong2019
commented
5 years ago 1.9.1. @Required
@Required注释适用于bean属性setter方法，如下例所示：
public class SimpleMovieLister {
private MovieFinder movieFinder;
@Required
public void setMovieFinder(MovieFinder movieFinder) {
this.movieFinder = movieFinder;
}
// ...
}此批注指示必须在配置时通过bean定义中的显式属性值或通过自动装配填充受影响的bean属性。如果尚未填充受影响的bean属性，则容器将引发异常。这允许急切和显式的失败，以后避免NullPointerException实例等。我们仍然建议您将断言放入bean类本身（例如，转换为init方法）。即使您在容器外部使用类，这样做也会强制执行那些必需的引用和值。
@Required注释从Spring Framework 5.1开始正式弃用，支持使用构造函数注入所需的设置（或者自定义实现InitializingBean.afterPropertiesSet（）以及bean属性setter方法）。
1.9.2. Using @Autowired
在本节所包含的示例中，可以使用JSR 330的@Inject注释代替Spring的@Autowired注释。有关详细信息，请参见此处
您可以将@Autowired注释应用于构造函数，如以下示例所示：
public class MovieRecommender {
private final CustomerPreferenceDao customerPreferenceDao;
@Autowired
public MovieRecommender(CustomerPreferenceDao customerPreferenceDao) {
this.customerPreferenceDao = customerPreferenceDao;
}
// ...
}从Spring Framework 4.3开始，如果目标bean只定义了一个开头的构造函数，则不再需要在这样的构造函数上使用@Autowired注释。但是，如果有几个构造器可用，则必须注释至少一个构造器以教导容器使用哪一个。
您还可以将@Autowired注释应用于“传统”setter方法，如以下示例所示：
public class SimpleMovieLister {
private MovieFinder movieFinder;
@Autowired
public void setMovieFinder(MovieFinder movieFinder) {
this.movieFinder = movieFinder;
}
// ...
}您还可以将注释应用于具有任意名称和多个参数的方法，如以下示例所示：
public class MovieRecommender {
private MovieCatalog movieCatalog;
private CustomerPreferenceDao customerPreferenceDao;
@Autowired
public void prepare(MovieCatalog movieCatalog,
CustomerPreferenceDao customerPreferenceDao) {
this.movieCatalog = movieCatalog;
this.customerPreferenceDao = customerPreferenceDao;
}
// ...
}您也可以将@Autowired应用于字段，甚至将其与构造函数混合，如以下示例所示：
public class MovieRecommender {
private final CustomerPreferenceDao customerPreferenceDao;
@Autowired
private MovieCatalog movieCatalog;
@Autowired
public MovieRecommender(CustomerPreferenceDao customerPreferenceDao) {
this.customerPreferenceDao = customerPreferenceDao;
}
// ...
}确保您的目标组件（例如，MovieCatalog或CustomerPreferenceDao）始终按照用于@Autowired-annotated注入点的类型声明。否则，由于在运行时未找到类型匹配，注入可能会失败。
对于通过类路径扫描找到的XML定义的bean或组件类，容器通常预先知道具体类型。但是，对于@Bean工厂方法，您需要确保声明的返回类型具有足够的表现力。对于实现多个接口的组件或可能由其实现类型引用的组件，请考虑在工厂方法上声明最具体的返回类型（至少与引用bean的注入点所需的特定类型一致）。
您还可以通过将注释添加到需要该类型数组的字段或方法，从ApplicationContext提供特定类型的所有bean，如以下示例所示：
public class MovieRecommender {
@Autowired
private MovieCatalog[] movieCatalogs;
// ...
}这同样适用于类型化集合，如以下示例所示：
public class MovieRecommender {
private Set<MovieCatalog> movieCatalogs;
@Autowired
public void setMovieCatalogs(Set<MovieCatalog> movieCatalogs) {
this.movieCatalogs = movieCatalogs;
}
// ...
}
如果希望数组或列表中的项按特定顺序排序，则目标bean可以实现org.springframework.core.Ordered接口或使用@Order或标准@Priority批注。否则，它们的顺序遵循容器中相应目标bean定义的注册顺序。
您可以在目标类级别和@Bean方法上声明@Order注释，可能是通过单个bean定义（在多个定义使用相同bean类的情况下）。 @Order值可能影响注入点的优先级，但要注意它们不会影响单例启动顺序，这是由依赖关系和@DependsOn声明确定的正交关注点。
请注意，标准的javax.annotation.Priority注释在@Bean级别不可用，因为它无法在方法上声明。它的语义可以通过@Order值与@Primary在每个类型的单个bean上进行建模。
只要预期的键类型是String，即使是类型化的Map实例也可以自动装配。 Map值包含所有期望类型的bean，并且键包含相应的bean名称，如以下示例所示：
public class MovieRecommender {
private Map<String, MovieCatalog> movieCatalogs;
@Autowired
public void setMovieCatalogs(Map<String, MovieCatalog> movieCatalogs) {
this.movieCatalogs = movieCatalogs;
}
// ...
}默认情况下，当给定注入点没有匹配的候选bean时，自动装配失败。对于声明的数组，集合或映射，至少需要一个匹配元素。
默认行为是将带注释的方法和字段视为指示所需的依赖项。您可以更改此行为，如以下示例所示，使框架能够通过将其标记为非必需来跳过不可满足的注入点：
public class SimpleMovieLister {
private MovieFinder movieFinder;
@Autowired(required = false)
public void setMovieFinder(MovieFinder movieFinder) {
this.movieFinder = movieFinder;
}
// ...
}如果不可用的依赖项（或多个参数情况下的依赖项之一），则根本不会调用非必需的方法。在这种情况下，根本不会填充非必填字段，保留其默认值。
注入构造函数和工厂方法参数是一种特殊情况，因为@Autowired上的'required'标志具有一些不同的含义，因为Spring的构造函数解析算法可能涉及多个构造函数。默认情况下有效地需要构造函数和工厂方法参数，但在单构造函数场景中有一些特殊规则，例如，如果没有匹配的bean可用，则解析为空实例的多元素注入点（数组，集合，映射）。这允许一种通用的实现模式，其中所有依赖关系都可以在唯一的多参数构造函数中声明，例如，声明为没有@Autowired注释的单个公共构造函数。
每个类只能标记一个带注释的构造函数，但可以注释多个非必需的构造函数。在这种情况下，每个都被认为是候选者之一，Spring使用最贪婪的构造函数，其依赖性可以得到满足 - 也就是说，具有最多参数的构造函数。构造函数解析算法与具有重载构造函数的非注释类相同，只是将候选者缩小到带注释的构造函数。
建议使用@Autowired的'required'属性而不是setter方法的@Required注释。 “required”属性表示该属性不是自动装配所必需的。如果无法自动装配，则会忽略该属性。另一方面，@ Required更强大，因为它强制通过容器支持的任何方式设置属性。如果未定义任何值，则会引发相应的异常。
或者，您可以通过Java 8的java.util.Optional表达特定依赖项的非必需特性，如以下示例所示：
public class SimpleMovieLister {
@Autowired
public void setMovieFinder(Optional<MovieFinder> movieFinder) {
...
}
}从Spring Framework 5.0开始，您还可以使用@Nullable注释（任何包中的任何类型 - 例如，来自JSR-305的javax.annotation.Nullable）：
public class SimpleMovieLister {
@Autowired
public void setMovieFinder(@Nullable MovieFinder movieFinder) {
...
}
}您还可以将@Autowired用于众所周知的可解析依赖项的接口：BeanFactory，ApplicationContext，Environment，ResourceLoader，ApplicationEventPublisher和MessageSource。这些接口及其扩展接口（如ConfigurableApplicationContext或ResourcePatternResolver）将自动解析，无需特殊设置。以下示例自动装配ApplicationContext对象：
public class MovieRecommender {
@Autowired
private ApplicationContext context;
public MovieRecommender() {
}
// ...
}@Autowired，@ Inject，@ Value和@Resource注释由Spring BeanPostProcessor实现处理。这意味着您无法在自己的BeanPostProcessor或BeanFactoryPostProcessor类型（如果有）中应用这些注释。必须使用XML或Spring @Bean方法显式地“连接”这些类型。
1.9. Annotation-based Container Configuration
基于注释的配置提供了XML设置的替代方案，该配置依赖于字节码元数据来连接组件而不是角括号声明。开发人员不是使用XML来描述bean连接，而是通过在相关的类，方法或字段声明上使用注释将配置移动到组件类本身。如示例中所述：RequiredAnnotationBeanPostProcessor，将BeanPostProcessor与注释结合使用是扩展Spring IoC容器的常用方法。例如，Spring 2.0引入了使用@Required注释强制执行所需属性的可能性。 Spring 2.5使得有可能采用相同的通用方法来驱动Spring的依赖注入。从本质上讲，@ Autowired注释提供的功能与自动装配协作者中描述的相同，但具有更细粒度的控制和更广泛的适用性。 Spring 2.5还增加了对JSR-250注释的支持，例如@ PostConstruct和@PreDestroy。 Spring 3.0增加了对javax.inject包中包含的JSR-330（Java的依赖注入）注释的支持，例如@Inject和@Named。有关这些注释的详细信息，请参阅相关章节。
与往常一样，您可以将它们注册为单独的bean定义，但也可以通过在基于XML的Spring配置中包含以下标记来隐式注册它们（请注意包含上下文命名空间）：
（隐式注册的后处理器包括AutowiredAnnotationBeanPostProcessor，CommonAnnotationBeanPostProcessor，PersistenceAnnotationBeanPostProcessor和前面提到的RequiredAnnotationBeanPostProcessor。）