The Spring Framework

## org.springframework.web.context.support
Class WebApplicationContextUtils

    java.lang.Object
      org.springframework.web.context.support.WebApplicationContextUtils

    public abstract class WebApplicationContextUtils

extends Object

Convenience methods for retrieving the root `WebApplicationContext` for a given `ServletContext`. This is e.g. useful for accessing a Spring context from within custom web views or Struts actions.

Note that there are more convenient ways of accessing the root context for many web frameworks, either part of Spring or available as external library. This helper class is just the most generic way to access the root context.

Author:
  Juergen Hoeller
See Also:
  `ContextLoader`, `FrameworkServlet`, `DispatcherServlet`, `ActionSupport`, `DelegatingActionProxy`, `FacesContextUtils`, `DelegatingVariableResolver`

Constructor Summary
`WebApplicationContextUtils()`

Method Summary
`static WebApplicationContext` `getRequiredWebApplicationContext(ServletContext sc)` Find the root WebApplicationContext for this web application, which is typically loaded via `ContextLoaderListener` or `ContextLoaderServlet`.
`static WebApplicationContext` `getWebApplicationContext(ServletContext sc)` Find the root WebApplicationContext for this web application, which is typically loaded via `ContextLoaderListener` or `ContextLoaderServlet`.
`static WebApplicationContext` `getWebApplicationContext(ServletContext sc, String attrName)` Find a custom WebApplicationContext for this web application.
`static void` `registerWebApplicationScopes(ConfigurableListableBeanFactory beanFactory)` Register web-specific scopes with the given BeanFactory, as used by the WebApplicationContext.

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Constructor Detail

### WebApplicationContextUtils

    public WebApplicationContextUtils()

Method Detail

### getRequiredWebApplicationContext

    public static WebApplicationContext getRequiredWebApplicationContext(ServletContext sc)
                                                                  throws IllegalStateException

  Find the root WebApplicationContext for this web application, which is typically loaded via `ContextLoaderListener` or `ContextLoaderServlet`.

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

  Parameters:
    `sc` - ServletContext to find the web application context for
  Returns:
    the root WebApplicationContext for this web app
  Throws:
    `IllegalStateException` - if the root WebApplicationContext could not be found
  See Also:
    `WebApplicationContext.ROOT_WEB_APPLICATION_CONTEXT_ATTRIBUTE`

### getWebApplicationContext

    public static WebApplicationContext getWebApplicationContext(ServletContext sc)

  Find the root WebApplicationContext for this web application, which is typically loaded via `ContextLoaderListener` or `ContextLoaderServlet`.

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

  Parameters:
    `sc` - ServletContext to find the web application context for
  Returns:
    the root WebApplicationContext for this web app, or `null` if none
  See Also:
    `WebApplicationContext.ROOT_WEB_APPLICATION_CONTEXT_ATTRIBUTE`

### getWebApplicationContext

    public static WebApplicationContext getWebApplicationContext(ServletContext sc,
                                                                 String attrName)

  Find a custom WebApplicationContext for this web application.

  Parameters:
    `sc` - ServletContext to find the web application context for
    `attrName` - the name of the ServletContext attribute to look for
  Returns:
    the desired WebApplicationContext for this web app, or `null` if none

### registerWebApplicationScopes

    public static void registerWebApplicationScopes(ConfigurableListableBeanFactory beanFactory)

  Register web-specific scopes with the given BeanFactory, as used by the WebApplicationContext.

  Parameters:
    `beanFactory` - the BeanFactory to configure

The Spring Framework

Copyright © 2002-2008 The Spring Framework.