org.apache.jackrabbit.jcr2spi
Class SessionImpl

java.lang.Object
  org.apache.jackrabbit.commons.AbstractSession
      org.apache.jackrabbit.jcr2spi.SessionImpl

All Implemented Interfaces:

javax.jcr.Session, ManagerProvider, NamespaceResolver

Direct Known Subclasses:

XASessionImpl

public class SessionImpl
extends AbstractSession
implements NamespaceResolver, ManagerProvider

SessionImpl...

Method Summary

void	addListener(SessionListener listener) Add a SessionListener
void	addLockToken(java.lang.String lt)
void	checkPermission(java.lang.String absPath, java.lang.String actions)
protected ItemManager	createItemManager(HierarchyManager hierarchyManager)
protected SessionItemStateManager	createSessionItemStateManager(UpdatableItemStateManager workspaceStateManager, ItemStateFactory isf)
protected WorkspaceImpl	createWorkspaceInstance(RepositoryConfig config, SessionInfo sessionInfo)
AccessManager	getAccessManager()
java.lang.Object	getAttribute(java.lang.String name) Always returns null.
java.lang.String[]	getAttributeNames() Always returns an empty String array.
EffectiveNodeTypeProvider	getEffectiveNodeTypeProvider()
HierarchyManager	getHierarchyManager()
IdFactory	getIdFactory()
org.xml.sax.ContentHandler	getImportContentHandler(java.lang.String parentAbsPath, int uuidBehavior)
javax.jcr.Item	getItem(java.lang.String absPath) Returns the node or property at the given path.
ItemDefinitionProvider	getItemDefinitionProvider()
javax.jcr.ValueFactory	getJcrValueFactory() Same as Session.getValueFactory() but omits the check, if this repository is really level 2 compliant.
LockManager	getLockManager() Returns the AccessManager associated with this ManagerProvider.
java.lang.String[]	getLockTokens()
NameFactory	getNameFactory()
NamePathResolver	getNamePathResolver()
NameResolver	getNameResolver()
NamespaceResolver	getNamespaceResolver()
javax.jcr.Node	getNodeByUUID(java.lang.String uuid)
PathResolver	getPathResolver()
java.lang.String	getPrefix(java.lang.String uri) Returns the prefix which is mapped to the given URI.
QValueFactory	getQValueFactory()
javax.jcr.Repository	getRepository()
javax.jcr.Node	getRootNode()
java.lang.String	getURI(java.lang.String prefix) Returns the URI to which the given prefix is mapped.
java.lang.String	getUserID()
ItemStateValidator	getValidator()
javax.jcr.ValueFactory	getValueFactory()
VersionManager	getVersionManager() Returns the VersionManager associated with this ManagerProvider.
javax.jcr.Workspace	getWorkspace()
boolean	hasPendingChanges()
javax.jcr.Session	impersonate(javax.jcr.Credentials credentials) Logs in the same workspace with the given credentials.
void	importXML(java.lang.String parentAbsPath, java.io.InputStream in, int uuidBehavior) Parses the given input stream as an XML document and processes the SAX events using the ContentHandler returned by Session.getImportContentHandler(String, int).
boolean	isLive()
boolean	itemExists(java.lang.String absPath) Calls AbstractSession.getItem(String) with the given path and returns true if the call succeeds.
void	logout() Clears the local namespace mappings.
void	move(java.lang.String srcAbsPath, java.lang.String destAbsPath)
void	refresh(boolean keepChanges)
void	removeListener(SessionListener listener) Remove a SessionListener
void	removeLockToken(java.lang.String lt)
void	save()
void	setNamespacePrefix(java.lang.String prefix, java.lang.String uri) Modifies the session local namespace mappings to contain the given prefix to URI mapping.

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

exportDocumentView, exportDocumentView, exportSystemView, exportSystemView, getNamespacePrefix, getNamespacePrefixes, getNamespaceURI

Methods inherited from class java.lang.Object

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

Method Detail

getRepository

public javax.jcr.Repository getRepository()

Specified by:

getRepository in interface javax.jcr.Session

See Also:

Session.getRepository()

getUserID

public java.lang.String getUserID()

Specified by:

getUserID in interface javax.jcr.Session

See Also:

Session.getUserID()

getAttribute

public java.lang.Object getAttribute(java.lang.String name)

Always returns null.

Specified by:

getAttribute in interface javax.jcr.Session

See Also:

Session.getAttribute(String)

getAttributeNames

public java.lang.String[] getAttributeNames()

Always returns an empty String array.

Specified by:

getAttributeNames in interface javax.jcr.Session

See Also:

Session.getAttributeNames()

getWorkspace

public javax.jcr.Workspace getWorkspace()

Specified by:

getWorkspace in interface javax.jcr.Session

See Also:

Session.getWorkspace()

impersonate

public javax.jcr.Session impersonate(javax.jcr.Credentials credentials)
                              throws javax.jcr.LoginException,
                                     javax.jcr.RepositoryException

Description copied from class: AbstractSession

Logs in the same workspace with the given credentials.

The default implementation:

• Retrieves the Repository instance using Session.getRepository()
• Retrieves the current workspace using Session.getWorkspace()
• Retrieves the name of the current workspace using Workspace.getName()
• Calls Repository.login(Credentials, String) on the retrieved repository with the given credentials and the retrieved workspace name.

Specified by:

impersonate in interface javax.jcr.Session

Overrides:

impersonate in class AbstractSession

Parameters:

credentials - login credentials

Returns:

logged in session

Throws:

javax.jcr.RepositoryException - if an error occurs

javax.jcr.LoginException

See Also:

Session.impersonate(Credentials)

getRootNode

public javax.jcr.Node getRootNode()
                           throws javax.jcr.RepositoryException

Specified by:

getRootNode in interface javax.jcr.Session

Throws:

javax.jcr.RepositoryException

See Also:

Session.getRootNode()

getNodeByUUID

public javax.jcr.Node getNodeByUUID(java.lang.String uuid)
                             throws javax.jcr.ItemNotFoundException,
                                    javax.jcr.RepositoryException

Specified by:

getNodeByUUID in interface javax.jcr.Session

Throws:

javax.jcr.ItemNotFoundException

javax.jcr.RepositoryException

See Also:

Session.getNodeByUUID(String)

getItem

public javax.jcr.Item getItem(java.lang.String absPath)
                       throws javax.jcr.PathNotFoundException,
                              javax.jcr.RepositoryException

Description copied from class: AbstractSession

Returns the node or property at the given path.

The default implementation:

• Throws a PathNotFoundException if the given path does not start with a slash.
• Returns the root node if the given path is "/"
• Calls Node.getNode(String) on the root node with the part of the given path after the first slash
• Calls Node.getProperty(String) similarly in case the above call fails with a PathNotFoundException

Specified by:

getItem in interface javax.jcr.Session

Overrides:

getItem in class AbstractSession

Parameters:

absPath - absolute path

Returns:

the node or property with the given path

Throws:

javax.jcr.PathNotFoundException - if the given path is invalid or not found

javax.jcr.RepositoryException - if another error occurs

See Also:

Session.getItem(String)

itemExists

public boolean itemExists(java.lang.String absPath)
                   throws javax.jcr.RepositoryException

Description copied from class: AbstractSession

Calls AbstractSession.getItem(String) with the given path and returns true if the call succeeds. Returns false if a PathNotFoundException was thrown. Other exceptions are passed through.

Specified by:

itemExists in interface javax.jcr.Session

Overrides:

itemExists in class AbstractSession

Parameters:

absPath - absolute path

Returns:

true if an item exists at the given path, false otherwise

Throws:

javax.jcr.RepositoryException - if an error occurs

See Also:

Session.itemExists(String)

move

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

Specified by:

move in interface javax.jcr.Session

Throws:

javax.jcr.ItemExistsException

javax.jcr.PathNotFoundException

javax.jcr.version.VersionException

javax.jcr.nodetype.ConstraintViolationException

javax.jcr.lock.LockException

javax.jcr.RepositoryException

See Also:

Session.move(String, String)

save

public void save()
          throws javax.jcr.AccessDeniedException,
                 javax.jcr.nodetype.ConstraintViolationException,
                 javax.jcr.InvalidItemStateException,
                 javax.jcr.version.VersionException,
                 javax.jcr.lock.LockException,
                 javax.jcr.RepositoryException

Specified by:

save in interface javax.jcr.Session

Throws:

javax.jcr.AccessDeniedException

javax.jcr.nodetype.ConstraintViolationException

javax.jcr.InvalidItemStateException

javax.jcr.version.VersionException

javax.jcr.lock.LockException

javax.jcr.RepositoryException

See Also:

Session.save()

refresh

public void refresh(boolean keepChanges)
             throws javax.jcr.RepositoryException

Specified by:

refresh in interface javax.jcr.Session

Throws:

javax.jcr.RepositoryException

See Also:

Session.refresh(boolean)

hasPendingChanges

public boolean hasPendingChanges()
                          throws javax.jcr.RepositoryException

Specified by:

hasPendingChanges in interface javax.jcr.Session

Throws:

javax.jcr.RepositoryException

See Also:

Session.hasPendingChanges()

getValueFactory

public javax.jcr.ValueFactory getValueFactory()
                                       throws javax.jcr.UnsupportedRepositoryOperationException,
                                              javax.jcr.RepositoryException

Specified by:

getValueFactory in interface javax.jcr.Session

Throws:

javax.jcr.UnsupportedRepositoryOperationException

javax.jcr.RepositoryException

See Also:

Session.getValueFactory()

checkPermission

public void checkPermission(java.lang.String absPath,
                            java.lang.String actions)
                     throws java.security.AccessControlException,
                            javax.jcr.RepositoryException

Specified by:

checkPermission in interface javax.jcr.Session

Throws:

java.security.AccessControlException

javax.jcr.RepositoryException

See Also:

Session.checkPermission(String, String)

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.Session

Throws:

javax.jcr.PathNotFoundException

javax.jcr.nodetype.ConstraintViolationException

javax.jcr.version.VersionException

javax.jcr.lock.LockException

javax.jcr.RepositoryException

See Also:

Session.getImportContentHandler(String, int)

importXML

public void importXML(java.lang.String parentAbsPath,
                      java.io.InputStream in,
                      int uuidBehavior)
               throws java.io.IOException,
                      javax.jcr.PathNotFoundException,
                      javax.jcr.ItemExistsException,
                      javax.jcr.nodetype.ConstraintViolationException,
                      javax.jcr.version.VersionException,
                      javax.jcr.InvalidSerializedDataException,
                      javax.jcr.lock.LockException,
                      javax.jcr.RepositoryException

Description copied from class: AbstractSession

Parses the given input stream as an XML document and processes the SAX events using the ContentHandler returned by Session.getImportContentHandler(String, int).

Specified by:

importXML in interface javax.jcr.Session

Overrides:

importXML in class AbstractSession

Parameters:

parentAbsPath - passed through

in - input stream to be parsed as XML and imported

uuidBehavior - passed through

Throws:

java.io.IOException - if an I/O error occurs

javax.jcr.InvalidSerializedDataException - if an XML parsing error occurs

javax.jcr.RepositoryException - if a repository error occurs

javax.jcr.PathNotFoundException

javax.jcr.ItemExistsException

javax.jcr.nodetype.ConstraintViolationException

javax.jcr.version.VersionException

javax.jcr.lock.LockException

See Also:

Session.importXML(String, java.io.InputStream, int)

setNamespacePrefix

public void setNamespacePrefix(java.lang.String prefix,
                               java.lang.String uri)
                        throws javax.jcr.RepositoryException

Description copied from class: AbstractSession

Modifies the session local namespace mappings to contain the given prefix to URI mapping.

This behaviour is based on JSR 283 (JCR 2.0), but remains backwards compatible with JCR 1.0.

Specified by:

setNamespacePrefix in interface javax.jcr.Session

Overrides:

setNamespacePrefix in class AbstractSession

Parameters:

prefix - namespace prefix

uri - namespace URI

Throws:

javax.jcr.NamespaceException - if the mapping is illegal

javax.jcr.RepositoryException - if a repository error occurs

See Also:

Session.setNamespacePrefix(String, String)

logout

public void logout()

Description copied from class: AbstractSession

Clears the local namespace mappings. Subclasses that for example want to participate in a session pools should remember to call super.logout() when overriding this method to avoid namespace mappings to be carried over to a new session.

Specified by:

logout in interface javax.jcr.Session

Overrides:

logout in class AbstractSession

See Also:

Session.logout()

isLive

public boolean isLive()

Specified by:

isLive in interface javax.jcr.Session

See Also:

Session.isLive()

addLockToken

public void addLockToken(java.lang.String lt)

Specified by:

addLockToken in interface javax.jcr.Session

See Also:

Session.addLockToken(String)

getLockTokens

public java.lang.String[] getLockTokens()

Specified by:

getLockTokens in interface javax.jcr.Session

See Also:

Session.getLockTokens()

removeLockToken

public void removeLockToken(java.lang.String lt)

Specified by:

removeLockToken in interface javax.jcr.Session

See Also:

Session.removeLockToken(String)

getPrefix

public java.lang.String getPrefix(java.lang.String uri)
                           throws javax.jcr.NamespaceException

Description copied from interface: NamespaceResolver

Returns the prefix which is mapped to the given URI.

Specified by:

getPrefix in interface NamespaceResolver

Parameters:

uri - namespace URI

Returns:

the prefix mapped to the given URI.

Throws:

javax.jcr.NamespaceException - if the URI is unknown.

getURI

public java.lang.String getURI(java.lang.String prefix)
                        throws javax.jcr.NamespaceException

Description copied from interface: NamespaceResolver

Returns the URI to which the given prefix is mapped.

Specified by:

getURI in interface NamespaceResolver

Parameters:

prefix - namespace prefix

Returns:

the namespace URI to which the given prefix is mapped.

Throws:

javax.jcr.NamespaceException - if the prefix is unknown.

addListener

public void addListener(SessionListener listener)

Add a SessionListener

Parameters:

listener - the new listener to be informed on modifications

removeListener

public void removeListener(SessionListener listener)

Remove a SessionListener

Parameters:

listener - an existing listener

createWorkspaceInstance

protected WorkspaceImpl createWorkspaceInstance(RepositoryConfig config,
                                                SessionInfo sessionInfo)
                                         throws javax.jcr.RepositoryException

Throws:

javax.jcr.RepositoryException

createSessionItemStateManager

protected SessionItemStateManager createSessionItemStateManager(UpdatableItemStateManager workspaceStateManager,
                                                                ItemStateFactory isf)
                                                         throws javax.jcr.RepositoryException

Throws:

javax.jcr.RepositoryException

createItemManager

protected ItemManager createItemManager(HierarchyManager hierarchyManager)

getNamePathResolver

public NamePathResolver getNamePathResolver()

Specified by:

getNamePathResolver in interface ManagerProvider

getNameResolver

public NameResolver getNameResolver()

Specified by:

getNameResolver in interface ManagerProvider

See Also:

ManagerProvider.getNameResolver()

getPathResolver

public PathResolver getPathResolver()

Specified by:

getPathResolver in interface ManagerProvider

See Also:

ManagerProvider.getPathResolver()

getNamespaceResolver

public NamespaceResolver getNamespaceResolver()

Specified by:

getNamespaceResolver in interface ManagerProvider

See Also:

ManagerProvider.getNamespaceResolver()

getHierarchyManager

public HierarchyManager getHierarchyManager()

Specified by:

getHierarchyManager in interface ManagerProvider

See Also:

ManagerProvider.getHierarchyManager()

getLockManager

public LockManager getLockManager()

Description copied from interface: ManagerProvider

Returns the AccessManager associated with this ManagerProvider.

Specified by:

getLockManager in interface ManagerProvider

Returns:

the AccessManager associated with this ManagerProvider

See Also:

ManagerProvider.getLockManager()

getAccessManager

public AccessManager getAccessManager()

Specified by:

getAccessManager in interface ManagerProvider

See Also:

ManagerProvider.getAccessManager()

getVersionManager

public VersionManager getVersionManager()

Description copied from interface: ManagerProvider

Returns the VersionManager associated with this ManagerProvider.

Specified by:

getVersionManager in interface ManagerProvider

Returns:

the VersionManager associated with this ManagerProvider

See Also:

ManagerProvider.getVersionManager()

getItemDefinitionProvider

public ItemDefinitionProvider getItemDefinitionProvider()

Specified by:

getItemDefinitionProvider in interface ManagerProvider

See Also:

ManagerProvider.getItemDefinitionProvider()

getEffectiveNodeTypeProvider

public EffectiveNodeTypeProvider getEffectiveNodeTypeProvider()

Specified by:

getEffectiveNodeTypeProvider in interface ManagerProvider

See Also:

ManagerProvider.getEffectiveNodeTypeProvider()

getQValueFactory

public QValueFactory getQValueFactory()
                               throws javax.jcr.RepositoryException

Specified by:

getQValueFactory in interface ManagerProvider

Throws:

javax.jcr.RepositoryException

See Also:

ManagerProvider.getQValueFactory()

getJcrValueFactory

public javax.jcr.ValueFactory getJcrValueFactory()
                                          throws javax.jcr.RepositoryException

Description copied from interface: ManagerProvider

Same as Session.getValueFactory() but omits the check, if this repository is really level 2 compliant. Therefore, this method may be used for internal functionality only, that require creation and conversion of JCR values.

Specified by:

getJcrValueFactory in interface ManagerProvider

Returns:

Throws:

javax.jcr.RepositoryException

See Also:

ManagerProvider.getJcrValueFactory()

getValidator

public ItemStateValidator getValidator()

getIdFactory

public IdFactory getIdFactory()
                       throws javax.jcr.RepositoryException

Throws:

javax.jcr.RepositoryException

getNameFactory

public NameFactory getNameFactory()
                           throws javax.jcr.RepositoryException

Throws:

javax.jcr.RepositoryException