com.sun.ams
Interface AppInstallerProgressListener

All Superinterfaces:

SuiteInstallerProgressListener

public interface AppInstallerProgressListener
extends SuiteInstallerProgressListener

Field Summary

Fields inherited from interface com.sun.ams.SuiteInstallerProgressListener

DOWNLOADING_BODY, DOWNLOADING_DATA, DOWNLOADING_DESCRIPTOR, STORING, VERIFYING

Method Summary

boolean	confirmAuthPath(java.lang.String[] authPath) Ask the user to confirm the authentication path.
boolean	confirmCertificateImport(Certificate cert) Called to ask the user to confirm that a certificate the MIDlet suite is signed with may imported into the internal keystore.
boolean	confirmCurrentScreenSaverUnset(java.lang.String name) Called then current screen saver is no longer available in new version of installed test suite
boolean	confirmCurrentScreenSaverUpdate(java.lang.String name) Called then current screen saver MIDlet is being updated by new version of screen saver MIDlet
boolean	confirmGrantMaximumPermissions(java.util.Vector groupNames, boolean hasRisks) Ask the user during installation or update if he wants to grant maximum permissions allowed by MIDP specification to the MIDlet suite.
boolean	confirmInstallUnverified() Called to ask the user to confirm that the MIDlet suite not passing verification due to unknown CA may be installed as untrusted.
boolean	confirmJarDownload(int totalSize) Called with the application description so the user can be asked to confirm the jar download.
boolean	confirmPersistentSuiteInstallation() Called to aks the user to confirm that the permanent MIDlet suite installation can proceed, and that the user will not be able to delete the MIDlet suite after installation.
boolean	confirmRedirect(java.lang.String newLocation) Called with the URL where the request is attempted to be redirected so the user can be asked to confirm if he really wants to install from the new location.
boolean	confirmUnsignedFxInstall() Called with the current state of the install so the user can be asked to confirm the unsigned JavaFX application install.
boolean	confirmUpdate(int status) Called to ask the user about update of already installed application.
java.lang.String[]	getNetworkAccessCredentials() Called to ask user for login and password for network access.
java.lang.String[]	getResourceAccessCredentials() Called to ask user for login and password for network resource access.
java.lang.String	getRmsDecryptionPassword() Called to ask user for RMS decryption password.
java.lang.String	getRmsEncryptionPassword() Called to ask user for RMS encryption password.
boolean	keepRMS() Called to ask the user to confirm if the RMS data should be kept for new version of an updated suite.

Methods inherited from interface com.sun.ams.SuiteInstallerProgressListener

done, updateStatus

Method Detail

getNetworkAccessCredentials

java.lang.String[] getNetworkAccessCredentials()

Called to ask user for login and password for network access.

Typically the function is used to ask login/password for proxy authorization. If authorization with the returned credentials fails then this function will be called again. This function may cancel the installation by returning null. NB: For access to .jar and .jad files the same credentials are used. In case the credentials provides for .jad file differ from .jar file this method will be called once again

Returns:

String[] the string array where first element is login and password is the second one or null to stop the installation (will result in InstallerErrorCodes.CANCELED error code in the corresponding SuiteInstallerProgressListener.done(int errorCode) call).

getResourceAccessCredentials

java.lang.String[] getResourceAccessCredentials()

Called to ask user for login and password for network resource access. If authorization with the returned credentials fails then this function will be called again. This function may cancel the installation by returning null.

Returns:

String[] the string array where first element is login and password is the second one or null to stop the installation (will result in InstallerErrorCodes.CANCELED error code in the corresponding SuiteInstallerProgressListener.done(int errorCode) call).

confirmUpdate

boolean confirmUpdate(int status)

Called to ask the user about update of already installed application.

Parameters:

status - is equal to one of the following values depending on installing suite version: InstallerErrorCodes.OLD_VERSION InstallerErrorCodes.ALREADY_INSTALLED InstallerErrorCodes.NEW_VERSION

Returns:

true if the user wants to continue, false to stop the installation (will result in InstallerErrorCodes.CANCELED error code in the corresponding SuiteInstallerProgressListener.done(int errorCode) call)

confirmJarDownload

boolean confirmJarDownload(int totalSize)

Called with the application description so the user can be asked to confirm the jar download.

Parameters:

totalSize - the expected size of data will be downloaded. Dynamic components and RMS are included as well.

Returns:

true if the user wants to continue, false to stop the installation (will result in InstallerErrorCodes.CANCELED error code in the corresponding SuiteInstallerProgressListener.done(int errorCode) call)

keepRMS

boolean keepRMS()

Called to ask the user to confirm if the RMS data should be kept for new version of an updated suite.

Returns:

true if the user wants to keep the RMS data for the next suite or false otherwise

confirmAuthPath

boolean confirmAuthPath(java.lang.String[] authPath)

Ask the user to confirm the authentication path.

Parameters:

authPath - the authorization path.

Returns:

true if the user wants to continue, false to stop the installation (will result in InstallerErrorCodes.CANCELED error code in the corresponding SuiteInstallerProgressListener.done(int errorCode) call)

confirmRedirect

boolean confirmRedirect(java.lang.String newLocation)

Called with the URL where the request is attempted to be redirected so the user can be asked to confirm if he really wants to install from the new location.

Parameters:

newLocation - new url of the resource to install.

Returns:

true if the user wants to continue, false to stop the installation (will result in InstallerErrorCodes.CANCELED error code in the corresponding SuiteInstallerProgressListener.done(int errorCode) call)

confirmUnsignedFxInstall

boolean confirmUnsignedFxInstall()

Called with the current state of the install so the user can be asked to confirm the unsigned JavaFX application install.

Returns:

true if the user wants to continue, false to stop the installation (will result in InstallerErrorCodes.CANCELED error code in the corresponding SuiteInstallerProgressListener.done(int errorCode) call)

confirmGrantMaximumPermissions

boolean confirmGrantMaximumPermissions(java.util.Vector groupNames,
                                       boolean hasRisks)

Ask the user during installation or update if he wants to grant maximum permissions allowed by MIDP specification to the MIDlet suite.

Parameters:

groupNames - names of permission groups matching to the permissions requested by this suite in it's JAD/JAR

hasRisks - true if groupNames will contain high risk combinations in case of the function groups are all set to BLANKET

Returns:

true if the user wants to grant maximum permissions, false to skip

confirmCurrentScreenSaverUpdate

boolean confirmCurrentScreenSaverUpdate(java.lang.String name)

Called then current screen saver MIDlet is being updated by new version of screen saver MIDlet

Parameters:

name - the name of the screen saver MIDlet

Returns:

true if the user wants to continue, false to stop the installation (will result in InstallerErrorCodes.CANCELED error code in the corresponding SuiteInstallerProgressListener.done(int errorCode) call)

confirmCurrentScreenSaverUnset

boolean confirmCurrentScreenSaverUnset(java.lang.String name)

Called then current screen saver is no longer available in new version of installed test suite

Parameters:

name - the name of the screen saver MIDlet

Returns:

true if the user wants to continue, false to stop the installation (will result in InstallerErrorCodes.CANCELED error code in the corresponding SuiteInstallerProgressListener.done(int errorCode) call)

confirmPersistentSuiteInstallation

boolean confirmPersistentSuiteInstallation()

Called to aks the user to confirm that the permanent MIDlet suite installation can proceed, and that the user will not be able to delete the MIDlet suite after installation.

Returns:

true if the user wants to continue, false to stop the installation (will result in InstallerErrorCodes.CANCELED error code in the corresponding SuiteInstallerProgressListener.done(int errorCode) call)

getRmsEncryptionPassword

java.lang.String getRmsEncryptionPassword()

Called to ask user for RMS encryption password.

Returns:

RMS encryption password

getRmsDecryptionPassword

java.lang.String getRmsDecryptionPassword()

Called to ask user for RMS decryption password.

Returns:

RMS decryption password

confirmInstallUnverified

boolean confirmInstallUnverified()

Called to ask the user to confirm that the MIDlet suite not passing verification due to unknown CA may be installed as untrusted. Note: this functionality is optional and may absent in some configurations.

Returns:

true if the user wants to continue, false to stop the installation (will result in InstallerErrorCodes.CANCELED error code in the corresponding SuiteInstallerProgressListener.done(int errorCode) call)

confirmCertificateImport

boolean confirmCertificateImport(Certificate cert)

Called to ask the user to confirm that a certificate the MIDlet suite is signed with may imported into the internal keystore. Note: this functionality is optional and may absent in some configurations.

Parameters:

cert - the certificate to import

Returns:

true if the user wants to import the certificate, false to skip