容器概述 (Container Overview) _ Spring Framework6.2.0-SNAPSHOT中文文档(官方文档中文翻译)|Spring 教程 —

此版本仍在开发中，尚未被视为稳定版本。最新的稳定版本请使用 Spring Framework 6.1.13！spring-doc.cn

该接口表示 Spring IoC 容器，并负责实例化、配置和组装 bean。容器在组件上获取其指令，以实例化、配置和通过读取配置元数据进行汇编。可以表示配置元数据作为带注释的组件类、具有工厂方法的配置类或外部 XML 文件或 Groovy 脚本。无论使用哪种格式，您都可以编写应用程序，并将这些组件之间丰富的相互依赖关系。org.springframework.context.ApplicationContextspring-doc.cn

该接口的几个实现是核心 Spring 的一部分。在独立应用程序中，通常创建AnnotationConfigApplicationContext或ClassPathXmlApplicationContext的实例。ApplicationContextspring-doc.cn

在大多数应用程序场景中，不需要显式用户代码来实例化一个或 Spring IoC 容器的更多实例。例如，在普通 Web 应用程序场景中，应用程序文件中的简单样板 Web 描述符 XML 就足够了（参见 Web 应用程序的便捷 ApplicationContext 实例化）。在 Spring Boot 场景中，应用程序上下文是隐式引导的基于通用设置约定。web.xmlspring-doc.cn

下图显示了 Spring 工作原理的高级视图。您的应用程序类与配置元数据结合使用，以便在创建并初始化后，您将拥有一个完全配置且可执行的系统或应用程序。ApplicationContextspring-doc.cn

图 1.Spring IoC 容器

配置元数据

如上图所示， Spring IoC 容器使用一种形式的配置元数据。此配置元数据表示您作为 application developer，告诉 Spring 容器实例化、配置、并在应用程序中组装组件。spring-doc.cn

Spring IoC 容器本身与此格式完全解耦配置元数据实际上是写入的。如今，许多开发人员为他们的 Spring 应用程序选择基于 Java 的配置：spring-doc.cn

基于注解的配置：使用应用程序组件类上基于 Annotation 的配置元数据。spring-doc.cn
基于 Java 的配置：定义应用程序外部的 bean 类。要使用这些功能，请参阅 @Configuration、@Bean @Import、和 @DependsOn 注释。spring-doc.cn

Spring 配置由至少一个（通常多个）bean 定义组成容器必须管理。Java 配置通常使用 -annotated 方法，每个方法对应一个 bean 定义。@Bean@Configurationspring-doc.cn

这些 Bean 定义对应于组成应用程序的实际对象。通常，您可以定义服务层对象、持久性层对象（如存储库或数据访问对象（DAO）、表示对象（如 Web 控制器）、基础设施对象，例如 JPA、JMS 队列等。通常，不会在容器中配置细粒度的域对象，因为创建和加载通常是存储库和业务逻辑的责任 domain 对象。EntityManagerFactoryspring-doc.cn

XML 作为外部配置 DSL

基于 XML 的配置元数据将这些 bean 配置为顶级元素。以下示例显示了基于 XML 的配置元数据：<bean/><beans/>spring-doc.cn

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://www.springframework.org/schema/beans
		https://www.springframework.org/schema/beans/spring-beans.xsd">

	<bean id="..." class="..."> (1) (2)
		<!-- collaborators and configuration for this bean go here -->
	</bean>

	<bean id="..." class="...">
		<!-- collaborators and configuration for this bean go here -->
	</bean>

	<!-- more bean definitions go here -->

</beans>

1	该属性是标识单个 Bean 定义的字符串。`id`
2	该属性定义 bean 的类型，并使用完全限定的类名。`class`

该属性的值可用于引用协作对象。The XML 本例中未显示 for reference to collaborative objects。有关更多信息，请参阅依赖项。idspring-doc.cn

对于实例化容器，XML 资源文件的位置路径或 paths 需要提供给一个构造函数，该构造函数允许容器加载来自各种外部资源的配置元数据，例如作为本地文件系统、Java 等。ClassPathXmlApplicationContextCLASSPATHspring-doc.cn

Javaspring-doc.cn
Kotlinspring-doc.cn

ApplicationContext context = new ClassPathXmlApplicationContext("services.xml", "daos.xml");

val context = ClassPathXmlApplicationContext("services.xml", "daos.xml")

在了解了 Spring 的 IoC 容器之后，您可能希望了解有关 Spring 抽象的更多信息（如参考资料中所述）它提供了一种方便的机制，用于从定义的位置读取 InputStream 在 URI 语法中。特别是，paths 用于构建应用程序上下文，如应用程序上下文和资源路径中所述。ResourceResourcespring-doc.cn

以下示例显示了服务层对象配置文件：(services.xml)spring-doc.cn

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://www.springframework.org/schema/beans
		https://www.springframework.org/schema/beans/spring-beans.xsd">

	<!-- services -->

	<bean id="petStore" class="org.springframework.samples.jpetstore.services.PetStoreServiceImpl">
		<property name="accountDao" ref="accountDao"/>
		<property name="itemDao" ref="itemDao"/>
		<!-- additional collaborators and configuration for this bean go here -->
	</bean>

	<!-- more bean definitions for services go here -->

</beans>

以下示例显示了数据访问对象文件：daos.xmlspring-doc.cn

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://www.springframework.org/schema/beans
		https://www.springframework.org/schema/beans/spring-beans.xsd">

	<bean id="accountDao"
		class="org.springframework.samples.jpetstore.dao.jpa.JpaAccountDao">
		<!-- additional collaborators and configuration for this bean go here -->
	</bean>

	<bean id="itemDao" class="org.springframework.samples.jpetstore.dao.jpa.JpaItemDao">
		<!-- additional collaborators and configuration for this bean go here -->
	</bean>

	<!-- more bean definitions for data access objects go here -->

</beans>

在前面的示例中，服务层由类以及两个数据类型为和（基于在 JPA Object-Relational Mapping 标准上）。该元素引用 name，并且该元素引用另一个 bean 的名称定义。和元素之间的这种联系表达了协作对象。有关配置对象依赖项的详细信息，请参阅依赖项。PetStoreServiceImplJpaAccountDaoJpaItemDaoproperty namerefidrefspring-doc.cn

编写基于 XML 的配置元数据

让 Bean 定义跨多个 XML 文件可能很有用。通常，每个个体 XML 配置文件表示体系结构中的逻辑层或模块。spring-doc.cn

您可以使用构造函数从 XML 片段。此构造函数采用多个位置，如上一节所示。或者使用元素的一个或多个匹配项从中加载 Bean 定义另一个文件或文件。以下示例显示了如何执行此操作：ClassPathXmlApplicationContextResource<import/>spring-doc.cn

<beans>
	<import resource="services.xml"/>
	<import resource="resources/messageSource.xml"/>
	<import resource="/resources/themeSource.xml"/>

	<bean id="bean1" class="..."/>
	<bean id="bean2" class="..."/>
</beans>

在前面的示例中，外部 Bean 定义是从三个文件加载的：、、和。所有位置路径都是相对于执行导入的定义文件，因此必须位于与执行导入的文件相同的目录或 Classpath 位置，而和必须位于导入文件的位置。如您所见，前导斜杠将被忽略。然而，鉴于这些路径是相对的，最好根本不使用斜杠。这正在导入的文件的内容（包括 top level 元素）必须根据 Spring Schema 是有效的 XML bean 定义。services.xmlmessageSource.xmlthemeSource.xmlservices.xmlmessageSource.xmlthemeSource.xmlresources<beans/>spring-doc.cn

可以使用相对 “../“ 路径。这样做会创建对当前应用。特别是，不建议将此引用用于 URL（对于 example，），其中运行时解析进程选择 “nearest” classpath 根目录，然后查看其父目录。类路径配置更改可能会导致选择不同的错误目录。classpath:classpath:../services.xmlspring-doc.cn

您始终可以使用完全限定的资源位置而不是相对路径：对于 example 或 .但是，be 知道您正在将应用程序的配置耦合到特定的 absolute 地点。通常最好为这种绝对的 locations — 例如，通过针对 JVM 解析的 “${...}” 占位符系统属性。file:C:/config/services.xmlclasspath:/config/services.xmlspring-doc.cn

命名空间本身提供了 import 指令功能。进一步除了普通 Bean 定义之外的配置功能在 SELECTION 中可用 Spring 提供的 XML 命名空间 — 例如，和命名空间。contextutilspring-doc.cn

Groovy Bean 定义 DSL

作为外部化配置元数据的另一个示例，bean 定义还可以用 Spring 的 Groovy Bean 定义 DSL 表示，如 Grails 框架所示。通常，此类配置位于“.groovy”文件中，其结构如以下示例：spring-doc.cn

beans {
	dataSource(BasicDataSource) {
		driverClassName = "org.hsqldb.jdbcDriver"
		url = "jdbc:hsqldb:mem:grailsDB"
		username = "sa"
		password = ""
		settings = [mynew:"setting"]
	}
	sessionFactory(SessionFactory) {
		dataSource = dataSource
	}
	myService(MyService) {
		nestedBean = { AnotherBean bean ->
			dataSource = dataSource
		}
	}
}

这种配置样式在很大程度上等同于 XML bean 定义，甚至支持 Spring 的 XML 配置命名空间。它还允许导入 XML bean 定义文件。importBeansspring-doc.cn

1	该属性是标识单个 Bean 定义的字符串。`id`
2	该属性定义 bean 的类型，并使用完全限定的类名。`class`

使用容器

这是能够维护不同 bean 及其依赖项的注册表。通过使用 method ，您可以检索 bean 的实例。ApplicationContextT getBean(String name, Class<T> requiredType)spring-doc.cn

允许您读取 bean 定义并访问它们，如下所示示例显示：ApplicationContextspring-doc.cn

Javaspring-doc.cn
Kotlinspring-doc.cn

// create and configure beans
ApplicationContext context = new ClassPathXmlApplicationContext("services.xml", "daos.xml");

// retrieve configured instance
PetStoreService service = context.getBean("petStore", PetStoreService.class);

// use configured instance
List<String> userList = service.getUsernameList();

   import org.springframework.beans.factory.getBean

// create and configure beans
   val context = ClassPathXmlApplicationContext("services.xml", "daos.xml")

   // retrieve configured instance
   val service = context.getBean<PetStoreService>("petStore")

   // use configured instance
   var userList = service.getUsernameList()

使用 Groovy 配置，引导看起来非常相似。它有不同的背景 implementation 类，该类是 Groovy 感知的（但也理解 XML bean 定义）。以下示例显示了 Groovy 配置：spring-doc.cn

Javaspring-doc.cn
Kotlinspring-doc.cn

ApplicationContext context = new GenericGroovyApplicationContext("services.groovy", "daos.groovy");

val context = GenericGroovyApplicationContext("services.groovy", "daos.groovy")

最灵活的变体是与阅读器结合使用 delegates — 例如，对于 XML 文件，如下所示示例显示：GenericApplicationContextXmlBeanDefinitionReaderspring-doc.cn

Javaspring-doc.cn
Kotlinspring-doc.cn

GenericApplicationContext context = new GenericApplicationContext();
new XmlBeanDefinitionReader(context).loadBeanDefinitions("services.xml", "daos.xml");
context.refresh();

val context = GenericApplicationContext()
XmlBeanDefinitionReader(context).loadBeanDefinitions("services.xml", "daos.xml")
context.refresh()

您还可以使用 for Groovy 文件，如下所示示例显示：GroovyBeanDefinitionReaderspring-doc.cn

Javaspring-doc.cn
Kotlinspring-doc.cn

GenericApplicationContext context = new GenericApplicationContext();
new GroovyBeanDefinitionReader(context).loadBeanDefinitions("services.groovy", "daos.groovy");
context.refresh();

val context = GenericApplicationContext()
GroovyBeanDefinitionReader(context).loadBeanDefinitions("services.groovy", "daos.groovy")
context.refresh()

您可以在同一个上混合和匹配此类 Reader 委托。从不同的配置源读取 bean 定义。ApplicationContextspring-doc.cn

然后，您可以使用来检索 bean 的实例。该接口有一些其他方法用于检索 bean，但理想情况下，您的应用程序代码永远不应该使用它们。事实上，你的应用程序代码应该根本不调用该方法，因此根本不依赖于 Spring API。例如 Spring 与 Web 框架的集成为各种 Web 提供了依赖注入框架组件（例如控制器和 JSF 托管 Bean），允许您声明通过元数据（例如自动装配 Comments）对特定 bean 的依赖。getBeanApplicationContextgetBean()spring-doc.cn