javax.faces
Class FactoryFinder

java.lang.Object
  javax.faces.FactoryFinder

public final class FactoryFinder
extends Object

see Javadoc of JSF Specification

Version:

$Revision: 1088858 $ $Date: 2011-04-04 21:36:35 -0500 (Mon, 04 Apr 2011) $

Author:

Manfred Geiler (latest modification by $Author: lu4242 $)

Field Summary

static String	APPLICATION_FACTORY
static String	EXCEPTION_HANDLER_FACTORY
static String	EXTERNAL_CONTEXT_FACTORY
static String	FACES_CONTEXT_FACTORY
static String	LIFECYCLE_FACTORY
static String	PARTIAL_VIEW_CONTEXT_FACTORY
static String	RENDER_KIT_FACTORY
static String	TAG_HANDLER_DELEGATE_FACTORY
static String	VIEW_DECLARATION_LANGUAGE_FACTORY
static String	VISIT_CONTEXT_FACTORY

Method Summary

static Object	getFactory(String factoryName) Create (if necessary) and return a per-web-application instance of the appropriate implementation class for the specified JavaServer Faces factory class, based on the discovery algorithm described in the class description.
static void	releaseFactories()
static void	setFactory(String factoryName, String implName)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

APPLICATION_FACTORY

public static final String APPLICATION_FACTORY

See Also:

Constant Field Values

EXCEPTION_HANDLER_FACTORY

public static final String EXCEPTION_HANDLER_FACTORY

See Also:

Constant Field Values

EXTERNAL_CONTEXT_FACTORY

public static final String EXTERNAL_CONTEXT_FACTORY

See Also:

Constant Field Values

FACES_CONTEXT_FACTORY

public static final String FACES_CONTEXT_FACTORY

See Also:

Constant Field Values

LIFECYCLE_FACTORY

public static final String LIFECYCLE_FACTORY

See Also:

Constant Field Values

PARTIAL_VIEW_CONTEXT_FACTORY

public static final String PARTIAL_VIEW_CONTEXT_FACTORY

See Also:

Constant Field Values

RENDER_KIT_FACTORY

public static final String RENDER_KIT_FACTORY

See Also:

Constant Field Values

TAG_HANDLER_DELEGATE_FACTORY

public static final String TAG_HANDLER_DELEGATE_FACTORY

See Also:

Constant Field Values

VIEW_DECLARATION_LANGUAGE_FACTORY

public static final String VIEW_DECLARATION_LANGUAGE_FACTORY

See Also:

Constant Field Values

VISIT_CONTEXT_FACTORY

public static final String VISIT_CONTEXT_FACTORY

See Also:

Constant Field Values

Method Detail

getFactory

public static Object getFactory(String factoryName)
                         throws FacesException

Create (if necessary) and return a per-web-application instance of the appropriate implementation class for the specified JavaServer Faces factory class, based on the discovery algorithm described in the class description.

The standard factories and wrappers in JSF all implement the interface FacesWrapper. If the returned Object is an implementation of one of the standard factories, it must be legal to cast it to an instance of FacesWrapper and call FacesWrapper.getWrapped() on the instance.

Parameters:

factoryName - Fully qualified name of the JavaServer Faces factory for which an implementation instance is requested

Returns:

A per-web-application instance of the appropriate implementation class for the specified JavaServer Faces factory class

Throws:

FacesException - if the web application class loader cannot be identified

FacesException - if an instance of the configured factory implementation class cannot be loaded

FacesException - if an instance of the configured factory implementation class cannot be instantiated

IllegalArgumentException - if factoryname does not identify a standard JavaServer Faces factory name

IllegalStateException - if there is no configured factory implementation class for the specified factory name

NullPointerException - if factoryname is null

setFactory

public static void setFactory(String factoryName,
                              String implName)

releaseFactories

public static void releaseFactories()
                             throws FacesException

Throws:

FacesException