类 WebApplicationContextUtils

构造器详细资料

• WebApplicationContextUtils

  public WebApplicationContextUtils()

方法详细资料

• getRequiredWebApplicationContext

  public static WebApplicationContext getRequiredWebApplicationContext​(ServletContext sc)
                                                                throws IllegalStateException

  Find the root WebApplicationContext for this web app, typically loaded via ContextLoaderListener.

  Will rethrow an exception that happened on root context startup, to differentiate between a failed context startup and no context at all.

  参数:

  sc - ServletContext to find the web application context for

  返回:

  the root WebApplicationContext for this web app

  抛出:

  IllegalStateException - if the root WebApplicationContext could not be found

  另请参阅:

  WebApplicationContext.ROOT_WEB_APPLICATION_CONTEXT_ATTRIBUTE

• getWebApplicationContext

  public static WebApplicationContext getWebApplicationContext​(ServletContext sc)

  Find the root WebApplicationContext for this web app, typically loaded via ContextLoaderListener.

  Will rethrow an exception that happened on root context startup, to differentiate between a failed context startup and no context at all.

  参数:

  sc - ServletContext to find the web application context for

  返回:

  the root WebApplicationContext for this web app, or null if none

  另请参阅:

  WebApplicationContext.ROOT_WEB_APPLICATION_CONTEXT_ATTRIBUTE

• getWebApplicationContext

  public static WebApplicationContext getWebApplicationContext​(ServletContext sc,
                                                               String attrName)

  Find a custom WebApplicationContext for this web app.

  参数:

  sc - ServletContext to find the web application context for

  attrName - the name of the ServletContext attribute to look for

  返回:

  the desired WebApplicationContext for this web app, or null if none

• findWebApplicationContext

  public static WebApplicationContext findWebApplicationContext​(ServletContext sc)

  Find a unique WebApplicationContext for this web app: either the root web app context (preferred) or a unique WebApplicationContext among the registered ServletContext attributes (typically coming from a single DispatcherServlet in the current web application).

  Note that DispatcherServlet's exposure of its context can be controlled through its publishContext property, which is true by default but can be selectively switched to only publish a single context despite multiple DispatcherServlet registrations in the web app.

  参数:

  sc - ServletContext to find the web application context for

  返回:

  the desired WebApplicationContext for this web app, or null if none

  从以下版本开始:

  4.2

  另请参阅:

  getWebApplicationContext(ServletContext), ServletContext.getAttributeNames()

• registerWebApplicationScopes

  public static void registerWebApplicationScopes​(ConfigurableListableBeanFactory beanFactory)

  Register web-specific scopes ("request", "session", "globalSession") with the given BeanFactory, as used by the WebApplicationContext.

  参数:

  beanFactory - the BeanFactory to configure

• registerWebApplicationScopes

  public static void registerWebApplicationScopes​(ConfigurableListableBeanFactory beanFactory,
                                                  ServletContext sc)

  Register web-specific scopes ("request", "session", "globalSession", "application") with the given BeanFactory, as used by the WebApplicationContext.

  参数:

  beanFactory - the BeanFactory to configure

  sc - the ServletContext that we're running within

• registerEnvironmentBeans

  public static void registerEnvironmentBeans​(ConfigurableListableBeanFactory bf,
                                              ServletContext sc)

  Register web-specific environment beans ("contextParameters", "contextAttributes") with the given BeanFactory, as used by the WebApplicationContext.

  参数:

  bf - the BeanFactory to configure

  sc - the ServletContext that we're running within

• registerEnvironmentBeans

  public static void registerEnvironmentBeans​(ConfigurableListableBeanFactory bf,
                                              ServletContext servletContext,
                                              ServletConfig servletConfig)

  Register web-specific environment beans ("contextParameters", "contextAttributes") with the given BeanFactory, as used by the WebApplicationContext.

  参数:

  bf - the BeanFactory to configure

  servletContext - the ServletContext that we're running within

  servletConfig - the ServletConfig of the containing Portlet

• initServletPropertySources

  public static void initServletPropertySources​(MutablePropertySources propertySources,
                                                ServletContext servletContext)

  Convenient variant of initServletPropertySources(MutablePropertySources, ServletContext, ServletConfig) that always provides null for the ServletConfig parameter.

  另请参阅:

  initServletPropertySources(MutablePropertySources, ServletContext, ServletConfig)

• initServletPropertySources

  public static void initServletPropertySources​(MutablePropertySources propertySources,
                                                ServletContext servletContext,
                                                ServletConfig servletConfig)

  Replace Servlet-based stub property sources with actual instances populated with the given servletContext and servletConfig objects.

  This method is idempotent with respect to the fact it may be called any number of times but will perform replacement of stub property sources with their corresponding actual property sources once and only once.

  参数:

  propertySources - the MutablePropertySources to initialize (must not be null)

  servletContext - the current ServletContext (ignored if null or if the servlet context property source has already been initialized)

  servletConfig - the current ServletConfig (ignored if null or if the servlet config property source has already been initialized)

  另请参阅:

  PropertySource.StubPropertySource, ConfigurableEnvironment.getPropertySources()