对于最新的稳定版本,请使用 Spring Framework 7.0.6!spring-doc.cadn.net.cn

上下文层次结构

DispatcherServlet 期望一个 WebApplicationContext(一个普通 ApplicationContext 的扩展)用于其自身的配置。WebApplicationContext 有一个指向 ServletContext 和与之关联的 Servlet 的链接。它还绑定到 ServletContext,以便应用程序可以使用 RequestContextUtils 上的静态方法来查找 WebApplicationContext,如果它们需要访问它。spring-doc.cadn.net.cn

对于许多应用程序,拥有一个单独的WebApplicationContext是简单且足够的。 也可以有一个上下文层次结构,其中一个根WebApplicationContext 被多个DispatcherServlet(或其他Servlet)实例共享,每个实例都有 自己的子WebApplicationContext配置。 请参见Spring上下文的附加功能 以了解更多关于上下文层次结构的功能。spring-doc.cadn.net.cn

WebApplicationContext 通常包含基础设施 bean,例如数据存储库和需要在多个 Servlet 实例之间共享的业务服务。这些 bean 实际上是继承的,并且可以在特定于 Servlet 的子 WebApplicationContext 中覆盖(即重新声明),该 WebApplicationContext 通常包含给定 Servlet 的本地 bean。 下图显示了这种关系:spring-doc.cadn.net.cn

mvc context hierarchy

以下示例配置了一个WebApplicationContext层级:spring-doc.cadn.net.cn

public class MyWebAppInitializer extends AbstractAnnotationConfigDispatcherServletInitializer {

	@Override
	protected Class<?>[] getRootConfigClasses() {
		return new Class<?>[] { RootConfig.class };
	}

	@Override
	protected Class<?>[] getServletConfigClasses() {
		return new Class<?>[] { App1Config.class };
	}

	@Override
	protected String[] getServletMappings() {
		return new String[] { "/app1/*" };
	}
}
class MyWebAppInitializer : AbstractAnnotationConfigDispatcherServletInitializer() {

	override fun getRootConfigClasses(): Array<Class<*>> {
		return arrayOf(RootConfig::class.java)
	}

	override fun getServletConfigClasses(): Array<Class<*>> {
		return arrayOf(App1Config::class.java)
	}

	override fun getServletMappings(): Array<String> {
		return arrayOf("/app1/*")
	}
}
如果不需要应用程序上下文层次结构,应用程序可以通过 getRootConfigClasses()nullgetServletConfigClasses() 返回所有配置。

以下示例显示了 web.xml 的等效内容:spring-doc.cadn.net.cn

<web-app>

	<listener>
		<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
	</listener>

	<context-param>
		<param-name>contextConfigLocation</param-name>
		<param-value>/WEB-INF/root-context.xml</param-value>
	</context-param>

	<servlet>
		<servlet-name>app1</servlet-name>
		<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
		<init-param>
			<param-name>contextConfigLocation</param-name>
			<param-value>/WEB-INF/app1-context.xml</param-value>
		</init-param>
		<load-on-startup>1</load-on-startup>
	</servlet>

	<servlet-mapping>
		<servlet-name>app1</servlet-name>
		<url-pattern>/app1/*</url-pattern>
	</servlet-mapping>

</web-app>
如果不需要应用程序上下文层次结构,应用程序可以仅配置一个“根”上下文,并将contextConfigLocation Servlet参数留空。