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.

Version: $Revision: 1.13 $

Method Summary
ConditionalPermissionInfo	addConditionalPermissionInfo(ConditionInfo[] conds, PermissionInfo[] perms) Create a new Conditional Permission Info.
AccessControlContext	getAccessControlContext(String[] signers) Returns the Access Control Context that corresponds to the specified signers.
ConditionalPermissionInfo	getConditionalPermissionInfo(String name) Return the Conditional Permission Info with the specified name.
Enumeration	getConditionalPermissionInfos() Returns the Conditional Permission Infos that are currently managed by Conditional Permission Admin.
ConditionalPermissionInfo	setConditionalPermissionInfo(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: SecurityException If the caller does not have AllPermission.

getAccessControlContext

public AccessControlContext getAccessControlContext(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.

getConditionalPermissionInfo

public ConditionalPermissionInfo getConditionalPermissionInfo(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.

getConditionalPermissionInfos

public Enumeration getConditionalPermissionInfos()

Returns the Conditional Permission Infos that are currently managed by Conditional Permission Admin. Calling 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.

setConditionalPermissionInfo

public ConditionalPermissionInfo setConditionalPermissionInfo(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: SecurityException If the caller does not have AllPermission.