org.safs.install

Class ProductDetectorDefault

java.lang.Object

org.safs.install.ProductDetectorDefault

All Implemented Interfaces:

IProductDetector

public class ProductDetectorDefault
extends java.lang.Object
implements IProductDetector

This class ONLY provides implementation for

• getBins()
• getValidExecutable(File, String)

User NEEDS to implement the other methods to get it work.

Author:

Lei Wang

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	BIN 'bin' the sub-folder (relative to product home) holding executables
protected InstallerImpl.BIT_OPTION	productBit The product's bit, 32 or 64.

Constructor Summary

Constructors

Constructor and Description
ProductDetectorDefault()
ProductDetectorDefault(InstallerImpl.BIT_OPTION productBit)

Method Summary

Modifier and Type	Method and Description
java.lang.String	appendInstallDirOption(java.lang.String command, java.lang.String installDirectory) Append installation directory option to installer and uninstaller
java.lang.String	appendOptions(java.lang.String command, java.lang.String... options) Append options to installer and uninstaller
java.lang.String	appendSientOption(java.lang.String command) Append silent option to installer and uninstaller
boolean	deleteRegistry(java.lang.String keyPrefix, java.lang.String keySuffix, java.lang.String value) To delete the value from registry for path starting with #HKLM_ST According to product bit productBit, delete the registry's value.
java.lang.String	findUnInstaller(java.lang.String home)
java.lang.String[]	getBins() Return an array containing one sub folder 'bin'.
java.lang.String	getDefaultHome() Return null.
java.util.Map<java.lang.String,java.lang.String>	getHomes() Return an empty Map.
java.lang.String	getInstaller() Return null.
java.lang.String[]	getPossibleExecutables() Return an empty String array.
java.lang.String	getPreferredHome() Return null.
InstallerImpl.BIT_OPTION	getProductBit()
java.lang.String	getRegistryValue(java.lang.String keyPrefix, java.lang.String keySuffix, java.lang.String value) To get the value from registry for path starting with #HKLM_ST According to product bit productBit, get the registry's value.
java.lang.String	getUnInstaller() Return null.
java.io.File	getValidExecutable(java.io.File home, java.lang.String defaultExecutable) Implement the search logic suggested in the interface. 1.
void	setProductBit(InstallerImpl.BIT_OPTION productBit)

Methods inherited from class java.lang.Object

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

Field Detail

BIN

public static final java.lang.String BIN

'bin' the sub-folder (relative to product home) holding executables

See Also:

Constant Field Values

productBit

protected InstallerImpl.BIT_OPTION productBit

The product's bit, 32 or 64. The default is 64 bit.

Constructor Detail

ProductDetectorDefault

public ProductDetectorDefault()

ProductDetectorDefault

public ProductDetectorDefault(InstallerImpl.BIT_OPTION productBit)

Method Detail

getProductBit

public InstallerImpl.BIT_OPTION getProductBit()

Specified by:

getProductBit in interface IProductDetector

Returns:

BIT_OPTION, the bit (32 or 64) of the product to detect.

setProductBit

public void setProductBit(InstallerImpl.BIT_OPTION productBit)

Specified by:

setProductBit in interface IProductDetector

Parameters:

productBit - BIT_OPTION, the bit (32 or 64) of the product to detect.

getRegistryValue

public java.lang.String getRegistryValue(java.lang.String keyPrefix,
                                         java.lang.String keySuffix,
                                         java.lang.String value)

To get the value from registry for path starting with #HKLM_ST
According to product bit productBit, get the registry's value.

Parameters:

keyPrefix - String, the prefix of the registry path, such as 'HKLM\Software\'.

keySuffix - String, the suffix of the registry path, such as 'GPL Ghostscript\9.23'

value - String, the registry value, it can be "(Default)".

Returns:

String the value got from registry

deleteRegistry

public boolean deleteRegistry(java.lang.String keyPrefix,
                              java.lang.String keySuffix,
                              java.lang.String value)

To delete the value from registry for path starting with #HKLM_ST
According to product bit productBit, delete the registry's value.

Parameters:

keyPrefix - String, the prefix of the registry path, such as 'HKLM\Software\'.

keySuffix - String, the suffix of the registry path, such as 'GPL Ghostscript\9.23'

value - String, the registry value, it can be "(Default)".

Returns:

boolean true if the registry value has been successfully deleted.

getHomes

public java.util.Map<java.lang.String,java.lang.String> getHomes()

Return an empty Map.

Specified by:

getHomes in interface IProductDetector

Returns:

Map, a map containing pairs of (key, product_installation_full_path).
an empty map if non installation has been detected.

getPreferredHome

public java.lang.String getPreferredHome()

Return null.

Specified by:

getPreferredHome in interface IProductDetector

Returns:

String, the preferred product_installation_full_path if multiple products have been installed.
null if non product installation is detected.

getDefaultHome

public java.lang.String getDefaultHome()

Return null.

Specified by:

getDefaultHome in interface IProductDetector

Returns:

String, the default home directory to install the product

findUnInstaller

public java.lang.String findUnInstaller(java.lang.String home)
                                 throws java.io.FileNotFoundException

Specified by:

findUnInstaller in interface IProductDetector

Parameters:

home - String, the product's home directory

Returns:

String, the full path to the un-installer executable

Throws:

java.io.FileNotFoundException - if not found

appendSientOption

public java.lang.String appendSientOption(java.lang.String command)

Description copied from interface: IProductDetector

Append silent option to installer and uninstaller

Specified by:

appendSientOption in interface IProductDetector

appendInstallDirOption

public java.lang.String appendInstallDirOption(java.lang.String command,
                                               java.lang.String installDirectory)

Description copied from interface: IProductDetector

Append installation directory option to installer and uninstaller

Specified by:

appendInstallDirOption in interface IProductDetector

appendOptions

public java.lang.String appendOptions(java.lang.String command,
                                      java.lang.String... options)

Description copied from interface: IProductDetector

Append options to installer and uninstaller

Specified by:

appendOptions in interface IProductDetector

getInstaller

public java.lang.String getInstaller()

Return null.

Specified by:

getInstaller in interface IProductDetector

Returns:

String, the installer's file name, it might be different between 32 bits and 64 bits product.

getUnInstaller

public java.lang.String getUnInstaller()

Return null.

Specified by:

getUnInstaller in interface IProductDetector

Returns:

String, the un-installer's file name, it might be different between 32 bits and 64 bits product.

getBins

public java.lang.String[] getBins()

Return an array containing one sub folder 'bin'.

Specified by:

getBins in interface IProductDetector

Returns:

String[], an array of sub folder (relative to the product home) holding executables. An empty array if there is no possible value.

getPossibleExecutables

public java.lang.String[] getPossibleExecutables()

Return an empty String array.

Specified by:

getPossibleExecutables in interface IProductDetector

Returns:

String[], an array of "relative path" for possible executables (relative to the product home).
The first element is the most favorable; the last the least favorable.
An empty array if no executable is possible.

getValidExecutable

public java.io.File getValidExecutable(java.io.File home,
                                       java.lang.String defaultExecutable)
                                throws java.io.FileNotFoundException

Implement the search logic suggested in the interface.
1. find the default executable under product home
2. find the default executable under the getBins() sub folder of product home
3. find the getPossibleExecutables() under the product home

Specified by:

getValidExecutable in interface IProductDetector

Parameters:

home - File, the product home directory

defaultExecutable - String, the default executable. It could be name or "path relative to home".

Returns:

File, the valid executable

Throws:

java.io.FileNotFoundException - if no executable could be found

See Also:

ProductDetectorDefault