org.apache.jackrabbit.core.security

Class AbstractAccessControlManager

java.lang.Object

org.apache.jackrabbit.core.security.AbstractAccessControlManager

All Implemented Interfaces:

javax.jcr.security.AccessControlManager, JackrabbitAccessControlManager

Direct Known Subclasses:

DefaultAccessManager, SimpleAccessManager

public abstract class AbstractAccessControlManager
extends Object
implements JackrabbitAccessControlManager

AbstractAccessControlManager...

Constructor Summary

Constructors

Constructor and Description
AbstractAccessControlManager()

Method Summary

Methods

Modifier and Type	Method and Description
protected abstract void	checkInitialized() Check if this manager has been properly initialized.
protected abstract void	checkPermission(String absPath, int permission) Check if the specified privileges are granted at absPath.
protected abstract void	checkValidNodePath(String absPath) Tests if the given absPath is absolute and points to an existing node.
JackrabbitAccessControlPolicy[]	getApplicablePolicies(Principal principal) Returns the applicable policies for the specified principal or an empty array if no additional policies can be applied.
javax.jcr.security.AccessControlPolicyIterator	getApplicablePolicies(String absPath) Returns an empty iterator.
JackrabbitAccessControlPolicy[]	getPolicies(Principal principal) Returns the AccessControlPolicy objects that have been set for the given principal or an empty array if no policy has been set.
javax.jcr.security.AccessControlPolicy[]	getPolicies(String absPath) Returns null.
protected abstract PrivilegeManager	getPrivilegeManager()
javax.jcr.security.Privilege[]	getSupportedPrivileges(String absPath) Always returns all registered Privileges.
javax.jcr.security.Privilege	privilegeFromName(String privilegeName)
void	removePolicy(String absPath, javax.jcr.security.AccessControlPolicy policy) Always throws AccessControlException
void	setPolicy(String absPath, javax.jcr.security.AccessControlPolicy policy) Always throws AccessControlException

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.jackrabbit.api.security.JackrabbitAccessControlManager

getEffectivePolicies, getPrivileges, hasPrivileges

Methods inherited from interface javax.jcr.security.AccessControlManager

getEffectivePolicies, getPrivileges, hasPrivileges

Constructor Detail

AbstractAccessControlManager

public AbstractAccessControlManager()

Method Detail

getSupportedPrivileges

public javax.jcr.security.Privilege[] getSupportedPrivileges(String absPath)
                                                      throws javax.jcr.PathNotFoundException,
                                                             javax.jcr.RepositoryException

Always returns all registered Privileges.

Specified by:

getSupportedPrivileges in interface javax.jcr.security.AccessControlManager

Parameters:

absPath - Path to an existing node.

Returns:

Always returns all registered Privileges.

Throws:

javax.jcr.PathNotFoundException

javax.jcr.RepositoryException

See Also:

AccessControlManager.getSupportedPrivileges(String)

privilegeFromName

public javax.jcr.security.Privilege privilegeFromName(String privilegeName)
                                               throws javax.jcr.security.AccessControlException,
                                                      javax.jcr.RepositoryException

Specified by:

privilegeFromName in interface javax.jcr.security.AccessControlManager

Throws:

javax.jcr.security.AccessControlException

javax.jcr.RepositoryException

See Also:

AccessControlManager.privilegeFromName(String)

getPolicies

public javax.jcr.security.AccessControlPolicy[] getPolicies(String absPath)
                                                     throws javax.jcr.PathNotFoundException,
                                                            javax.jcr.AccessDeniedException,
                                                            javax.jcr.RepositoryException

Returns null.

Specified by:

getPolicies in interface javax.jcr.security.AccessControlManager

Parameters:

absPath - Path to an existing node.

Returns:

always returns null.

Throws:

javax.jcr.PathNotFoundException

javax.jcr.AccessDeniedException

javax.jcr.RepositoryException

See Also:

AccessControlManager.getApplicablePolicies(String)

getApplicablePolicies

public javax.jcr.security.AccessControlPolicyIterator getApplicablePolicies(String absPath)
                                                                     throws javax.jcr.PathNotFoundException,
                                                                            javax.jcr.AccessDeniedException,
                                                                            javax.jcr.RepositoryException

Returns an empty iterator.

Specified by:

getApplicablePolicies in interface javax.jcr.security.AccessControlManager

Parameters:

absPath - Path to an existing node.

Returns:

always returns an empty iterator.

Throws:

javax.jcr.PathNotFoundException

javax.jcr.AccessDeniedException

javax.jcr.RepositoryException

See Also:

AccessControlManager.getApplicablePolicies(String)

setPolicy

public void setPolicy(String absPath,
             javax.jcr.security.AccessControlPolicy policy)
               throws javax.jcr.PathNotFoundException,
                      javax.jcr.security.AccessControlException,
                      javax.jcr.AccessDeniedException,
                      javax.jcr.RepositoryException

Always throws AccessControlException

Specified by:

setPolicy in interface javax.jcr.security.AccessControlManager

Throws:

javax.jcr.PathNotFoundException

javax.jcr.security.AccessControlException

javax.jcr.AccessDeniedException

javax.jcr.RepositoryException

See Also:

AccessControlManager.setPolicy(String, AccessControlPolicy)

removePolicy

public void removePolicy(String absPath,
                javax.jcr.security.AccessControlPolicy policy)
                  throws javax.jcr.PathNotFoundException,
                         javax.jcr.security.AccessControlException,
                         javax.jcr.AccessDeniedException,
                         javax.jcr.RepositoryException

Always throws AccessControlException

Specified by:

removePolicy in interface javax.jcr.security.AccessControlManager

Throws:

javax.jcr.PathNotFoundException

javax.jcr.security.AccessControlException

javax.jcr.AccessDeniedException

javax.jcr.RepositoryException

See Also:

AccessControlManager.removePolicy(String, AccessControlPolicy)

getApplicablePolicies

public JackrabbitAccessControlPolicy[] getApplicablePolicies(Principal principal)
                                                      throws javax.jcr.AccessDeniedException,
                                                             javax.jcr.security.AccessControlException,
                                                             javax.jcr.UnsupportedRepositoryOperationException,
                                                             javax.jcr.RepositoryException

Description copied from interface: JackrabbitAccessControlManager

Returns the applicable policies for the specified principal or an empty array if no additional policies can be applied.

Specified by:

getApplicablePolicies in interface JackrabbitAccessControlManager

Parameters:

principal - A principal known to the editing session.

Returns:

array of policies for the specified principal. Note that the policy object returned must reveal the path of the node where they can be applied later on using AccessControlManager.setPolicy(String, javax.jcr.security.AccessControlPolicy).

Throws:

javax.jcr.AccessDeniedException - if the session lacks MODIFY_ACCESS_CONTROL privilege.

javax.jcr.security.AccessControlException - if the specified principal does not exist or if another access control related exception occurs.

javax.jcr.UnsupportedRepositoryOperationException - if editing access control policies by principal is not supported.

javax.jcr.RepositoryException - if another error occurs.

See Also:

JackrabbitAccessControlManager.getApplicablePolicies(java.security.Principal)

getPolicies

public JackrabbitAccessControlPolicy[] getPolicies(Principal principal)
                                            throws javax.jcr.AccessDeniedException,
                                                   javax.jcr.security.AccessControlException,
                                                   javax.jcr.UnsupportedRepositoryOperationException,
                                                   javax.jcr.RepositoryException

Description copied from interface: JackrabbitAccessControlManager

Returns the AccessControlPolicy objects that have been set for the given principal or an empty array if no policy has been set. This method reflects the binding state, including transient policy modifications.

Specified by:

getPolicies in interface JackrabbitAccessControlManager

Parameters:

principal - A valid principal.

Returns:

The policies defined for the given principal or an empty array.

Throws:

javax.jcr.AccessDeniedException - if the session lacks READ_ACCESS_CONTROL privilege.

javax.jcr.security.AccessControlException - if the specified principal does not exist or if another access control related exception occurs.

javax.jcr.UnsupportedRepositoryOperationException - if editing access control policies by principal is not supported.

javax.jcr.RepositoryException - If another error occurs.

See Also:

JackrabbitAccessControlManager.getPolicies(java.security.Principal)

checkInitialized

protected abstract void checkInitialized()
                                  throws IllegalStateException

Check if this manager has been properly initialized.

Throws:

IllegalStateException - If this manager has not been properly initialized.

checkPermission

protected abstract void checkPermission(String absPath,
                   int permission)
                                 throws javax.jcr.AccessDeniedException,
                                        javax.jcr.PathNotFoundException,
                                        javax.jcr.RepositoryException

Check if the specified privileges are granted at absPath.

Parameters:

absPath - Path to an existing node.

permission - Permissions to be checked.

Throws:

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

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

javax.jcr.RepositoryException - If another error occurs.

getPrivilegeManager

protected abstract PrivilegeManager getPrivilegeManager()
                                                 throws javax.jcr.RepositoryException

Returns:

the privilege manager

Throws:

javax.jcr.RepositoryException - If another error occurs.

checkValidNodePath

protected abstract void checkValidNodePath(String absPath)
                                    throws javax.jcr.PathNotFoundException,
                                           javax.jcr.RepositoryException

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

Parameters:

absPath - Path to an existing node.

Throws:

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

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