基于注释的容器配置
基于注释的配置提供了XML设置的替代方法,该配置依赖字节码元数据来连接组件,而不是尖括号声明。通过使用相关类,方法或字段声明上的注释,开发人员无需使用XML来描述bean的连接,而是将配置移入组件类本身。
本质上,@Autowired
注释提供的功能与自动装配协作器中所述的功能相同,但具有更细粒度的控制和更广泛的适用性。
Spring 2.5还添加了对JSR-250批注(例如 @PostConstruct和)的支持@PreDestroy。Spring 3.0增加了对javax.inject包中包含的JSR-330(Java依赖注入)注释的支持,例如@Inject 和@Named。
注释注入在XML注入之前执行。因此,XML配置将覆盖通过两种方法连接的属性的注释。
## @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方法中)。这样做会强制执行那些必需的引用和值,即使您在容器外部使用该类也是如此。
从Spring Framework 5.1开始,正式弃用了@Required,以支持对所需的设置(或InitializingBean.afterPropertiesSet()Bean属性设置器方法的自定义实现)使用构造函数注入 。
@Autowired
在本节中的示例中,@Inject可以使用JSR 330的注释代替Spring的@Autowired注释。
您可以将@Autowired注释应用于构造函数,如以下示例所示:
public class MovieRecommender {
private final CustomerPreferenceDao customerPreferenceDao;
@Autowired
public MovieRecommender(CustomerPreferenceDao customerPreferenceDao) {
this.customerPreferenceDao = customerPreferenceDao;
}
// ...
}
从Spring Framework 4.3开始,@Autowired如果目标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;
}
// ...
}
您还可以ApplicationContext通过将@Autowired注解添加到需要该类型数组的字段或方法中,指示Spring提供特定类型的所有bean ,如以下示例所示:
public class MovieRecommender {
@Autowired
private MovieCatalog[] movieCatalogs;
// ...
}
如果您希望数组或列表中的项目以特定顺序排序,则目标bean可以实现org.springframework.core.Ordered接口或使用@Order或标准@Priority注释。否则,它们的顺序将遵循容器中相应目标bean定义的注册顺序。
您可以@Order在目标类级别和@Bean方法上声明注释,可能是针对单个bean定义(在使用同一bean类的多个定义的情况下)。@Order值可能会影响注入点的优先级,但请注意它们不会影响单例启动顺序,这是由依赖关系和@DependsOn声明确定的正交关系。
请注意,标准javax.annotation.Priority注释在该@Bean级别不可用 ,因为无法在方法上声明它。可以通过将@Order值与@Primary每个类型的单个bean 结合使用来对其语义进行建模。
您还可以使用@Autowired对于那些众所周知的解析依赖接口:
BeanFactory,ApplicationContext,Environment,ResourceLoader, ApplicationEventPublisher,和MessageSource。这些接口及其扩展接口(例如ConfigurableApplicationContext或ResourcePatternResolver)将自动解析,而无需进行特殊设置。
网友评论