|
||||||||||
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. |
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. |
Session |
impersonate(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 Session
public String getNamespacePrefix(String uri) throws NamespaceException, RepositoryException
This behaviour is based on JSR 283 (JCR 2.0), but remains backwards compatible with JCR 1.0.
getNamespacePrefix
in interface Session
uri
- namespace URI
NamespaceException
- if the namespace is not found
RepositoryException
- if a repository error occurspublic String getNamespaceURI(String prefix) throws NamespaceException, RepositoryException
This behaviour is based on JSR 283 (JCR 2.0), but remains backwards compatible with JCR 1.0.
getNamespaceURI
in interface Session
prefix
- namespace prefix
NamespaceException
- if the namespace is not found
RepositoryException
- if a repository error occurspublic String[] getNamespacePrefixes() throws RepositoryException
This behaviour is based on JSR 283 (JCR 2.0), but remains backwards compatible with JCR 1.0.
getNamespacePrefixes
in interface Session
RepositoryException
- if a repository error occurspublic void setNamespacePrefix(String prefix, String uri) throws NamespaceException, RepositoryException
This behaviour is based on JSR 283 (JCR 2.0), but remains backwards compatible with JCR 1.0.
setNamespacePrefix
in interface Session
prefix
- namespace prefixuri
- namespace URI
NamespaceException
- if the mapping is illegal
RepositoryException
- if a repository error occurspublic void exportDocumentView(String path, ContentHandler handler, boolean skipBinary, boolean noRecurse) throws PathNotFoundException, SAXException, RepositoryException
DocumentViewExporter
instance.
exportDocumentView
in interface 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
PathNotFoundException
- if a node at the given path does not exist
SAXException
- if the SAX event handler failed
RepositoryException
- if another error occurspublic void exportSystemView(String path, ContentHandler handler, boolean skipBinary, boolean noRecurse) throws PathNotFoundException, SAXException, RepositoryException
SystemViewExporter
instance.
exportSystemView
in interface 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
PathNotFoundException
- if a node at the given path does not exist
SAXException
- if the SAX event handler failed
RepositoryException
- if another error occurspublic void exportDocumentView(String absPath, OutputStream out, boolean skipBinary, boolean noRecurse) throws IOException, 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 Session
absPath
- passed throughout
- output stream to which the SAX events are serializedskipBinary
- passed throughnoRecurse
- passed through
IOException
- if the SAX serialization failed
RepositoryException
- if another error occurspublic void exportSystemView(String absPath, OutputStream out, boolean skipBinary, boolean noRecurse) throws IOException, 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 Session
absPath
- passed throughout
- output stream to which the SAX events are serializedskipBinary
- passed throughnoRecurse
- passed through
IOException
- if the SAX serialization failed
RepositoryException
- if another error occurspublic void importXML(String parentAbsPath, InputStream in, int uuidBehavior) throws IOException, InvalidSerializedDataException, RepositoryException
ContentHandler
returned by
Session.getImportContentHandler(String, int)
.
importXML
in interface Session
parentAbsPath
- passed throughin
- input stream to be parsed as XML and importeduuidBehavior
- passed through
IOException
- if an I/O error occurs
InvalidSerializedDataException
- if an XML parsing error occurs
RepositoryException
- if a repository error occurspublic Item getItem(String absPath) throws PathNotFoundException, 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 Session
absPath
- absolute path
PathNotFoundException
- if the given path is invalid or not found
RepositoryException
- if another error occurspublic boolean itemExists(String absPath) throws 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 Session
absPath
- absolute path
true
if an item exists at the given path,
false
otherwise
RepositoryException
- if an error occurspublic Session impersonate(Credentials credentials) throws 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 Session
credentials
- login credentials
RepositoryException
- if an error occurs
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |