|
此版本仍在开发中，尚不被认为是稳定的。对于最新的稳定版本，请使用 Spring Framework 6.2.10！ |
使用AnnotationConfigApplicationContext
以下部分记录了 Spring 的AnnotationConfigApplicationContext，在 Spring 中引入
3.0. 这个多功能的ApplicationContext实施不仅能够接受@Configuration类作为输入，但也是普通的@Component类和类
用 JSR-330 元数据进行注释。
什么时候@Configuration类作为输入提供，则@Configuration类本身
被注册为 bean 定义，并且所有@Bean类中的方法
也注册为 bean 定义。
什么时候@Component和 JSR-330 类，它们被注册为 bean
定义，并且假定 DI 元数据（例如@Autowired或@Inject是
必要时在这些类中使用。
结构简单
与实例化ClassPathXmlApplicationContext，您可以使用@Configuration类作为输入
实例化AnnotationConfigApplicationContext.这完全允许
Spring 容器的无 XML 用法，如以下示例所示：
-
Java
-
Kotlin
public static void main(String[] args) {
ApplicationContext ctx = new AnnotationConfigApplicationContext(AppConfig.class);
MyService myService = ctx.getBean(MyService.class);
myService.doStuff();
}import org.springframework.beans.factory.getBean
fun main() {
val ctx = AnnotationConfigApplicationContext(AppConfig::class.java)
val myService = ctx.getBean<MyService>()
myService.doStuff()
}如前所述，AnnotationConfigApplicationContext不仅限于工作
跟@Configuration类。任何@Component或可以提供 JSR-330 注释类
作为构造函数的输入，如以下示例所示：
-
Java
-
Kotlin
public static void main(String[] args) {
ApplicationContext ctx = new AnnotationConfigApplicationContext(MyServiceImpl.class, Dependency1.class, Dependency2.class);
MyService myService = ctx.getBean(MyService.class);
myService.doStuff();
}import org.springframework.beans.factory.getBean
fun main() {
val ctx = AnnotationConfigApplicationContext(MyServiceImpl::class.java, Dependency1::class.java, Dependency2::class.java)
val myService = ctx.getBean<MyService>()
myService.doStuff()
}前面的示例假设MyServiceImpl,Dependency1和Dependency2使用 Spring
依赖注入注解，例如@Autowired.
使用register(Class<?>…)
您可以实例化AnnotationConfigApplicationContext通过使用无参数构造函数
，然后使用register()方法。这种方法特别有用
以编程方式构建AnnotationConfigApplicationContext.以下内容
示例显示了如何执行此作：
-
Java
-
Kotlin
public static void main(String[] args) {
AnnotationConfigApplicationContext ctx = new AnnotationConfigApplicationContext();
ctx.register(AppConfig.class, OtherConfig.class);
ctx.register(AdditionalConfig.class);
ctx.refresh();
MyService myService = ctx.getBean(MyService.class);
myService.doStuff();
}import org.springframework.beans.factory.getBean
fun main() {
val ctx = AnnotationConfigApplicationContext()
ctx.register(AppConfig::class.java, OtherConfig::class.java)
ctx.register(AdditionalConfig::class.java)
ctx.refresh()
val myService = ctx.getBean<MyService>()
myService.doStuff()
}启用元件扫描scan(String…)
要启用组件扫描，您可以注释@Configuration类如下：
-
Java
-
Kotlin
@Configuration
@ComponentScan(basePackages = "com.acme") (1)
public class AppConfig {
// ...
}| 1 | 此注释启用组件扫描。 |
@Configuration
@ComponentScan(basePackages = ["com.acme"]) (1)
class AppConfig {
// ...
}| 1 | 此注释启用组件扫描。 |
|
有经验的 Spring 用户可能熟悉 XML 声明，等效于
Spring的 |
在前面的示例中，com.acme扫描包以查找任何@Component-带注释的类，这些类被注册为 Spring bean容器内的定义。AnnotationConfigApplicationContext公开scan(String…)方法允许相同的组件扫描功能，如以下示例所示：
-
Java
-
Kotlin
public static void main(String[] args) {
AnnotationConfigApplicationContext ctx = new AnnotationConfigApplicationContext();
ctx.scan("com.acme");
ctx.refresh();
MyService myService = ctx.getBean(MyService.class);
}fun main() {
val ctx = AnnotationConfigApplicationContext()
ctx.scan("com.acme")
ctx.refresh()
val myService = ctx.getBean<MyService>()
}记住@Configuration类的元注释为@Component，因此它们是组件扫描的候选者。在前面的示例中，假设AppConfig在com.acme包（或任何包下），在调用期间被拾取scan(). 后refresh()，其所有@Bean方法在容器中被处理并注册为 bean 定义。 |
支持 Web 应用程序AnnotationConfigWebApplicationContext
一个WebApplicationContext的变体AnnotationConfigApplicationContext可用 跟AnnotationConfigWebApplicationContext. 您可以在以下情况下使用此实现配置 SpringContextLoaderListenerservlet 监听器，Spring MVCDispatcherServlet，依此类推。以下内容web.xml代码片段配置一个典型的Spring MVC Web 应用程序（请注意，使用contextClasscontext-param 和init-param）：
<web-app>
<!-- Configure ContextLoaderListener to use AnnotationConfigWebApplicationContext
instead of the default XmlWebApplicationContext -->
<context-param>
<param-name>contextClass</param-name>
<param-value>
org.springframework.web.context.support.AnnotationConfigWebApplicationContext
</param-value>
</context-param>
<!-- Configuration locations must consist of one or more comma- or space-delimited
fully-qualified @Configuration classes. Fully-qualified packages may also be
specified for component-scanning -->
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>com.acme.AppConfig</param-value>
</context-param>
<!-- Bootstrap the root application context as usual using ContextLoaderListener -->
<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>
<!-- Declare a Spring MVC DispatcherServlet as usual -->
<servlet>
<servlet-name>dispatcher</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<!-- Configure DispatcherServlet to use AnnotationConfigWebApplicationContext
instead of the default XmlWebApplicationContext -->
<init-param>
<param-name>contextClass</param-name>
<param-value>
org.springframework.web.context.support.AnnotationConfigWebApplicationContext
</param-value>
</init-param>
<!-- Again, config locations must consist of one or more comma- or space-delimited
and fully-qualified @Configuration classes -->
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>com.acme.web.MvcConfig</param-value>
</init-param>
</servlet>
<!-- map all requests for /app/* to the dispatcher servlet -->
<servlet-mapping>
<servlet-name>dispatcher</servlet-name>
<url-pattern>/app/*</url-pattern>
</servlet-mapping>
</web-app>对于编程用例，一个GenericWebApplicationContext可以用作替代AnnotationConfigWebApplicationContext. 请参阅GenericWebApplicationContextjavadoc 了解详情。 |