com.xdev.security.authorization

Interface PermissionManager

All Superinterfaces:

PermissionProvider, PermissionRegistry

All Known Subinterfaces:

AuthorizationManager, XdevInMemorySecurityManager, XdevSecurityManager<C,R>

All Known Implementing Classes:

AuthorizationManager.Implementation, PermissionManager.Implementation, XdevInMemorySecurityManager.Implementation, XdevSecurityManager.Implementation

public interface PermissionManager
extends PermissionRegistry, PermissionProvider

Manager type that extends PermissionRegistry with functionality for mutating (managing) the registered entries. A PermissionManager is also a relaying implementation of a PermissionProvider.

Author:

XDEV Software (TM)

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	PermissionManager.Implementation A simple PermissionManager default implementation that uses a shared synchronization lock.

Method Summary

Modifier and Type	Method and Description
static PermissionManager	New() Creates a new PermissionManager instance with a PermissionProvider default implementation.
static PermissionManager	New(Object registryLock, PermissionProvider permissionProvider, HashMap<Resource,HashMap<Integer,Permission>> table) Creates a new PermissionManager instance with the passed PermissionProvider instance the passed registry lock instance to be used as the internal synchronization lock and the passed table as its internal datastructure.
static PermissionManager	New(PermissionProvider permissionProvider) Creates a new PermissionManager instance with the passed PermissionProvider instance.
default Permission	providePermission(Resource resource) Provides a permission for the passed Resource instance and a factor of 0.
Permission	providePermission(Resource resource, Integer factor) Provides a permission for the passed Resource instance and the passed factor.

Methods inherited from interface com.xdev.security.authorization.PermissionRegistry

lockPermissionRegistry, New, New, New, New, permission, permission

Method Detail

providePermission

Permission providePermission(Resource resource,
                             Integer factor)

Provides a permission for the passed Resource instance and the passed factor. Providing means to either return a suitable existing Permission instance of create, register and then return a new one.

Specified by:

providePermission in interface PermissionProvider

Parameters:

resource - the Resource instance to be associated.

factor - the factor of the access to the passed Resource instance.

Returns:

a Permission instance satisfiying the specified values.

See Also:

providePermission(Resource)

providePermission

default Permission providePermission(Resource resource)

Provides a permission for the passed Resource instance and a factor of 0.

Specified by:

providePermission in interface PermissionProvider

Parameters:

resource - the Resource instance to be associated.

Returns:

a Permission instance associated with the passed Resource instance.

See Also:

providePermission(Resource, Integer)

New

static PermissionManager New()

Creates a new PermissionManager instance with a PermissionProvider default implementation. The PermissionProvider is used whenever providePermission(Resource, Integer) is unable to find an existing suitable Permission instance.

Returns:

a new PermissionManager instance.

See Also:

Permission.New(Resource, int), New(PermissionProvider), New(Object, PermissionProvider, HashMap)

New

static PermissionManager New(PermissionProvider permissionProvider)

Creates a new PermissionManager instance with the passed PermissionProvider instance. The PermissionProvider is used whenever providePermission(Resource, Integer) is unable to find an existing suitable Permission instance.

Parameters:

permissionProvider - the PermissionProvider instance to be used to provide Permission instances.

Returns:

a new PermissionManager instance.

See Also:

New(), New(Object, PermissionProvider, HashMap)

New

static PermissionManager New(Object registryLock,
                             PermissionProvider permissionProvider,
                             HashMap<Resource,HashMap<Integer,Permission>> table)

Creates a new PermissionManager instance with the passed PermissionProvider instance the passed registry lock instance to be used as the internal synchronization lock and the passed table as its internal datastructure.

Parameters:

registryLock - the synchronization lock instance to be used for concurrency handling.

permissionProvider - permissionProvider the PermissionProvider instance to be used to provide Permission instances.

table - the table to be used as the internal datastructure.

Returns:

a new PermissionManager instance.

See Also:

New(), New(PermissionProvider)