当前页面: 在线文档首页 > Spring Framework 2.1.0 API 文档英文版

FacesContextUtils (Spring Framework API 2.1) - Spring Framework 2.1.0 API 文档英文版

---

Overview  Package   Class  Use  Tree  Deprecated  Index  Help		The Spring Framework
PREV CLASS   NEXT CLASS	FRAMES    NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---

org.springframework.web.jsf
Class FacesContextUtils

java.lang.Object
  org.springframework.web.jsf.FacesContextUtils

---

public abstract class FacesContextUtils
extends Object

Convenience methods to retrieve the root WebApplicationContext for a given FacesContext. This is e.g. useful for accessing a Spring context from custom JSF code.

Analogous to Spring's WebApplicationContextUtils for the ServletContext.

Since:

1.1

Author:

Juergen Hoeller

See Also:

ContextLoader, WebApplicationContextUtils

---

Constructor Summary
FacesContextUtils()

 

Method Summary
static WebApplicationContext	getRequiredWebApplicationContext(javax.faces.context.FacesContext fc)           Find the root WebApplicationContext for this web app, which is typically loaded via ContextLoaderListener or ContextLoaderServlet.
static Object	getSessionMutex(javax.faces.context.FacesContext fc)           Return the best available mutex for the given session: that is, an object to synchronize on for the given session.
static WebApplicationContext	getWebApplicationContext(javax.faces.context.FacesContext fc)           Find the root WebApplicationContext for this web app, which is typically loaded via ContextLoaderListener or ContextLoaderServlet.

 

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

 

Constructor Detail

FacesContextUtils

public FacesContextUtils()

Method Detail

getWebApplicationContext

public static WebApplicationContext getWebApplicationContext(javax.faces.context.FacesContext fc)

Find the root WebApplicationContext for this web app, 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:

fc - the FacesContext 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

---

getRequiredWebApplicationContext

public static WebApplicationContext getRequiredWebApplicationContext(javax.faces.context.FacesContext fc)
                                                              throws IllegalStateException

Find the root WebApplicationContext for this web app, 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:

fc - the FacesContext 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

---

getSessionMutex

public static Object getSessionMutex(javax.faces.context.FacesContext fc)

Return the best available mutex for the given session: that is, an object to synchronize on for the given session.

Returns the session mutex attribute if available; usually, this means that the HttpSessionMutexListener needs to be defined in web.xml. Falls back to the Session reference itself if no mutex attribute found.

The session mutex is guaranteed to be the same object during the entire lifetime of the session, available under the key defined by the SESSION_MUTEX_ATTRIBUTE constant. It serves as a safe reference to synchronize on for locking on the current session.

In many cases, the Session reference itself is a safe mutex as well, since it will always be the same object reference for the same active logical session. However, this is not guaranteed across different servlet containers; the only 100% safe way is a session mutex.

Parameters:

fc - the FacesContext to find the session mutex for

Returns:

the mutex object (never null)

See Also:

WebUtils.SESSION_MUTEX_ATTRIBUTE, HttpSessionMutexListener

---

Overview  Package   Class  Use  Tree  Deprecated  Index  Help		The Spring Framework
PREV CLASS   NEXT CLASS	FRAMES    NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---

Copyright © 2002-2007 The Spring Framework.