com.sun.faces.spi

Class InjectionProviderFactory

java.lang.Object

com.sun.faces.spi.InjectionProviderFactory

public class InjectionProviderFactory
extends java.lang.Object

A factory for creating InjectionProvider instances.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	InjectionProviderFactory.NoopInjectionProvider A no-op implementation of InjectionProvider which will be used when the #INJECTION_PROVIDER_PROPERTY is not specified or is invalid.

Field Summary

Fields

Modifier and Type	Field and Description
private static java.lang.String[]	EMPTY_ARRAY
private static InjectionProvider	GENERIC_WEB_PROVIDER
private static java.lang.String	INJECTION_PROVIDER_PROPERTY The system property that will be checked for alternate InjectionProvider implementations.
private static java.lang.String	INJECTION_SERVICE
private static java.util.logging.Logger	LOGGER
private static InjectionProvider	NOOP_PROVIDER Our no-op InjectionProvider.

Constructor Summary

Constructors

Constructor and Description
InjectionProviderFactory()

Method Summary

Modifier and Type	Method and Description
static InjectionProvider	createInstance(javax.faces.context.ExternalContext extContext) Creates a new instance of the class specified by the com.sun.faces.InjectionProvider system property.
private static boolean	extendsDiscoverableInjectionProvider(java.lang.Class<?> clazz) Determine if the specified class extends the DiscoverableInjectionProvider interfaces.
private static java.lang.String	findProviderClass(javax.faces.context.ExternalContext extContext) Attempt to find an InjectionProvider based on the following algorithm:
private static java.lang.String	getProviderFromEntry(java.util.Map<java.lang.String,java.lang.Object> appMap, java.lang.String entry)
private static InjectionProvider	getProviderInstance(java.lang.String className, javax.faces.context.ExternalContext extContext)
private static java.lang.String[]	getServiceEntries()
private static boolean	implementsInjectionProvider(java.lang.Class<?> clazz) Determine if the specified class implements the InjectionProvider interfaces.

Methods inherited from class java.lang.Object

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

Field Detail

NOOP_PROVIDER

private static final InjectionProvider NOOP_PROVIDER

Our no-op InjectionProvider.

GENERIC_WEB_PROVIDER

private static final InjectionProvider GENERIC_WEB_PROVIDER

INJECTION_SERVICE

private static final java.lang.String INJECTION_SERVICE

See Also:

Constant Field Values

INJECTION_PROVIDER_PROPERTY

private static final java.lang.String INJECTION_PROVIDER_PROPERTY

The system property that will be checked for alternate InjectionProvider implementations.

LOGGER

private static final java.util.logging.Logger LOGGER

EMPTY_ARRAY

private static final java.lang.String[] EMPTY_ARRAY

Constructor Detail

InjectionProviderFactory

public InjectionProviderFactory()

Method Detail

createInstance

public static InjectionProvider createInstance(javax.faces.context.ExternalContext extContext)

Creates a new instance of the class specified by the com.sun.faces.InjectionProvider system property. If this propery is not defined, then a default, no-op, InjectionProvider will be returned.

Parameters:

extContext - ExteranlContext for the current request

Returns:

an implementation of the InjectionProvider interfaces

getProviderInstance

private static InjectionProvider getProviderInstance(java.lang.String className,
                                                     javax.faces.context.ExternalContext extContext)

implementsInjectionProvider

private static boolean implementsInjectionProvider(java.lang.Class<?> clazz)

Determine if the specified class implements the InjectionProvider interfaces.

Parameters:

clazz - the class in question

Returns:

true if clazz implements the InjectionProvider interface

extendsDiscoverableInjectionProvider

private static boolean extendsDiscoverableInjectionProvider(java.lang.Class<?> clazz)

Determine if the specified class extends the DiscoverableInjectionProvider interfaces.

Parameters:

clazz - the class in question

Returns:

true if clazz implements the InjectionProvider interface

findProviderClass

private static java.lang.String findProviderClass(javax.faces.context.ExternalContext extContext)

Attempt to find an InjectionProvider based on the following algorithm:

• Check for an explicit configuration within the web.xml using the key com.sun.faces.injectionProvider. If found, return the value.
• Check for a system property keyed by com.sun.faces.InjectionProvider. If found, return the value.
• Check for entries within META-INF/services/com.sun.faces.injectionprovider. If entries are found and the entries extend DiscoverableInjectionProvider, invoke isInjectionFeatureAvailable(String) passing in the configured delegate. If isInjectionFeatureAvailable(String) returns true return the service entry.
• If no InjectionProviders are found, return null
Tries to find a provider class in a web context parameter. If not present it tries to find it as a System property. If still not found returns null.

Parameters:

extContext - The ExternalContext for this request

Returns:

The provider class name specified in the container configuration, or null if not found.

getProviderFromEntry

private static java.lang.String getProviderFromEntry(java.util.Map<java.lang.String,java.lang.Object> appMap,
                                                     java.lang.String entry)

getServiceEntries

private static java.lang.String[] getServiceEntries()