public interface AppInstaller extends SuiteInstaller
Modifier and Type | Method and Description |
---|---|
SuiteInfo |
initialize(java.lang.String locationUrl,
AppInstallerProgressListener listener)
Initializes an installer with an address of an resource where
an application descriptor or jar file can be found and installation
progress listener.
|
SuiteInfo |
initialize(java.lang.String locationUrl,
AppInstallerProgressListener listener,
boolean ignoreUpdateLock)
Initializes an installer with an address of an resource where
an application descriptor or jar file can be found and installation
progress listener.
|
SuiteInfo |
initialize(java.lang.String locationUrl,
byte[] iconBytes,
AppInstallerProgressListener listener)
Initializes an installer with an address of an resource where
an application descriptor or jar file can be found and installation
progress listener.
|
SuiteInfo |
initialize(java.lang.String jadUrl,
java.lang.String jarUrl,
AppInstallerProgressListener listener)
Initializes an installer with an address of an resource where
an application descriptor can be found, an URL of the
application body and installation progress listener.
|
SuiteInfo |
initialize(java.lang.String jadUrl,
java.lang.String jarUrl,
byte[] iconBytes,
AppInstallerProgressListener listener)
Initializes an installer with an address of an resource where
an application descriptor can be found, an URL of the
application body and installation progress listener.
|
SuiteInfo |
initialize(SuiteInfo suiteInfo,
AppInstallerProgressListener listener)
Initializes an installer with an Link object and installation
progress listener.
|
cancel, start
SuiteInfo initialize(java.lang.String locationUrl, AppInstallerProgressListener listener)
The function can result in network access for the application descriptor acquiring.
The installation progress listener must be present and ready to handle callback requests. It may be used for login/password querying.
locationUrl
- URL indicating the network location where
the jad/jar files can be retrieved fromlistener
- the installation progress listenerSuiteInfo
has no suite management methods implementation,
so calling to any of
SuiteInfo.getIcon()
,
SuiteInfo.remove()
,
SuiteInfo.getState()
,
SuiteInfo.setState(int state, boolean value)
or
SuiteInfo.getSettings()
method will result in
RuntimeException
.
If descriptor was not provided (locationUrl points to jar file) then
in returned SuiteInfo
all other methods except
com.sun.ams.SuiteInfo#.getDownloadUrl()
and
com.sun.ams.SuiteInfo#.getSuiteType()
are returning null values.java.lang.IllegalStateException
- if installer was already initializedSuiteInfo initialize(java.lang.String locationUrl, AppInstallerProgressListener listener, boolean ignoreUpdateLock)
The function can result in network access for the application descriptor acquiring.
The installation progress listener must be present and ready to handle callback requests. It may be used for login/password querying.
locationUrl
- URL indicating the network location where
the jad/jar files can be retrieved fromlistener
- the installation progress listenerignoreUpdateLock
- if true
the MIDlet suite
components will be updated even if lock for update is setignoreUpdateLock
- if true
then suite will be updated event
if it is locked for update. This option should be used with caution and
never initiated by user.SuiteInfo
has no suite management methods implementation,
so calling to any of
SuiteInfo.getIcon()
,
SuiteInfo.remove()
,
SuiteInfo.getState()
,
SuiteInfo.setState(int state, boolean value)
or
SuiteInfo.getSettings()
method will result in
RuntimeException
.
If descriptor was not provided (locationUrl points to jar file) then
in returned SuiteInfo
all other methods except
com.sun.ams.SuiteInfo#.getDownloadUrl()
and
com.sun.ams.SuiteInfo#.getSuiteType()
are returning null values.java.lang.IllegalStateException
- if installer was already initializedSuiteInfo initialize(java.lang.String locationUrl, byte[] iconBytes, AppInstallerProgressListener listener)
The function can result in network access for the application descriptor acquiring.
The installation progress listener must be present and ready to handle callback requests. It may be used for login/password querying.
locationUrl
- URL indicating the network location where
the jad/jar file can be retrieved fromlistener
- the installation progress listenericonBytes
- the icon to be associated with the installed Suite.SuiteInfo
has no suite management methods implementation,
so calling to any of
SuiteInfo.getIcon()
,
SuiteInfo.remove()
,
SuiteInfo.getState()
,
SuiteInfo.setState(int state, boolean value)
or
SuiteInfo.getSettings()
method will result in
RuntimeException
.
If descriptor was not provided (locationUrl points to jar file) then
in returned SuiteInfo
all other methods except
com.sun.ams.SuiteInfo#.getDownloadUrl()
and
com.sun.ams.SuiteInfo#.getSuiteType()
are returning null values.java.lang.IllegalStateException
- if installer was already initializedSuiteInfo initialize(java.lang.String jadUrl, java.lang.String jarUrl, AppInstallerProgressListener listener)
The function is intended to use for installation from local storage but is not limited by such use case.
The function can result in network access for the application descriptor acquiring.
The AppInstallerProgressListener must be present and ready to handle callback requests. It may be used for login/password querying.
jadUrl
- the address where to find the application descriptorjarUrl
- the address where to find the application jar file
(is ignored currently)listener
- the installation progress listenerSuiteInfo
has no suite management methods implementation,
so calling to any of
SuiteInfo.getIcon()
,
SuiteInfo.remove()
,
SuiteInfo.getState()
,
SuiteInfo.setState(int state, boolean value)
or
SuiteInfo.getSettings()
method will result in
RuntimeException
.java.lang.IllegalStateException
- if installer was already initializedSuiteInfo initialize(java.lang.String jadUrl, java.lang.String jarUrl, byte[] iconBytes, AppInstallerProgressListener listener)
The function is intended to use for installation from local storage but is not limited by such use case.
The function can result in network access for the application descriptor acquiring.
The AppInstallerProgressListener must be present and ready to handle callback requests. It may be used for login/password querying.
jadUrl
- the address where to find the application descriptorjarUrl
- the address where to find the application jar file
(is ignored currently)iconBytes
- the icon to be associated with the installed Suite.listener
- the installation progress listenerSuiteInfo
has no suite management methods implementation,
so calling to any of
SuiteInfo.getIcon()
,
SuiteInfo.remove()
,
SuiteInfo.getState()
,
SuiteInfo.setState(int state, boolean value)
or
SuiteInfo.getSettings()
method will result in
RuntimeException
.java.lang.IllegalStateException
- if installer was already initializedSuiteInfo initialize(SuiteInfo suiteInfo, AppInstallerProgressListener listener) throws UnsupportedServiceException
The function can result in network access.
The AppInstallerProgressListener must be present and ready to handle callback requests. It may be used for login/password querying.
NB: this functionality is not supported yet
(throws UnsupportedServiceException
)
suiteInfo
- the SuiteInfo for Suite Link for which MIDlet Suite
should be installedlistener
- the installation progress listenerSuiteInfo
has no suite management methods implementation,
so calling to any of
SuiteInfo.getIcon()
,
SuiteInfo.remove()
,
SuiteInfo.getState()
,
SuiteInfo.setState(int state, boolean value)
or
SuiteInfo.getSettings()
method will result in
RuntimeException
.UnsupportedServiceException
- always, as this
functionality is not supported currentlyjava.lang.IllegalStateException
- if installer was already initializedCopyright (c) 1990, 2013, Oracle and/or its affiliates. All rights reserved.