java.security

Interface AccessControlContext

public interface AccessControlContext

The AccessControlContext interface is used in the case where the permission of an application not running in the current isolate needs to be checked, for example the when an installer has to register connection for a MIDlet with the push registry.

This API does not specify the names used to identify permissions, the policy behind the API should use the standard names in JSR specifications to identify permissions. Manufacturer API names should be specified in the documentation for that API so the policy maker can accomidate them.

Method Summary

Methods

Modifier and Type	Method and Description
void	checkPermission(String name) Determines whether the access request indicated by the specified permission should be allowed or denied, based on the security policy currently in effect.
void	checkPermission(String name, String resource) Check for permission and throw an exception if not allowed.
void	checkPermission(String name, String resource, String extraValue) Checks for permission and throw an exception if not allowed.

Method Detail

checkPermission

void checkPermission(String name)
                     throws SecurityException

Determines whether the access request indicated by the specified permission should be allowed or denied, based on the security policy currently in effect. This method quietly returns if the access request is permitted, or throws a suitable SecurityException otherwise. May block to ask the user a question.

If the permission check failed because an InterruptedException was thrown, this method will throw a InterruptedSecurityException.

Parameters:

name - name of the requested permission

Throws:

SecurityException - if the specified permission is not permitted, based on the current security policy

checkPermission

void checkPermission(String name,
                   String resource)
                     throws SecurityException

Check for permission and throw an exception if not allowed. May block to ask the user a question.

If the permission check failed because an InterruptedException was thrown, this method will throw a InterruptedSecurityException.

Parameters:

name - name of the requested permission

resource - string to insert into the question, can be null if no %2 in the question

name - name of the requested permission

Throws:

SecurityException - if the specified permission is not permitted, based on the current security policy

checkPermission

void checkPermission(String name,
                   String resource,
                   String extraValue)
                     throws SecurityException

Checks for permission and throw an exception if not allowed. May block to ask the user a question.

If the permission check failed because an InterruptedException was thrown, this method will throw a InterruptedSecurityException.

Parameters:

permission - ID of the permission to check for, the ID must be from com.sun.midp.security.Permissions

resource - string to insert into the question, can be null if no %2 in the question

extraValue - string to insert into the question, can be null if no %3 in the question

name - name of the requested permission

Throws:

SecurityException - if the specified permission is not permitted, based on the current security policy