Package org.apache.uima.pear.tools

Class PackageInstaller

java.lang.Object

org.apache.uima.pear.tools.PackageInstaller

public class PackageInstaller
extends java.lang.Object

The PackageInstaller class is the main user API for installing PEAR packages. The class has a static method installPackage to install PEAR packages that returns a PackageBrowser object containing all the needed information about the installed PEAR package.

See Also:

PackageBrowser

Field Summary

Fields

Modifier and Type	Field	Description
private static java.lang.String	PEAR_MESSAGE_RESOURCE_BUNDLE

Constructor Summary

Constructors

Constructor	Description
PackageInstaller()

Method Summary

Modifier and Type	Method	Description
static PackageBrowser	installPackage(java.io.File installDir, java.io.File pearPackage, boolean verify)	Installs the specified PEAR package to the specified install location.
static PackageBrowser	installPackage(java.io.File installDir, java.io.File pearPackage, boolean verify, boolean cleanInstallDir)	Installs the specified PEAR package to the specified install location.
static PackageBrowser	installPackage(java.io.File installDir, java.io.File pearPackage, boolean verify, boolean cleanInstallDir, boolean installToTopLevelDir)	Installs the specified PEAR package to the specified install location.

Methods inherited from class java.lang.Object

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

Field Detail

PEAR_MESSAGE_RESOURCE_BUNDLE

private static final java.lang.String PEAR_MESSAGE_RESOURCE_BUNDLE

See Also:

Constant Field Values

Constructor Detail

PackageInstaller

public PackageInstaller()

Method Detail

installPackage

public static PackageBrowser installPackage(java.io.File installDir,
                                            java.io.File pearPackage,
                                            boolean verify)
                                     throws PackageInstallerException

Installs the specified PEAR package to the specified install location. After the installation is completed, an optional installation verification step can be executed. This verification uses the main component descriptor to instantiate the UIMA resource, encapsulated in the PEAR package, and may run some additional tests, if applicable

Parameters:

installDir - PEAR package install location

pearPackage - PEAR package file location to install

verify - If true the PEAR package verification is done after the installation

Returns:

Returns a PackageBrowser object containing all PEAR package install settings

Throws:

PackageInstallerException - If an error occurred during the pear installation or verification.

installPackage

public static PackageBrowser installPackage(java.io.File installDir,
                                            java.io.File pearPackage,
                                            boolean verify,
                                            boolean cleanInstallDir)
                                     throws PackageInstallerException

Installs the specified PEAR package to the specified install location. After the installation is completed, an optional installation verification step can be executed. This verification uses the main component descriptor to instantiate the UIMA resource, encapsulated in the PEAR package, and may run some additional tests, if applicable

Parameters:

installDir - PEAR package install location

pearPackage - PEAR package file location to install

verify - If true the PEAR package verification is done after the installation

cleanInstallDir - If true, the target installation directory will be cleaned before the PEAR file is installed.

Returns:

Returns a PackageBrowser object containing all PEAR package install settings

Throws:

PackageInstallerException - If an error occurred during the pear installation or verification.

installPackage

public static PackageBrowser installPackage(java.io.File installDir,
                                            java.io.File pearPackage,
                                            boolean verify,
                                            boolean cleanInstallDir,
                                            boolean installToTopLevelDir)
                                     throws PackageInstallerException

Installs the specified PEAR package to the specified install location. After the installation is completed, an optional installation verification step can be executed. This verification uses the main component descriptor to instantiate the UIMA resource, encapsulated in the PEAR package, and may run some additional tests, if applicable.

Parameters:

installDir - PEAR package install location

pearPackage - PEAR package file location to install

verify - If true the PEAR package verification is done after the installation

cleanInstallDir - If true, the target installation directory will be cleaned before the PEAR file is installed.

installToTopLevelDir - If true, the PEAR is installed directly into the installDir. No intermediate directory with the component name is created. Defaults to false in the overloads of this method.

Returns:

Returns a PackageBrowser object containing all PEAR package install settings

Throws:

PackageInstallerException - If an error occurred during the pear installation or verification.