getSuiteName() Gets the label for the downloaded JAR.
public boolean
isEnabled() Determine if the a MIDlet from this suite can be run.
public boolean
isRegistered(String midletName) Indicates if the named MIDlet is registered in the suite
with MIDlet-<n> record in the manifest or
application descriptor.
Checks for permission and throw an exception if not allowed.
May block to ask the user a question.
Parameters: permission - ID of the permission to check for,the ID must be fromcom.sun.midp.security.Permissions Parameters: resource - string to insert into the question, can be null ifno %2 in the question exception: SecurityException - if the permission is notallowed by this token exception: InterruptedException - if another thread interrupts thecalling thread while this method is waiting to preempt thedisplay.
Checks for permission and throw an exception if not allowed.
May block to ask the user a question.
Parameters: permission - ID of the permission to check for,the ID must be fromcom.sun.midp.security.Permissions Parameters: resource - string to insert into the question, can be null ifno %2 in the question Parameters: extraValue - string to insert into the question,can be null if no %3 in the question exception: SecurityException - if the permission is notallowed by this token exception: InterruptedException - if another thread interrupts thecalling thread while this method is waiting to preempt thedisplay.
checkIfPermissionAllowed
public void checkIfPermissionAllowed(int permission)(Code)
Checks to see the suite has the ALLOW level for specific permission.
This is used for by internal APIs that only provide access to
trusted system applications.
Only trust this method if the object has been obtained from the
MIDletStateHandler of the suite.
Parameters: permission - permission ID fromcom.sun.midp.security.Permissions exception: SecurityException - if the suite is notallowed to perform the specified action
checkPermission
public int checkPermission(String permission)(Code)
Gets the status of the specified permission.
If no API on the device defines the specific permission
requested then it must be reported as denied.
If the status of the permission is not known because it might
require a user interaction then it should be reported as unknown.
Parameters: permission - to check if denied, allowed, or unknown 0 if the permission is denied; 1 if the permission isallowed; -1 if the status is unknown
Gets a property of the application to be installed.
First from the jaD, then if not found, the JAR manifeSt.
Parameters: key - key of the property value of the property or null if not found
Gets the authorization path of this suite. The path starts with
the most trusted CA that authorized this suite.
array of CA names or null if the suite was not signed
Gets the last recoverable exception that stopped the install.
Non-recoverable exceptions are thrown and not saved in the state.
last exception that stopped the install
Gets a property of the suite. A property is an attribute from
either the application descriptor or JAR Manifest.
Parameters: key - the name of the property A string with the value of the property.null is returned if no valueis available for the key.
Gets push setting for interrupting other MIDlets.
Reuses the Permissions.
push setting for interrupting MIDlets the valuewill be permission level from Permissions
Determine if the a MIDlet from this suite can be run. Note that
disable suites can still have their settings changed and their
install info displayed.
true if suite is enabled, false otherwise
isRegistered
public boolean isRegistered(String midletName)(Code)
Indicates if the named MIDlet is registered in the suite
with MIDlet-<n> record in the manifest or
application descriptor.
Parameters: midletName - class name of the MIDlet to be checked true if the MIDlet is registered
Indicates if this suite is trusted.
(not to be confused with a domain named "trusted",
this is used to determine if a trusted symbol should be displayed
to the user and not used for permissions)
true if the suite is trusted false if not
Check if the suite classes were successfully verified
during the suite installation.
true if the suite classes are verified, false otherwise
permissionToInterrupt
public boolean permissionToInterrupt(String connection)(Code)
Asks the user want to interrupt the current MIDlet with
a new MIDlet that has received network data.
Parameters: connection - connection to place in the permission question ornull for alarm true if the use wants interrupt the current MIDlet,else false
Saves any the settings (security or others) that the user may have
changed. Normally called by the scheduler after
the last running MIDlet in the suite is destroyed.
However it could be call during a suspend of the VM so
that persistent settings of the suite can be preserved.
Replace or add a property to the suite for this run only.
Parameters: token - token with the AMS permission set to allowed Parameters: key - the name of the property Parameters: value - the value of the property exception: SecurityException - if the caller's token does not haveinternal AMS permission