javax.faces.context: abstract public class: FacesContextFactory

javax.faces.context
abstract public class: FacesContextFactory [javadoc | source]

java.lang.Object
   javax.faces.context.FacesContextFactory

All Implemented Interfaces:
FacesWrapper

FacesContextFactory is a factory object that creates (if needed) and returns new FacesContext instances, initialized for the processing of the specified request and response objects. Implementations may take advantage of the calls to the release() method of the allocated FacesContext instances to pool and recycle them, rather than creating a new instance every time.

There must be one FacesContextFactory instance per web application that is utilizing JavaServer Faces. This instance can be acquired, in a portable manner, by calling:

  FacesContextFactory factory = (FacesContextFactory)
   FactoryFinder.getFactory(FactoryFinder.FACES_CONTEXT_FACTORY);

Method from javax.faces.context.FacesContextFactory Summary:
getFacesContext, getWrapped

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

Method from javax.faces.context.FacesContextFactory Detail:
abstract public FacesContext getFacesContext(Object context, Object request, Object response, Lifecycle lifecycle) throws FacesException Create (if needed) and return a FacesContext instance that is initialized for the processing of the specified request and response objects, utilizing the specified Lifecycle instance, for this web application. The implementation of this method must ensure that calls to the `getCurrentInstance()` method of FacesContext , from the same thread that called this method, will return the same FacesContext instance until the `release()` method is called on that instance. The implementation must call ExternalContextFactory#getExternalContext to produce the ExternalContext for the FacesContext instance. The default implementation must call ExceptionHandlerFactory#getExceptionHandler and make it so the return from that method is what gets returned from a call to FacesContext#getExceptionHandler on the returned `FacesContext` instance.
public FacesContextFactory getWrapped() { return null; } If this factory has been decorated, the implementation doing the decorating may override this method to provide access to the implementation being wrapped. A default implementation is provided that returns `null`.

Method from javax.faces.context.FacesContextFactory Detail:

 abstract public FacesContext getFacesContext(Object context,
    Object request,
    Object response,
    Lifecycle lifecycle) throws FacesExceptionCreate (if needed)
and return a FacesContext  instance that is initialized
for the processing of the specified request and response objects,
utilizing the specified Lifecycle  instance, for this web
application.

The implementation of this method must ensure that calls to the
getCurrentInstance() method of FacesContext ,
from the same thread that called this method, will return the same
FacesContext  instance until the release()
method is called on that instance.

The implementation must call
ExternalContextFactory#getExternalContext  to produce the
ExternalContext  for the FacesContext  instance.

The default implementation must call
ExceptionHandlerFactory#getExceptionHandler  and make it
so the return from that method is what gets returned from a call
to FacesContext#getExceptionHandler  on the returned
FacesContext instance.

 public FacesContextFactory getWrapped() {
        return null;
}

If this factory has been decorated, the implementation doing the decorating may override this method to provide access to the implementation being wrapped. A default implementation is provided that returns null.