org.safs.install

Class GhostScriptInstaller

java.lang.Object

org.safs.install.InstallerImpl

org.safs.install.GhostScriptInstaller

All Implemented Interfaces:

InstallerInterface, DebugListener, NamedListener

public class GhostScriptInstaller
extends InstallerImpl
implements DebugListener

Install/Uninstall GhostScript.

Author:

Lei Wang

Nested Class Summary

Nested classes/interfaces inherited from class org.safs.install.InstallerImpl

InstallerImpl.BIT_OPTION, InstallerImpl.VERSION_OPTION

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	CURRENT_VERSION 9.23 current install version
static java.lang.String	ENV_GS_DLL GS_DLL the environment to keep the path of ghostscript dll
static java.lang.String	ENV_GS_LIB GS_LIB the environment to keep the path of ghostscript library files
static java.lang.String	ENV_HOME GS_HOME the environment to keep the product installation path
protected org.safs.install.GhostScriptInstaller.ProductDetectorGhostScript	myProductDetector A convenient product detector of ghostscript.
static java.lang.String	PRODUCT_NAME GHOSTSCRIPT
static java.lang.String[]	SUPPORTED_VERSION [CURRENT_VERSION, ...
static java.lang.String	TITLE GHOSTSCRIPT INSTALLATION

Fields inherited from class org.safs.install.InstallerImpl

ARG_DEBUG, ARG_INSTALLDIR, ARG_SAFS_DIR, ARG_SILENT, ARG_UNINSTALL, ARG_VERBOSE, debug, DIR_BIN, DIR_INSTALL, DIR_SAFS_HOME_DEFAULT, home, PARAM_SWITCH, PARAM_USE_LATEST_VERSION, productDetector, progresser, REGSVR32, rootdir, s, safsHome, silent, SYSTEM32, SYSWOW64, verbose

Constructor Summary

Constructors

Constructor and Description
GhostScriptInstaller(ProgressIndicator progresser, java.lang.String safsHome)
GhostScriptInstaller(ProgressIndicator progresser, java.lang.String safsHome, java.lang.String home)
GhostScriptInstaller(ProgressIndicator progresser, java.lang.String safsHome, java.lang.String home, boolean silent, boolean verbose, boolean debug)

Method Summary

Modifier and Type	Method and Description
protected java.lang.String	envHome()
protected IProductDetector	getDefaultProductDetector()
java.lang.String	getListenerName() Unique name to identify the listener.
protected java.lang.String	getProductName()
protected IProductDetector	getUnixProductDetector()
protected IProductDetector	getWindowsProductDetector()
protected void	initilizeProductDetector() Initialize the IProdcutDetector object according to the Operation System. A ProductDetectorDefault will be returned if the OS is not Windows or UNIX/LINUX.
boolean	install(java.lang.String... optionals) Install both 32-bit and 64-bit ghostscript. Add bin directory to the PATH environment. See Install ghostscript.
static void	main(java.lang.String[] args) Main Java executable.
void	onReceiveDebug(java.lang.String message) A remote client has sent a Debug message to be logged by the listener.
boolean	uninstall(java.lang.String... args) UnInstall the all installed ghostscript. Clear the HOME environment. Clear the PATH environment. Clear the Registry. See Install ghostscript.

Methods inherited from class org.safs.install.InstallerImpl

appendSystemEnvironment, findInstaller, getDefaultHome, getEnvValue, getHome, getInstallationRoot, getInstallerDir, getRegistryValue, getSafsHome, hasRegistryEntry, increaseProgress, prependSystemEnvironment, removeSystemEnvironmentSubstring, removeSystemEnvironmentSubstringContaining, setEnvironment, setEnvValue, setHome, setProgress, setProgressIndicator, setProgressMessage, setProgressMessage, setRegistryValue, setSafsHome

Methods inherited from class java.lang.Object

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

Field Detail

PRODUCT_NAME

public static final java.lang.String PRODUCT_NAME

GHOSTSCRIPT

See Also:

Constant Field Values

ENV_HOME

public static final java.lang.String ENV_HOME

GS_HOME the environment to keep the product installation path

See Also:

Constant Field Values

ENV_GS_DLL

public static final java.lang.String ENV_GS_DLL

GS_DLL the environment to keep the path of ghostscript dll

See Also:

Constant Field Values

ENV_GS_LIB

public static final java.lang.String ENV_GS_LIB

GS_LIB the environment to keep the path of ghostscript library files

See Also:

Constant Field Values

TITLE

public static final java.lang.String TITLE

GHOSTSCRIPT INSTALLATION

See Also:

Constant Field Values

CURRENT_VERSION

public static final java.lang.String CURRENT_VERSION

9.23 current install version

See Also:

Constant Field Values

SUPPORTED_VERSION

public static final java.lang.String[] SUPPORTED_VERSION

[CURRENT_VERSION, ... ] an array of supported version, CURRENT_VERSION should always be put at the first position

myProductDetector

protected org.safs.install.GhostScriptInstaller.ProductDetectorGhostScript myProductDetector

A convenient product detector of ghostscript. It is cast from super class field InstallerImpl.productDetector.

See Also:

initilizeProductDetector()

Constructor Detail

GhostScriptInstaller

public GhostScriptInstaller(ProgressIndicator progresser,
                            java.lang.String safsHome)

GhostScriptInstaller

public GhostScriptInstaller(ProgressIndicator progresser,
                            java.lang.String safsHome,
                            java.lang.String home)

GhostScriptInstaller

public GhostScriptInstaller(ProgressIndicator progresser,
                            java.lang.String safsHome,
                            java.lang.String home,
                            boolean silent,
                            boolean verbose,
                            boolean debug)

Method Detail

getListenerName

public java.lang.String getListenerName()

Description copied from interface: NamedListener

Unique name to identify the listener.

Specified by:

getListenerName in interface NamedListener

Returns:

name of listener. Might be null.

onReceiveDebug

public void onReceiveDebug(java.lang.String message)

Description copied from interface: DebugListener

A remote client has sent a Debug message to be logged by the listener.

Specified by:

onReceiveDebug in interface DebugListener

getProductName

protected java.lang.String getProductName()

Overrides:

getProductName in class InstallerImpl

envHome

protected java.lang.String envHome()

Returns:

String, the environment name to store the home directory of this product

install

public boolean install(java.lang.String... optionals)

Install both 32-bit and 64-bit ghostscript.
Add bin directory to the PATH environment.
See Install ghostscript.

Specified by:

install in interface InstallerInterface

uninstall

public boolean uninstall(java.lang.String... args)

UnInstall the all installed ghostscript.
Clear the HOME environment.
Clear the PATH environment.
Clear the Registry.
See Install ghostscript.

Specified by:

uninstall in interface InstallerInterface

initilizeProductDetector

protected void initilizeProductDetector()
                                 throws java.lang.UnsupportedOperationException

Description copied from class: InstallerImpl

Initialize the IProdcutDetector object according to the Operation System.
A ProductDetectorDefault will be returned if the OS is not Windows or UNIX/LINUX.

Overrides:

initilizeProductDetector in class InstallerImpl

Throws:

java.lang.UnsupportedOperationException

getDefaultProductDetector

protected IProductDetector getDefaultProductDetector()

Overrides:

getDefaultProductDetector in class InstallerImpl

Returns:

ProductDetectorDefault

See Also:

ProductDetectorDefault

getWindowsProductDetector

protected IProductDetector getWindowsProductDetector()
                                              throws java.lang.UnsupportedOperationException

Overrides:

getWindowsProductDetector in class InstallerImpl

Throws:

java.lang.UnsupportedOperationException

getUnixProductDetector

protected IProductDetector getUnixProductDetector()
                                           throws java.lang.UnsupportedOperationException

Overrides:

getUnixProductDetector in class InstallerImpl

Throws:

java.lang.UnsupportedOperationException

main

public static void main(java.lang.String[] args)

Main Java executable. Primarily to run standalone outside of a larger process.

%SELENIUM_PLUS%\jre\bin\java org.safs.install.GhostScriptInstaller -safs safsHome [-u] [-installdir home] [-silent] [-v] [-debug]

Parameters:

args -
-safs safsHome required, is the SAFS/SeleniumPlus directory, its sub-folder 'install' holds the installer (executable) to install the product.
-installdir home NOT SUPPORTED YET optional, is the directory where the product will be installed to or un-installed from.
if not provided, then the InstallerImpl.getDefaultHome() will be used to get the directory from system environment.
-u optional, means to un-install the product; if not provided, then install the product.
-debug optional, means in debug mode, default is false
-silent optional, means in silent mode, default is true
-v optional, means in verbose mode, default is false

example:
%SELENIUM_PLUS%\jre\bin\java org.safs.install.GhostScriptInstaller -safs c:\SeleniumPlus
%SELENIUM_PLUS%\jre\bin\java org.safs.install.GhostScriptInstaller -safs c:\SeleniumPlus -u

System.exit(0) on perceived success.
System.exit(-1) on perceived failure.
System.exit(-2) on any un-expected exception.

See Also:

SilentInstaller