org.apache.jackrabbit.core

Class WorkspaceImpl

java.lang.Object

org.apache.jackrabbit.commons.AbstractWorkspace

org.apache.jackrabbit.core.WorkspaceImpl

All Implemented Interfaces:

javax.jcr.Workspace, JackrabbitWorkspace, EventStateCollectionFactory

public class WorkspaceImpl
extends AbstractWorkspace
implements JackrabbitWorkspace, javax.jcr.Workspace, EventStateCollectionFactory

A WorkspaceImpl ...

Field Summary

Fields

Modifier and Type	Field and Description
protected SessionContext	context The component context of this session.
protected CachingHierarchyManager	hierMgr The hierarchy mgr that reflects persistent state only (i.e.
protected LockManager	lockMgr The LockManager for this Workspace
protected ObservationManagerImpl	obsMgr The ObservationManager instance for this session.
protected QueryManagerImpl	queryManager The QueryManager for this Workspace.
protected SessionImpl	session the session that was used to acquire this Workspace
protected LocalItemStateManager	stateMgr The persistent state mgr associated with the workspace represented by this Workspace instance.
protected VersionManagerImpl	versionMgr The API Version manager for this workspace
protected WorkspaceConfig	wspConfig The configuration of this Workspace

Fields inherited from interface javax.jcr.Workspace

NAME_ACTIVITIES_NODE, NAME_CONFIGURATIONS_NODE, NAME_JCR_XMLCHARACTERS, NAME_JCR_XMLTEXT, NAME_NODE_TYPES_NODE, NAME_SYSTEM_NODE, NAME_UNFILED_NODE, NAME_VERSION_STORAGE_NODE, NAME_WORKSPACE_ROOT, PATH_ACTIVITIES_NODE, PATH_CONFIGURATIONS_NODE, PATH_NODE_TYPES_NODE, PATH_SYSTEM_NODE, PATH_UNFILED_NODE, PATH_VERSION_STORAGE_NODE, PATH_WORKSPACE_ROOT, RELPATH_JCR_XMLCHARACTERS

Constructor Summary

Constructors

Constructor and Description
WorkspaceImpl(SessionContext context, WorkspaceConfig wspConfig) Creates a new workspace instance

Method Summary

Methods

Modifier and Type	Method and Description
void	clone(String srcWorkspace, String srcAbsPath, String destAbsPath, boolean removeExisting)
void	copy(String srcAbsPath, String destAbsPath)
void	copy(String srcWorkspace, String srcAbsPath, String destAbsPath)
EventStateCollection	createEventStateCollection() Creates an EventStateCollection.
protected LocalItemStateManager	createItemStateManager() Create the persistent item state manager on top of the shared item state manager.
void	createWorkspace(String name) Creates a new Workspace with the specified name.
void	createWorkspace(String workspaceName, InputSource configTemplate) Creates a workspace with the given name and a workspace configuration template.
void	createWorkspace(String name, String srcWorkspace)
void	deleteWorkspace(String name)
String[]	getAccessibleWorkspaceNames() Returns the names of all workspaces of this repository with respect of the access rights of this session.
WorkspaceConfig	getConfig() Returns the configuration of this workspace.
HierarchyManager	getHierarchyManager() The hierarchy manager that reflects workspace state only (i.e.
ContentHandler	getImportContentHandler(String parentAbsPath, int uuidBehavior)
LockManager	getInternalLockManager() Return the lock manager for this workspace.
LocalItemStateManager	getItemStateManager() Returns the item state manager associated with the workspace represented by this WorkspaceImpl instance.
javax.jcr.lock.LockManager	getLockManager()
String	getName()
javax.jcr.NamespaceRegistry	getNamespaceRegistry()
javax.jcr.nodetype.NodeTypeManager	getNodeTypeManager()
javax.jcr.observation.ObservationManager	getObservationManager() Returns the observation manager of this session.
PrivilegeManager	getPrivilegeManager() Return the PrivilegeManager.
javax.jcr.query.QueryManager	getQueryManager()
javax.jcr.Session	getSession()
protected SharedItemStateManager	getSharedItemStateManager() Returns the shared item state manager of this workspace.
javax.jcr.version.VersionManager	getVersionManager()
void	move(String srcAbsPath, String destAbsPath)
void	restore(javax.jcr.version.Version[] versions, boolean removeExisting) Deprecated.
void	sanityCheck() Performs a sanity check on this workspace and the associated session.

Methods inherited from class org.apache.jackrabbit.commons.AbstractWorkspace

importXML

Methods inherited from class java.lang.Object

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

Methods inherited from interface javax.jcr.Workspace

importXML

Field Detail

context

protected final SessionContext context

The component context of this session.

wspConfig

protected final WorkspaceConfig wspConfig

The configuration of this Workspace

stateMgr

protected final LocalItemStateManager stateMgr

The persistent state mgr associated with the workspace represented by this Workspace instance.

hierMgr

protected final CachingHierarchyManager hierMgr

The hierarchy mgr that reflects persistent state only (i.e. that is isolated from transient changes made through the session).

obsMgr

protected ObservationManagerImpl obsMgr

The ObservationManager instance for this session.

queryManager

protected QueryManagerImpl queryManager

The QueryManager for this Workspace.

session

protected final SessionImpl session

the session that was used to acquire this Workspace

lockMgr

protected LockManager lockMgr

The LockManager for this Workspace

versionMgr

protected VersionManagerImpl versionMgr

The API Version manager for this workspace

Constructor Detail

WorkspaceImpl

public WorkspaceImpl(SessionContext context,
             WorkspaceConfig wspConfig)
              throws javax.jcr.RepositoryException

Creates a new workspace instance

Parameters:

context - component context of this session

wspConfig - The workspace configuration

Throws:

javax.jcr.RepositoryException - if the workspace can not be accessed

Method Detail

getHierarchyManager

public HierarchyManager getHierarchyManager()

The hierarchy manager that reflects workspace state only (i.e. that is isolated from transient changes made through the session)

Returns:

the hierarchy manager of this workspace

getItemStateManager

public LocalItemStateManager getItemStateManager()

Returns the item state manager associated with the workspace represented by this WorkspaceImpl instance.

Returns:

the item state manager of this workspace

sanityCheck

public void sanityCheck()
                 throws javax.jcr.RepositoryException

Performs a sanity check on this workspace and the associated session.

Throws:

javax.jcr.RepositoryException - if this workspace has been rendered invalid for some reason

createWorkspace

public void createWorkspace(String name,
                   String srcWorkspace)
                     throws javax.jcr.AccessDeniedException,
                            javax.jcr.RepositoryException

Specified by:

createWorkspace in interface javax.jcr.Workspace

Throws:

javax.jcr.AccessDeniedException

javax.jcr.RepositoryException

deleteWorkspace

public void deleteWorkspace(String name)
                     throws javax.jcr.AccessDeniedException,
                            javax.jcr.UnsupportedRepositoryOperationException,
                            javax.jcr.RepositoryException

Always throws UnsupportedRepositoryOperationException since removal of workspaces is currently not supported.

Specified by:

deleteWorkspace in interface javax.jcr.Workspace

Throws:

javax.jcr.AccessDeniedException

javax.jcr.UnsupportedRepositoryOperationException

javax.jcr.RepositoryException

getLockManager

public javax.jcr.lock.LockManager getLockManager()
                                          throws javax.jcr.UnsupportedRepositoryOperationException,
                                                 javax.jcr.RepositoryException

Specified by:

getLockManager in interface javax.jcr.Workspace

Throws:

javax.jcr.UnsupportedRepositoryOperationException

javax.jcr.RepositoryException

See Also:

Workspace.getLockManager(), LockManager

getVersionManager

public javax.jcr.version.VersionManager getVersionManager()

Specified by:

getVersionManager in interface javax.jcr.Workspace

See Also:

Workspace.getVersionManager()

createWorkspace

public void createWorkspace(String name)
                     throws javax.jcr.AccessDeniedException,
                            javax.jcr.RepositoryException

Creates a new Workspace with the specified name. The new workspace is empty, meaning it contains only root node.

The new workspace can be accessed through a login specifying its name.

Throws an AccessDeniedException if the session through which this Workspace object was acquired does not have permission to create the new workspace.

Throws an UnsupportedRepositoryOperationException if the repository does not support the creation of workspaces.

A RepositoryException is thrown if another error occurs.

Specified by:

createWorkspace in interface javax.jcr.Workspace

Specified by:

createWorkspace in interface JackrabbitWorkspace

Parameters:

name - A String, the name of the new workspace.

Throws:

javax.jcr.AccessDeniedException - if the session through which this Workspace object was acquired does not have permission to create the new workspace.

javax.jcr.RepositoryException - if another error occurs.

Since:

JCR 2.0

See Also:

Workspace.getAccessibleWorkspaceNames()

createWorkspace

public void createWorkspace(String workspaceName,
                   InputSource configTemplate)
                     throws javax.jcr.AccessDeniedException,
                            javax.jcr.RepositoryException

Creates a workspace with the given name and a workspace configuration template.

Specified by:

createWorkspace in interface JackrabbitWorkspace

Parameters:

workspaceName - name of the new workspace

configTemplate - the configuration template of the new workspace

Throws:

javax.jcr.AccessDeniedException - if the current session is not allowed to create the workspace

javax.jcr.RepositoryException - if a workspace with the given name already exists or if another error occurs

See Also:

getAccessibleWorkspaceNames()

getPrivilegeManager

public PrivilegeManager getPrivilegeManager()
                                     throws javax.jcr.RepositoryException

Return the PrivilegeManager.

Specified by:

getPrivilegeManager in interface JackrabbitWorkspace

Returns:

Throws:

javax.jcr.RepositoryException

See Also:

JackrabbitWorkspace.getPrivilegeManager()

getConfig

public WorkspaceConfig getConfig()

Returns the configuration of this workspace.

Returns:

the workspace configuration

getInternalLockManager

public LockManager getInternalLockManager()
                                   throws javax.jcr.RepositoryException

Return the lock manager for this workspace. If not already done, creates a new instance.

Returns:

lock manager for this workspace

Throws:

javax.jcr.RepositoryException - if an error occurs

getName

public String getName()

Specified by:

getName in interface javax.jcr.Workspace

getSession

public javax.jcr.Session getSession()

Specified by:

getSession in interface javax.jcr.Workspace

getNamespaceRegistry

public javax.jcr.NamespaceRegistry getNamespaceRegistry()
                                                 throws javax.jcr.RepositoryException

Specified by:

getNamespaceRegistry in interface javax.jcr.Workspace

Throws:

javax.jcr.RepositoryException

getNodeTypeManager

public javax.jcr.nodetype.NodeTypeManager getNodeTypeManager()
                                                      throws javax.jcr.RepositoryException

Specified by:

getNodeTypeManager in interface javax.jcr.Workspace

Throws:

javax.jcr.RepositoryException

clone

public void clone(String srcWorkspace,
         String srcAbsPath,
         String destAbsPath,
         boolean removeExisting)
           throws javax.jcr.NoSuchWorkspaceException,
                  javax.jcr.nodetype.ConstraintViolationException,
                  javax.jcr.version.VersionException,
                  javax.jcr.AccessDeniedException,
                  javax.jcr.PathNotFoundException,
                  javax.jcr.ItemExistsException,
                  javax.jcr.lock.LockException,
                  javax.jcr.RepositoryException

Specified by:

clone in interface javax.jcr.Workspace

Throws:

javax.jcr.NoSuchWorkspaceException

javax.jcr.nodetype.ConstraintViolationException

javax.jcr.version.VersionException

javax.jcr.AccessDeniedException

javax.jcr.PathNotFoundException

javax.jcr.ItemExistsException

javax.jcr.lock.LockException

javax.jcr.RepositoryException

copy

public void copy(String srcAbsPath,
        String destAbsPath)
          throws javax.jcr.nodetype.ConstraintViolationException,
                 javax.jcr.version.VersionException,
                 javax.jcr.AccessDeniedException,
                 javax.jcr.PathNotFoundException,
                 javax.jcr.ItemExistsException,
                 javax.jcr.lock.LockException,
                 javax.jcr.RepositoryException

Specified by:

copy in interface javax.jcr.Workspace

Throws:

javax.jcr.nodetype.ConstraintViolationException

javax.jcr.version.VersionException

javax.jcr.AccessDeniedException

javax.jcr.PathNotFoundException

javax.jcr.ItemExistsException

javax.jcr.lock.LockException

javax.jcr.RepositoryException

copy

public void copy(String srcWorkspace,
        String srcAbsPath,
        String destAbsPath)
          throws javax.jcr.NoSuchWorkspaceException,
                 javax.jcr.nodetype.ConstraintViolationException,
                 javax.jcr.version.VersionException,
                 javax.jcr.AccessDeniedException,
                 javax.jcr.PathNotFoundException,
                 javax.jcr.ItemExistsException,
                 javax.jcr.lock.LockException,
                 javax.jcr.RepositoryException

Specified by:

copy in interface javax.jcr.Workspace

Throws:

javax.jcr.NoSuchWorkspaceException

javax.jcr.nodetype.ConstraintViolationException

javax.jcr.version.VersionException

javax.jcr.AccessDeniedException

javax.jcr.PathNotFoundException

javax.jcr.ItemExistsException

javax.jcr.lock.LockException

javax.jcr.RepositoryException

move

public void move(String srcAbsPath,
        String destAbsPath)
          throws javax.jcr.nodetype.ConstraintViolationException,
                 javax.jcr.version.VersionException,
                 javax.jcr.AccessDeniedException,
                 javax.jcr.PathNotFoundException,
                 javax.jcr.ItemExistsException,
                 javax.jcr.lock.LockException,
                 javax.jcr.RepositoryException

Specified by:

move in interface javax.jcr.Workspace

Throws:

javax.jcr.nodetype.ConstraintViolationException

javax.jcr.version.VersionException

javax.jcr.AccessDeniedException

javax.jcr.PathNotFoundException

javax.jcr.ItemExistsException

javax.jcr.lock.LockException

javax.jcr.RepositoryException

getObservationManager

public javax.jcr.observation.ObservationManager getObservationManager()

Returns the observation manager of this session.

Specified by:

getObservationManager in interface javax.jcr.Workspace

Returns:

the observation manager of this session

getQueryManager

public javax.jcr.query.QueryManager getQueryManager()
                                             throws javax.jcr.RepositoryException

Specified by:

getQueryManager in interface javax.jcr.Workspace

Throws:

javax.jcr.RepositoryException

restore

@Deprecated
public void restore(javax.jcr.version.Version[] versions,
                      boolean removeExisting)
             throws javax.jcr.ItemExistsException,
                    javax.jcr.UnsupportedRepositoryOperationException,
                    javax.jcr.version.VersionException,
                    javax.jcr.lock.LockException,
                    javax.jcr.InvalidItemStateException,
                    javax.jcr.RepositoryException

Deprecated.

Specified by:

restore in interface javax.jcr.Workspace

Throws:

javax.jcr.ItemExistsException

javax.jcr.UnsupportedRepositoryOperationException

javax.jcr.version.VersionException

javax.jcr.lock.LockException

javax.jcr.InvalidItemStateException

javax.jcr.RepositoryException

getAccessibleWorkspaceNames

public String[] getAccessibleWorkspaceNames()
                                     throws javax.jcr.RepositoryException

Returns the names of all workspaces of this repository with respect of the access rights of this session.

Specified by:

getAccessibleWorkspaceNames in interface javax.jcr.Workspace

Returns:

the names of all accessible workspaces

Throws:

javax.jcr.RepositoryException - if an error occurs

getImportContentHandler

public ContentHandler getImportContentHandler(String parentAbsPath,
                                     int uuidBehavior)
                                       throws javax.jcr.PathNotFoundException,
                                              javax.jcr.nodetype.ConstraintViolationException,
                                              javax.jcr.version.VersionException,
                                              javax.jcr.lock.LockException,
                                              javax.jcr.RepositoryException

Specified by:

getImportContentHandler in interface javax.jcr.Workspace

Throws:

javax.jcr.PathNotFoundException

javax.jcr.nodetype.ConstraintViolationException

javax.jcr.version.VersionException

javax.jcr.lock.LockException

javax.jcr.RepositoryException

getSharedItemStateManager

protected SharedItemStateManager getSharedItemStateManager()
                                                    throws javax.jcr.RepositoryException

Returns the shared item state manager of this workspace.

Returns:

shared item state manager

Throws:

javax.jcr.RepositoryException - if the workspace can not be accessed

createItemStateManager

protected LocalItemStateManager createItemStateManager()
                                                throws javax.jcr.RepositoryException

Create the persistent item state manager on top of the shared item state manager.

Returns:

local item state manager

Throws:

javax.jcr.RepositoryException - if the workspace can not be accessed

createEventStateCollection

public EventStateCollection createEventStateCollection()
                                                throws javax.jcr.RepositoryException

Creates an EventStateCollection.

Implemented in this object and forwarded rather than obsMgr since creation of the latter is lazy.

Specified by:

createEventStateCollection in interface EventStateCollectionFactory

Returns:

a new EventStateCollection

Throws:

javax.jcr.RepositoryException - if creation fails for some reason