org.apache.jackrabbit.spi
Interface SessionInfo

All Known Subinterfaces:

XASessionInfo

All Known Implementing Classes:

SessionInfoImpl

public interface SessionInfo

SessionInfo is created upon RepositoryService.obtain(javax.jcr.Credentials, String) or RepositoryService.obtain(SessionInfo, String) and will be used for any call on the RepositoryService that requires user and workspace identification.

In addition the SessionInfo acts as primary container for lock tokens. They will assert that a given SessionInfo is able to execute operations on the RepositoryService that are affected by existing locks.

Method Summary

void	addLockToken(java.lang.String lockToken) Add the given lock token to this SessionInfo.
java.lang.String[]	getLockTokens() Returns the lock tokens present on this SessionInfo.
java.lang.String	getUserID() Returns the user id.
java.lang.String	getWorkspaceName() Returns the workspace name.
void	removeLockToken(java.lang.String lockToken) Removes the given lock token from this SessionInfo.

Method Detail

getUserID

java.lang.String getUserID()

Returns the user id.

Returns:

The user identification.

See Also:

RepositoryService.obtain(javax.jcr.Credentials, String)

getWorkspaceName

java.lang.String getWorkspaceName()

Returns the workspace name.

Returns:

The name of the workspace this SessionInfo has been built for.

See Also:

RepositoryService.obtain(javax.jcr.Credentials, String), Workspace.getName()

getLockTokens

java.lang.String[] getLockTokens()

Returns the lock tokens present on this SessionInfo.

Returns:

lock tokens present on this SessionInfo.

addLockToken

void addLockToken(java.lang.String lockToken)

Add the given lock token to this SessionInfo. The token will enable the SessionInfo to operate on Items that are affected by the lock identified by the given token.

Parameters:

lockToken - to be added.

removeLockToken

void removeLockToken(java.lang.String lockToken)

Removes the given lock token from this SessionInfo. This must happen if the associated Session successfully removes the Lock from a Node or if the token is removed from the Session itself by calling Session.removeLockToken(String). Consequently all RepositoryService operations affected by a lock will fail with LockException provided the lock hasn't been released.

Parameters:

lockToken - to be removed.