javax.microedition.midlet
Class MIDletIdentity

java.lang.Object
  javax.microedition.midlet.MIDletIdentity

public final class MIDletIdentity
extends java.lang.Object

This class represents the identity of a MIDlet. The identity is used in Inter-MIDlet Communication and by javax.microedition.event. The implementation is responsible for creating instances of MIDletIdentity, and creationof MIDletIdentity instances is restricted. MIDlets should not attempt to create instances of .

This class provides identity information for a specific MIDlet including suite name, vendor, version, secuity domain, and if the MIDlet has been granted authorization to the current runtime execution environment using application level access authorization.

Since:

MIDP 3.0

Field Summary

static java.lang.String	IDENTIFIED_THIRD_PARTY Constant for the Identified Third Party domain.
static java.lang.String	MANUFACTURER Constant for the Manufacturer domain.
static java.lang.String	OPERATOR Constant for the Operator domain.
static java.lang.String	UNIDENTIFIED_THIRD_PARTY Constant for the Unidentified Third Party domain.

Method Summary

java.lang.String	getName() Get the name of the MIDlet
java.lang.String	getSecurityDomain() Get the name of the security domain for the MIDlet associated with the specified MIDletIdentity.
java.lang.String	getVendor() Get vendor name of the MIDlet
java.lang.String	getVersion() Get version of the MIDlet
boolean	isAuthorized() Checks whether the MIDlet associated with the specified MIDletIdentity is authorized to the current MIDlet's runtime execution environment via application level access authorization.
java.lang.String	toString() Returns the string representation of this MIDletIdentity.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

MANUFACTURER

public static final java.lang.String MANUFACTURER

Constant for the Manufacturer domain. Returned by getSecurityDomain() if the MIDlet was bound to the Manufacturer domain at install time.

See Also:

Constant Field Values

OPERATOR

public static final java.lang.String OPERATOR

Constant for the Operator domain. Returned by getSecurityDomain() iff the MIDlet was bound to the Operator domain at install time.

See Also:

Constant Field Values

IDENTIFIED_THIRD_PARTY

public static final java.lang.String IDENTIFIED_THIRD_PARTY

Constant for the Identified Third Party domain. Returned by getSecurityDomain() iff the MIDlet was bound to the Identified Third Party domain at install time.

See Also:

Constant Field Values

UNIDENTIFIED_THIRD_PARTY

public static final java.lang.String UNIDENTIFIED_THIRD_PARTY

Constant for the Unidentified Third Party domain. Returned by getSecurityDomain() iff the MIDlet was bound to the Unidentified Third Party domain at install time.

See Also:

Constant Field Values

Method Detail

getName

public java.lang.String getName()

Get the name of the MIDlet

Returns:

Name of the MIDlet

getVersion

public java.lang.String getVersion()

Get version of the MIDlet

Returns:

Version string of the MIDlet

getVendor

public java.lang.String getVendor()

Get vendor name of the MIDlet

Returns:

Vendor name of the MIDlet

isAuthorized

public boolean isAuthorized()

Checks whether the MIDlet associated with the specified MIDletIdentity is authorized to the current MIDlet's runtime execution environment via application level access authorization.

Returns:

true if the MIDlet associated with the specified MIDletIdentity is authorized to the current MIDlet's runtime execution environment, false otherwise.

getSecurityDomain

public java.lang.String getSecurityDomain()

Get the name of the security domain for the MIDlet associated with the specified MIDletIdentity. If the MIDlet was bound to one of the predefined security domains, then one of the following MUST be returned, as appropriate :

• MANUFACTURER
• OPERATOR
• IDENTIFIED_THIRD_PARTY
• UNIDENTIFIED_THIRD_PARTY

If the MIDlet was not bound to one of the predefined security domains, then some String value other than those listed above MUST be returned.

Returns:

Name of the security domain that the MIDlet associated with this MIDletIdentity was bound to when it was installed.

toString

public java.lang.String toString()

Returns the string representation of this MIDletIdentity.

Overrides:

toString in class java.lang.Object

Returns:

the String concatenation of getVendor() + "; " + getName() + "; " + getVersion().