org.apache.jackrabbit.jcr2spi
Class WorkspaceManager

java.lang.Object
  org.apache.jackrabbit.jcr2spi.WorkspaceManager

All Implemented Interfaces:

NamespaceStorage, AccessManager, UpdatableItemStateManager

public class WorkspaceManager
extends Object
implements UpdatableItemStateManager, NamespaceStorage, AccessManager

WorkspaceManager...

Field Summary

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

ADD_NODE_ACTION, READ, READ_ACTION, REMOVE, REMOVE_ACTION, SET_PROPERTY_ACTION

Constructor Summary

WorkspaceManager(RepositoryService service, SessionInfo sessionInfo, CacheBehaviour cacheBehaviour, int pollTimeout, boolean enableObservation)

Method Summary

void	addEventListener(InternalEventListener listener) Sets the InternalEventListener that gets notifications about local and external changes.
void	addLockToken(String lt) This method always succeeds.
boolean	canAccess(String workspaceName) Determines whether the subject of the current context is granted access to the given workspace.
boolean	canRead(ItemState itemState) Returns true if the existing item with the given ItemId can be read.
boolean	canRemove(ItemState itemState) Returns true if the existing item state can be removed.
EventFilter	createEventFilter(int eventTypes, Path path, boolean isDeep, String[] uuids, Name[] nodeTypes, boolean noLocal) Creates an event filter based on the parameters available in ObservationManager.addEventListener(javax.jcr.observation.EventListener, int, java.lang.String, boolean, java.lang.String[], java.lang.String[], boolean).
void	dispose() Dispose this WorkspaceManager
void	execute(ChangeLog changes) Creates a new batch from the given ChangeLog and executes it.
void	execute(Operation operation) Creates a new batch from the single workspace operation and executes it.
QueryInfo	executeQuery(String statement, String language, Map namespaces)
EffectiveNodeTypeProvider	getEffectiveNodeTypeProvider()
HierarchyManager	getHierarchyManager()
IdFactory	getIdFactory()
ItemDefinitionProvider	getItemDefinitionProvider()
ItemStateFactory	getItemStateFactory()
LockInfo	getLockInfo(NodeId nodeId)
String[]	getLockTokens()
NameFactory	getNameFactory()
NamespaceRegistryImpl	getNamespaceRegistryImpl()
NodeTypeRegistry	getNodeTypeRegistry()
PathFactory	getPathFactory()
String	getPrefix(String uri)
Map	getRegisteredNamespaces()
String[]	getSupportedQueryLanguages()
String	getURI(String prefix)
String[]	getWorkspaceNames()
void	checkQueryStatement(String statement, String language, Map namespaces) Checks if the query statement is valid.
boolean	isGranted(ItemState itemState, String[] actions) Determines whether the specified permissions are granted on the item with the specified path.
boolean	isGranted(NodeState parentState, Path relPath, String[] actions) Determines whether the specified permissions are granted on the item with the specified path.
void	registerNamespace(String prefix, String uri)
void	removeEventListener(InternalEventListener listener)
void	removeLockToken(String lt) Tries to remove the given token from the SessionInfo.
void	unregisterNamespace(String uri)
void	updateEventFilters() Updates the event filters on the subscription.

Methods inherited from class java.lang.Object

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

Constructor Detail

WorkspaceManager

public WorkspaceManager(RepositoryService service,
                        SessionInfo sessionInfo,
                        CacheBehaviour cacheBehaviour,
                        int pollTimeout,
                        boolean enableObservation)
                 throws RepositoryException

Throws:

RepositoryException

Method Detail

getNamespaceRegistryImpl

public NamespaceRegistryImpl getNamespaceRegistryImpl()

getNodeTypeRegistry

public NodeTypeRegistry getNodeTypeRegistry()

getItemDefinitionProvider

public ItemDefinitionProvider getItemDefinitionProvider()

getEffectiveNodeTypeProvider

public EffectiveNodeTypeProvider getEffectiveNodeTypeProvider()

getHierarchyManager

public HierarchyManager getHierarchyManager()

getWorkspaceNames

public String[] getWorkspaceNames()
                           throws RepositoryException

Throws:

RepositoryException

getIdFactory

public IdFactory getIdFactory()
                       throws RepositoryException

Throws:

RepositoryException

getNameFactory

public NameFactory getNameFactory()
                           throws RepositoryException

Throws:

RepositoryException

getPathFactory

public PathFactory getPathFactory()
                           throws RepositoryException

Throws:

RepositoryException

getItemStateFactory

public ItemStateFactory getItemStateFactory()

getLockInfo

public LockInfo getLockInfo(NodeId nodeId)
                     throws RepositoryException

Throws:

RepositoryException

getLockTokens

public String[] getLockTokens()

addLockToken

public void addLockToken(String lt)
                  throws LockException,
                         RepositoryException

This method always succeeds. This is not compliant to the requirements for Session.addLockToken(String) as defined by JSR170, which defines that at most one single Session may contain the same lock token. However, with SPI it is not possible to determine, whether another session holds the lock, nor can the client determine, which lock this token belongs to. The latter would be necessary in order to build the 'Lock' object properly.

Parameters:

lt -

Throws:

LockException

RepositoryException

removeLockToken

public void removeLockToken(String lt)
                     throws LockException,
                            RepositoryException

Tries to remove the given token from the SessionInfo. If the SessionInfo does not contains the specified token, this method returns silently.
Note, that any restriction regarding removal of lock tokens must be asserted before this method is called.

Parameters:

lt -

Throws:

LockException

RepositoryException

getSupportedQueryLanguages

public String[] getSupportedQueryLanguages()
                                    throws RepositoryException

Returns:

Throws:

RepositoryException

checkQueryStatement

public void checkQueryStatement(String statement,
                                String language,
                                Map namespaces)
                         throws InvalidQueryException,
                                RepositoryException

Checks if the query statement is valid.

Parameters:

statement - the query statement.

language - the query language.

namespaces - the locally remapped namespaces which might be used in the query statement.

Throws:

InvalidQueryException - if the query statement is invalid.

RepositoryException - if an error occurs while checking the query statement.

executeQuery

public QueryInfo executeQuery(String statement,
                              String language,
                              Map namespaces)
                       throws RepositoryException

Parameters:

statement - the query statement.

language - the query language.

namespaces - the locally remapped namespaces which might be used in the query statement.

Returns:

Throws:

RepositoryException

addEventListener

public void addEventListener(InternalEventListener listener)
                      throws RepositoryException

Sets the InternalEventListener that gets notifications about local and external changes.

Parameters:

listener - the new listener.

Throws:

RepositoryException - if the listener cannot be registered.

updateEventFilters

public void updateEventFilters()
                        throws RepositoryException

Updates the event filters on the subscription. The filters are retrieved from the current list of internal event listeners.

Throws:

RepositoryException

removeEventListener

public void removeEventListener(InternalEventListener listener)
                         throws RepositoryException

Parameters:

listener -

Throws:

RepositoryException

createEventFilter

public EventFilter createEventFilter(int eventTypes,
                                     Path path,
                                     boolean isDeep,
                                     String[] uuids,
                                     Name[] nodeTypes,
                                     boolean noLocal)
                              throws UnsupportedRepositoryOperationException,
                                     RepositoryException

Creates an event filter based on the parameters available in ObservationManager.addEventListener(javax.jcr.observation.EventListener, int, java.lang.String, boolean, java.lang.String[], java.lang.String[], boolean).

Parameters:

eventTypes - A combination of one or more event type constants encoded as a bitmask.

path - an absolute path.

isDeep - a boolean.

uuids - array of UUIDs.

nodeTypes - array of node type names.

noLocal - a boolean.

Returns:

the event filter instance with the given parameters.

Throws:

UnsupportedRepositoryOperationException - if this implementation does not support observation.

RepositoryException

execute

public void execute(Operation operation)
             throws RepositoryException

Creates a new batch from the single workspace operation and executes it.

Specified by:

execute in interface UpdatableItemStateManager

Throws:

RepositoryException

See Also:

UpdatableItemStateManager.execute(Operation)

execute

public void execute(ChangeLog changes)
             throws RepositoryException

Creates a new batch from the given ChangeLog and executes it.

Specified by:

execute in interface UpdatableItemStateManager

Parameters:

changes -

Throws:

RepositoryException

dispose

public void dispose()

Dispose this WorkspaceManager

Specified by:

dispose in interface UpdatableItemStateManager

isGranted

public boolean isGranted(NodeState parentState,
                         Path relPath,
                         String[] actions)
                  throws ItemNotFoundException,
                         RepositoryException

Description copied from interface: AccessManager

Determines whether the specified permissions are granted on the item with the specified path.

Specified by:

isGranted in interface AccessManager

Parameters:

parentState - The node state of the next existing ancestor.

relPath - The relative path pointing to the non-existing target item.

actions - An array of actions that need to be checked.

Returns:

true if the actions are granted; otherwise false

Throws:

ItemNotFoundException - if the target item does not exist

RepositoryException - if another error occurs

See Also:

AccessManager.isGranted(NodeState, Path, String[])

isGranted

public boolean isGranted(ItemState itemState,
                         String[] actions)
                  throws ItemNotFoundException,
                         RepositoryException

Description copied from interface: AccessManager

Determines whether the specified permissions are granted on the item with the specified path.

Specified by:

isGranted in interface AccessManager

actions - An array of actions that need to be checked.

Returns:

true if the actions are granted; otherwise false

Throws:

ItemNotFoundException - if the target item does not exist

RepositoryException - if another error occurs

See Also:

AccessManager.isGranted(ItemState, String[])

canRead

public boolean canRead(ItemState itemState)
                throws ItemNotFoundException,
                       RepositoryException

Description copied from interface: AccessManager

Returns true if the existing item with the given ItemId can be read.

Specified by:

canRead in interface AccessManager

Returns:

Throws:

ItemNotFoundException

RepositoryException

See Also:

AccessManager.canRead(ItemState)

canRemove

public boolean canRemove(ItemState itemState)
                  throws ItemNotFoundException,
                         RepositoryException

Description copied from interface: AccessManager

Returns true if the existing item state can be removed.

Specified by:

canRemove in interface AccessManager

Returns:

Throws:

ItemNotFoundException

RepositoryException

See Also:

AccessManager.canRemove(ItemState)

canAccess

public boolean canAccess(String workspaceName)
                  throws NoSuchWorkspaceException,
                         RepositoryException

Description copied from interface: AccessManager

Determines whether the subject of the current context is granted access to the given workspace.

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:

NoSuchWorkspaceException - if a workspace with the given name does not exist.

RepositoryException - if another error occurs

See Also:

AccessManager.canAccess(String)

getRegisteredNamespaces

public Map getRegisteredNamespaces()
                            throws RepositoryException

Specified by:

getRegisteredNamespaces in interface NamespaceStorage

Throws:

RepositoryException

getPrefix

public String getPrefix(String uri)
                 throws NamespaceException,
                        RepositoryException

Specified by:

getPrefix in interface NamespaceStorage

Throws:

NamespaceException

RepositoryException

getURI

public String getURI(String prefix)
              throws NamespaceException,
                     RepositoryException

Specified by:

getURI in interface NamespaceStorage

Throws:

NamespaceException

RepositoryException

registerNamespace

public void registerNamespace(String prefix,
                              String uri)
                       throws NamespaceException,
                              UnsupportedRepositoryOperationException,
                              AccessDeniedException,
                              RepositoryException

Specified by:

registerNamespace in interface NamespaceStorage

Throws:

NamespaceException

UnsupportedRepositoryOperationException

AccessDeniedException

RepositoryException

unregisterNamespace

public void unregisterNamespace(String uri)
                         throws NamespaceException,
                                UnsupportedRepositoryOperationException,
                                AccessDeniedException,
                                RepositoryException

Specified by:

unregisterNamespace in interface NamespaceStorage

Throws:

NamespaceException

UnsupportedRepositoryOperationException

AccessDeniedException

RepositoryException