org.osgi.service.condpermadmin
Interface ConditionalPermissionAdmin

public interface ConditionalPermissionAdmin

Framework service to administer Conditional Permissions. Conditional Permissions can be added to, retrieved from, and removed from the framework.

Method Summary

ConditionalPermissionInfo	addConditionalPermissionInfo(ConditionInfo[] conds, PermissionInfo[] perms) Create a new Conditional Permission Info.
java.security.AccessControlContext	getAccessControlContext(java.lang.String[] signers) Returns the Access Control Context that corresponds to the specified signers.
ConditionalPermissionInfo	getConditionalPermissionInfo(java.lang.String name) Return the Conditional Permission Info with the specified name.
java.util.Enumeration	getConditionalPermissionInfos() Returns the Conditional Permission Infos that are currently managed by Conditional Permission Admin.
ConditionalPermissionInfo	setConditionalPermissionInfo(java.lang.String name, ConditionInfo[] conds, PermissionInfo[] perms) Set or create a Conditional Permission Info with a specified name.

Method Detail

addConditionalPermissionInfo

public ConditionalPermissionInfo addConditionalPermissionInfo(ConditionInfo[] conds,
                                                              PermissionInfo[] perms)

Create a new Conditional Permission Info. The Conditional Permission Info will be given a unique, never reused name.

Parameters:

conds - The Conditions that need to be satisfied to enable the corresponding Permissions.

perms - The Permissions that are enable when the corresponding Conditions are satisfied.

Returns:

The ConditionalPermissionInfo for the specified Conditions and Permissions.

Throws:

java.lang.SecurityException - If the caller does not have AllPermission.

setConditionalPermissionInfo

public ConditionalPermissionInfo setConditionalPermissionInfo(java.lang.String name,
                                                              ConditionInfo[] conds,
                                                              PermissionInfo[] perms)

Set or create a Conditional Permission Info with a specified name. If the specified name is null, a new Conditional Permission Info must be created and will be given a unique, never reused name. If there is currently no Conditional Permission Info with the specified name, a new Conditional Permission Info must be created with the specified name. Otherwise, the Conditional Permission Info with the specified name must be updated with the specified Conditions and Permissions.

Parameters:

name - The name of the Conditional Permission Info, or null.

conds - The Conditions that need to be satisfied to enable the corresponding Permissions.

perms - The Permissions that are enable when the corresponding Conditions are satisfied.

Returns:

The ConditionalPermissionInfo that for the specified name, Conditions and Permissions.

Throws:

java.lang.SecurityException - If the caller does not have AllPermission.

getConditionalPermissionInfos

public java.util.Enumeration getConditionalPermissionInfos()

Returns the Conditional Permission Infos that are currently managed by Conditional Permission Admin. Calling ConditionalPermissionInfo.delete() will remove the Conditional Permission Info from Conditional Permission Admin.

Returns:

An enumeration of the Conditional Permission Infos that are currently managed by Conditional Permission Admin.

getConditionalPermissionInfo

public ConditionalPermissionInfo getConditionalPermissionInfo(java.lang.String name)

Return the Conditional Permission Info with the specified name.

Parameters:

name - The name of the Conditional Permission Info to be returned.

Returns:

The Conditional Permission Info with the specified name.

getAccessControlContext

public java.security.AccessControlContext getAccessControlContext(java.lang.String[] signers)

Returns the Access Control Context that corresponds to the specified signers.

Parameters:

signers - The signers for which to return an Access Control Context.

Returns:

An AccessControlContext that has the Permissions associated with the signer.