org.hippoecm.repository.api

Interface HippoSession

All Superinterfaces:

javax.jcr.Session

public interface HippoSession
extends javax.jcr.Session

An extension of a plain Session based session. Any session as obtained from the Hippo Repository 2 can be cased to a HippoSession allowing access to the extensions to the JCR API.

Field Summary

Fields

Modifier and Type	Field and Description
static String	NO_SYSTEM_IMPERSONATION Deprecated. this attribute name and usage will be removed again when the limitation as described above has been fixed.

Fields inherited from interface javax.jcr.Session

ACTION_ADD_NODE, ACTION_READ, ACTION_REMOVE, ACTION_SET_PROPERTY

Method Summary

Modifier and Type	Method and Description
javax.jcr.Node	copy(javax.jcr.Node srcNode, String destAbsNodePath) Deprecated. Use JcrUtils.copy(javax.jcr.Session, String, String) instead
javax.jcr.Session	createSecurityDelegate(javax.jcr.Session session, DomainRuleExtension... domainExtensions) Create a new Session that contains the union of access control rules of this Session and the provided session, with the optional addition of custom domain rules.
void	disableVirtualLayers() Disable virtual layers.
void	exportDereferencedView(String absPath, ContentHandler contentHandler, boolean binaryAsLink, boolean noRecurse) Export a dereferenced view of a node.
void	exportDereferencedView(String absPath, OutputStream out, boolean binaryAsLink, boolean noRecurse) Export a dereferenced view of a node.
File	exportEnhancedSystemViewPackage(String parentAbsPath, boolean recurse)
ClassLoader	getSessionClassLoader() This call is not (yet) part of the API, but under evaluation. Probably it will change into getSessionClassLoader(Node) or similar.
User	getUser() Get the User object identified by this session's user id.
XAResource	getXAResource() Retrieves an XAResource object that the transaction manager will use to manage this XASession object's participation in a distributed transaction.
void	importDereferencedXML(String parentAbsPath, InputStream in, ContentResourceLoader referredResourceLoader, int uuidBehavior, int referenceBehavior, int mergeBehavior) Deprecated. use importEnhancedSystemViewXML(String, InputStream, int, int, ContentResourceLoader)
void	importDereferencedXML(String parentAbsPath, InputStream in, int uuidBehavior, int referenceBehavior, int mergeBehavior) Deprecated. use importEnhancedSystemViewXML(String, InputStream, int, int, ContentResourceLoader)
ImportResult	importEnhancedSystemViewXML(String parentAbsPath, InputStream in, int uuidBehavior, int referenceBehavior, ContentResourceLoader referredResourceLoader) Import an enhanced system view xml file.
void	localRefresh() This method discards all pending changes currently recorded in this Session, including the built-up virtual node states.
javax.jcr.NodeIterator	pendingChanges() Largely a conveniance method for pendingChanges(Session.getRootNode(), "nt:base", false) however will also return the root node if modified.
javax.jcr.NodeIterator	pendingChanges(javax.jcr.Node node, String nodeType) Conveniance method for pendingChanges(node,nodeType,false)
javax.jcr.NodeIterator	pendingChanges(javax.jcr.Node node, String nodeType, boolean prune) Obtains an iterator over the set of nodes that potentially contain changes, starting (and not including) the indicated node.

Methods inherited from interface javax.jcr.Session

addLockToken, checkPermission, exportDocumentView, exportDocumentView, exportSystemView, exportSystemView, getAccessControlManager, getAttribute, getAttributeNames, getImportContentHandler, getItem, getLockTokens, getNamespacePrefix, getNamespacePrefixes, getNamespaceURI, getNode, getNodeByIdentifier, getNodeByUUID, getProperty, getRepository, getRetentionManager, getRootNode, getUserID, getValueFactory, getWorkspace, hasCapability, hasPendingChanges, hasPermission, impersonate, importXML, isLive, itemExists, logout, move, nodeExists, propertyExists, refresh, removeItem, removeLockToken, save, setNamespacePrefix

Field Detail

NO_SYSTEM_IMPERSONATION

static final String NO_SYSTEM_IMPERSONATION

Deprecated. this attribute name and usage will be removed again when the limitation as described above has been fixed.

By default a System Session when impersonating another user will always add the SystemPrincipal itself to the impersonated session. This has as 'side-effect' that it a System Session cannot be 'downgraded' to a normal user. This limitation or 'feature' will be removed in a next major release. Until then, the desired effect can be achieved by adding this attribute with any value (not null) on the SimpleCredentials parameter in a Session.impersonate(Credentials) call. If this attribute is defined, the SystemPrincipal will not be added to the impersonated session when using the System session to impersonate another session.

See Also:

Constant Field Values

Method Detail

copy

javax.jcr.Node copy(javax.jcr.Node srcNode,
                    String destAbsNodePath)
             throws javax.jcr.RepositoryException

Deprecated. Use JcrUtils.copy(javax.jcr.Session, String, String) instead

Convenience function to copy a node to a destination path in the same workspace. Unlike the copy method in the javax.jcr.Workspace class, this copy method does not immediately persist (i.e. requires a save operation on the session, or ancestor node of the destination path) and it does return the produced copy. The latter makes this the preferred method to copy a node as the method on the Workspace makes it impossible to know for sure which node is produced in case of same-name siblings. It also provides a save method for copying node types that are extensions of the Hippo repository.

Parameters:

srcNode - the node to copy

destAbsNodePath - the absolute path of the to be created target node which will be a copy of srcNode

Returns:

the resulting copy

Throws:

javax.jcr.RepositoryException - a generic error while accessing the repository

pendingChanges

javax.jcr.NodeIterator pendingChanges(javax.jcr.Node node,
                                      String nodeType,
                                      boolean prune)
                               throws javax.jcr.NamespaceException,
                                      javax.jcr.nodetype.NoSuchNodeTypeException,
                                      javax.jcr.RepositoryException

Obtains an iterator over the set of nodes that potentially contain changes, starting (and not including) the indicated node. Only nodes for which Node.isNodeType(nodeType) returns true are included in the resulting set. If the prune boolean value is true, then the nodes matching in the hierarchy first are returned. If matching modified node exists beneath the nodes, these are not included.

Parameters:

node - The starting node for which to look for changes, will not be included in result, may be null to indicate to search whole tree

nodeType - Only nodes that are (derived) of this nodeType are included in the result, may be null to indicate no filtering on nodeType

prune - Wheter only to return the first matching modified node in a subtree (true), or provide a depth search for all modified nodes (false)

Returns:

A NodeIterator instance which iterates over all modified nodes, not including the passed node

Throws:

javax.jcr.NamespaceException - an invalid nodeType was passed

javax.jcr.RepositoryException - a generic error while accessing the repository

javax.jcr.nodetype.NoSuchNodeTypeException - an invalid nodeType was passed

pendingChanges

javax.jcr.NodeIterator pendingChanges(javax.jcr.Node node,
                                      String nodeType)
                               throws javax.jcr.NamespaceException,
                                      javax.jcr.nodetype.NoSuchNodeTypeException,
                                      javax.jcr.RepositoryException

Conveniance method for pendingChanges(node,nodeType,false)

Parameters:

node - The starting node for which to look for changes, will not be included in result, may be null to indicate to search whole tree

nodeType - Only nodes that are (derived) of this nodeType are included in the result, may be null to indicate no filtering on nodeType

Returns:

A NodeIterator instance which iterates over all modified nodes, not including the passed node

Throws:

javax.jcr.NamespaceException - an invalid nodeType was passed

javax.jcr.RepositoryException - a generic error while accessing the repository

javax.jcr.nodetype.NoSuchNodeTypeException - an invalid nodeType was passed

See Also:

pendingChanges(Node,String,boolean)

pendingChanges

javax.jcr.NodeIterator pendingChanges()
                               throws javax.jcr.RepositoryException

Largely a conveniance method for pendingChanges(Session.getRootNode(), "nt:base", false) however will also return the root node if modified.

Returns:

A NodeIterator instance which iterates over all modified nodes, including the root

Throws:

javax.jcr.RepositoryException

See Also:

pendingChanges(Node,String,boolean)

exportDereferencedView

void exportDereferencedView(String absPath,
                            OutputStream out,
                            boolean binaryAsLink,
                            boolean noRecurse)
                     throws IOException,
                            javax.jcr.PathNotFoundException,
                            javax.jcr.RepositoryException

Export a dereferenced view of a node.

Parameters:

absPath - the absolute path to the subtree to be exported

out - the output stream to which the resulting XML should be outputted

binaryAsLink - whether to include binaries

noRecurse - whether to output just a single node or the whole subtree

Throws:

IOException - in case of an error writing to the output stream

javax.jcr.RepositoryException - a generic error while accessing the repository

javax.jcr.PathNotFoundException - in case the absPath parameter does not point to a valid node

See Also:

Session.exportSystemView(String,OutputStream,boolean,boolean)

exportDereferencedView

void exportDereferencedView(String absPath,
                            ContentHandler contentHandler,
                            boolean binaryAsLink,
                            boolean noRecurse)
                     throws javax.jcr.PathNotFoundException,
                            SAXException,
                            javax.jcr.RepositoryException

Export a dereferenced view of a node.

Parameters:

absPath - the absolute path to the subtree to be exported

contentHandler - The org.xml.sax.ContentHandler to which the SAX events representing the XML serialization of the subgraph will be output.

binaryAsLink - whether to include binaries

noRecurse - whether to output just a single node or the whole subtree

Throws:

javax.jcr.RepositoryException - a generic error while accessing the repository

javax.jcr.PathNotFoundException - in case the absPath parameter does not point to a valid node

SAXException

See Also:

Session.exportSystemView(String,OutputStream,boolean,boolean)

importDereferencedXML

@Deprecated
void importDereferencedXML(String parentAbsPath,
                                        InputStream in,
                                        int uuidBehavior,
                                        int referenceBehavior,
                                        int mergeBehavior)
                                 throws 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

Deprecated. use importEnhancedSystemViewXML(String, InputStream, int, int, ContentResourceLoader)

This call is not (yet) part of the API, but under evaluation. Import a dereferenced export.

Parameters:

parentAbsPath - the parent node below which to in

in - the input stream from which to read the XML

uuidBehavior - how to handle deserialized UUIDs in the input stream ImportUUIDBehavior

mergeBehavior - an options flag containing one of the values of ImportMergeBehavior indicating how to merge nodes that already exist

referenceBehavior - an options flag containing one of the values of ImportReferenceBehavior indicating how to handle references

Throws:

IOException - if incoming stream is not a valid XML document.

javax.jcr.PathNotFoundException - in case the parentAbsPath parameter does not point to a valid node

javax.jcr.ItemExistsException - in case the to be imported node already exist below the parent and same-name siblings are not allowed, or when the merge behavior does not allow merging on an existing node and the node does exist

javax.jcr.nodetype.ConstraintViolationException - when imported node is marked protected accoring to the node definition of the parent

javax.jcr.InvalidSerializedDataException

javax.jcr.version.VersionException - when the parent node is not in checked-out status

javax.jcr.lock.LockException - when the parent node is locked

javax.jcr.RepositoryException - a generic error while accessing the repository

See Also:

exportDereferencedView(String,OutputStream,boolean,boolean), Session.importXML(java.lang.String, java.io.InputStream, int), ImportReferenceBehavior, ImportMergeBehavior

importDereferencedXML

@Deprecated
void importDereferencedXML(String parentAbsPath,
                                        InputStream in,
                                        ContentResourceLoader referredResourceLoader,
                                        int uuidBehavior,
                                        int referenceBehavior,
                                        int mergeBehavior)
                                 throws 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

Deprecated. use importEnhancedSystemViewXML(String, InputStream, int, int, ContentResourceLoader)

This call is not (yet) part of the API, but under evaluation. Import a dereferenced export.

Parameters:

parentAbsPath - the parent node below which to in

in - the input stream from which to read the XML

referredResourceLoader - the content resouce loader to load the referred imported content resources

uuidBehavior - how to handle deserialized UUIDs in the input stream ImportUUIDBehavior

mergeBehavior - an options flag containing one of the values of ImportMergeBehavior indicating how to merge nodes that already exist

referenceBehavior - an options flag containing one of the values of ImportReferenceBehavior indicating how to handle references

Throws:

IOException - if incoming stream is not a valid XML document.

javax.jcr.PathNotFoundException - in case the parentAbsPath parameter does not point to a valid node

javax.jcr.ItemExistsException - in case the to be imported node already exist below the parent and same-name siblings are not allowed, or when the merge behavior does not allow merging on an existing node and the node does exist

javax.jcr.nodetype.ConstraintViolationException - when imported node is marked protected accoring to the node definition of the parent

javax.jcr.InvalidSerializedDataException

javax.jcr.version.VersionException - when the parent node is not in checked-out status

javax.jcr.lock.LockException - when the parent node is locked

javax.jcr.RepositoryException - a generic error while accessing the repository

See Also:

exportDereferencedView(String,OutputStream,boolean,boolean), Session.importXML(java.lang.String, java.io.InputStream, int), ImportReferenceBehavior, ImportMergeBehavior

importEnhancedSystemViewXML

ImportResult importEnhancedSystemViewXML(String parentAbsPath,
                                         InputStream in,
                                         int uuidBehavior,
                                         int referenceBehavior,
                                         ContentResourceLoader referredResourceLoader)
                                  throws IOException,
                                         javax.jcr.RepositoryException

Import an enhanced system view xml file.

Parameters:

parentAbsPath - the parent node below which to in

in - the input stream from which to read the XML

uuidBehavior - how to handle deserialized UUIDs in the input stream ImportUUIDBehavior

referenceBehavior - an options flag containing one of the values of ImportReferenceBehavior indicating how to handle references

referredResourceLoader - the content resouce loader to load the referred imported content resources

Throws:

IOException - if incoming stream is not a valid XML document.

javax.jcr.RepositoryException - a generic error while accessing the repository

See Also:

exportDereferencedView(String,OutputStream,boolean,boolean), Session.importXML(java.lang.String, java.io.InputStream, int), ImportReferenceBehavior

exportEnhancedSystemViewPackage

File exportEnhancedSystemViewPackage(String parentAbsPath,
                                     boolean recurse)
                              throws IOException,
                                     javax.jcr.RepositoryException

Throws:

IOException

javax.jcr.RepositoryException

getXAResource

XAResource getXAResource()

Retrieves an XAResource object that the transaction manager will use to manage this XASession object's participation in a distributed transaction.

Returns:

the XAResource object.

getSessionClassLoader

ClassLoader getSessionClassLoader()
                           throws javax.jcr.RepositoryException

This call is not (yet) part of the API, but under evaluation. Probably it will change into getSessionClassLoader(Node) or similar. Get a classloader which uses the JCR repository to load the classes from.

Returns:

a classloader instance that will load class definitions stored in the JCR repository

Throws:

javax.jcr.RepositoryException - a generic error while accessing the repository

getUser

User getUser()
      throws javax.jcr.ItemNotFoundException,
             javax.jcr.RepositoryException

Get the User object identified by this session's user id.

Returns:

the User object identified by this session's user id.

Throws:

javax.jcr.ItemNotFoundException - if the user could not be found in the repository.

javax.jcr.RepositoryException

createSecurityDelegate

javax.jcr.Session createSecurityDelegate(javax.jcr.Session session,
                                         DomainRuleExtension... domainExtensions)
                                  throws javax.jcr.RepositoryException

Create a new Session that contains the union of access control rules of this Session and the provided session, with the optional addition of custom domain rules. Those rules will be added to existing domain rules, imposing additional restrictions on the session.

Throws:

javax.jcr.RepositoryException

localRefresh

void localRefresh()

This method discards all pending changes currently recorded in this Session, including the built-up virtual node states. The difference with Session.refresh(boolean false) is that after this method returns, the state of the items is not guaranteed to reflect the current persistent storage because in a clustered environment, the cluster node is not synced as a result of this call.

disableVirtualLayers

void disableVirtualLayers()

Disable virtual layers.