install4j API

com.install4j.api.beaninfo
Class ActionBeanInfo

java.lang.Object
  extended by java.beans.SimpleBeanInfo
      extended by com.install4j.api.beaninfo.Install4JBeanInfo
          extended by com.install4j.api.beaninfo.ActionBeanInfo
All Implemented Interfaces:
java.beans.BeanInfo

public abstract class ActionBeanInfo
extends Install4JBeanInfo

Base class for bean infos of actions classes.

Using this class is not strictly required. In principle, you could also set values for the ATTRIBUTE_* constants in the bean descriptor of an unrelated bean info class.


Field Summary
static java.lang.String ATTRIBUTE_ASSOCIATED_CONFIRMATION
           
static java.lang.String ATTRIBUTE_ASSOCIATED_CONFIRMATION_INIT_SCRIPT
           
static java.lang.String ATTRIBUTE_ASSOCIATED_SCREEN
           
static java.lang.String ATTRIBUTE_ASSOCIATED_STARTUP_ACTION
           
static java.lang.String ATTRIBUTE_ASSOCIATED_STARTUP_ACTION_INSTALLER_AND_UNINSTALLER
           
static java.lang.String ATTRIBUTE_DEFAULT_ERROR_MESSAGE
           
static java.lang.String ATTRIBUTE_DEFAULT_FAILURE_STRATEGY
           
static java.lang.String ATTRIBUTE_INSTALLER_TARGET_SCREEN
           
static java.lang.String ATTRIBUTE_UNINSTALLER_TARGET_SCREEN
           
 
Fields inherited from class com.install4j.api.beaninfo.Install4JBeanInfo
ATTRIBUTE_BEAN_CATEGORY, ATTRIBUTE_BEAN_INITIALIZER, ATTRIBUTE_BEAN_VALIDATOR, ATTRIBUTE_COLLAPSED_PROPERTY_CATEGORIES, ATTRIBUTE_CUSTOMIZER_PLACEMENT, ATTRIBUTE_DEFAULT_CONDITION_EXPRESSION, ATTRIBUTE_DEFAULT_ROLLBACK_BARRIER, ATTRIBUTE_ENUMERATION_MAPPERS, ATTRIBUTE_ICON_16x16, ATTRIBUTE_ICON_24x24, ATTRIBUTE_INSTALLED_FILES_REQUIRED, ATTRIBUTE_MINIMUM_JAVA_VERSION, ATTRIBUTE_MULTIPLE_INSTANCES_SUPPORTED, ATTRIBUTE_PERSISTENCE_DELEGATE_MAP, ATTRIBUTE_SEQUENCE_VALIDATOR, ATTRIBUTE_SORT_KEY
 
Fields inherited from interface java.beans.BeanInfo
ICON_COLOR_16x16, ICON_COLOR_32x32, ICON_MONO_16x16, ICON_MONO_32x32
 
Constructor Summary
protected ActionBeanInfo(java.lang.String displayName, java.lang.String shortDescription, java.lang.String category, boolean multipleInstancesSupported, boolean installedFilesRequired, java.lang.Integer sortKey, java.lang.Class beanClass)
          Same as ActionBeanInfo(String, String, String, boolean, boolean, Integer, Class, Class) with a customizer class of null.
protected ActionBeanInfo(java.lang.String displayName, java.lang.String shortDescription, java.lang.String category, boolean multipleInstancesSupported, boolean installedFilesRequired, java.lang.Integer sortKey, java.lang.Class beanClass, java.lang.Class customizerClass)
          Same as Install4JBeanInfo.Install4JBeanInfo(String, String, String, boolean, boolean, Integer, Class, Class)
 
Method Summary
 void setAssociatedConfirmation(java.lang.String confirmationDescription, java.lang.String initScript)
          Configures an associated confirmation.
 void setAssociatedScreen(java.lang.String className)
          Configures an associated screen.
 void setAssociatedStartupAction(java.lang.String className, boolean installerAndUninstaller)
          Configures an associated startup action.
 void setDefaultErrorMessage(java.lang.String errorMessage)
          Configures the default error message for the action.
 void setDefaultFailureStrategy(FailureStrategy failureStrategy)
          Configures the default failure strategy for the action.
 void setInstallerTargetScreen(java.lang.String className)
          Configures a target screen for the installer.
 void setUninstallerTargetScreen(java.lang.String className)
          Configures a target screen for the uninstaller.
 
Methods inherited from class com.install4j.api.beaninfo.Install4JBeanInfo
addPropertyDescriptor, checkNotEmpty, checkNotEmpty, findPropertyDescriptor, getBeanClass, getBeanDescriptor, getPropertyDescriptors, getPropertyValue, isEmpty, setBeanInitializer, setBeanValidator, setCollapsedPropertyCategories, setCustomizerPlacement, setDefaultConditionExpression, setDefaultRollbackBarrier, setEnumerationMappers, setIcons, setMinimumJavaVersion, setPersistenceDelegateMap, setSequenceValidator
 
Methods inherited from class java.beans.SimpleBeanInfo
getAdditionalBeanInfo, getDefaultEventIndex, getDefaultPropertyIndex, getEventSetDescriptors, getIcon, getMethodDescriptors, loadImage
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

ATTRIBUTE_ASSOCIATED_CONFIRMATION

public static final java.lang.String ATTRIBUTE_ASSOCIATED_CONFIRMATION
See Also:
setAssociatedConfirmation(String, String), Constant Field Values

ATTRIBUTE_ASSOCIATED_CONFIRMATION_INIT_SCRIPT

public static final java.lang.String ATTRIBUTE_ASSOCIATED_CONFIRMATION_INIT_SCRIPT
See Also:
setAssociatedConfirmation(String, String), Constant Field Values

ATTRIBUTE_ASSOCIATED_SCREEN

public static final java.lang.String ATTRIBUTE_ASSOCIATED_SCREEN
See Also:
setAssociatedScreen(String), Constant Field Values

ATTRIBUTE_INSTALLER_TARGET_SCREEN

public static final java.lang.String ATTRIBUTE_INSTALLER_TARGET_SCREEN
See Also:
setInstallerTargetScreen(String), Constant Field Values

ATTRIBUTE_UNINSTALLER_TARGET_SCREEN

public static final java.lang.String ATTRIBUTE_UNINSTALLER_TARGET_SCREEN
See Also:
setUninstallerTargetScreen(String), Constant Field Values

ATTRIBUTE_ASSOCIATED_STARTUP_ACTION

public static final java.lang.String ATTRIBUTE_ASSOCIATED_STARTUP_ACTION
See Also:
setAssociatedStartupAction(String, boolean), Constant Field Values

ATTRIBUTE_ASSOCIATED_STARTUP_ACTION_INSTALLER_AND_UNINSTALLER

public static final java.lang.String ATTRIBUTE_ASSOCIATED_STARTUP_ACTION_INSTALLER_AND_UNINSTALLER
See Also:
ATTRIBUTE_ASSOCIATED_STARTUP_ACTION_INSTALLER_AND_UNINSTALLER, Constant Field Values

ATTRIBUTE_DEFAULT_FAILURE_STRATEGY

public static final java.lang.String ATTRIBUTE_DEFAULT_FAILURE_STRATEGY
See Also:
ATTRIBUTE_DEFAULT_FAILURE_STRATEGY, Constant Field Values

ATTRIBUTE_DEFAULT_ERROR_MESSAGE

public static final java.lang.String ATTRIBUTE_DEFAULT_ERROR_MESSAGE
See Also:
ATTRIBUTE_DEFAULT_ERROR_MESSAGE, Constant Field Values
Constructor Detail

ActionBeanInfo

protected ActionBeanInfo(java.lang.String displayName,
                         java.lang.String shortDescription,
                         java.lang.String category,
                         boolean multipleInstancesSupported,
                         boolean installedFilesRequired,
                         java.lang.Integer sortKey,
                         java.lang.Class beanClass,
                         java.lang.Class customizerClass)
Same as Install4JBeanInfo.Install4JBeanInfo(String, String, String, boolean, boolean, Integer, Class, Class)


ActionBeanInfo

protected ActionBeanInfo(java.lang.String displayName,
                         java.lang.String shortDescription,
                         java.lang.String category,
                         boolean multipleInstancesSupported,
                         boolean installedFilesRequired,
                         java.lang.Integer sortKey,
                         java.lang.Class beanClass)
Same as ActionBeanInfo(String, String, String, boolean, boolean, Integer, Class, Class) with a customizer class of null.

Method Detail

setAssociatedConfirmation

public void setAssociatedConfirmation(java.lang.String confirmationDescription,
                                      java.lang.String initScript)
Configures an associated confirmation. If the user adds the action, the install4j GUI will ask the user whether to add a question to the associated screen, if the screen is a form screen or to the "Additional confirmation" screen otherwise. The form screen will receive a check box form component with a variable name equal to the simple class name of the action. The condition expression of the action will be set to context.getBooleanVariable("variableName") so that the confirmation and the execution of the action are automatically wired together.

If the initScript parameter is not null and the user accepts the addition of the confirmation, the "Initialization script" property of the check box form component is set to initScript.

Parameters:
confirmationDescription - the message of the confirmation
initScript - the init script
See Also:
ATTRIBUTE_ASSOCIATED_CONFIRMATION, ATTRIBUTE_ASSOCIATED_CONFIRMATION_INIT_SCRIPT

setAssociatedScreen

public void setAssociatedScreen(java.lang.String className)
Configures an associated screen. If set, and the user adds the action, the install4j GUI checks if an instance of the specified class is present in the list of configured screens. If not, it will ask the user whether to add such a screen.

Parameters:
className - the class name of the associated screen
See Also:
ATTRIBUTE_ASSOCIATED_SCREEN

setInstallerTargetScreen

public void setInstallerTargetScreen(java.lang.String className)
Configures a target screen for the installer. If set, and the user adds the action, the install4j GUI checks if the current screen is an instance of the specified class. If not, it will ask the user whether the action should rather be added to the target screen, adding that screen if it is not present in the list of configured screens.

Parameters:
className - the class name of the target screen
See Also:
ATTRIBUTE_INSTALLER_TARGET_SCREEN

setUninstallerTargetScreen

public void setUninstallerTargetScreen(java.lang.String className)
Configures a target screen for the uninstaller. If set, and the user adds the action, the install4j GUI checks if the current screen is an instance of the specified class. If not, it will ask the user whether the action should rather be added to the target screen, adding that screen if it is not present in the list of configured screens.

Parameters:
className - the class name of the target screen
See Also:
ATTRIBUTE_UNINSTALLER_TARGET_SCREEN

setAssociatedStartupAction

public void setAssociatedStartupAction(java.lang.String className,
                                       boolean installerAndUninstaller)
Configures an associated startup action. If set, and the user adds the action, the install4j GUI checks if the startup screen contains an action of the specified class. If not, it will ask the user whether the action of that class should be added to the startup screen.

Parameters:
className - the class name of the associated startup action
installerAndUninstaller - if the startup action should be added for both the installer and uninstaller or for the installer only
See Also:
ATTRIBUTE_ASSOCIATED_STARTUP_ACTION, ATTRIBUTE_ASSOCIATED_STARTUP_ACTION_INSTALLER_AND_UNINSTALLER

setDefaultFailureStrategy

public void setDefaultFailureStrategy(FailureStrategy failureStrategy)
Configures the default failure strategy for the action.

Parameters:
failureStrategy - the default failure strategy
See Also:
ATTRIBUTE_DEFAULT_FAILURE_STRATEGY

setDefaultErrorMessage

public void setDefaultErrorMessage(java.lang.String errorMessage)
Configures the default error message for the action.

Parameters:
errorMessage - the default error message
See Also:
ATTRIBUTE_DEFAULT_ERROR_MESSAGE

install4j API