- java.lang.Object
-
- javax.faces.context.FacesContextFactory
-
- All Implemented Interfaces:
- FacesWrapper<FacesContextFactory>
public abstract class FacesContextFactory extends Object implements FacesWrapper<FacesContextFactory>
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 therelease()
method of the allocatedFacesContext
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);
-
-
Constructor Summary
Constructors Constructor and Description FacesContextFactory()
-
Method Summary
All Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method and Description abstract FacesContext
getFacesContext(Object context, Object request, Object response, Lifecycle lifecycle)
Create (if needed) and return aFacesContext
instance that is initialized for the processing of the specified request and response objects, utilizing the specifiedLifecycle
instance, for this web application.FacesContextFactory
getWrapped()
If this factory has been decorated, the implementation doing the decorating may override this method to provide access to the implementation being wrapped.
-
-
-
Method Detail
-
getWrapped
public FacesContextFactory getWrapped()
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
.- Specified by:
getWrapped
in interfaceFacesWrapper<FacesContextFactory>
- Since:
- 2.0
-
getFacesContext
public abstract 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 specifiedLifecycle
instance, for this web application.The implementation of this method must ensure that calls to the
getCurrentInstance()
method ofFacesContext
, from the same thread that called this method, will return the sameFacesContext
instance until therelease()
method is called on that instance.The implementation must call
ExternalContextFactory.getExternalContext(java.lang.Object, java.lang.Object, java.lang.Object)
to produce theExternalContext
for theFacesContext
instance.The default implementation must call
ExceptionHandlerFactory.getExceptionHandler()
and make it so the return from that method is what gets returned from a call toFacesContext.getExceptionHandler()
on the returnedFacesContext
instance.The default implementation must call
ClientWindowFactory.getClientWindow(javax.faces.context.FacesContext)
and make it so the return from that method is what gets returned from a call toExternalContext.getClientWindow()
on the returnedExternalContext
instance.- Parameters:
context
- In servlet environments, theServletContext
that is associated with this web applicationrequest
- In servlet environments, theServletRequest
that is to be processedresponse
- In servlet environments, theServletResponse
that is to be processedlifecycle
- TheLifecycle
instance being used to process this request- Throws:
FacesException
- if aFacesContext
cannot be constructed for the specified parametersNullPointerException
- if any of the parameters arenull
-
-
Nederlandse vertaling
U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.
Bij voorbaat dank.
Document heeft de 11/06/2005 gemaakt, de laatste keer de 18/08/2025 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-javaee-rf-javax/faces/context/FacesContextFactory.html
De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.
Referenties
Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur van deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.