javax.microedition.swm

Class SuiteManagementTracker

java.lang.Object

javax.microedition.swm.SuiteManagementTracker

public class SuiteManagementTracker
extends java.lang.Object

An instance of this class is generated as soon as an installation or update of a Suite is started using SuiteInstaller.start(). Any of those operations creates a new tracker instance. Whether two trackers refer to the same Suite can be found out by calling getSuite() for both and compare the returned Suite instances. The tracker instance created for a management operation is passed to any call of SuiteListener.notifySuiteStateChanged in order to inform about the progress of this operation. For the installation of a new Suite, as long as the installation hasn't been successfully completed, an instance of SuiteManagementTracker is not assigned to any Suite instance yet as it does not exit yet. In this cases a call to getSuite() returns null. In case of an update, the tracker is assigned to the existing Suite from the beginning, though.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	SuiteManagementTracker() Protected constructor to prevent explicit creation of a SuiteManagementTracker.

Method Summary

Methods

Modifier and Type	Method and Description
Suite	getSuite() Returns the Suite instance this tracker is assigned to.

Methods inherited from class java.lang.Object

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

Constructor Detail

SuiteManagementTracker

protected SuiteManagementTracker()

Protected constructor to prevent explicit creation of a SuiteManagementTracker. Instances are only created as result of the SuiteInstaller.start() method for installation or update of a Suite.

Method Detail

getSuite

public Suite getSuite()

Returns the Suite instance this tracker is assigned to. In case of the installation of a new Suite, as long as the Suite has not been successfully installed yet, the value returned is always null. In case the tracker has been created for a suite update, it is the Suite instance of the existing suite.

The returned Suite instance has always the AVAILABLE and ENABLED suite state flag set to true, this can be changed using Suite.setSuiteStateFlag method afterwards.

Returns:

the Suite assigned to this tracker, or null if the tracker has been created for the installation of a new Suite as long as it has not been successfully installed yet