com.xdev.security.authorization

Class AuthorizationManager.Implementation

java.lang.Object

com.xdev.security.authorization.AuthorizationManager.Implementation

All Implemented Interfaces:

AuthorizationManager, AuthorizationRegistry, PermissionManager, PermissionProvider, PermissionRegistry, RoleManager, RoleRegistry, SubjectManager, SubjectRegistry

Enclosing interface:

AuthorizationManager

public static final class AuthorizationManager.Implementation
extends Object
implements AuthorizationManager

Simple AuthorizationManager default implementation that uses an internally created locking instance and connects delegate PermissionManager, RoleManager and SubjectManager instances to it.

Author:

XDEV Software (TM)

Nested Class Summary

Nested classes/interfaces inherited from interface com.xdev.security.authorization.AuthorizationManager

AuthorizationManager.Builder, AuthorizationManager.Implementation

Method Summary

Modifier and Type	Method and Description
AuthorizationRegistry	authorizationRegistry()
Object	lockPermissionRegistry() Returns the lock instance that is internally used by this registry instance.
Object	lockRoleRegistry() Returns the lock instance that is internally used by this registry instance.
Object	lockSubjectRegistry() Returns the lock instance that is internally used by this registry instance.
Permission	permission(Resource resource, Integer factor) Looks up the Permission instance representing the passed Resource instance with the passed factor value.
Permission	providePermission(Resource resource, Integer factor) Provides a permission for the passed Resource instance and the passed factor.
void	reloadAuthorizations() Causes the authorization information to be reloaded and all depending data structures to be rebuilt accordingly.
Resource	resource(String name) Returns the Resource instance identified by the passed name.
Role	role(String roleName) Returns the Role instance identified by the passed role name.
Map<String,Role>	roles() Returns a read-only map of all known Role instances (values), identified by their names (keys).
Subject	subject(String subjectName) Returns the Subject instance identified by the passed subject name.
Map<String,Subject>	subjects() Returns a read-only map of all known Subject instances (values), identified by their names (keys).

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

Builder, New, New, NewFromXmlFile

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

New, New, New

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

New, New, New, providePermission

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

New, New, New, New, permission

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

New, New, New, New

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

New, New, New

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

New, New, New, New

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

New, New, New

Method Detail

lockPermissionRegistry

public final Object lockPermissionRegistry()

Returns the lock instance that is internally used by this registry instance.

Specified by:

lockPermissionRegistry in interface PermissionRegistry

Returns:

the lock.

lockRoleRegistry

public final Object lockRoleRegistry()

Returns the lock instance that is internally used by this registry instance.

Specified by:

lockRoleRegistry in interface RoleRegistry

Returns:

the lock.

lockSubjectRegistry

public final Object lockSubjectRegistry()

Returns the lock instance that is internally used by this registry instance.

Specified by:

lockSubjectRegistry in interface SubjectRegistry

Returns:

the lock.

resource

public final Resource resource(String name)

Returns the Resource instance identified by the passed name.

Specified by:

resource in interface AuthorizationManager

Parameters:

name - the name identifying the desired resource.

Returns:

the Resource instance identified by the passed name.

permission

public final Permission permission(Resource resource,
                                   Integer factor)

Looks up the Permission instance representing the passed Resource instance with the passed factor value. If no suitable Permission instance can be found, null is returned.

Specified by:

permission in interface PermissionRegistry

Parameters:

resource - the Resource instance for which the associated Permission instance shall be returned.

factor - the factor value of the Resource instance for which the associated Permission instance shall be returned.

Returns:

the associated Permission instance specified by the passed values.

role

public final Role role(String roleName)

Returns the Role instance identified by the passed role name.

Specified by:

role in interface RoleRegistry

Parameters:

roleName - the name identifying the desired Role instance.

Returns:

the Role instance identified by the passed name.

subject

public final Subject subject(String subjectName)

Returns the Subject instance identified by the passed subject name.

Specified by:

subject in interface SubjectRegistry

Parameters:

subjectName - the name identifying the desired Subject instance.

Returns:

the Subject instance identified by the passed name.

providePermission

public final 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 PermissionManager

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:

PermissionManager.providePermission(Resource)

roles

public final Map<String,Role> roles()

Returns a read-only map of all known Role instances (values), identified by their names (keys).

Specified by:

roles in interface RoleManager

Specified by:

roles in interface RoleRegistry

Returns:

a read-only map containing all known roles.

subjects

public final Map<String,Subject> subjects()

Returns a read-only map of all known Subject instances (values), identified by their names (keys).

Specified by:

subjects in interface SubjectManager

Specified by:

subjects in interface SubjectRegistry

Returns:

a read-only map containing all known subjects.

authorizationRegistry

public final AuthorizationRegistry authorizationRegistry()

Specified by:

authorizationRegistry in interface AuthorizationManager

Returns:

the AuthorizationRegistry instance, possibly this instance itself.

reloadAuthorizations

public void reloadAuthorizations()

Causes the authorization information to be reloaded and all depending data structures to be rebuilt accordingly.

Specified by:

reloadAuthorizations in interface AuthorizationManager