com.sun.faces.spi

Class AnnotationProvider

java.lang.Object

com.sun.faces.spi.AnnotationProvider

Direct Known Subclasses:

AnnotationScanner, FilterClassesFromFacesInitializerAnnotationProvider

public abstract class AnnotationProvider
extends Object

An integration point for integrators to provide custom annotation scanning.

All AnnotationProvider implementations must scan for the following annotations:

• FacesComponent
• FacesConverter
• FacesRenderer
• FacesValidator
• ManagedBean
• NamedEvent
• FacesBehavior
• FacesBehaviorRenderer

The AnnotationProvider instance will be wrapped as a Future and executed during the environment initialization. The result of the future can be obtained by calling ConfigManager.getAnnotatedClasses(javax.faces.context.FacesContext).

The Future itself can be obtained from the application map using the key com.sun.faces.config.ConfigManager__ANNOTATION_SCAN_TASK.

It's important to note that the value returned by either method described above is only available while the application is being initialized and will be removed before the application is put into service.

To register a custom AnnotationProvider with the runtime, place a file named com.sun.faces.spi.annotationprovider within META-INF/services of a JAR file, with a single line referencing the fully qualified class name of the AnnotationProvider implementation. Custom AnnotationProviders can be used to decorate the default AnnotationProvider by providing a constructor that takes an AnnotationProvider as the second parameter:

public AnnotationProvider(ServletContext sc, AnnotationProvider parent)

If decoration is not desired, then the custom provider must have a constructor that takes one paramer, a ServletContext:

public AnnotationProvider(ServletContext sc)

All customer providers must extend this class.

Field Summary

Fields

Modifier and Type	Field and Description
protected javax.servlet.ServletContext	servletContext
protected AnnotationProvider	wrappedAnnotationProvider The wrapped annotation provider.

Constructor Summary

Constructors

Constructor and Description
AnnotationProvider()
AnnotationProvider(javax.servlet.ServletContext servletContext)

Method Summary

Modifier and Type	Method and Description
abstract Map<Class<? extends Annotation>,Set<Class<?>>>	getAnnotatedClasses(Set<URI> urls)

Methods inherited from class java.lang.Object

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

Field Detail

servletContext

protected javax.servlet.ServletContext servletContext

wrappedAnnotationProvider

protected AnnotationProvider wrappedAnnotationProvider

The wrapped annotation provider. May be null if this class is not loaded via ServiceLoader (from a file named com.sun.faces.spi.AnnotationProvider) and is instead loaded via Mojarra's ServiceFactory (from a file named com.sun.faces.spi.annotationprovider).

Constructor Detail

AnnotationProvider

public AnnotationProvider(javax.servlet.ServletContext servletContext)

AnnotationProvider

public AnnotationProvider()

Method Detail

getAnnotatedClasses

public abstract Map<Class<? extends Annotation>,Set<Class<?>>> getAnnotatedClasses(Set<URI> urls)

Parameters:

urls - a Set of URLs that refer to specific faces-config.xml documents on the classpath. The information returned by the map may return annotation information from sources outside of those defined by the urls.

Returns:

a Map of classes mapped to a specific annotation type. If no annotations are present, this method returns an empty Map.