Module org.eclipse.jetty.ee10.annotations

Package org.eclipse.jetty.ee10.annotations

Class AnnotationConfiguration

java.lang.Object

org.eclipse.jetty.ee10.webapp.AbstractConfiguration

org.eclipse.jetty.ee10.annotations.AnnotationConfiguration

All Implemented Interfaces:

org.eclipse.jetty.ee10.webapp.Configuration

public class AnnotationConfiguration
extends org.eclipse.jetty.ee10.webapp.AbstractConfiguration

Configuration for Annotations

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	AnnotationConfiguration.ClassInheritanceMap
static class	AnnotationConfiguration.DiscoveredServletContainerInitializerHolder
static class	AnnotationConfiguration.ParserTask	ParserTask
static class	AnnotationConfiguration.ServletContainerInitializerComparator	ServletContainerInitializerComparator
static class	AnnotationConfiguration.ServletContainerInitializerOrdering	ServletContainerInitializerOrdering
protected static class	AnnotationConfiguration.State
static class	AnnotationConfiguration.TimeStatistic	Simple class to capture elapsed time of an operation.

Nested classes/interfaces inherited from class org.eclipse.jetty.ee10.webapp.AbstractConfiguration

org.eclipse.jetty.ee10.webapp.AbstractConfiguration.Builder

Field Summary

Fields

Modifier and Type	Field	Description
static final String	CLASS_INHERITANCE_MAP
static final String	CONTAINER_INITIALIZER_STARTER
static final String	CONTAINER_INITIALIZERS
static final int	DEFAULT_MAX_SCAN_WAIT
static final boolean	DEFAULT_MULTI_THREADED
static final String	MAX_SCAN_WAIT
static final String	MULTI_THREADED
static final String	SERVLET_CONTAINER_INITIALIZER_EXCLUSION_PATTERN
static final String	SERVLET_CONTAINER_INITIALIZER_ORDER
protected static final String	STATE

Constructor Summary

Constructors

Constructor	Description
AnnotationConfiguration()

Method Summary

Modifier and Type	Method	Description
void	configure(org.eclipse.jetty.ee10.webapp.WebAppContext context)
protected AnnotationParser	createAnnotationParser(int javaPlatform)
void	createServletContainerInitializerAnnotationHandlers(org.eclipse.jetty.ee10.webapp.WebAppContext context, List<jakarta.servlet.ServletContainerInitializer> scis)
AnnotationConfiguration.ServletContainerInitializerOrdering	getInitializerOrdering(org.eclipse.jetty.ee10.webapp.WebAppContext context)	Jetty-specific extension that allows an ordering to be applied across ALL ServletContainerInitializers.
protected org.eclipse.jetty.util.resource.Resource	getJarFor(org.eclipse.jetty.ee10.webapp.WebAppContext context, jakarta.servlet.ServletContainerInitializer service)
protected int	getMaxScanWait(org.eclipse.jetty.ee10.webapp.WebAppContext context)	Work out how long we should wait for the async scanning to occur.
protected List<jakarta.servlet.ServletContainerInitializer>	getNonExcludedInitializers(AnnotationConfiguration.State state)	Get SCIs that are not excluded from consideration
boolean	isFromContainerClassPath(org.eclipse.jetty.ee10.webapp.WebAppContext context, jakarta.servlet.ServletContainerInitializer sci)	Test if the ServletContainerInitializer is from the container classpath
boolean	isFromExcludedJar(org.eclipse.jetty.ee10.webapp.WebAppContext context, jakarta.servlet.ServletContainerInitializer sci, org.eclipse.jetty.util.resource.Resource sciResource)	Check to see if the ServletContainerIntializer loaded via the ServiceLoader came from a jar that is excluded by the fragment ordering.
boolean	isFromWebInfClasses(org.eclipse.jetty.ee10.webapp.WebAppContext context, org.eclipse.jetty.util.resource.Resource sci)	Test if the ServletContainerInitializer is from WEB-INF/classes
protected boolean	isUseMultiThreading(org.eclipse.jetty.ee10.webapp.WebAppContext context)	Check if we should use multiple threads to scan for annotations or not
boolean	matchesExclusionPattern(AnnotationConfiguration.State state, jakarta.servlet.ServletContainerInitializer sci)	Test if the ServletContainerIntializer is excluded by the o.e.j.containerInitializerExclusionPattern
void	parseContainerPath(org.eclipse.jetty.ee10.webapp.WebAppContext context, AnnotationParser parser)	Scan jars on container path.
protected void	parseWebInfClasses(AnnotationConfiguration.State state, AnnotationParser parser)	Scan classes in WEB-INF/classes.
protected void	parseWebInfLib(AnnotationConfiguration.State state, AnnotationParser parser)	Scan jars in WEB-INF/lib.
void	postConfigure(org.eclipse.jetty.ee10.webapp.WebAppContext context)
void	preConfigure(org.eclipse.jetty.ee10.webapp.WebAppContext context)
protected void	scanForAnnotations(org.eclipse.jetty.ee10.webapp.WebAppContext context, AnnotationConfiguration.State state)	Perform scanning of classes for discoverable annotations such as WebServlet/WebFilter/WebListener

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

abort, deconfigure, destroy, getDependencies, getDependents, getHiddenClasses, getProtectedClasses, isEnabledByDefault

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.eclipse.jetty.ee10.webapp.Configuration

getServerClasses, getSystemClasses, isAvailable, replaces

Field Details

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

STATE

protected static final String STATE

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

Constructor Details

AnnotationConfiguration

public AnnotationConfiguration()

Method Details

preConfigure

public void preConfigure(org.eclipse.jetty.ee10.webapp.WebAppContext context)

Specified by:

preConfigure in interface org.eclipse.jetty.ee10.webapp.Configuration

Overrides:

preConfigure in class org.eclipse.jetty.ee10.webapp.AbstractConfiguration

configure

public void configure(org.eclipse.jetty.ee10.webapp.WebAppContext context)
               throws Exception

Specified by:

configure in interface org.eclipse.jetty.ee10.webapp.Configuration

Overrides:

configure in class org.eclipse.jetty.ee10.webapp.AbstractConfiguration

Throws:

Exception

postConfigure

public void postConfigure(org.eclipse.jetty.ee10.webapp.WebAppContext context)
                   throws Exception

Specified by:

postConfigure in interface org.eclipse.jetty.ee10.webapp.Configuration

Overrides:

postConfigure in class org.eclipse.jetty.ee10.webapp.AbstractConfiguration

Throws:

Exception

scanForAnnotations

protected void scanForAnnotations(org.eclipse.jetty.ee10.webapp.WebAppContext context,
 AnnotationConfiguration.State state)
                           throws Exception

Perform scanning of classes for discoverable annotations such as WebServlet/WebFilter/WebListener

Parameters:

context - the context for the scan

Throws:

Exception - if unable to scan

createAnnotationParser

protected AnnotationParser createAnnotationParser(int javaPlatform)

Parameters:

javaPlatform - The java platform to scan for.

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(org.eclipse.jetty.ee10.webapp.WebAppContext context)

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

Parameters:

context - the context of the multi threaded setting

Returns:

true if multi threading is enabled on the context, server, or via a System property.

See Also:

• MULTI_THREADED

getMaxScanWait

protected int getMaxScanWait(org.eclipse.jetty.ee10.webapp.WebAppContext context)

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

Parameters:

context - the context of the max scan wait setting

Returns:

the max scan wait setting on the context, or server, or via a System property.

See Also:

• MAX_SCAN_WAIT

createServletContainerInitializerAnnotationHandlers

public void createServletContainerInitializerAnnotationHandlers(org.eclipse.jetty.ee10.webapp.WebAppContext context,
 List<jakarta.servlet.ServletContainerInitializer> scis)
                                                         throws Exception

Throws:

Exception

getJarFor

protected org.eclipse.jetty.util.resource.Resource getJarFor(org.eclipse.jetty.ee10.webapp.WebAppContext context,
 jakarta.servlet.ServletContainerInitializer service)

isFromExcludedJar

public boolean isFromExcludedJar(org.eclipse.jetty.ee10.webapp.WebAppContext context,
 jakarta.servlet.ServletContainerInitializer sci,
 org.eclipse.jetty.util.resource.Resource sciResource)

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 - the context for the jars

sci - the servlet container initializer

sciResource - the resource for the servlet container initializer

Returns:

true if excluded

matchesExclusionPattern

public boolean matchesExclusionPattern(AnnotationConfiguration.State state,
 jakarta.servlet.ServletContainerInitializer sci)

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

Parameters:

state - the state of the Annotation parsing

sci - the ServletContainerIntializer

Returns:

true if the ServletContainerIntializer is excluded

isFromContainerClassPath

public boolean isFromContainerClassPath(org.eclipse.jetty.ee10.webapp.WebAppContext context,
 jakarta.servlet.ServletContainerInitializer sci)

Test if the ServletContainerInitializer is from the container classpath

Parameters:

context - the context for the webapp classpath

sci - the ServletContainerIntializer

Returns:

true if ServletContainerIntializer is from container classpath

isFromWebInfClasses

public boolean isFromWebInfClasses(org.eclipse.jetty.ee10.webapp.WebAppContext context,
 org.eclipse.jetty.util.resource.Resource sci)

Test if the ServletContainerInitializer is from WEB-INF/classes

Parameters:

context - the webapp to test

sci - a Resource representing the SCI

Returns:

true if the sci Resource is inside a WEB-INF/classes directory, false otherwise

getNonExcludedInitializers

protected List<jakarta.servlet.ServletContainerInitializer> getNonExcludedInitializers(AnnotationConfiguration.State state)

Get SCIs that are not excluded from consideration

Parameters:

state - the web app annotation parse state

Returns:

the list of non-excluded servlet container initializers

getInitializerOrdering

public AnnotationConfiguration.ServletContainerInitializerOrdering getInitializerOrdering(org.eclipse.jetty.ee10.webapp.WebAppContext context)

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

Parameters:

context - the context for the initializer ordering configuration

Returns:

the ordering of the ServletContainerIntializer's

parseContainerPath

public void parseContainerPath(org.eclipse.jetty.ee10.webapp.WebAppContext context,
 AnnotationParser parser)

Scan jars on container path.

Parameters:

context - the context for the scan

parser - the parser to scan with

parseWebInfLib

protected void parseWebInfLib(AnnotationConfiguration.State state,
 AnnotationParser parser)
                       throws Exception

Scan jars in WEB-INF/lib.

Only jars selected by MetaInfConfiguration, and that are not excluded by an ordering will be considered.

Parameters:

state - the state for the scan

parser - the annotation parser to use

Throws:

Exception - if unable to scan and/or parse

parseWebInfClasses

protected void parseWebInfClasses(AnnotationConfiguration.State state,
 AnnotationParser parser)

Scan classes in WEB-INF/classes.

Parameters:

state - the state for the scan

parser - the annotation parser to use