Package org.eclipse.jetty.webapp

Class MetaInfConfiguration

java.lang.Object

org.eclipse.jetty.webapp.AbstractConfiguration

org.eclipse.jetty.webapp.MetaInfConfiguration

All Implemented Interfaces:

Configuration

public class MetaInfConfiguration
extends AbstractConfiguration

MetaInfConfiguration

Scan META-INF of jars to find:

• tlds
• web-fragment.xml
• resources

The jars which are scanned are:

1. those from the container classpath whose pattern matched the WebInfConfiguration.CONTAINER_JAR_PATTERN
2. those from WEB-INF/lib

Nested Class Summary

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

Configuration.ClassList, Configuration.Wrapper, Configuration.WrapperFunction

Field Summary

Fields

Modifier and Type	Field	Description
static final List<String>	__allScanTypes
static final String	CACHED_CONTAINER_FRAGMENTS
static final String	CACHED_CONTAINER_RESOURCES
static final String	CACHED_CONTAINER_TLDS
static final boolean	DEFAULT_USE_CONTAINER_METAINF_CACHE
static final String	METAINF_FRAGMENTS
static final String	METAINF_RESOURCES
static final String	METAINF_TLDS
static final String	USE_CONTAINER_METAINF_CACHE

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

ATTR

Constructor Summary

Constructors

Constructor	Description
MetaInfConfiguration()

Method Summary

Modifier and Type	Method	Description
Collection<URL>	getTlds(File dir)	Find all .tld files in all subdirs of the given dir.
Collection<URL>	getTlds(URI uri)	Find all .tld files in the given jar.
void	postConfigure(WebAppContext context)	Clear down after configuration.
void	preConfigure(WebAppContext context)	Set up for configuration.
void	scanForFragment(WebAppContext context, org.eclipse.jetty.util.resource.Resource jar, ConcurrentHashMap<org.eclipse.jetty.util.resource.Resource,org.eclipse.jetty.util.resource.Resource> cache)	Scan for META-INF/web-fragment.xml file in the given jar.
void	scanForResources(WebAppContext context, org.eclipse.jetty.util.resource.Resource target, ConcurrentHashMap<org.eclipse.jetty.util.resource.Resource,org.eclipse.jetty.util.resource.Resource> cache)	Scan for META-INF/resources dir in the given jar.
void	scanForTlds(WebAppContext context, org.eclipse.jetty.util.resource.Resource jar, ConcurrentHashMap<org.eclipse.jetty.util.resource.Resource,Collection<URL>> cache)	Discover META-INF/*.tld files in the given jar
void	scanJars(WebAppContext context, Collection<org.eclipse.jetty.util.resource.Resource> jars, boolean useCaches)	For backwards compatibility.
void	scanJars(WebAppContext context, Collection<org.eclipse.jetty.util.resource.Resource> jars, boolean useCaches, List<String> scanTypes)	Look into the jars to discover info in META-INF.

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

cloneConfigure, configure, deconfigure, destroy

Methods inherited from class java.lang.Object

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

Field Details

USE_CONTAINER_METAINF_CACHE

public static final String USE_CONTAINER_METAINF_CACHE

See Also:

• Constant Field Values

DEFAULT_USE_CONTAINER_METAINF_CACHE

public static final boolean DEFAULT_USE_CONTAINER_METAINF_CACHE

See Also:

• Constant Field Values

CACHED_CONTAINER_TLDS

public static final String CACHED_CONTAINER_TLDS

See Also:

• Constant Field Values

CACHED_CONTAINER_FRAGMENTS

public static final String CACHED_CONTAINER_FRAGMENTS

See Also:

• Constant Field Values

CACHED_CONTAINER_RESOURCES

public static final String CACHED_CONTAINER_RESOURCES

See Also:

• Constant Field Values

METAINF_TLDS

public static final String METAINF_TLDS

See Also:

• Constant Field Values

METAINF_FRAGMENTS

public static final String METAINF_FRAGMENTS

See Also:

• Constant Field Values

METAINF_RESOURCES

public static final String METAINF_RESOURCES

See Also:

• Constant Field Values

__allScanTypes

public static final List<String> __allScanTypes

Constructor Details

MetaInfConfiguration

public MetaInfConfiguration()

Method Details

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 - if unable to pre configure

scanJars

public void scanJars(WebAppContext context,
 Collection<org.eclipse.jetty.util.resource.Resource> jars,
 boolean useCaches)
              throws Exception

For backwards compatibility. This method will always scan for all types of data.

Parameters:

context - the context for the scan

jars - the jars to scan

useCaches - if true, the scanned info is cached

Throws:

Exception - if unable to scan the jars

scanJars

public void scanJars(WebAppContext context,
 Collection<org.eclipse.jetty.util.resource.Resource> jars,
 boolean useCaches,
 List<String> scanTypes)
              throws Exception

Look into the jars to discover info in META-INF. If useCaches == true, then we will cache the info discovered indexed by the jar in which it was discovered: this speeds up subsequent context deployments.

Parameters:

context - the context for the scan

jars - the jars resources to scan

useCaches - if true, cache the info discovered

scanTypes - the type of things to look for in the jars

Throws:

Exception - if unable to scan the jars

scanForResources

public void scanForResources(WebAppContext context,
 org.eclipse.jetty.util.resource.Resource target,
 ConcurrentHashMap<org.eclipse.jetty.util.resource.Resource,org.eclipse.jetty.util.resource.Resource> cache)
                      throws Exception

Scan for META-INF/resources dir in the given jar.

Parameters:

context - the context for the scan

target - the target resource to scan for

cache - the resource cache

Throws:

Exception - if unable to scan for resources

scanForFragment

public void scanForFragment(WebAppContext context,
 org.eclipse.jetty.util.resource.Resource jar,
 ConcurrentHashMap<org.eclipse.jetty.util.resource.Resource,org.eclipse.jetty.util.resource.Resource> cache)
                     throws Exception

Scan for META-INF/web-fragment.xml file in the given jar.

Parameters:

context - the context for the scan

jar - the jar resource to scan for fragements in

cache - the resource cache

Throws:

Exception - if unable to scan for fragments

scanForTlds

public void scanForTlds(WebAppContext context,
 org.eclipse.jetty.util.resource.Resource jar,
 ConcurrentHashMap<org.eclipse.jetty.util.resource.Resource,Collection<URL>> cache)
                 throws Exception

Discover META-INF/*.tld files in the given jar

Parameters:

context - the context for the scan

jar - the jar resources to scan tlds for

cache - the resource cache

Throws:

Exception - if unable to scan for tlds

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 - if unable to post configure

getTlds

public Collection<URL> getTlds(File dir)
                        throws IOException

Find all .tld files in all subdirs of the given dir.

Parameters:

dir - the directory to scan

Returns:

the list of tlds found

Throws:

IOException - if unable to scan the directory

getTlds

public Collection<URL> getTlds(URI uri)
                        throws IOException

Find all .tld files in the given jar.

Parameters:

uri - the uri to jar file

Returns:

the collection of tlds as url references

Throws:

IOException - if unable to scan the jar file