容器概述 (Container Overview) _ Spring Framework 6.0.23-SNAPSHOT 中文文档(官方文档中文翻译) —

此版本仍在开发中，尚未被视为稳定版本。对于最新的稳定版本，请使用 Spring Framework 6.1.10！Spring中文文档

该接口表示 Spring IoC 容器，并负责实例化、配置和组装豆。容器获取有关要执行哪些对象的指令通过读取配置元数据进行实例化、配置和组装。这配置元数据以 XML、Java 注释或 Java 代码表示。它让您可以表达组成应用程序的对象和丰富的相互依赖关系在这些对象之间。org.springframework.context.ApplicationContextSpring中文文档

提供了该接口的几种实现与Spring。在独立应用程序中，通常会创建一个 ClassPathXmlApplicationContext 或 FileSystemXmlApplicationContext 的实例。虽然 XML 一直是定义配置元数据的传统格式，但您可以指示容器使用 Java 注解或代码作为元数据格式提供少量 XML 配置以声明方式启用对这些配置的支持其他元数据格式。ApplicationContextSpring中文文档

在大多数应用程序方案中，不需要显式用户代码来实例化一个或 Spring IoC 容器的更多实例。例如，在 Web 应用程序方案中，一个文件中简单的八行（左右）样板 Web 描述符 XML 通常就足够了（请参阅 Web 应用程序的方便 ApplicationContext 实例化）。如果您使用 Spring Tools for Eclipse（由 Eclipse 提供支持的开发环境），您可以使用很少点击鼠标或击键。web.xmlSpring中文文档

下图显示了 Spring 工作原理的高级视图。您的应用程序类与配置元数据结合使用，因此，在创建并初始化，您有一个完全配置和可执行的系统，或者应用。ApplicationContextSpring中文文档

图 1.Spring IoC 容器

配置元数据

如上图所示，Spring IoC 容器使用配置元数据。此配置元数据表示您作为应用程序开发人员，告诉 Spring 容器实例化、配置和组装应用程序中的对象。Spring中文文档

配置元数据传统上以简单直观的 XML 格式提供，这是本章的大部分内容，用于传达 Spring IoC 容器。Spring中文文档

基于 XML 的元数据并不是唯一允许的配置元数据形式。 Spring IoC 容器本身与以下格式完全分离配置元数据实际上是写入的。如今，许多开发人员为他们的 Spring 应用程序选择基于 Java 的配置。

有关在 Spring 容器中使用其他形式的元数据的信息，请参阅：Spring中文文档

基于注释的配置：使用基于注释的配置元数据。Spring中文文档
基于 Java 的配置：定义应用程序外部的 Bean 使用 Java 而不是 XML 文件的类。要使用这些功能，请参阅@Configuration、@Bean、@Import、和@DependsOn注释。Spring中文文档

Spring 配置由至少一个 Bean 组成，通常由多个 Bean 组成容器必须管理的定义。基于 XML 的配置元数据配置这些 bean 作为顶级元素中的元素。爪哇岛配置通常在类中使用 -annotated 方法。<bean/><beans/>@Bean@ConfigurationSpring中文文档

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

以下示例显示了基于 XML 的配置元数据的基本结构：Spring中文文档

<?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 此示例中未显示用于引用协作对象。有关详细信息，请参阅依赖项。idSpring中文文档

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

实例化容器

位置路径提供给构造函数的是资源字符串，这些字符串让来自各种外部资源的容器加载配置元数据，例如作为本地文件系统、Java 等。ApplicationContextCLASSPATHSpring中文文档

JavaSpring中文文档
KotlinSpring中文文档

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

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

在了解了 Spring 的 IoC 容器之后，您可能想更多地了解 Spring 的抽象（如参考资料中所述）它提供了一种方便的机制，用于从定义的位置读取 InputStream 在 URI 语法中。具体而言，路径用于构造应用程序上下文，如应用程序上下文和资源路径中所述。ResourceResourceSpring中文文档

以下示例显示了服务层对象配置文件：(services.xml)Spring中文文档

<?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中文文档

<?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 对象关系映射标准上）。该元素是指 JavaBean 属性的名称，该元素引用另一个 Bean 的名称定义。和元素之间的这种联系表达了协作对象。有关配置对象依赖关系的详细信息，请参阅依赖关系。PetStoreServiceImplJpaAccountDaoJpaItemDaoproperty namerefidrefSpring中文文档

编写基于 XML 的配置元数据

让 Bean 定义跨越多个 XML 文件会很有用。通常，每个人 XML 配置文件表示体系结构中的逻辑层或模块。Spring中文文档

您可以使用应用程序上下文构造函数从所有这些中加载 Bean 定义 XML 片段。此构造函数采用多个位置，如上一节所示。或者使用元素的一个或多个匹配项从中加载 Bean 定义另一个文件或文件。以下示例演示如何执行此操作：Resource<import/>Spring中文文档

<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 定义是从三个文件加载的：、和。所有位置路径都是相对于进行导入的定义文件，因此必须在与执行导入的文件相同的目录或类路径位置，而和必须位于导入文件的位置。如您所见，前导斜杠被忽略。但是，鉴于这些路径是相对的，最好不要使用斜杠。这要导入的文件的内容（包括 top level 元素）必须是有效的 XML bean 定义，根据 Spring Schema。services.xmlmessageSource.xmlthemeSource.xmlservices.xmlmessageSource.xmlthemeSource.xmlresources<beans/>Spring中文文档

可以（但不建议）使用相对“../“路径。这样做会创建对当前文件之外的文件的依赖关系应用。特别是，不建议对 URL （对于例如，其中运行时解析过程选择 “Nearest”类路径根目录，然后查看其父目录。类路径配置更改可能会导致选择不同的不正确目录。classpath:classpath:../services.xmlSpring中文文档

您始终可以使用完全限定的资源位置而不是相对路径：for 示例，或者 .但是，是意识到您正在将应用程序的配置耦合到特定的绝对值地点。通常最好为这种绝对值保留间接性位置 — 例如，通过针对 JVM 解析的“${...}”占位符运行时的系统属性。file:C:/config/services.xmlclasspath:/config/services.xmlSpring中文文档

命名空间本身提供 import 指令功能。进一步除了普通 Bean 定义之外，还可以在一系列配置中提供的 XML 命名空间，例如，和命名空间。contextutilSpring中文文档

Groovy Bean 定义 DSL

作为外部化配置元数据的进一步示例，Bean 定义还可以在 Spring 的 Groovy Bean Definition DSL 中表示，正如 Grails 框架所知道的那样。通常，此类配置位于“.groovy”文件中，其结构显示在以下示例：Spring中文文档

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中文文档

使用容器

是先进工厂的接口，能够维护不同 Bean 及其依赖关系的注册表。通过使用该方法，您可以检索 Bean 的实例。ApplicationContextT getBean(String name, Class<T> requiredType)Spring中文文档

允许您读取 Bean 定义并访问它们，如下所示示例显示：ApplicationContextSpring中文文档

JavaSpring中文文档
KotlinSpring中文文档

// 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 配置，引导看起来非常相似。它有不同的背景实现类，它具有 Groovy 感知能力（但也理解 XML Bean 定义）。以下示例显示了 Groovy 配置：Spring中文文档

JavaSpring中文文档
KotlinSpring中文文档

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

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

最灵活的变体是与阅读器结合使用委托 — 例如，对于 XML 文件，如下所示示例显示：GenericApplicationContextXmlBeanDefinitionReaderSpring中文文档

JavaSpring中文文档
KotlinSpring中文文档

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中文文档

JavaSpring中文文档
KotlinSpring中文文档

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()

你可以在同一个上混合和匹配这样的读者委托，从不同的配置源读取 Bean 定义。ApplicationContextSpring中文文档

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