org.apache.jackrabbit.core.security.simple
Class SimpleAccessManager

java.lang.Object
  org.apache.jackrabbit.core.security.AbstractAccessControlManager
      org.apache.jackrabbit.core.security.simple.SimpleAccessManager

All Implemented Interfaces:

AccessControlManager, JackrabbitAccessControlManager, AccessManager

public class SimpleAccessManager
extends AbstractAccessControlManager
implements AccessManager

SimpleAccessManager ...

Field Summary

Fields inherited from interface org.apache.jackrabbit.core.security.AccessManager

READ, REMOVE, WRITE

Constructor Summary

SimpleAccessManager()
Empty constructor

Method Summary

boolean	canAccess(String workspaceName) Determines whether the subject of the current context is granted access to the given workspace.
boolean	canRead(Path itemPath) Determines whether the item at the specified absolute path can be read.
protected void	checkInitialized() Check if this manager has been properly initialized.
void	checkPermission(ItemId id, int permissions) Determines whether the specified permissions are granted on the item with the specified id (i.e.
void	checkPermission(Path absPath, int permissions) Determines whether the specified permissions are granted on the item with the specified id (i.e.
protected void	checkPermission(String absPath, int permission) Check if the specified privileges are granted at absPath.
protected void	checkValidNodePath(String absPath) Tests if the given absPath is absolute and points to an existing node.
void	close() Close this access manager.
AccessControlPolicy[]	getEffectivePolicies(String absPath)
protected PrivilegeRegistry	getPrivilegeRegistry()
Privilege[]	getPrivileges(String absPath)
Privilege[]	getPrivileges(String absPath, Set<Principal> principals)
boolean	hasPrivileges(String absPath, Privilege[] privileges)
boolean	hasPrivileges(String absPath, Set<Principal> principals, Privilege[] privileges)
void	init(AMContext context) Initialize this access manager.
void	init(AMContext context, AccessControlProvider acProvider, WorkspaceAccessManager wspAccessManager) Initialize this access manager.
boolean	isGranted(ItemId id, int permissions) Determines whether the specified permissions are granted on the item with the specified id (i.e.
boolean	isGranted(Path absPath, int permissions) Determines whether the specified permissions are granted on the item with the specified absPath (i.e.
boolean	isGranted(Path parentPath, Name childName, int permissions) Determines whether the specified permissions are granted on an item represented by the combination of the given parentPath and childName (i.e.

Methods inherited from class org.apache.jackrabbit.core.security.AbstractAccessControlManager

getApplicablePolicies, getApplicablePolicies, getPolicies, getPolicies, getSupportedPrivileges, privilegeFromName, removePolicy, setPolicy

Methods inherited from class java.lang.Object

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

Constructor Detail

SimpleAccessManager

public SimpleAccessManager()

Empty constructor

Method Detail

init

public void init(AMContext context)
          throws AccessDeniedException,
                 Exception

Initialize this access manager. An AccessDeniedException will be thrown if the subject of the given context is not granted access to the specified workspace.

Specified by:

init in interface AccessManager

Parameters:

context - access manager context

Throws:

AccessDeniedException - if the subject is not granted access to the specified workspace.

Exception - if another error occurs

init

public void init(AMContext context,
                 AccessControlProvider acProvider,
                 WorkspaceAccessManager wspAccessManager)
          throws AccessDeniedException,
                 Exception

Initialize this access manager. An AccessDeniedException will be thrown if the subject of the given context is not granted access to the specified workspace.

Specified by:

init in interface AccessManager

Parameters:

context - access manager context.

acProvider - The access control provider.

wspAccessManager - The workspace access manager.

Throws:

AccessDeniedException - if the subject is not granted access to the specified workspace.

Exception - if another error occurs

close

public void close()
           throws Exception

Close this access manager. After having closed an access manager, further operations on this object are treated as illegal and throw

Specified by:

close in interface AccessManager

Throws:

Exception - if an error occurs

checkPermission

public void checkPermission(ItemId id,
                            int permissions)
                     throws AccessDeniedException,
                            RepositoryException

Determines whether the specified permissions are granted on the item with the specified id (i.e. the target item).

Specified by:

checkPermission in interface AccessManager

Parameters:

id - the id of the target item

permissions - A combination of one or more of the following constants encoded as a bitmask value:

• READ
• WRITE
• REMOVE

Throws:

AccessDeniedException - if permission is denied

ItemNotFoundException - if the target item does not exist

RepositoryException - it an error occurs

checkPermission

public void checkPermission(Path absPath,
                            int permissions)
                     throws AccessDeniedException,
                            RepositoryException

Determines whether the specified permissions are granted on the item with the specified id (i.e. the target item).

Specified by:

checkPermission in interface AccessManager

Parameters:

absPath - Path to an item.

permissions - A combination of one or more of the Permission constants encoded as a bitmask value.

Throws:

AccessDeniedException - if permission is denied

RepositoryException - it another error occurs

isGranted

public boolean isGranted(ItemId id,
                         int permissions)
                  throws RepositoryException

Determines whether the specified permissions are granted on the item with the specified id (i.e. the target item).

Specified by:

isGranted in interface AccessManager

Parameters:

id - the id of the target item

permissions - A combination of one or more of the following constants encoded as a bitmask value:

• READ
• WRITE
• REMOVE

Returns:

true if permission is granted; otherwise false

Throws:

ItemNotFoundException - if the target item does not exist

RepositoryException - if another error occurs

isGranted

public boolean isGranted(Path absPath,
                         int permissions)
                  throws RepositoryException

Description copied from interface: AccessManager

Determines whether the specified permissions are granted on the item with the specified absPath (i.e. the target item, that may or may not yet exist).

Specified by:

isGranted in interface AccessManager

Parameters:

absPath - the absolute path to test

permissions - A combination of one or more of the Permission constants encoded as a bitmask value.

Returns:

true if the specified permissions are granted; otherwise false.

Throws:

RepositoryException - if an error occurs.

isGranted

public boolean isGranted(Path parentPath,
                         Name childName,
                         int permissions)
                  throws RepositoryException

Description copied from interface: AccessManager

Determines whether the specified permissions are granted on an item represented by the combination of the given parentPath and childName (i.e. the target item, that may or may not yet exist).

Specified by:

isGranted in interface AccessManager

Parameters:

parentPath - Path to an existing parent node.

childName - Name of the child item that may or may not exist yet.

permissions - A combination of one or more of the Permission constants encoded as a bitmask value.

Returns:

true if the specified permissions are granted; otherwise false.

Throws:

RepositoryException - if an error occurs.

canRead

public boolean canRead(Path itemPath)
                throws RepositoryException

Description copied from interface: AccessManager

Determines whether the item at the specified absolute path can be read.

Specified by:

canRead in interface AccessManager

Parameters:

itemPath - Path to the item to be tested.s

Returns:

true if the item can be read; otherwise false.

Throws:

RepositoryException - if an error occurs.

canAccess

public boolean canAccess(String workspaceName)
                  throws RepositoryException

Determines whether the subject of the current context is granted access to the given workspace. Note that an implementation is free to test for the existance of a workspace with the specified name. In this case the expected return value is false, if no such workspace exists.

Specified by:

canAccess in interface AccessManager

Parameters:

workspaceName - name of workspace

Returns:

true if the subject of the current context is granted access to the given workspace; otherwise false.

Throws:

RepositoryException - if an error occurs.

hasPrivileges

public boolean hasPrivileges(String absPath,
                             Privilege[] privileges)
                      throws PathNotFoundException,
                             RepositoryException

Specified by:

hasPrivileges in interface AccessControlManager

Throws:

PathNotFoundException

RepositoryException

getPrivileges

public Privilege[] getPrivileges(String absPath)
                          throws PathNotFoundException,
                                 RepositoryException

Specified by:

getPrivileges in interface AccessControlManager

Throws:

PathNotFoundException

RepositoryException

getEffectivePolicies

public AccessControlPolicy[] getEffectivePolicies(String absPath)
                                           throws PathNotFoundException,
                                                  AccessDeniedException,
                                                  RepositoryException

Specified by:

getEffectivePolicies in interface AccessControlManager

Throws:

PathNotFoundException

AccessDeniedException

RepositoryException

checkInitialized

protected void checkInitialized()
                         throws IllegalStateException

Description copied from class: AbstractAccessControlManager

Check if this manager has been properly initialized.

Specified by:

checkInitialized in class AbstractAccessControlManager

Throws:

IllegalStateException - If this manager has not been properly initialized.

See Also:

AbstractAccessControlManager.checkInitialized()

checkPermission

protected void checkPermission(String absPath,
                               int permission)
                        throws AccessDeniedException,
                               PathNotFoundException,
                               RepositoryException

Description copied from class: AbstractAccessControlManager

Check if the specified privileges are granted at absPath.

Specified by:

checkPermission in class AbstractAccessControlManager

Parameters:

absPath - Path to an existing node.

permission - Permissions to be checked.

Throws:

AccessDeniedException - if the session does not have the specified privileges.

PathNotFoundException - if no node exists at absPath of if the session does not have the permission to READ it.

RepositoryException - If another error occurs.

See Also:

AbstractAccessControlManager.checkPermission(String,int)

getPrivilegeRegistry

protected PrivilegeRegistry getPrivilegeRegistry()
                                          throws RepositoryException

Specified by:

getPrivilegeRegistry in class AbstractAccessControlManager

Returns:

the privilege registry

Throws:

RepositoryException - If another error occurs.

See Also:

AbstractAccessControlManager.getPrivilegeRegistry()

checkValidNodePath

protected void checkValidNodePath(String absPath)
                           throws PathNotFoundException,
                                  RepositoryException

Description copied from class: AbstractAccessControlManager

Tests if the given absPath is absolute and points to an existing node.

Specified by:

checkValidNodePath in class AbstractAccessControlManager

Parameters:

absPath - Path to an existing node.

Throws:

PathNotFoundException - if no node at absPath exists or the session does not have privilege to retrieve the node.

RepositoryException - If the given absPath is not absolute or if some other error occurs.

See Also:

AbstractAccessControlManager.checkValidNodePath(String)

hasPrivileges

public boolean hasPrivileges(String absPath,
                             Set<Principal> principals,
                             Privilege[] privileges)
                      throws PathNotFoundException,
                             RepositoryException

Specified by:

hasPrivileges in interface JackrabbitAccessControlManager

Throws:

PathNotFoundException

RepositoryException

See Also:

JackrabbitAccessControlManager.hasPrivileges(String, Set, Privilege[])

getPrivileges

public Privilege[] getPrivileges(String absPath,
                                 Set<Principal> principals)
                          throws PathNotFoundException,
                                 RepositoryException

Specified by:

getPrivileges in interface JackrabbitAccessControlManager

Throws:

PathNotFoundException

RepositoryException

See Also:

JackrabbitAccessControlManager.getPrivileges(String, Set)