org.glassfish.deployment.common
Class DeploymentUtils

java.lang.Object
  org.glassfish.deployment.common.DeploymentUtils

public class DeploymentUtils
extends java.lang.Object

Utility methods for deployment.

Field Summary

static java.lang.String	DEPLOYMENT_PROPERTY_JAVA_WEB_START_ENABLED
static java.lang.String	DOMAIN_TARGET_NAME

Constructor Summary

DeploymentUtils()

Method Summary

static long	checksum(java.io.File directory) Computes the checksum of the URIs of files contained in a directory.
static Artifacts	downloadableArtifacts(Application app) Returns the downloadable artifacts object derived from the properties saved with the specified Application
static Artifacts	downloadableArtifacts(DeploymentContext dc) Returns the downloadable artifacts object from the specified deployment context, creating it there if it does not already exist.
static Artifacts	generatedArtifacts(Application app) Returns the generated artifacts object derived from the properties saved with the specified Application
static Artifacts	generatedArtifacts(DeploymentContext dc) Returns the generated artifacts object from the specified deployment context, creating it there if it does not already exist.
static java.lang.String	getDefaultEEName(java.lang.String pathName)
static java.lang.String	getEmbeddedModulePath(java.lang.String appRootPath, java.lang.String moduleUri) This method returns the file path of an embedded module.
static java.util.List<java.net.URI>	getExternalLibraries(ReadableArchive archive)
static java.util.List<java.net.URL>	getManifestLibraries(DeploymentContext context)
static java.util.List<java.net.URL>	getManifestLibraries(DeploymentContext context, java.util.jar.Manifest manifest)
static java.util.List<java.net.URL>	getManifestLibraries(ReadableArchive archive)
static java.util.List<java.net.URL>	getModuleLibraryJars(DeploymentContext context)
static java.lang.String	getRelativeEmbeddedModulePath(java.lang.String appRootPath, java.lang.String moduleUri) This method returns the relative file path of an embedded module to the application root.
static boolean	hasResourcesXML(ReadableArchive archive)
static boolean	isDASTarget(java.lang.String targetName)
static boolean	isDomainTarget(java.lang.String targetName)
static boolean	isEAR(ReadableArchive archive) check whether the archive is a .ear
static boolean	isRAR(ReadableArchive archive) check whether the archive is a .rar
static boolean	isWebArchive(ReadableArchive archive)
static FileArchive	openAsFileArchive(java.io.File dir, ArchiveFactory archiveFactory) Opens the specified file as an archive, using the provided archive factory.
static java.lang.String	propertiesValue(java.util.Properties props, char sep)
static java.lang.String	relativizeWithinDomainIfPossible(java.net.URI absURI)
static boolean	useV2Compatibility(DeploymentContext context)
static void	validateApplicationName(java.lang.String name)

Methods inherited from class java.lang.Object

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

Field Detail

DEPLOYMENT_PROPERTY_JAVA_WEB_START_ENABLED

public static final java.lang.String DEPLOYMENT_PROPERTY_JAVA_WEB_START_ENABLED

See Also:

Constant Field Values

DOMAIN_TARGET_NAME

public static final java.lang.String DOMAIN_TARGET_NAME

See Also:

Constant Field Values

Constructor Detail

DeploymentUtils

public DeploymentUtils()

Method Detail

isDASTarget

public static boolean isDASTarget(java.lang.String targetName)

isDomainTarget

public static boolean isDomainTarget(java.lang.String targetName)

checksum

public static long checksum(java.io.File directory)

Computes the checksum of the URIs of files contained in a directory.

Parameters:

directory - the directory for which to compute a checksum

Returns:

checksum calculated from URIs of files in the directory

downloadableArtifacts

public static Artifacts downloadableArtifacts(DeploymentContext dc)

Returns the downloadable artifacts object from the specified deployment context, creating it there if it does not already exist.

Parameters:

dc - the deployment context from which to fetch the downloadable Artifacts object

Returns:

downloadableArtifacts

public static Artifacts downloadableArtifacts(Application app)

Returns the downloadable artifacts object derived from the properties saved with the specified Application

Parameters:

app - the Application config object with (possibly) properties describing downloadable artifacts

Returns:

generatedArtifacts

public static Artifacts generatedArtifacts(DeploymentContext dc)

Returns the generated artifacts object from the specified deployment context, creating it there if it does not already exist.

Parameters:

app -

Returns:

generatedArtifacts

public static Artifacts generatedArtifacts(Application app)

Returns the generated artifacts object derived from the properties saved with the specified Application

Parameters:

app - the Application config object with (possibly) properties describing generated artifacts

Returns:

isWebArchive

public static boolean isWebArchive(ReadableArchive archive)

getDefaultEEName

public static java.lang.String getDefaultEEName(java.lang.String pathName)

Parameters:

pathName -

Returns:

the default value of the EE name. The default name is the pathname with any filename extension (.jar, .war, .rar) removed, but with any directory names included.

hasResourcesXML

public static boolean hasResourcesXML(ReadableArchive archive)

isRAR

public static boolean isRAR(ReadableArchive archive)

check whether the archive is a .rar

Parameters:

archive - archive to be tested

Returns:

status of .rar or not

isEAR

public static boolean isEAR(ReadableArchive archive)

check whether the archive is a .ear

Parameters:

archive - archive to be tested

Returns:

status of .ear or not

getRelativeEmbeddedModulePath

public static java.lang.String getRelativeEmbeddedModulePath(java.lang.String appRootPath,
                                                             java.lang.String moduleUri)

This method returns the relative file path of an embedded module to the application root. For example, if the module is expanded/located at $domain_dir/applications/j2ee-apps/foo/fooEJB_jar, this method will return fooEJB_jar

Parameters:

appRootPath - The path of the application root which contains the module e.g. $domain_dir/applications/j2ee-apps/foo

moduleUri - The module uri e.g. fooEJB.jar

Returns:

The relative file path of the module to the application root

getEmbeddedModulePath

public static java.lang.String getEmbeddedModulePath(java.lang.String appRootPath,
                                                     java.lang.String moduleUri)

This method returns the file path of an embedded module. For example, if the module is expanded/located at $domain_dir/applications/j2ee-apps/foo/fooEJB_jar, this method will return $domain_dir/applications/j2ee-apps/foo/fooEJB_jar

Parameters:

appRootPath - The path of the application root which contains the module e.g. $domain_dir/applications/j2ee-apps/foo

moduleUri - The module uri e.g. fooEJB.jar

Returns:

The file path of the module

useV2Compatibility

public static boolean useV2Compatibility(DeploymentContext context)

relativizeWithinDomainIfPossible

public static java.lang.String relativizeWithinDomainIfPossible(java.net.URI absURI)
                                                         throws java.net.URISyntaxException

Throws:

java.net.URISyntaxException

validateApplicationName

public static void validateApplicationName(java.lang.String name)

propertiesValue

public static java.lang.String propertiesValue(java.util.Properties props,
                                               char sep)

getManifestLibraries

public static java.util.List<java.net.URL> getManifestLibraries(DeploymentContext context)
                                                         throws java.io.IOException

Throws:

java.io.IOException

getManifestLibraries

public static java.util.List<java.net.URL> getManifestLibraries(DeploymentContext context,
                                                                java.util.jar.Manifest manifest)
                                                         throws java.io.IOException

Throws:

java.io.IOException

getManifestLibraries

public static java.util.List<java.net.URL> getManifestLibraries(ReadableArchive archive)
                                                         throws java.io.IOException

Throws:

java.io.IOException

getExternalLibraries

public static java.util.List<java.net.URI> getExternalLibraries(ReadableArchive archive)

getModuleLibraryJars

public static java.util.List<java.net.URL> getModuleLibraryJars(DeploymentContext context)
                                                         throws java.lang.Exception

Throws:

java.lang.Exception

openAsFileArchive

public static FileArchive openAsFileArchive(java.io.File dir,
                                            ArchiveFactory archiveFactory)
                                     throws java.io.IOException

Opens the specified file as an archive, using the provided archive factory.

Parameters:

dir - directory to be opened as an archive

archiveFactory - ArchiveFactory to use to create the archive object

Returns:

FileArchive opened for the directory

Throws:

java.io.IOException