org.eclipse.jetty.annotations

Class AnnotationConfiguration

java.lang.Object

org.eclipse.jetty.webapp.AbstractConfiguration

org.eclipse.jetty.annotations.AnnotationConfiguration

All Implemented Interfaces:

Configuration

Direct Known Subclasses:

AnnotationConfiguration

public class AnnotationConfiguration
extends AbstractConfiguration

Configuration for Annotations

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AnnotationConfiguration.ClassInheritanceMap
class	AnnotationConfiguration.ContainerClassNameResolver ContainerClassNameResolver Checks to see if a classname belongs to a hidden or visible package when scanning for annotations and thus whether it should be excluded from consideration or not.
class	AnnotationConfiguration.ParserTask ParserTask Task to executing scanning of a resource for annotations.
class	AnnotationConfiguration.ServletContainerInitializerComparator ServletContainerInitializerComparator Comparator impl that orders a set of ServletContainerInitializers according to the list of classnames (optionally containing a "*" wildcard character) established in a ServletContainerInitializerOrdering.
class	AnnotationConfiguration.ServletContainerInitializerOrdering ServletContainerInitializerOrdering A list of classnames of ServletContainerInitializers in the order in which they are to be called back.
class	AnnotationConfiguration.TimeStatistic TimeStatistic Simple class to capture elapsed time of an operation.
class	AnnotationConfiguration.WebAppClassNameResolver WebAppClassNameResolver Checks to see if a classname belongs to hidden or visible packages when scanning, and whether a classname that is a duplicate should override a previously scanned classname.

Nested classes/interfaces inherited from interface org.eclipse.jetty.webapp.Configuration

Configuration.ClassList

Field Summary

Fields

Modifier and Type	Field and Description
protected ClassInheritanceHandler	_classInheritanceHandler
protected AnnotationConfiguration.ContainerClassNameResolver	_containerClassNameResolver
protected List<ContainerInitializerAnnotationHandler>	_containerInitializerAnnotationHandlers
protected CounterStatistic	_containerPathStats
protected List<AbstractDiscoverableAnnotationHandler>	_discoverableAnnotationHandlers
protected List<AnnotationConfiguration.ParserTask>	_parserTasks
protected Pattern	_sciExcludePattern
protected AnnotationConfiguration.WebAppClassNameResolver	_webAppClassNameResolver
protected CounterStatistic	_webInfClassesStats
protected CounterStatistic	_webInfLibStats
static String	CLASS_INHERITANCE_MAP
static String	CONTAINER_INITIALIZER_STARTER
static String	CONTAINER_INITIALIZERS
static int	DEFAULT_MAX_SCAN_WAIT
static boolean	DEFAULT_MULTI_THREADED
static String	MAX_SCAN_WAIT
static String	MULTI_THREADED
static String	SERVLET_CONTAINER_INITIALIZER_EXCLUSION_PATTERN
static String	SERVLET_CONTAINER_INITIALIZER_ORDER

Fields inherited from interface org.eclipse.jetty.webapp.Configuration

ATTR

Constructor Summary

Constructors

Constructor and Description
AnnotationConfiguration()

Method Summary

Methods

Modifier and Type	Method and Description
void	addDiscoverableAnnotationHandler(AbstractDiscoverableAnnotationHandler handler)
void	cloneConfigure(WebAppContext template, WebAppContext context) Clone configuration instance.
void	configure(WebAppContext context) Configure WebApp.
protected AnnotationParser	createAnnotationParser()
void	createServletContainerInitializerAnnotationHandlers(WebAppContext context, List<ServletContainerInitializer> scis)
void	deconfigure(WebAppContext context) DeConfigure WebApp.
FragmentDescriptor	getFragmentFromJar(Resource jar, List<FragmentDescriptor> frags) Get the web-fragment.xml from a jar
AnnotationConfiguration.ServletContainerInitializerOrdering	getInitializerOrdering(WebAppContext context) Jetty-specific extension that allows an ordering to be applied across ALL ServletContainerInitializers.
Resource	getJarFor(ServletContainerInitializer service)
protected int	getMaxScanWait(WebAppContext context) Work out how long we should wait for the async scanning to occur.
List<ServletContainerInitializer>	getNonExcludedInitializers(WebAppContext context)
boolean	isFromContainerClassPath(WebAppContext context, ServletContainerInitializer sci) Test if the ServletContainerInitializer is from the container classpath
boolean	isFromExcludedJar(WebAppContext context, ServletContainerInitializer sci, Resource sciResource) Check to see if the ServletContainerIntializer loaded via the ServiceLoader came from a jar that is excluded by the fragment ordering.
boolean	isMetaDataComplete(WebDescriptor d)
protected boolean	isUseMultiThreading(WebAppContext context) Check if we should use multiple threads to scan for annotations or not
boolean	matchesExclusionPattern(ServletContainerInitializer sci) Test if the ServletContainerIntializer is excluded by the o.e.j.containerInitializerExclusionPattern
void	parseContainerPath(WebAppContext context, AnnotationParser parser) Scan jars on container path.
void	parseWebInfClasses(WebAppContext context, AnnotationParser parser) Scan classes in WEB-INF/classes
void	parseWebInfLib(WebAppContext context, AnnotationParser parser) Scan jars in WEB-INF/lib
void	postConfigure(WebAppContext context) Clear down after configuration.
void	preConfigure(WebAppContext context) Set up for configuration.
protected void	scanForAnnotations(WebAppContext context) Perform scanning of classes for annotations

Methods inherited from class org.eclipse.jetty.webapp.AbstractConfiguration

destroy

Methods inherited from class java.lang.Object

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

Field Detail

SERVLET_CONTAINER_INITIALIZER_EXCLUSION_PATTERN

public static final String SERVLET_CONTAINER_INITIALIZER_EXCLUSION_PATTERN

See Also:

Constant Field Values

SERVLET_CONTAINER_INITIALIZER_ORDER

public static final String SERVLET_CONTAINER_INITIALIZER_ORDER

See Also:

Constant Field Values

CLASS_INHERITANCE_MAP

public static final String CLASS_INHERITANCE_MAP

See Also:

Constant Field Values

CONTAINER_INITIALIZERS

public static final String CONTAINER_INITIALIZERS

See Also:

Constant Field Values

CONTAINER_INITIALIZER_STARTER

public static final String CONTAINER_INITIALIZER_STARTER

See Also:

Constant Field Values

MULTI_THREADED

public static final String MULTI_THREADED

See Also:

Constant Field Values

MAX_SCAN_WAIT

public static final String MAX_SCAN_WAIT

See Also:

Constant Field Values

DEFAULT_MAX_SCAN_WAIT

public static final int DEFAULT_MAX_SCAN_WAIT

See Also:

Constant Field Values

DEFAULT_MULTI_THREADED

public static final boolean DEFAULT_MULTI_THREADED

See Also:

Constant Field Values

_discoverableAnnotationHandlers

protected List<AbstractDiscoverableAnnotationHandler> _discoverableAnnotationHandlers

_classInheritanceHandler

protected ClassInheritanceHandler _classInheritanceHandler

_containerInitializerAnnotationHandlers

protected List<ContainerInitializerAnnotationHandler> _containerInitializerAnnotationHandlers

_parserTasks

protected List<AnnotationConfiguration.ParserTask> _parserTasks

_webAppClassNameResolver

protected AnnotationConfiguration.WebAppClassNameResolver _webAppClassNameResolver

_containerClassNameResolver

protected AnnotationConfiguration.ContainerClassNameResolver _containerClassNameResolver

_containerPathStats

protected CounterStatistic _containerPathStats

_webInfLibStats

protected CounterStatistic _webInfLibStats

_webInfClassesStats

protected CounterStatistic _webInfClassesStats

_sciExcludePattern

protected Pattern _sciExcludePattern

Constructor Detail

AnnotationConfiguration

public AnnotationConfiguration()

Method Detail

preConfigure

public void preConfigure(WebAppContext context)
                  throws Exception

Description copied from interface: Configuration

Set up for configuration.

Typically this step discovers configuration resources

Specified by:

preConfigure in interface Configuration

Overrides:

preConfigure in class AbstractConfiguration

Parameters:

context - The context to configure

Throws:

Exception

addDiscoverableAnnotationHandler

public void addDiscoverableAnnotationHandler(AbstractDiscoverableAnnotationHandler handler)

deconfigure

public void deconfigure(WebAppContext context)
                 throws Exception

Description copied from interface: Configuration

DeConfigure WebApp. This method is called to undo all configuration done. This is called to allow the context to work correctly over a stop/start cycle

Specified by:

deconfigure in interface Configuration

Overrides:

deconfigure in class AbstractConfiguration

Parameters:

context - The context to configure

Throws:

Exception

configure

public void configure(WebAppContext context)
               throws Exception

Description copied from interface: Configuration

Configure WebApp.

Typically this step applies the discovered configuration resources to either the WebAppContext or the associated MetaData.

Specified by:

configure in interface Configuration

Overrides:

configure in class AbstractConfiguration

Parameters:

context - The context to configure

Throws:

Exception

See Also:

AbstractConfiguration.configure(org.eclipse.jetty.webapp.WebAppContext)

postConfigure

public void postConfigure(WebAppContext context)
                   throws Exception

Description copied from interface: Configuration

Clear down after configuration.

Specified by:

postConfigure in interface Configuration

Overrides:

postConfigure in class AbstractConfiguration

Parameters:

context - The context to configure

Throws:

Exception

See Also:

AbstractConfiguration.postConfigure(org.eclipse.jetty.webapp.WebAppContext)

scanForAnnotations

protected void scanForAnnotations(WebAppContext context)
                           throws Exception

Perform scanning of classes for annotations

Parameters:

context -

Throws:

Exception

createAnnotationParser

protected AnnotationParser createAnnotationParser()

Returns:

a new AnnotationParser. This method can be overridden to use a different implementation of the AnnotationParser. Note that this is considered internal API.

isUseMultiThreading

protected boolean isUseMultiThreading(WebAppContext context)

Check if we should use multiple threads to scan for annotations or not

Parameters:

context -

Returns:

getMaxScanWait

protected int getMaxScanWait(WebAppContext context)

Work out how long we should wait for the async scanning to occur.

Parameters:

context -

Returns:

cloneConfigure

public void cloneConfigure(WebAppContext template,
                  WebAppContext context)
                    throws Exception

Description copied from interface: Configuration

Clone configuration instance.

Configure an instance of a WebAppContext, based on a template WebAppContext that has previously been configured by this Configuration.

Specified by:

cloneConfigure in interface Configuration

Overrides:

cloneConfigure in class AbstractConfiguration

Parameters:

template - The template context

context - The context to configure

Throws:

Exception

See Also:

AbstractConfiguration.cloneConfigure(org.eclipse.jetty.webapp.WebAppContext, org.eclipse.jetty.webapp.WebAppContext)

createServletContainerInitializerAnnotationHandlers

public void createServletContainerInitializerAnnotationHandlers(WebAppContext context,
                                                       List<ServletContainerInitializer> scis)
                                                         throws Exception

Parameters:

context -

scis -

Throws:

Exception

getJarFor

public Resource getJarFor(ServletContainerInitializer service)
                   throws MalformedURLException,
                          IOException

Throws:

MalformedURLException

IOException

isFromExcludedJar

public boolean isFromExcludedJar(WebAppContext context,
                        ServletContainerInitializer sci,
                        Resource sciResource)
                          throws Exception

Check to see if the ServletContainerIntializer loaded via the ServiceLoader came from a jar that is excluded by the fragment ordering. See ServletSpec 3.0 p.85.

Parameters:

context -

sci -

Returns:

true if excluded

Throws:

Exception

matchesExclusionPattern

public boolean matchesExclusionPattern(ServletContainerInitializer sci)

Test if the ServletContainerIntializer is excluded by the o.e.j.containerInitializerExclusionPattern

Parameters:

context -

sci -

Returns:

isFromContainerClassPath

public boolean isFromContainerClassPath(WebAppContext context,
                               ServletContainerInitializer sci)

Test if the ServletContainerInitializer is from the container classpath

Parameters:

context -

sci -

Returns:

getNonExcludedInitializers

public List<ServletContainerInitializer> getNonExcludedInitializers(WebAppContext context)
                                                             throws Exception

Parameters:

context -

Returns:

list of non-excluded ServletContainerInitializers

Throws:

Exception

getInitializerOrdering

public AnnotationConfiguration.ServletContainerInitializerOrdering getInitializerOrdering(WebAppContext context)

Jetty-specific extension that allows an ordering to be applied across ALL ServletContainerInitializers.

Returns:

parseContainerPath

public void parseContainerPath(WebAppContext context,
                      AnnotationParser parser)
                        throws Exception

Scan jars on container path.

Parameters:

context -

parser -

Throws:

Exception

parseWebInfLib

public void parseWebInfLib(WebAppContext context,
                  AnnotationParser parser)
                    throws Exception

Scan jars in WEB-INF/lib

Parameters:

context -

parser -

Throws:

Exception

parseWebInfClasses

public void parseWebInfClasses(WebAppContext context,
                      AnnotationParser parser)
                        throws Exception

Scan classes in WEB-INF/classes

Parameters:

context -

parser -

Throws:

Exception

getFragmentFromJar

public FragmentDescriptor getFragmentFromJar(Resource jar,
                                    List<FragmentDescriptor> frags)
                                      throws Exception

Get the web-fragment.xml from a jar

Parameters:

jar -

frags -

Returns:

the fragment if found, or null of not found

Throws:

Exception

isMetaDataComplete

public boolean isMetaDataComplete(WebDescriptor d)