public class SuiteInstaller
extends java.lang.Object
Modifier and Type | Method and Description |
---|---|
void |
addInstallationListener(SuiteInstallListener listener)
Adds an
SuiteInstallListener to this suite installer. |
void |
cancel()
Cancel the installation.
|
void |
removeInstallationListener(SuiteInstallListener listener)
Removes an
SuiteInstallListener from this suite installer. |
SuiteManagementTracker |
start()
Begins installation of the suite.
|
public void addInstallationListener(SuiteInstallListener listener)
SuiteInstallListener
to this suite installer.
The installed listener implements the SuiteInstallListener
interface. There is no limitation to add SuiteInstallListeners
.listener
- the installation progress listener to be addedpublic void removeInstallationListener(SuiteInstallListener listener)
SuiteInstallListener
from this suite installer.listener
- the installation progress listener to be removedpublic SuiteManagementTracker start()
An SuiteInstallListener
must be assigned and ready
in order to handle callback requests.
This method returns immediately an instance of SuiteManagementTracker
;
the caller can observe the progress of the installation via the
SuiteInstallListener
added. Please not that "immediately"
not necessarily means "fast". Depending on the provisioning
mechanism used in the implementation of MEEP 8, it may be necessary
to download the whole jar data first in order to inspect the manifest
of the application suite in order to find out whether this is a new
installation or an update of an existing application suite. Depending
on the network connection this may take some time.
In case the previous attempt to install this suite (initiated by a
previous call of the start()
method) has not been finished
at the time the new call takes place, the call is queued and the new
attempt to install (in case the first one failed) or the re-installation
(in case the first call was successful), respectively, starts as soon
as the first installation attempt or installation has been finished.
A new instance of SuiteManagementTracker
will be created for
every call to this method and assigned to the Suite
to be installed
as soon as the installation has been completed successfully in case of a
new Suite
. In case of an update of an existing Suite
,
the SuiteManagementTracker
instance is assigned to the
existing Suite
object from the beginning.
If the initiating application does not have the right SWMPermission
,
the installation will fail with InstallErrorCodes.UNAUTHORIZED_INSTALL
.
public void cancel()
If installation is not in progress this method has no effect.
Copyright (c) 2014, Oracle and/or its affiliates. All rights reserved. Use of this specification is subject to license terms.