org.apache.catalina.startup
Class ExpandWar

java.lang.Object
  org.apache.catalina.startup.ExpandWar

public class ExpandWar
extends java.lang.Object

Expand out a WAR in a Host's appBase.

Author:

Craig R. McClanahan, Remy Maucherat, Glenn L. Nielsen

sm

protected static final StringManager sm

The string resources for this package.

ExpandWar

public ExpandWar()

expand

public static java.lang.String expand(Host host,
                                      java.net.URL war)
                               throws java.io.IOException

Expand the WAR file found at the specified URL into an unpacked directory structure, and return the absolute pathname to the expanded directory.

Parameters:

host - Host war is being installed for

war - URL of the web application archive to be expanded (must start with "jar:")

Throws:

java.lang.IllegalArgumentException - if this is not a "jar:" URL

java.io.IOException - if an input/output error was encountered during expansion

expand

public static java.lang.String expand(Host host,
                                      java.net.URL war,
                                      java.lang.String pathname)
                               throws java.io.IOException

Expand the WAR file found at the specified URL into an unpacked directory structure, and return the absolute pathname to the expanded directory.

Parameters:

host - Host war is being installed for

war - URL of the web application archive to be expanded (must start with "jar:")

pathname - Context path name for web application

Throws:

java.lang.IllegalArgumentException - if this is not a "jar:" URL or if the WAR file is invalid

java.io.IOException - if an input/output error was encountered during expansion

validate

public static void validate(Host host,
                            java.net.URL war,
                            java.lang.String pathname)
                     throws java.io.IOException

Validate the WAR file found at the specified URL.

Parameters:

host - Host war is being installed for

war - URL of the web application archive to be validated (must start with "jar:")

pathname - Context path name for web application

Throws:

java.lang.IllegalArgumentException - if this is not a "jar:" URL or if the WAR file is invalid

java.io.IOException - if an input/output error was encountered during validation

copy

public static boolean copy(java.io.File src,
                           java.io.File dest)

Copy the specified file or directory to the destination.

Parameters:

src - File object representing the source

dest - File object representing the destination

delete

public static boolean delete(java.io.File dir)

Delete the specified directory, including all of its contents and sub-directories recursively. Any failure will be logged.

Parameters:

dir - File object representing the directory to be deleted

delete

public static boolean delete(java.io.File dir,
                             boolean logFailure)

Delete the specified directory, including all of its contents and sub-directories recursively.

Parameters:

dir - File object representing the directory to be deleted

logFailure - true if failure to delete the resource should be logged

deleteDir

public static boolean deleteDir(java.io.File dir)

Delete the specified directory, including all of its contents and sub-directories recursively. Any failure will be logged.

Parameters:

dir - File object representing the directory to be deleted

deleteDir

public static boolean deleteDir(java.io.File dir,
                                boolean logFailure)

Delete the specified directory, including all of its contents and sub-directories recursively.

Parameters:

dir - File object representing the directory to be deleted

logFailure - true if failure to delete the resource should be logged

expand

protected static java.io.File expand(java.io.InputStream input,
                                     java.io.File docBase,
                                     java.lang.String name)
                              throws java.io.IOException

Deprecated. 

Expand the specified input stream into the specified directory, creating a file named from the specified relative path.

Parameters:

input - InputStream to be copied

docBase - Document base directory into which we are expanding

name - Relative pathname of the file to be created

Returns:

A handle to the expanded File

Throws:

java.io.IOException - if an input/output error occurs