SessionImpl (Apache Jackrabbit 2.12.11 API)

java.lang.Object
- org.apache.jackrabbit.commons.AbstractSession
- - org.apache.jackrabbit.core.SessionImpl

All Implemented Interfaces:

javax.jcr.Session, JackrabbitSession, IdentifierResolver, NamePathResolver, NameResolver, PathResolver, NamespaceResolver, SessionExtensions

Direct Known Subclasses:

XASessionImpl
```
public class SessionImpl
extends AbstractSession
implements JackrabbitSession, SessionExtensions, NamespaceResolver, NamePathResolver, IdentifierResolver
```
A SessionImpl ...

Field Summary

Fields
Modifier and Type	Field and Description
`protected Map<String,Object>`	`attributes` the attributes of this session
`static String`	`AUTO_FIX_CORRUPTIONS` Name of the session attribute that controls whether repository inconsistencies should be automatically fixed when traversing over child nodes, when trying to add a child node, or removing a child node.
`protected SessionContext`	`context` The component context of this session.
`static String`	`DISABLE_CLUSTER_SYNC_ON_REFRESH` Name of the session attribute that controls whether the `refresh(boolean)` method will cause the repository to synchronize itself to changes in other cluster nodes.
`protected Map<SessionListener,SessionListener>`	`listeners` Listeners (weak references)
`protected AuthContext`	`loginContext` the AuthContext of this session (can be null if this session was not instantiated through a login process)
`protected NamePathResolver`	`namePathResolver` Name and Path resolver
`protected RepositoryContext`	`repositoryContext` The component context of the repository that issued this session.
`protected Subject`	`subject` the Subject of this session
`protected String`	`userId` the user ID that was used to acquire this session
`protected InternalVersionManager`	`versionMgr` The version manager for this session

Fields inherited from interface org.apache.jackrabbit.api.JackrabbitSession
ACTION_ADD_PROPERTY, ACTION_LOCKING, ACTION_MODIFY_ACCESS_CONTROL, ACTION_MODIFY_PROPERTY, ACTION_NODE_TYPE_MANAGEMENT, ACTION_READ_ACCESS_CONTROL, ACTION_REMOVE_NODE, ACTION_REMOVE_PROPERTY, ACTION_USER_MANAGEMENT, ACTION_VERSIONING

Fields inherited from interface javax.jcr.Session
ACTION_ADD_NODE, ACTION_READ, ACTION_REMOVE, ACTION_SET_PROPERTY

Constructor Summary

Constructors
Modifier	Constructor and Description
`protected`	`SessionImpl(RepositoryContext repositoryContext, AuthContext loginContext, WorkspaceConfig wspConfig)` Protected constructor.
`protected`	`SessionImpl(RepositoryContext repositoryContext, Subject subject, WorkspaceConfig wspConfig)` Protected constructor.

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`addListener(SessionListener listener)` Add a `SessionListener`
`void`	`addLockToken(String lt)`
`protected boolean`	`autoFixCorruptions()` Checks whether repository inconsistencies should be automatically fixed when traversing over child nodes, when trying to add a child node, or when removing a child node.
`void`	`checkFormat(String identifier)`
`void`	`checkPermission(String absPath, String actions)`
`protected boolean`	`clusterSyncOnRefresh()` Checks whether the `refresh(boolean)` method should cause cluster synchronization.
`protected AccessManager`	`createAccessManager(Subject subject)` Create the access manager.
`GarbageCollector`	`createDataStoreGarbageCollector()` Create a data store garbage collector for this repository.
`protected ItemManager`	`createItemManager()` Create the item manager.
`protected ObservationManagerImpl`	`createObservationManager(String wspName)`
`javax.jcr.Session`	`createSession(String workspaceName)` Creates a new session with the same subject as this sessions but to a different workspace.
`protected SessionItemStateManager`	`createSessionItemStateManager()` Create the session item state manager.
`protected InternalVersionManager`	`createVersionManager()` Create the version manager.
`void`	`finalize()` Finalize the session.
`javax.jcr.security.AccessControlManager`	`getAccessControlManager()`
`AccessManager`	`getAccessManager()` Returns the `AccessManager` associated with this session.
`Object`	`getAttribute(String name)`
`String[]`	`getAttributeNames()`
`HierarchyManager`	`getHierarchyManager()` Returns the `HierarchyManager` associated with this session.
`ContentHandler`	`getImportContentHandler(String parentAbsPath, int uuidBehavior)`
`InternalVersionManager`	`getInternalVersionManager()` Returns the `InternalVersionManager` associated with this session.
`javax.jcr.Item`	`getItem(String absPath)` Returns the node or property at the given path.
`ItemManager`	`getItemManager()` Returns the `ItemManager` of this session.
`javax.jcr.Item`	`getItemOrNull(String absPath)` Returns the node at the specified absolute path in the workspace.
`String`	`getJCRName(Name name)` Returns the qualified JCR name String for the given `Name` object.
`String`	`getJCRPath(Path path)` Returns the given JCR path string for the given path object.
`javax.jcr.lock.Lock[]`	`getLocks()` Returns all locks owned by this session.
`String[]`	`getLockTokens()`
`javax.jcr.Node`	`getNode(String absPath)` Returns the node with the given absolute path.
`NodeImpl`	`getNodeById(NodeId id)` Retrieves the `Node` with the given id.
`javax.jcr.Node`	`getNodeByIdentifier(String id)`
`javax.jcr.Node`	`getNodeByUUID(String uuid)`
`javax.jcr.Node`	`getNodeOrNull(String absPath)` Returns the node at the specified absolute path in the workspace or `null` if no such node exists.
`NodeTypeManagerImpl`	`getNodeTypeManager()` Returns the `NodeTypeManager`.
`Path`	`getPath(String identifier)`
`String`	`getPrefix(String uri)` Returns the prefix which is mapped to the given URI.
`PrincipalManager`	`getPrincipalManager()` Returns the `PrincipalManager` for the current `Session`.
`javax.jcr.Property`	`getProperty(String absPath)` Returns the property with the given absolute path.
`javax.jcr.Property`	`getPropertyOrNull(String absPath)` Returns the property at the specified absolute path in the workspace or `null` if no such node exists.
`Name`	`getQName(String name)` Returns the `Name` for the given JCR name String.
`Path`	`getQPath(String path)` Returns the path object for the given JCR path string.
`Path`	`getQPath(String path, boolean normalizeIdentifier)` Returns the path object for the given JCR path string.
`javax.jcr.Repository`	`getRepository()`
`javax.jcr.retention.RetentionManager`	`getRetentionManager()`
`protected RetentionRegistry`	`getRetentionRegistry()` Returns the internal retention manager used for evaluation of effective retention policies and holds.
`javax.jcr.Node`	`getRootNode()`
`Subject`	`getSubject()` Returns a read only copy of the `Subject` associated with this session.
`String`	`getURI(String prefix)` Returns the URI to which the given prefix is mapped.
`String`	`getUserID()`
`UserManager`	`getUserManager()` Returns the `UserManager` for the current `Session`.
`javax.jcr.ValueFactory`	`getValueFactory()`
`javax.jcr.Workspace`	`getWorkspace()`
`boolean`	`hasCapability(String methodName, Object target, Object[] arguments)`
`boolean`	`hasPendingChanges()`
`boolean`	`hasPermission(String absPath, String... actions)` Returns `true` if this `Session` has permission to perform the specified actions at the specified `absPath` and `false` otherwise.
`boolean`	`hasPermission(String absPath, String actions)`
`javax.jcr.Session`	`impersonate(javax.jcr.Credentials otherCredentials)` Logs in the same workspace with the given credentials.
`boolean`	`isAdmin()` Returns `true` if this session has been created for the administrator.
`boolean`	`isLive()`
`boolean`	`isSystem()` Returns `true` if the subject contains a `SystemPrincipal`; `false` otherwise.
`boolean`	`itemExists(String absPath)` Calls `AbstractSession.getItem(String)` with the given path and returns `true` if the call succeeds.
`void`	`logout()` Invalidates this session and releases all associated resources.
`void`	`move(String srcAbsPath, String destAbsPath)`
`boolean`	`nodeExists(String absPath)` Checks whether a node with the given absolute path exists.
`protected void`	`notifyLoggedOut()` Notify the listeners that this session has been closed.
`protected void`	`notifyLoggingOut()` Notify the listeners that this session is about to be closed.
`boolean`	`propertyExists(String absPath)` Checks whether a property with the given absolute path exists.
`void`	`refresh(boolean keepChanges)`
`void`	`removeItem(String absPath)` Removes the identified item.
`void`	`removeListener(SessionListener listener)` Remove a `SessionListener`
`void`	`removeLockToken(String lt)`
`protected String`	`retrieveUserId(Subject subject, String workspaceName)` Retrieve the userID from the specified subject.
`void`	`save()`
`void`	`setAttribute(String name, Object value)` Sets the named attribute.
`void`	`setNamespacePrefix(String prefix, String uri)` Modifies the session local namespace mappings to contain the given prefix to URI mapping.
`String`	`toString()` Returns the unique internal name of this session.

Methods inherited from class org.apache.jackrabbit.commons.AbstractSession
exportDocumentView, exportDocumentView, exportSystemView, exportSystemView, getNamespacePrefix, getNamespacePrefixes, getNamespaceURI, importXML

Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface javax.jcr.Session
exportDocumentView, exportDocumentView, exportSystemView, exportSystemView, getNamespacePrefix, getNamespacePrefixes, getNamespaceURI, importXML

- Field Detail
  - DISABLE_CLUSTER_SYNC_ON_REFRESH
```
public static final String DISABLE_CLUSTER_SYNC_ON_REFRESH
```
    Name of the session attribute that controls whether the refresh(boolean) method will cause the repository to synchronize itself to changes in other cluster nodes. This cluster synchronization is enabled by default, unless an attribute with this name is set (any non-null value) for this session.
    
    Since:
    
    Apache Jackrabbit 1.6
    
    See Also:
    JCR-1753, Constant Field Values
  - AUTO_FIX_CORRUPTIONS
```
public static final String AUTO_FIX_CORRUPTIONS
```
    Name of the session attribute that controls whether repository inconsistencies should be automatically fixed when traversing over child nodes, when trying to add a child node, or removing a child node.
    
    Since:
    
    Apache Jackrabbit 2.2
    
    See Also:
    JCR-2740, Constant Field Values
  - context
```
protected final SessionContext context
```
    The component context of this session.
  - repositoryContext
```
protected final RepositoryContext repositoryContext
```
    The component context of the repository that issued this session.
  - loginContext
```
protected AuthContext loginContext
```
    the AuthContext of this session (can be null if this session was not instantiated through a login process)
  - subject
```
protected final Subject subject
```
    the Subject of this session
  - userId
```
protected final String userId
```
    the user ID that was used to acquire this session
  - attributes
```
protected final Map<String,Object> attributes
```
    the attributes of this session
  - namePathResolver
```
protected NamePathResolver namePathResolver
```
    Name and Path resolver
  - versionMgr
```
protected final InternalVersionManager versionMgr
```
    The version manager for this session
  - listeners
```
protected final Map<SessionListener,SessionListener> listeners
```
    Listeners (weak references)
- Constructor Detail
  - SessionImpl
```
protected SessionImpl(RepositoryContext repositoryContext,
           AuthContext loginContext,
           WorkspaceConfig wspConfig)
               throws javax.jcr.AccessDeniedException,
                      javax.jcr.RepositoryException
```
    Protected constructor.
    
    Parameters:
    repositoryContext - repository context
    loginContext -
    wspConfig -
    
    Throws:
    
    javax.jcr.AccessDeniedException - if the subject of the given login context is not granted access to the specified workspace
    
    javax.jcr.RepositoryException - if another error occurs
  - SessionImpl
```
protected SessionImpl(RepositoryContext repositoryContext,
           Subject subject,
           WorkspaceConfig wspConfig)
               throws javax.jcr.AccessDeniedException,
                      javax.jcr.RepositoryException
```
    Protected constructor.
    
    Parameters:
    repositoryContext - repository context
    subject -
    wspConfig -
    
    Throws:
    
    javax.jcr.AccessDeniedException - if the given subject is not granted access to the specified workspace
    
    javax.jcr.RepositoryException - if another error occurs
- Method Detail
  - retrieveUserId
```
protected String retrieveUserId(Subject subject,
                    String workspaceName)
                         throws javax.jcr.RepositoryException
```
    Retrieve the userID from the specified subject.
    
    Returns:
    the userID.
    
    Throws:
    
    javax.jcr.RepositoryException
  - createSessionItemStateManager
```
protected SessionItemStateManager createSessionItemStateManager()
```
    Create the session item state manager.
    
    Returns:
    session item state manager
  - createItemManager
```
protected ItemManager createItemManager()
```
    Create the item manager.
    
    Returns:
    item manager
  - createObservationManager
```
protected ObservationManagerImpl createObservationManager(String wspName)
                                                   throws javax.jcr.RepositoryException
```
    Throws:
    
    javax.jcr.RepositoryException
  - createVersionManager
```
protected InternalVersionManager createVersionManager()
                                               throws javax.jcr.RepositoryException
```
    Create the version manager. If we are not using XA, we may safely use the repository version manager.
    
    Returns:
    version manager
    
    Throws:
    
    javax.jcr.RepositoryException
  - createAccessManager
```
protected AccessManager createAccessManager(Subject subject)
                                     throws javax.jcr.AccessDeniedException,
                                            javax.jcr.RepositoryException
```
    Create the access manager.
    
    Parameters:
    subject -
    
    Returns:
    access manager
    
    Throws:
    
    javax.jcr.AccessDeniedException - if the current subject is not granted access to the current workspace
    
    javax.jcr.RepositoryException - if the access manager cannot be instantiated
  - getSubject
```
public Subject getSubject()
```
    Returns a read only copy of the Subject associated with this session.
    
    Returns:
    a read only copy of Subject associated with this session
  - isSystem
```
public boolean isSystem()
```
    Returns true if the subject contains a SystemPrincipal; false otherwise.
    
    Returns:
    true if this is an system session.
  - isAdmin
```
public boolean isAdmin()
```
    Returns true if this session has been created for the administrator. False otherwise.
    
    Returns:
    true if this is an admin session.
  - createSession
```
public javax.jcr.Session createSession(String workspaceName)
                                throws javax.jcr.AccessDeniedException,
                                       javax.jcr.NoSuchWorkspaceException,
                                       javax.jcr.RepositoryException
```
    Creates a new session with the same subject as this sessions but to a different workspace. The returned session is a newly logged in session, with the same subject but a different workspace. Even if the given workspace is the same as this sessions one, the implementation must return a new session object.
    
    Parameters:
    workspaceName - name of the workspace to acquire a session for.
    
    Returns:
    A session to the requested workspace for the same authenticated subject.
    
    Throws:
    
    javax.jcr.AccessDeniedException - in case the current Subject is not allowed to access the requested Workspace
    
    javax.jcr.NoSuchWorkspaceException - If the named workspace does not exist.
    
    javax.jcr.RepositoryException - in any other exceptional state
  - getAccessManager
```
public AccessManager getAccessManager()
```
    Returns the AccessManager associated with this session.
    
    Returns:
    the AccessManager associated with this session
  - getNodeTypeManager
```
public NodeTypeManagerImpl getNodeTypeManager()
```
    Returns the NodeTypeManager.
    
    Returns:
    the NodeTypeManager
  - getItemManager
```
public ItemManager getItemManager()
```
    Returns the ItemManager of this session.
    
    Returns:
    the ItemManager
  - getHierarchyManager
```
public HierarchyManager getHierarchyManager()
```
    Returns the HierarchyManager associated with this session.
    
    Returns:
    the HierarchyManager associated with this session
  - getInternalVersionManager
```
public InternalVersionManager getInternalVersionManager()
```
    Returns the InternalVersionManager associated with this session.
    
    Returns:
    the InternalVersionManager associated with this session
  - getRetentionRegistry
```
protected RetentionRegistry getRetentionRegistry()
                                          throws javax.jcr.RepositoryException
```
    Returns the internal retention manager used for evaluation of effective retention policies and holds.
    
    Returns:
    internal retention manager
    
    Throws:
    
    javax.jcr.RepositoryException
  - setAttribute
```
public void setAttribute(String name,
                Object value)
```
    Sets the named attribute. If the value is null, then the named attribute is removed.
    
    Specified by:
    
    setAttribute in interface SessionExtensions
    
    Parameters:
    name - attribute name
    value - attribute value
    Since:
    
    Apache Jackrabbit 1.6
    
    See Also:
    JCR-1932
  - getNodeById
```
public NodeImpl getNodeById(NodeId id)
                     throws javax.jcr.ItemNotFoundException,
                            javax.jcr.RepositoryException
```
    Retrieves the Node with the given id.
    
    Parameters:
    id - id of node to be retrieved
    
    Returns:
    node with the given NodeId.
    
    Throws:
    
    javax.jcr.ItemNotFoundException - if no such node exists or if this Session does not have permission to access the node.
    
    javax.jcr.RepositoryException - if another error occurs.
  - notifyLoggingOut
```
protected void notifyLoggingOut()
```
    Notify the listeners that this session is about to be closed.
  - notifyLoggedOut
```
protected void notifyLoggedOut()
```
    Notify the listeners that this session has been closed.
  - 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
  - createDataStoreGarbageCollector
```
public GarbageCollector createDataStoreGarbageCollector()
                                                 throws javax.jcr.RepositoryException
```
    Create a data store garbage collector for this repository.
    
    Throws:
    
    javax.jcr.RepositoryException
  - getPrefix
```
public String getPrefix(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 String getURI(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.
  - getJCRName
```
public String getJCRName(Name name)
                  throws javax.jcr.NamespaceException
```
    Description copied from interface: NameResolver
    
    Returns the qualified JCR name String for the given Name object.
    
    Specified by:
    
    getJCRName in interface NameResolver
    
    Parameters:
    name - A Name object.
    
    Returns:
    The qualified JCR name String consisting of prefix:localName or localName in case of the empty namespace.
    
    Throws:
    
    javax.jcr.NamespaceException - if the namespace URI can not be resolved
  - getQName
```
public Name getQName(String name)
              throws IllegalNameException,
                     javax.jcr.NamespaceException
```
    Description copied from interface: NameResolver
    
    Returns the Name for the given JCR name String.
    
    Specified by:
    
    getQName in interface NameResolver
    
    Parameters:
    name - A JCR name String.
    
    Returns:
    A Name object.
    
    Throws:
    
    IllegalNameException - if the JCR name format is invalid
    
    javax.jcr.NamespaceException - if the namespace prefix can not be resolved
  - getJCRPath
```
public String getJCRPath(Path path)
                  throws javax.jcr.NamespaceException
```
    Description copied from interface: PathResolver
    
    Returns the given JCR path string for the given path object.
    
    Specified by:
    
    getJCRPath in interface PathResolver
    
    Parameters:
    path - a Path object.
    
    Returns:
    a JCR path string
    
    Throws:
    
    javax.jcr.NamespaceException - if a namespace URI can not be resolved
  - getQPath
```
public Path getQPath(String path)
              throws MalformedPathException,
                     IllegalNameException,
                     javax.jcr.NamespaceException
```
    Description copied from interface: PathResolver
    
    Returns the path object for the given JCR path string.
    
    Specified by:
    
    getQPath in interface PathResolver
    
    Parameters:
    path - prefixed JCR path
    
    Returns:
    a Path object.
    
    Throws:
    
    MalformedPathException - if the JCR path format is invalid.
    
    IllegalNameException - if any of the JCR names contained in the path are invalid.
    
    javax.jcr.NamespaceException - if a namespace prefix can not be resolved.
  - getQPath
```
public Path getQPath(String path,
            boolean normalizeIdentifier)
              throws MalformedPathException,
                     IllegalNameException,
                     javax.jcr.NamespaceException
```
    Description copied from interface: PathResolver
    
    Returns the path object for the given JCR path string.
    
    Specified by:
    
    getQPath in interface PathResolver
    
    Parameters:
    path - prefixed JCR path
    
    Returns:
    a Path object.
    
    Throws:
    
    MalformedPathException - if the JCR path format is invalid.
    
    IllegalNameException - if any of the JCR names contained in the path are invalid.
    
    javax.jcr.NamespaceException - if a namespace prefix can not be resolved.
  - getPath
```
public Path getPath(String identifier)
             throws MalformedPathException
```
    Specified by:
    
    getPath in interface IdentifierResolver
    
    Throws:
    
    MalformedPathException
    See Also:
    IdentifierResolver.getPath(String)
  - checkFormat
```
public void checkFormat(String identifier)
                 throws MalformedPathException
```
    Specified by:
    
    checkFormat in interface IdentifierResolver
    
    Throws:
    
    MalformedPathException
    See Also:
    IdentifierResolver.checkFormat(String)
  - hasPermission
```
public boolean hasPermission(String absPath,
                    String... actions)
                      throws javax.jcr.RepositoryException
```
    Description copied from interface: JackrabbitSession
    Returns true if this Session has permission to perform the specified actions at the specified absPath and false otherwise.
    The actions parameter is a list of action strings. Apart from the actions defined on Session, this variant also allows to specify the following additional actions to provide better permission discovery:
    - {@code add_property}: If hasPermission(path, "add_property") returns true, then this Session has permission to add a new property at path.
    - {@code modify_property}: If hasPermission(path, "modify_property") returns true, then this Session has permission to change a property at path.
    - {@code remove_property}: If hasPermission(path, "remove_property") returns true, then this Session has permission to remove a property at path.
    - {@code remove_node}: If hasPermission(path, "remove_node") returns true, then this Session has permission to remove a node at path.
    - {@code node_type_management}: If hasPermission(path, "node_type_management") returns true, then this Session has permission to explicitly set or change the node type information associated with a node at path.
    - {@code versioning}: If hasPermission(path, "versioning") returns true, then this Session has permission to perform version related operations on a node at path.
    - {@code locking}: If hasPermission(path, "locking") returns true, then this Session has permission to lock and unlock a node at path.
    - {@code read_access_control}: If hasPermission(path, "read_access_control") returns true, then this Session has permission to read access control content stored at an item at path.
    - {@code modify_access_control}: If hasPermission(path, "modify_access_control") returns true, then this Session has permission to modify access control content at an item at path.
    - {@code user_management}: If hasPermission(path, "user_management") returns true, then this Session has permission to perform user management operations at an item at path.
    When more than one action is specified, this method will only return true if this Session has permission to perform all of the listed actions at the specified path.
    The information returned through this method will only reflect the permission status (both JCR defined and implementation-specific) and not other restrictions that may exist, such as node type or other implementation enforced constraints. For example, even though hasPermission may indicate that a particular Session may add a property at /A/B/C, the node type of the node at /A/B may prevent the addition of a property called C.
    Specified by:
    
    hasPermission in interface JackrabbitSession
    
    Parameters:
    absPath - an absolute path.
    actions - one or serveral actions.
    
    Returns:
    true if this Session has permission to perform the specified actions at the specified absPath.
    
    Throws:
    
    javax.jcr.RepositoryException - if an error occurs.
    See Also:
    JackrabbitSession.hasPermission(String, String...)
  - getPrincipalManager
```
public PrincipalManager getPrincipalManager()
                                     throws javax.jcr.RepositoryException,
                                            javax.jcr.AccessDeniedException
```
    Description copied from interface: JackrabbitSession
    
    Returns the PrincipalManager for the current Session.
    
    Specified by:
    
    getPrincipalManager in interface JackrabbitSession
    
    Returns:
    the PrincipalManager associated with this Session.
    
    Throws:
    
    javax.jcr.AccessDeniedException - If the session lacks privileges to access the principal manager or principals in general.
    
    javax.jcr.UnsupportedRepositoryOperationException - If principal management is not supported.
    
    javax.jcr.RepositoryException - If another error occurs.
    See Also:
    JackrabbitSession.getPrincipalManager()
  - getUserManager
```
public UserManager getUserManager()
                           throws javax.jcr.AccessDeniedException,
                                  javax.jcr.RepositoryException
```
    Description copied from interface: JackrabbitSession
    
    Returns the UserManager for the current Session.
    
    Specified by:
    
    getUserManager in interface JackrabbitSession
    
    Returns:
    the UserManager associated with this Session.
    
    Throws:
    
    javax.jcr.AccessDeniedException - If this session is not allowed to to access user data.
    
    javax.jcr.UnsupportedRepositoryOperationException - If user management is not supported.
    
    javax.jcr.RepositoryException - If another error occurs.
    See Also:
    JackrabbitSession.getUserManager()
  - getItemOrNull
```
public javax.jcr.Item getItemOrNull(String absPath)
                             throws javax.jcr.RepositoryException
```
    Description copied from interface: JackrabbitSession
    
    Returns the node at the specified absolute path in the workspace. If no such node exists, then it returns the property at the specified path. If no such property exists, then it return null.
    
    Specified by:
    
    getItemOrNull in interface JackrabbitSession
    
    Parameters:
    absPath - An absolute path.
    
    Returns:
    the specified Item or null.
    
    Throws:
    
    javax.jcr.RepositoryException - if another error occurs.
  - getPropertyOrNull
```
public javax.jcr.Property getPropertyOrNull(String absPath)
                                     throws javax.jcr.RepositoryException
```
    Description copied from interface: JackrabbitSession
    
    Returns the property at the specified absolute path in the workspace or null if no such node exists.
    
    Specified by:
    
    getPropertyOrNull in interface JackrabbitSession
    
    Parameters:
    absPath - An absolute path.
    
    Returns:
    the specified Property or null.
    
    Throws:
    
    javax.jcr.RepositoryException - if another error occurs.
  - getNodeOrNull
```
public javax.jcr.Node getNodeOrNull(String absPath)
                             throws javax.jcr.RepositoryException
```
    Description copied from interface: JackrabbitSession
    
    Returns the node at the specified absolute path in the workspace or null if no such node exists.
    
    Specified by:
    
    getNodeOrNull in interface JackrabbitSession
    
    Parameters:
    absPath - An absolute path.
    
    Returns:
    the specified Node or null.
    
    Throws:
    
    javax.jcr.RepositoryException - If another error occurs.
  - checkPermission
```
public void checkPermission(String absPath,
                   String actions)
                     throws AccessControlException,
                            javax.jcr.RepositoryException
```
    Specified by:
    
    checkPermission in interface javax.jcr.Session
    
    Throws:
    
    AccessControlException
    
    javax.jcr.RepositoryException
  - getWorkspace
```
public javax.jcr.Workspace getWorkspace()
```
    Specified by:
    
    getWorkspace in interface javax.jcr.Session
  - impersonate
```
public javax.jcr.Session impersonate(javax.jcr.Credentials otherCredentials)
                              throws javax.jcr.LoginException,
                                     javax.jcr.RepositoryException
```
    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:
    otherCredentials - login credentials
    
    Returns:
    logged in session
    
    Throws:
    
    javax.jcr.RepositoryException - if an error occurs
    
    javax.jcr.LoginException
  - getRootNode
```
public javax.jcr.Node getRootNode()
                           throws javax.jcr.RepositoryException
```
    Specified by:
    
    getRootNode in interface javax.jcr.Session
    
    Throws:
    
    javax.jcr.RepositoryException
  - getNodeByUUID
```
public javax.jcr.Node getNodeByUUID(String uuid)
                             throws javax.jcr.ItemNotFoundException,
                                    javax.jcr.RepositoryException
```
    Specified by:
    
    getNodeByUUID in interface javax.jcr.Session
    
    Throws:
    
    javax.jcr.ItemNotFoundException
    
    javax.jcr.RepositoryException
  - getItem
```
public javax.jcr.Item getItem(String absPath)
                       throws javax.jcr.RepositoryException
```
    Returns the node or property at the given path.
    The default implementation:
    - Returns the root node if the given path is "/"
    - Delegates to Session.getNodeByIdentifier(String) for identifier paths
    - Throws a PathNotFoundException if the given path does not start with a slash.
    - 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(String absPath)
                   throws javax.jcr.RepositoryException
```
    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)
  - save
```
public void save()
          throws javax.jcr.RepositoryException
```
    Specified by:
    
    save in interface javax.jcr.Session
    
    Throws:
    
    javax.jcr.RepositoryException
  - refresh
```
public void refresh(boolean keepChanges)
             throws javax.jcr.RepositoryException
```
    Specified by:
    
    refresh in interface javax.jcr.Session
    
    Throws:
    
    javax.jcr.RepositoryException
  - clusterSyncOnRefresh
```
protected boolean clusterSyncOnRefresh()
```
    Checks whether the refresh(boolean) method should cause cluster synchronization.
    Subclasses can override this method to implement alternative rules on when cluster synchronization should be done.
    
    Returns:
    true if the DISABLE_CLUSTER_SYNC_ON_REFRESH attribute is not set, false otherwise
    Since:
    
    Apache Jackrabbit 1.6
    
    See Also:
    JCR-1753
  - autoFixCorruptions
```
protected boolean autoFixCorruptions()
```
    Checks whether repository inconsistencies should be automatically fixed when traversing over child nodes, when trying to add a child node, or when removing a child node.
    
    Returns:
    true if the AUTO_FIX_CORRUPTIONS attribute is set, false otherwise
    Since:
    
    Apache Jackrabbit 2.2
    
    See Also:
    JCR-2740
  - hasPendingChanges
```
public boolean hasPendingChanges()
                          throws javax.jcr.RepositoryException
```
    Specified by:
    
    hasPendingChanges in interface javax.jcr.Session
    
    Throws:
    
    javax.jcr.RepositoryException
  - move
```
public void move(String srcAbsPath,
        String destAbsPath)
          throws javax.jcr.RepositoryException
```
    Specified by:
    
    move in interface javax.jcr.Session
    
    Throws:
    
    javax.jcr.RepositoryException
  - 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.Session
    
    Throws:
    
    javax.jcr.PathNotFoundException
    
    javax.jcr.nodetype.ConstraintViolationException
    
    javax.jcr.version.VersionException
    
    javax.jcr.lock.LockException
    
    javax.jcr.RepositoryException
  - isLive
```
public boolean isLive()
```
    Specified by:
    
    isLive in interface javax.jcr.Session
  - logout
```
public void logout()
```
    Invalidates this session and releases all associated resources.
    
    Specified by:
    
    logout in interface javax.jcr.Session
    
    Overrides:
    
    logout in class AbstractSession
  - getRepository
```
public javax.jcr.Repository getRepository()
```
    Specified by:
    
    getRepository in interface javax.jcr.Session
  - getValueFactory
```
public javax.jcr.ValueFactory getValueFactory()
```
    Specified by:
    
    getValueFactory in interface javax.jcr.Session
  - getUserID
```
public String getUserID()
```
    Specified by:
    
    getUserID in interface javax.jcr.Session
  - getAttribute
```
public Object getAttribute(String name)
```
    Specified by:
    
    getAttribute in interface javax.jcr.Session
  - getAttributeNames
```
public String[] getAttributeNames()
```
    Specified by:
    
    getAttributeNames in interface javax.jcr.Session
  - setNamespacePrefix
```
public void setNamespacePrefix(String prefix,
                      String uri)
                        throws javax.jcr.NamespaceException,
                               javax.jcr.RepositoryException
```
    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
  - addLockToken
```
public void addLockToken(String lt)
```
    Specified by:
    
    addLockToken in interface javax.jcr.Session
  - getLockTokens
```
public String[] getLockTokens()
```
    Specified by:
    
    getLockTokens in interface javax.jcr.Session
  - removeLockToken
```
public void removeLockToken(String lt)
```
    Specified by:
    
    removeLockToken in interface javax.jcr.Session
  - getLocks
```
public javax.jcr.lock.Lock[] getLocks()
```
    Returns all locks owned by this session.
    
    Returns:
    an array of Locks
  - getNodeByIdentifier
```
public javax.jcr.Node getNodeByIdentifier(String id)
                                   throws javax.jcr.ItemNotFoundException,
                                          javax.jcr.RepositoryException
```
    Specified by:
    
    getNodeByIdentifier in interface javax.jcr.Session
    
    Throws:
    
    javax.jcr.ItemNotFoundException
    
    javax.jcr.RepositoryException
    Since:
    
    JCR 2.0
    
    See Also:
    Session.getNodeByIdentifier(String)
  - getNode
```
public javax.jcr.Node getNode(String absPath)
                       throws javax.jcr.RepositoryException
```
    Description copied from class: AbstractSession
    
    Returns the node with the given absolute path.
    
    Specified by:
    
    getNode in interface javax.jcr.Session
    
    Overrides:
    
    getNode in class AbstractSession
    
    Parameters:
    absPath - absolute path
    
    Returns:
    node at the given path
    
    Throws:
    
    javax.jcr.RepositoryException - if the node can not be accessed
    Since:
    
    JCR 2.0
    
    See Also:
    Session.getNode(String)
  - getProperty
```
public javax.jcr.Property getProperty(String absPath)
                               throws javax.jcr.RepositoryException
```
    Description copied from class: AbstractSession
    
    Returns the property with the given absolute path.
    
    Specified by:
    
    getProperty in interface javax.jcr.Session
    
    Overrides:
    
    getProperty in class AbstractSession
    
    Parameters:
    absPath - absolute path
    
    Returns:
    node at the given path
    
    Throws:
    
    javax.jcr.RepositoryException - if the property can not be accessed
    Since:
    
    JCR 2.0
    
    See Also:
    Session.getProperty(String)
  - nodeExists
```
public boolean nodeExists(String absPath)
                   throws javax.jcr.RepositoryException
```
    Description copied from class: AbstractSession
    
    Checks whether a node with the given absolute path exists.
    
    Specified by:
    
    nodeExists in interface javax.jcr.Session
    
    Overrides:
    
    nodeExists in class AbstractSession
    
    Parameters:
    absPath - absolute path
    
    Returns:
    true if a node with the given path exists, false otherwise
    
    Throws:
    
    javax.jcr.RepositoryException - if the path is invalid
    Since:
    
    JCR 2.0
    
    See Also:
    Session.nodeExists(String)
  - propertyExists
```
public boolean propertyExists(String absPath)
                       throws javax.jcr.RepositoryException
```
    Description copied from class: AbstractSession
    
    Checks whether a property with the given absolute path exists.
    
    Specified by:
    
    propertyExists in interface javax.jcr.Session
    
    Overrides:
    
    propertyExists in class AbstractSession
    
    Parameters:
    absPath - absolute path
    
    Returns:
    true if a property with the given path exists, false otherwise
    
    Throws:
    
    javax.jcr.RepositoryException - if the path is invalid
    Since:
    
    JCR 2.0
    
    See Also:
    Session.propertyExists(String)
  - removeItem
```
public void removeItem(String absPath)
                throws javax.jcr.RepositoryException
```
    Description copied from class: AbstractSession
    
    Removes the identified item. Implemented by calling Item.remove() on the item removed by AbstractSession.getItem(String).
    
    Specified by:
    
    removeItem in interface javax.jcr.Session
    
    Overrides:
    
    removeItem in class AbstractSession
    
    Parameters:
    absPath - An absolute path of the item to be removed
    
    Throws:
    
    javax.jcr.RepositoryException - if the item can not be removed
    Since:
    
    JCR 2.0
    
    See Also:
    Session.removeItem(String)
  - hasPermission
```
public boolean hasPermission(String absPath,
                    String actions)
                      throws javax.jcr.RepositoryException
```
    Specified by:
    
    hasPermission in interface javax.jcr.Session
    
    Throws:
    
    javax.jcr.RepositoryException
    Since:
    
    2.0
    
    See Also:
    Session.hasPermission(String, String)
  - hasCapability
```
public boolean hasCapability(String methodName,
                    Object target,
                    Object[] arguments)
                      throws javax.jcr.RepositoryException
```
    Specified by:
    
    hasCapability in interface javax.jcr.Session
    
    Throws:
    
    javax.jcr.RepositoryException
    Since:
    
    JCR 2.0
    
    See Also:
    Session.hasCapability(String, Object, Object[])
  - getAccessControlManager
```
public javax.jcr.security.AccessControlManager getAccessControlManager()
                                                                throws javax.jcr.UnsupportedRepositoryOperationException,
                                                                       javax.jcr.RepositoryException
```
    Specified by:
    
    getAccessControlManager in interface javax.jcr.Session
    
    Throws:
    
    javax.jcr.UnsupportedRepositoryOperationException
    
    javax.jcr.RepositoryException
    Since:
    
    JCR 2.0
    
    See Also:
    Session.getAccessControlManager()
  - getRetentionManager
```
public javax.jcr.retention.RetentionManager getRetentionManager()
                                                         throws javax.jcr.UnsupportedRepositoryOperationException,
                                                                javax.jcr.RepositoryException
```
    Specified by:
    
    getRetentionManager in interface javax.jcr.Session
    
    Throws:
    
    javax.jcr.UnsupportedRepositoryOperationException
    
    javax.jcr.RepositoryException
    Since:
    
    JCR 2.0
    
    See Also:
    Session.getRetentionManager()
  - toString
```
public String toString()
```
    Returns the unique internal name of this session. The returned name is especially useful for debugging and logging purposes.
    
    Overrides:
    
    toString in class Object
    
    Returns:
    session name
    See Also:
    sessionName
  - finalize
```
public void finalize()
```
    Finalize the session. If the application doesn't call Session.logout(), the session is closed automatically; however a warning is written to the log file, together with the stack trace of where the session was opened.
    
    Overrides:
    
    finalize in class Object

Class SessionImpl

Field Summary

Fields inherited from interface org.apache.jackrabbit.api.JackrabbitSession

Fields inherited from interface javax.jcr.Session

Constructor Summary

Method Summary

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

Methods inherited from class java.lang.Object

Methods inherited from interface javax.jcr.Session

Field Detail

DISABLE_CLUSTER_SYNC_ON_REFRESH

AUTO_FIX_CORRUPTIONS

context

repositoryContext

loginContext

subject

userId

attributes

namePathResolver

versionMgr

listeners

Constructor Detail

SessionImpl

SessionImpl

Method Detail

retrieveUserId

createSessionItemStateManager

createItemManager

createObservationManager

createVersionManager

createAccessManager

getSubject

isSystem

isAdmin

createSession

getAccessManager

getNodeTypeManager

getItemManager

getHierarchyManager

getInternalVersionManager

getRetentionRegistry

setAttribute

getNodeById

notifyLoggingOut

notifyLoggedOut

addListener

removeListener

createDataStoreGarbageCollector

getPrefix

getURI

getJCRName

getQName

getJCRPath

getQPath

getQPath

getPath

checkFormat

hasPermission

getPrincipalManager

getUserManager

getItemOrNull

getPropertyOrNull

getNodeOrNull

checkPermission

getWorkspace

impersonate

getRootNode

getNodeByUUID

getItem

itemExists

save

refresh

clusterSyncOnRefresh

autoFixCorruptions

hasPendingChanges

move

getImportContentHandler

isLive

logout

getRepository