org.glassfish.grizzly.http.server.util

Class ExpandJar

java.lang.Object

org.glassfish.grizzly.http.server.util.ExpandJar

public class ExpandJar
extends java.lang.Object

Expand out a jar. Adapted from Tomcat's org.apache.catalina.startup.ExpendWar classes

Author:

Jeanfrancois Arcand

Constructor Summary

Constructors

Constructor and Description
ExpandJar()

Method Summary

Methods

Modifier and Type	Method and Description
static boolean	copy(java.io.File src, java.io.File dest) Copy the specified file or directory to the destination.
static boolean	delete(java.io.File dir) Delete the specified directory, including all of its contents and subdirectories recursively.
static boolean	deleteDir(java.io.File dir) Delete the specified directory, including all of its contents and subdirectories recursively.
protected static void	expand(java.io.InputStream input, java.io.File docBase, java.lang.String name) Expand the specified input stream into the specified directory, creating a file named from the specified relative path.
static java.lang.String	expand(java.net.URL jar) Expand the jar file found at the specified URL into an unpacked directory structure, and return the absolute pathname to the expanded directory.
static java.lang.String	expand(java.net.URL jar, java.lang.String workFolder) Expand the jar file found at the specified URL into an unpacked directory structure, and return the absolute pathname to the expanded directory.
static java.lang.String	expand(java.net.URL jar, java.lang.String pathname, java.lang.String dirname) Expand the jar file found at the specified URL into an unpacked directory structure, and return the absolute pathname to the expanded directory.

Methods inherited from class java.lang.Object

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

Constructor Detail

ExpandJar

public ExpandJar()

Method Detail

expand

public static java.lang.String expand(java.net.URL jar)
                               throws java.io.IOException

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

Parameters:

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

Returns:

Absolute path as in File.getAbsolutePath() of location where to find expanded 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(java.net.URL jar,
                      java.lang.String workFolder)
                               throws java.io.IOException

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

Parameters:

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

workFolder - the folder where the file will be expanded

Returns:

Absolute path as in File.getAbsolutePath() of location where to find expanded 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(java.net.URL jar,
                      java.lang.String pathname,
                      java.lang.String dirname)
                               throws java.io.IOException

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

Parameters:

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

pathname - Context path name for web application

Returns:

Absolute path as in File.getAbsolutePath() of location where to find expanded jar.

Throws:

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

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

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

Parameters:

dir - File object representing the directory to be deleted

deleteDir

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

Delete the specified directory, including all of its contents and subdirectories recursively.

Parameters:

dir - File object representing the directory to be deleted

expand

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

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

Throws:

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