|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.apache.jackrabbit.commons.AbstractSession
public abstract class AbstractSession
Abstract base class for implementing the JCR Session
interface.
Constructor Summary | |
---|---|
AbstractSession()
|
Method Summary | |
---|---|
void |
exportDocumentView(String path,
ContentHandler handler,
boolean skipBinary,
boolean noRecurse)
Generates a document view export using a DocumentViewExporter
instance. |
void |
exportDocumentView(String absPath,
OutputStream out,
boolean skipBinary,
boolean noRecurse)
Calls Session.exportDocumentView(String, ContentHandler, boolean, boolean)
with the given arguments and a ContentHandler that serializes
SAX events to the given output stream. |
void |
exportSystemView(String path,
ContentHandler handler,
boolean skipBinary,
boolean noRecurse)
Generates a system view export using a SystemViewExporter
instance. |
void |
exportSystemView(String absPath,
OutputStream out,
boolean skipBinary,
boolean noRecurse)
Calls Session.exportSystemView(String, ContentHandler, boolean, boolean)
with the given arguments and a ContentHandler that serializes
SAX events to the given output stream. |
javax.jcr.Item |
getItem(String absPath)
Returns the node or property at the given path. |
String |
getNamespacePrefix(String uri)
Returns the namespace prefix mapped to the given URI. |
String[] |
getNamespacePrefixes()
Returns the prefixes of all known namespace mappings. |
String |
getNamespaceURI(String prefix)
Returns the namespace URI mapped to the given prefix. |
javax.jcr.Session |
impersonate(javax.jcr.Credentials credentials)
Logs in the same workspace with the given credentials. |
void |
importXML(String parentAbsPath,
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 |
itemExists(String absPath)
Calls getItem(String) with the given path and returns
true if the call succeeds. |
void |
logout()
Clears the local namespace mappings. |
void |
setNamespacePrefix(String prefix,
String uri)
Modifies the session local namespace mappings to contain the given prefix to URI mapping. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Methods inherited from interface javax.jcr.Session |
---|
addLockToken, checkPermission, getAttribute, getAttributeNames, getImportContentHandler, getLockTokens, getNodeByUUID, getRepository, getRootNode, getUserID, getValueFactory, getWorkspace, hasPendingChanges, isLive, move, refresh, removeLockToken, save |
Constructor Detail |
---|
public AbstractSession()
Method Detail |
---|
public void logout()
super.logout()
when overriding this method to avoid
namespace mappings to be carried over to a new session.
logout
in interface javax.jcr.Session
public String getNamespacePrefix(String uri) throws javax.jcr.NamespaceException, javax.jcr.RepositoryException
This behaviour is based on JSR 283 (JCR 2.0), but remains backwards compatible with JCR 1.0.
getNamespacePrefix
in interface javax.jcr.Session
uri
- namespace URI
javax.jcr.NamespaceException
- if the namespace is not found
javax.jcr.RepositoryException
- if a repository error occurspublic String getNamespaceURI(String prefix) throws javax.jcr.NamespaceException, javax.jcr.RepositoryException
This behaviour is based on JSR 283 (JCR 2.0), but remains backwards compatible with JCR 1.0.
getNamespaceURI
in interface javax.jcr.Session
prefix
- namespace prefix
javax.jcr.NamespaceException
- if the namespace is not found
javax.jcr.RepositoryException
- if a repository error occurspublic String[] getNamespacePrefixes() throws javax.jcr.RepositoryException
This behaviour is based on JSR 283 (JCR 2.0), but remains backwards compatible with JCR 1.0.
getNamespacePrefixes
in interface javax.jcr.Session
javax.jcr.RepositoryException
- if a repository error occurspublic void setNamespacePrefix(String prefix, String uri) throws javax.jcr.NamespaceException, javax.jcr.RepositoryException
This behaviour is based on JSR 283 (JCR 2.0), but remains backwards compatible with JCR 1.0.
setNamespacePrefix
in interface javax.jcr.Session
prefix
- namespace prefixuri
- namespace URI
javax.jcr.NamespaceException
- if the mapping is illegal
javax.jcr.RepositoryException
- if a repository error occurspublic void exportDocumentView(String path, ContentHandler handler, boolean skipBinary, boolean noRecurse) throws javax.jcr.PathNotFoundException, SAXException, javax.jcr.RepositoryException
DocumentViewExporter
instance.
exportDocumentView
in interface javax.jcr.Session
path
- of the node to be exportedhandler
- handler for the SAX events of the exportskipBinary
- whether binary values should be skippednoRecurse
- whether to export just the identified node
javax.jcr.PathNotFoundException
- if a node at the given path does not exist
SAXException
- if the SAX event handler failed
javax.jcr.RepositoryException
- if another error occurspublic void exportSystemView(String path, ContentHandler handler, boolean skipBinary, boolean noRecurse) throws javax.jcr.PathNotFoundException, SAXException, javax.jcr.RepositoryException
SystemViewExporter
instance.
exportSystemView
in interface javax.jcr.Session
path
- of the node to be exportedhandler
- handler for the SAX events of the exportskipBinary
- whether binary values should be skippednoRecurse
- whether to export just the identified node
javax.jcr.PathNotFoundException
- if a node at the given path does not exist
SAXException
- if the SAX event handler failed
javax.jcr.RepositoryException
- if another error occurspublic void exportDocumentView(String absPath, OutputStream out, boolean skipBinary, boolean noRecurse) throws IOException, javax.jcr.RepositoryException
Session.exportDocumentView(String, ContentHandler, boolean, boolean)
with the given arguments and a ContentHandler
that serializes
SAX events to the given output stream.
exportDocumentView
in interface javax.jcr.Session
absPath
- passed throughout
- output stream to which the SAX events are serializedskipBinary
- passed throughnoRecurse
- passed through
IOException
- if the SAX serialization failed
javax.jcr.RepositoryException
- if another error occurspublic void exportSystemView(String absPath, OutputStream out, boolean skipBinary, boolean noRecurse) throws IOException, javax.jcr.RepositoryException
Session.exportSystemView(String, ContentHandler, boolean, boolean)
with the given arguments and a ContentHandler
that serializes
SAX events to the given output stream.
exportSystemView
in interface javax.jcr.Session
absPath
- passed throughout
- output stream to which the SAX events are serializedskipBinary
- passed throughnoRecurse
- passed through
IOException
- if the SAX serialization failed
javax.jcr.RepositoryException
- if another error occurspublic void importXML(String parentAbsPath, InputStream in, int uuidBehavior) throws IOException, javax.jcr.InvalidSerializedDataException, javax.jcr.RepositoryException
ContentHandler
returned by
Session.getImportContentHandler(String, int)
.
importXML
in interface javax.jcr.Session
parentAbsPath
- passed throughin
- input stream to be parsed as XML and importeduuidBehavior
- passed through
IOException
- if an I/O error occurs
javax.jcr.InvalidSerializedDataException
- if an XML parsing error occurs
javax.jcr.RepositoryException
- if a repository error occurspublic javax.jcr.Item getItem(String absPath) throws javax.jcr.PathNotFoundException, javax.jcr.RepositoryException
The default implementation:
PathNotFoundException
if the given path
does not start with a slash.
Node.getNode(String)
on the root node with the
part of the given path after the first slash
Node.getProperty(String)
similarly in case the
above call fails with a PathNotFoundException
getItem
in interface javax.jcr.Session
absPath
- absolute path
javax.jcr.PathNotFoundException
- if the given path is invalid or not found
javax.jcr.RepositoryException
- if another error occurspublic boolean itemExists(String absPath) throws javax.jcr.RepositoryException
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.
itemExists
in interface javax.jcr.Session
absPath
- absolute path
true
if an item exists at the given path,
false
otherwise
javax.jcr.RepositoryException
- if an error occurspublic javax.jcr.Session impersonate(javax.jcr.Credentials credentials) throws javax.jcr.RepositoryException
The default implementation:
Repository
instance using
Session.getRepository()
Session.getWorkspace()
Workspace.getName()
Repository.login(Credentials, String)
on the
retrieved repository with the given credentials and the retrieved
workspace name.
impersonate
in interface javax.jcr.Session
credentials
- login credentials
javax.jcr.RepositoryException
- if an error occurs
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |