Package org.eclipse.jetty.webapp

Class WebInfConfiguration

java.lang.Object

org.eclipse.jetty.webapp.AbstractConfiguration

org.eclipse.jetty.webapp.WebInfConfiguration

All Implemented Interfaces:

Configuration

public class WebInfConfiguration
extends AbstractConfiguration

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
class	WebInfConfiguration.ContainerPathNameMatcher	ContainerPathNameMatcher Matches names of jars on the container classpath against a pattern.
class	WebInfConfiguration.WebAppPathNameMatcher	WebAppPathNameMatcher Matches names of jars or dirs on the webapp classpath against a pattern.

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

Configuration.ClassList

Field Summary

Fields

Modifier and Type	Field	Description
protected org.eclipse.jetty.util.resource.Resource	_preUnpackBaseResource
static java.lang.String	CONTAINER_JAR_PATTERN
static java.lang.String	RESOURCE_DIRS	If set, to a list of URLs, these resources are added to the context resource base as a resource collection.
static java.lang.String	TEMPDIR_CONFIGURED
static java.lang.String	WEBINF_JAR_PATTERN

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

ATTR

Constructor Summary

Constructors

Constructor	Description
WebInfConfiguration()

Method Summary

Modifier and Type	Method	Description
void	cloneConfigure(WebAppContext template, WebAppContext context)	Clone configuration instance.
void	configure(WebAppContext context)	Configure WebApp.
void	configureTempDirectory(java.io.File dir, WebAppContext context)
void	deconfigure(WebAppContext context)	DeConfigure WebApp.
void	findAndFilterContainerPaths(WebAppContext context)	Find jars and directories that are on the container's classpath and apply an optional filter.
void	findAndFilterWebAppPaths(WebAppContext context)	Finds the jars that are either physically or virtually in WEB-INF/lib, and applies an optional filter to their full pathnames.
protected java.util.List<org.eclipse.jetty.util.resource.Resource>	findClassDirs(WebAppContext context)
protected java.util.List<org.eclipse.jetty.util.resource.Resource>	findExtraClasspathDirs(WebAppContext context)	Get class dirs from WebAppContext.getExtraClasspath as resources
protected java.util.List<org.eclipse.jetty.util.resource.Resource>	findExtraClasspathJars(WebAppContext context)	Get jars from WebAppContext.getExtraClasspath as resources
protected java.util.List<org.eclipse.jetty.util.resource.Resource>	findJars(WebAppContext context)	Look for jars that should be treated as if they are in WEB-INF/lib
protected org.eclipse.jetty.util.resource.Resource	findWebInfClassesDir(WebAppContext context)	Get WEB-INF/classes dir
protected java.util.List<org.eclipse.jetty.util.resource.Resource>	findWebInfLibJars(WebAppContext context)	Look for jars in WEB-INF/lib
static java.lang.String	getCanonicalNameForWebAppTmpDir(WebAppContext context)	Create a canonical name for a webapp temp directory.
void	makeTempDirectory(java.io.File parent, WebAppContext context)
void	preConfigure(WebAppContext context)	Set up for configuration.
void	resolveTempDirectory(WebAppContext context)	Get a temporary directory in which to unpack the war etc etc.
void	unpack(WebAppContext context)

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

destroy, postConfigure

Methods inherited from class java.lang.Object

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

Field Detail

TEMPDIR_CONFIGURED

public static final java.lang.String TEMPDIR_CONFIGURED

See Also:

Constant Field Values

CONTAINER_JAR_PATTERN

public static final java.lang.String CONTAINER_JAR_PATTERN

See Also:

Constant Field Values

WEBINF_JAR_PATTERN

public static final java.lang.String WEBINF_JAR_PATTERN

See Also:

Constant Field Values

RESOURCE_DIRS

public static final java.lang.String RESOURCE_DIRS

If set, to a list of URLs, these resources are added to the context resource base as a resource collection.

See Also:

Constant Field Values

_preUnpackBaseResource

protected org.eclipse.jetty.util.resource.Resource _preUnpackBaseResource

Constructor Detail

WebInfConfiguration

public WebInfConfiguration()

Method Detail

preConfigure

public void preConfigure(WebAppContext context)
                  throws java.lang.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:

java.lang.Exception - if unable to pre configure

findAndFilterContainerPaths

public void findAndFilterContainerPaths(WebAppContext context)
                                 throws java.lang.Exception

Find jars and directories that are on the container's classpath and apply an optional filter. The filter is a pattern applied to the full jar or directory names. If there is no pattern, then no jar or dir is considered to match. Those jars that do match will be later examined for META-INF information and annotations. To find them, examine the classloaders in the hierarchy above the webapp classloader that are URLClassLoaders. For jdk-9 we also look at the java.class.path, and the jdk.module.path.

Parameters:

context - the WebAppContext being deployed

Throws:

java.lang.Exception - if unable to apply optional filtering on the container's classpath

findAndFilterWebAppPaths

public void findAndFilterWebAppPaths(WebAppContext context)
                              throws java.lang.Exception

Finds the jars that are either physically or virtually in WEB-INF/lib, and applies an optional filter to their full pathnames. The filter selects which jars will later be examined for META-INF information and annotations. If there is no pattern, then all jars are considered selected.

Parameters:

context - the WebAppContext being deployed

Throws:

java.lang.Exception - if unable to find the jars or apply filtering

configure

public void configure(WebAppContext context)
               throws java.lang.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:

java.lang.Exception - if unable to configure

deconfigure

public void deconfigure(WebAppContext context)
                 throws java.lang.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:

java.lang.Exception - if unable to deconfigure

cloneConfigure

public void cloneConfigure(WebAppContext template,
                           WebAppContext context)
                    throws java.lang.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:

java.lang.Exception - if unable to clone

See Also:

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

resolveTempDirectory

public void resolveTempDirectory(WebAppContext context)
                          throws java.lang.Exception

Get a temporary directory in which to unpack the war etc etc. The algorithm for determining this is to check these alternatives in the order shown:

A. Try to use an explicit directory specifically for this webapp:

1. Iff an explicit directory is set for this webapp, use it. Set delete on exit depends on value of persistTempDirectory.
2. Iff javax.servlet.context.tempdir context attribute is set for this webapp && exists && writeable, then use it. Set delete on exit depends on value of persistTempDirectory.

B. Create a directory based on global settings. The new directory will be called "Jetty-"+host+"-"+port+"__"+context+"-"+virtualhost+"-"+randomdigits+".dir"

If the user has specified the context attribute org.eclipse.jetty.webapp.basetempdir, the directory specified by this attribute will be the parent of the temp dir created. Otherwise, the parent dir is ${java.io.tmpdir}. Set delete on exit depends on value of persistTempDirectory.

Parameters:

context - the context to resolve the temp directory from

Throws:

java.lang.Exception - if unable to resolve the temp directory

makeTempDirectory

public void makeTempDirectory(java.io.File parent,
                              WebAppContext context)
                       throws java.lang.Exception

Throws:

java.lang.Exception

configureTempDirectory

public void configureTempDirectory(java.io.File dir,
                                   WebAppContext context)

unpack

public void unpack(WebAppContext context)
            throws java.io.IOException

Throws:

java.io.IOException

getCanonicalNameForWebAppTmpDir

public static java.lang.String getCanonicalNameForWebAppTmpDir(WebAppContext context)

Create a canonical name for a webapp temp directory.

The form of the name is:

"jetty-"+host+"-"+port+"-"+resourceBase+"-_"+context+"-"+virtualhost+"-"+randomdigits+".dir"

host and port uniquely identify the server context and virtual host uniquely identify the webapp randomdigits ensure every tmp directory is unique

Parameters:

context - the context to get the canonical name from

Returns:

the canonical name for the webapp temp directory

findClassDirs

protected java.util.List<org.eclipse.jetty.util.resource.Resource> findClassDirs(WebAppContext context)
                                                                          throws java.lang.Exception

Throws:

java.lang.Exception

findJars

protected java.util.List<org.eclipse.jetty.util.resource.Resource> findJars(WebAppContext context)
                                                                     throws java.lang.Exception

Look for jars that should be treated as if they are in WEB-INF/lib

Parameters:

context - the context to find the jars in

Returns:

the list of jar resources found within context

Throws:

java.lang.Exception - if unable to find the jars

findWebInfLibJars

protected java.util.List<org.eclipse.jetty.util.resource.Resource> findWebInfLibJars(WebAppContext context)
                                                                              throws java.lang.Exception

Look for jars in WEB-INF/lib

Parameters:

context - the context to find the lib jars in

Returns:

the list of jars as Resource, or null

Throws:

java.lang.Exception - if unable to scan for lib jars

findExtraClasspathJars

protected java.util.List<org.eclipse.jetty.util.resource.Resource> findExtraClasspathJars(WebAppContext context)
                                                                                   throws java.lang.Exception

Get jars from WebAppContext.getExtraClasspath as resources

Parameters:

context - the context to find extra classpath jars in

Returns:

the list of Resources with the extra classpath, or null if not found

Throws:

java.lang.Exception - if unable to find the extra classpath jars

findWebInfClassesDir

protected org.eclipse.jetty.util.resource.Resource findWebInfClassesDir(WebAppContext context)
                                                                 throws java.lang.Exception

Get WEB-INF/classes dir

Parameters:

context - the context to look for the WEB-INF/classes directory

Returns:

the Resource for the WEB-INF/classes directory

Throws:

java.lang.Exception - if unable to find the WEB-INF/classes directory

findExtraClasspathDirs

protected java.util.List<org.eclipse.jetty.util.resource.Resource> findExtraClasspathDirs(WebAppContext context)
                                                                                   throws java.lang.Exception

Get class dirs from WebAppContext.getExtraClasspath as resources

Parameters:

context - the context to look for extra classpaths in

Returns:

the list of Resources to the extra classpath

Throws:

java.lang.Exception - if unable to find the extra classpaths