Package org.eclipse.jetty.webapp

Class MetaInfConfiguration

java.lang.Object

org.eclipse.jetty.webapp.AbstractConfiguration

org.eclipse.jetty.webapp.MetaInfConfiguration

All Implemented Interfaces:

Configuration

@Deprecated(since="2021-05-27")
public class MetaInfConfiguration
extends AbstractConfiguration

Deprecated.

The Eclipse Jetty and Apache Felix Http Jetty packages are no longer supported.

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 List<String>	__allScanTypes	Deprecated.
static String	CACHED_CONTAINER_FRAGMENTS	Deprecated.
static String	CACHED_CONTAINER_RESOURCES	Deprecated.
static String	CACHED_CONTAINER_TLDS	Deprecated.
static boolean	DEFAULT_USE_CONTAINER_METAINF_CACHE	Deprecated.
static String	METAINF_FRAGMENTS	Deprecated.
static String	METAINF_RESOURCES	Deprecated.
static String	METAINF_TLDS	Deprecated.
static String	USE_CONTAINER_METAINF_CACHE	Deprecated.

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

ATTR

Constructor Summary

Constructors

Constructor	Description
MetaInfConfiguration()	Deprecated.

Method Summary

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

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

Field Detail

USE_CONTAINER_METAINF_CACHE

public static final String USE_CONTAINER_METAINF_CACHE

Deprecated.

See Also:

Constant Field Values

DEFAULT_USE_CONTAINER_METAINF_CACHE

public static final boolean DEFAULT_USE_CONTAINER_METAINF_CACHE

Deprecated.

See Also:

Constant Field Values

CACHED_CONTAINER_TLDS

public static final String CACHED_CONTAINER_TLDS

Deprecated.

See Also:

Constant Field Values

CACHED_CONTAINER_FRAGMENTS

public static final String CACHED_CONTAINER_FRAGMENTS

Deprecated.

See Also:

Constant Field Values

CACHED_CONTAINER_RESOURCES

public static final String CACHED_CONTAINER_RESOURCES

Deprecated.

See Also:

Constant Field Values

METAINF_TLDS

public static final String METAINF_TLDS

Deprecated.

See Also:

Constant Field Values

METAINF_FRAGMENTS

public static final String METAINF_FRAGMENTS

Deprecated.

See Also:

Constant Field Values

METAINF_RESOURCES

public static final String METAINF_RESOURCES

Deprecated.

See Also:

Constant Field Values

__allScanTypes

public static final List<String> __allScanTypes

Deprecated.

Constructor Detail

MetaInfConfiguration

public MetaInfConfiguration()

Deprecated.

Method Detail

preConfigure

public void preConfigure(WebAppContext context)
                  throws Exception

Deprecated.

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<Resource> jars,
                     boolean useCaches)
              throws Exception

Deprecated.

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<Resource> jars,
                     boolean useCaches,
                     List<String> scanTypes)
              throws Exception

Deprecated.

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,
                             Resource target,
                             ConcurrentHashMap<Resource,Resource> cache)
                      throws Exception

Deprecated.

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,
                            Resource jar,
                            ConcurrentHashMap<Resource,Resource> cache)
                     throws Exception

Deprecated.

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,
                        Resource jar,
                        ConcurrentHashMap<Resource,Collection<URL>> cache)
                 throws Exception

Deprecated.

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

Deprecated.

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

Deprecated.

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

Deprecated.

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