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

Direct Known Subclasses:

XAWorkspace

public class WorkspaceImpl
extends AbstractWorkspace
implements JackrabbitWorkspace, EventStateCollectionFactory

A WorkspaceImpl ...

Field Summary

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 RepositoryImpl	rep The repository that created this workspace instance
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 WorkspaceConfig	wspConfig The configuration of this Workspace

Constructor Summary

protected

WorkspaceImpl(WorkspaceConfig wspConfig, SharedItemStateManager stateMgr, RepositoryImpl rep, SessionImpl session) Protected constructor.

Method Summary

void	clone(java.lang.String srcWorkspace, java.lang.String srcAbsPath, java.lang.String destAbsPath, boolean removeExisting)
void	copy(java.lang.String srcAbsPath, java.lang.String destAbsPath)
void	copy(java.lang.String srcWorkspace, java.lang.String srcAbsPath, java.lang.String destAbsPath)
EventStateCollection	createEventStateCollection() Creates an EventStateCollection.
protected LocalItemStateManager	createItemStateManager(SharedItemStateManager shared) Create the persistent item state manager on top of the shared item state manager.
void	createWorkspace(java.lang.String name) Creates a new Workspace with the specified name.
void	createWorkspace(java.lang.String workspaceName, org.xml.sax.InputSource configTemplate) Creates a workspace with the given name and a workspace configuration template.
void	createWorkspace(java.lang.String name, java.lang.String srcWorkspace) Creates a new Workspace with the specified name initialized with a clone of the content of the workspace srcWorkspace.
void	deleteWorkspace(java.lang.String name) Deletes the workspace with the specified name from the repository, deleting all content within it.
java.lang.String[]	getAccessibleWorkspaceNames()
WorkspaceConfig	getConfig() Returns the configuration of this workspace.
HierarchyManager	getHierarchyManager() The hierarchy manager that reflects workspace state only (i.e.
org.xml.sax.ContentHandler	getImportContentHandler(java.lang.String parentAbsPath, int uuidBehavior)
LocalItemStateManager	getItemStateManager() Returns the item state manager associated with the workspace represented by this WorkspaceImpl instance.
LockManager	getLockManager() Return the lock manager for this workspace.
java.lang.String	getName()
javax.jcr.NamespaceRegistry	getNamespaceRegistry()
javax.jcr.nodetype.NodeTypeManager	getNodeTypeManager()
javax.jcr.observation.ObservationManager	getObservationManager() Returns the observation manager of this session.
javax.jcr.query.QueryManager	getQueryManager()
javax.jcr.Session	getSession()
void	move(java.lang.String srcAbsPath, java.lang.String destAbsPath)
void	restore(javax.jcr.version.Version[] versions, boolean removeExisting)
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

wspConfig

protected final WorkspaceConfig wspConfig

The configuration of this Workspace

rep

protected final RepositoryImpl rep

The repository that created this workspace instance

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

Constructor Detail

WorkspaceImpl

protected WorkspaceImpl(WorkspaceConfig wspConfig,
                        SharedItemStateManager stateMgr,
                        RepositoryImpl rep,
                        SessionImpl session)

Protected constructor.

Parameters:

wspConfig - The workspace configuration

stateMgr - The shared item state manager

rep - The repository

session - The session

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(java.lang.String name,
                            java.lang.String srcWorkspace)
                     throws javax.jcr.AccessDeniedException,
                            javax.jcr.UnsupportedRepositoryOperationException,
                            javax.jcr.RepositoryException

Creates a new Workspace with the specified name initialized with a clone of the content of the workspace srcWorkspace. Semantically, this method is equivalent to creating a new workspace and manually cloning srcWorkspace to it; however, this method may assist some implementations in optimizing subsequent Node.update and Node.merge calls between the new workspace and its source.

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.

Parameters:

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

srcWorkspace - The name of the workspace from which the new workspace is to be cloned.

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.UnsupportedRepositoryOperationException - if the repository does not support the creation of workspaces.

javax.jcr.RepositoryException - if another error occurs.

Since:

JCR 2.0

deleteWorkspace

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

Deletes the workspace with the specified name from the repository, deleting all content within it.

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

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

Parameters:

name - A String, the name of the workspace to be deleted.

Throws:

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

javax.jcr.UnsupportedRepositoryOperationException - if the repository does not support the removal of workspaces.

javax.jcr.RepositoryException - if another error occurs.

Since:

JCR 2.0

createWorkspace

public void createWorkspace(java.lang.String name)
                     throws javax.jcr.AccessDeniedException,
                            javax.jcr.UnsupportedRepositoryOperationException,
                            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 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.UnsupportedRepositoryOperationException - if the repository does not support the creation of workspaces.

javax.jcr.RepositoryException - if another error occurs.

Since:

JCR 2.0

See Also:

Workspace.getAccessibleWorkspaceNames()

createWorkspace

public void createWorkspace(java.lang.String workspaceName,
                            org.xml.sax.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()

getConfig

public WorkspaceConfig getConfig()

Returns the configuration of this workspace.

Returns:

the workspace configuration

getLockManager

public LockManager getLockManager()
                           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 java.lang.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(java.lang.String srcWorkspace,
                  java.lang.String srcAbsPath,
                  java.lang.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(java.lang.String srcAbsPath,
                 java.lang.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(java.lang.String srcWorkspace,
                 java.lang.String srcAbsPath,
                 java.lang.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(java.lang.String srcAbsPath,
                 java.lang.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()
                                                               throws javax.jcr.RepositoryException

Returns the observation manager of this session. The observation manager is lazily created if it does not exist yet.

Specified by:

getObservationManager in interface javax.jcr.Workspace

Returns:

the observation manager of this session

Throws:

javax.jcr.RepositoryException - if a repository error occurs

getQueryManager

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

Specified by:

getQueryManager in interface javax.jcr.Workspace

Throws:

javax.jcr.RepositoryException

restore

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

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 java.lang.String[] getAccessibleWorkspaceNames()
                                               throws javax.jcr.RepositoryException

Specified by:

getAccessibleWorkspaceNames in interface javax.jcr.Workspace

Throws:

javax.jcr.RepositoryException

getImportContentHandler

public org.xml.sax.ContentHandler getImportContentHandler(java.lang.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

createItemStateManager

protected LocalItemStateManager createItemStateManager(SharedItemStateManager shared)

Create the persistent item state manager on top of the shared item state manager. May be overridden by subclasses.

Parameters:

shared - shared item state manager

Returns:

local item state manager

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