org.eclipse.jetty.webapp
Class WebInfConfiguration

java.lang.Object
  org.eclipse.jetty.webapp.WebInfConfiguration

All Implemented Interfaces:

Configuration

public class WebInfConfiguration
extends java.lang.Object
implements Configuration

Field Summary

protected Resource	_preUnpackBaseResource
static java.lang.String	CONTAINER_JAR_PATTERN
static java.lang.String	CONTAINER_JAR_RESOURCES
static java.lang.String	RESOURCE_URLS 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_CREATED
static java.lang.String	WEB_INF_JAR_RESOURCES
static java.lang.String	WEBINF_JAR_PATTERN

Constructor Summary

WebInfConfiguration()

Method Summary

void	configure(WebAppContext context) Configure WebApp.
void	deconfigure(WebAppContext context) DeConfigure WebApp.
protected java.util.List<Resource>	findJars(WebAppContext context) Look for jars in WEB-INF/lib
java.io.File	findWorkDirectory(WebAppContext context)
java.lang.String	getCanonicalNameForWebAppTmpDir(WebAppContext context) Create a canonical name for a webapp temp directory.
boolean	isTempWorkDirectory(java.io.File tmpDir) Check if the tmpDir itself is called "work", or if the tmpDir is in a directory called "work".
void	makeTempDirectory(java.io.File parent, WebAppContext context, boolean deleteExisting)
void	postConfigure(WebAppContext context) Clear down after configuration.
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	setTempDirectory(java.io.File tmpDir, WebAppContext context)
void	unpack(WebAppContext context)

Methods inherited from class java.lang.Object

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

Field Detail

TEMPDIR_CREATED

public static final java.lang.String TEMPDIR_CREATED

See Also:

Constant Field Values

CONTAINER_JAR_RESOURCES

public static final java.lang.String CONTAINER_JAR_RESOURCES

See Also:

Constant Field Values

WEB_INF_JAR_RESOURCES

public static final java.lang.String WEB_INF_JAR_RESOURCES

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_URLS

public static final java.lang.String RESOURCE_URLS

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 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.

Specified by:

preConfigure in interface Configuration

Throws:

java.lang.Exception

postConfigure

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

Description copied from interface: Configuration

Clear down after configuration.

Specified by:

postConfigure in interface Configuration

Throws:

java.lang.Exception

configure

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

Description copied from interface: Configuration

Configure WebApp.

Specified by:

configure in interface Configuration

Throws:

java.lang.Exception

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

Throws:

java.lang.Exception

resolveTempDirectory

public void resolveTempDirectory(WebAppContext context)

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. Do NOT set delete on exit.
2. Iff javax.servlet.context.tempdir context attribute is set for this webapp && exists && writeable, then use it. Do NOT set delete on exit.

B. Create a directory based on global settings. The new directory will be called "Jetty_"+host+"_"+port+"__"+context+"_"+virtualhost Work out where to create this directory:

1. Iff $(jetty.home)/work exists create the directory there. Do NOT set delete on exit. Do NOT delete contents if dir already exists.
2. Iff WEB-INF/work exists create the directory there. Do NOT set delete on exit. Do NOT delete contents if dir already exists.
3. Else create dir in $(java.io.tmpdir). Set delete on exit. Delete contents if dir already exists.

makeTempDirectory

public void makeTempDirectory(java.io.File parent,
                              WebAppContext context,
                              boolean deleteExisting)
                       throws java.io.IOException

Throws:

java.io.IOException

setTempDirectory

public void setTempDirectory(java.io.File tmpDir,
                             WebAppContext context)

unpack

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

Throws:

java.io.IOException

findWorkDirectory

public java.io.File findWorkDirectory(WebAppContext context)
                               throws java.io.IOException

Throws:

java.io.IOException

isTempWorkDirectory

public boolean isTempWorkDirectory(java.io.File tmpDir)

Check if the tmpDir itself is called "work", or if the tmpDir is in a directory called "work".

Returns:

true if File is a temporary or work directory

getCanonicalNameForWebAppTmpDir

public 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+base36_hashcode_of_whole_string host and port uniquely identify the server context and virtual host uniquely identify the webapp

Returns:

the canonical name for the webapp temp directory

findJars

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

Look for jars in WEB-INF/lib

Parameters:

context -

Returns:

the list of jar resources found within context

Throws:

java.lang.Exception