org.exoplatform.services.jcr.rmi.api.remote
Interface RemoteSession

All Superinterfaces:

java.rmi.Remote

All Known Implementing Classes:

ServerSession

public interface RemoteSession
extends java.rmi.Remote

Remote version of the JCR Session interface. Used by the ServerSession and ClientSession adapters to provide transparent RMI access to remote sessions.

Most of the methods in this interface are documented only with a reference to a corresponding Session method. In these cases the remote object will simply forward the method call to the underlying Session instance. Complex return values like workspaces and other objects are returned as remote references to the corresponding remote interface. Simple return values and possible exceptions are simply copied over the network to the client. RMI errors are signalled with RemoteExceptions.

See Also:

Session, ClientSession, ServerSession

Method Summary

void	addLockToken(java.lang.String name) Remote version of the Session.addLockToken(String) method.
void	checkPermission(java.lang.String path, java.lang.String actions) Remote version of the Session.checkPermission(String,String) method.
byte[]	exportDocumentView(java.lang.String path, boolean skipBinary, boolean noRecurse) Exports the identified repository subtree as a document view XML stream.
byte[]	exportSystemView(java.lang.String path, boolean skipBinary, boolean noRecurse) Exports the identified repository subtree as a system view XML stream.
java.lang.String[]	getAllNamespacePrefixes()
java.lang.Object	getAttribute(java.lang.String name) Returns the named attribute.
java.lang.String[]	getAttributeNames() Remote version of the Session.getAttributeNames() method.
RemoteItem	getItem(java.lang.String path) Remote version of the Session.getItem(String) method.
java.lang.String[]	getLockTokens() Remote version of the Session.getLockTokens() method.
java.lang.String	getNamespacePrefix(java.lang.String uri) Remote version of the Session.getNamespacePrefix(String) method.
java.lang.String	getNamespacePrefixByURI(java.lang.String uri)
java.lang.String[]	getNamespacePrefixes() Remote version of the Session.getNamespacePrefixes() method.
java.lang.String	getNamespaceURI(java.lang.String prefix) Remote version of the Session.getNamespaceURI(String) method.
java.lang.String	getNamespaceURIByPrefix(java.lang.String prefix)
RemoteNode	getNodeByUUID(java.lang.String uuid) Remote version of the Session.getNodeByUUID(String) method.
RemoteNode	getRootNode() Remote version of the Session.getRootNode() method.
java.lang.String	getUserID() Remote version of the Session.getUserID() method.
RemoteWorkspace	getWorkspace() Remote version of the Session.getWorkspace() method.
boolean	hasPendingChanges() Remote version of the Session.hasPendingChanges() method.
RemoteSession	impersonate(javax.jcr.Credentials credentials) Remote version of the Session.impersonate(Credentials) method.
void	importXML(java.lang.String path, byte[] xml, int uuidBehaviour) Imports the system or document view XML data into a subtree of the identified node.
boolean	isLive() Remote version of the Session.isLive() method.
boolean	itemExists(java.lang.String path) Remote version of the Session.itemExists(String) method.
void	logout() Remote version of the Session.logout() method.
void	move(java.lang.String from, java.lang.String to) Remote version of the Session.move(String,String) method.
void	refresh(boolean keepChanges) Remote version of the Session.refresh(boolean) method.
void	removeLockToken(java.lang.String name) Remote version of the Session.removeLockToken(String) method.
void	save() Remote version of the Session.save() method.
void	setNamespacePrefix(java.lang.String prefix, java.lang.String uri) Remote version of the Session.setNamespacePrefix(String,String) method.

Method Detail

getUserID

java.lang.String getUserID()
                           throws java.rmi.RemoteException

Remote version of the Session.getUserID() method.

Returns:

user id

Throws:

java.rmi.RemoteException - on RMI errors

See Also:

Session.getUserID()

getAttribute

java.lang.Object getAttribute(java.lang.String name)
                              throws java.rmi.RemoteException

Returns the named attribute. Note that only serializable attribute values can be transmitted over the network and that the client should have (or be able to fetch) the object class to access the returned value. Failures to meet these conditions are signalled with RemoteExceptions.

Parameters:

name - attribute name

Returns:

attribute value

Throws:

java.rmi.RemoteException - on RMI errors

See Also:

Session.getAttribute(java.lang.String)

getAttributeNames

java.lang.String[] getAttributeNames()
                                     throws java.rmi.RemoteException

Remote version of the Session.getAttributeNames() method.

Returns:

attribute names

Throws:

java.rmi.RemoteException - on RMI errors

getWorkspace

RemoteWorkspace getWorkspace()
                             throws java.rmi.RemoteException

Remote version of the Session.getWorkspace() method.

Returns:

workspace

Throws:

java.rmi.RemoteException - on RMI errors

See Also:

Session.getWorkspace()

impersonate

RemoteSession impersonate(javax.jcr.Credentials credentials)
                          throws javax.jcr.RepositoryException,
                                 java.rmi.RemoteException

Remote version of the Session.impersonate(Credentials) method.

Parameters:

credentials - credentials for the new session

Returns:

new session

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

getNodeByUUID

RemoteNode getNodeByUUID(java.lang.String uuid)
                         throws javax.jcr.RepositoryException,
                                java.rmi.RemoteException

Remote version of the Session.getNodeByUUID(String) method.

Parameters:

uuid - node uuid

Returns:

node

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

getItem

RemoteItem getItem(java.lang.String path)
                   throws javax.jcr.RepositoryException,
                          java.rmi.RemoteException

Remote version of the Session.getItem(String) method.

Parameters:

path - item path

Returns:

item

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

itemExists

boolean itemExists(java.lang.String path)
                   throws javax.jcr.RepositoryException,
                          java.rmi.RemoteException

Remote version of the Session.itemExists(String) method.

Parameters:

path - item path

Returns:

true if the item exists, false otherwise

Throws:

javax.jcr.RepositoryException - on repository exception

java.rmi.RemoteException - on RMI errors

move

void move(java.lang.String from,
          java.lang.String to)
          throws javax.jcr.RepositoryException,
                 java.rmi.RemoteException

Remote version of the Session.move(String,String) method.

Parameters:

from - source path

to - destination path

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

save

void save()
          throws javax.jcr.RepositoryException,
                 java.rmi.RemoteException

Remote version of the Session.save() method.

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

refresh

void refresh(boolean keepChanges)
             throws javax.jcr.RepositoryException,
                    java.rmi.RemoteException

Remote version of the Session.refresh(boolean) method.

Parameters:

keepChanges - flag to keep transient changes

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

logout

void logout()
            throws java.rmi.RemoteException

Remote version of the Session.logout() method.

Throws:

java.rmi.RemoteException - on RMI errors

isLive

boolean isLive()
               throws java.rmi.RemoteException

Remote version of the Session.isLive() method.

Returns:

true if the session is live, false otherwise

Throws:

java.rmi.RemoteException - on RMI errors

getRootNode

RemoteNode getRootNode()
                       throws javax.jcr.RepositoryException,
                              java.rmi.RemoteException

Remote version of the Session.getRootNode() method.

Returns:

root node

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

hasPendingChanges

boolean hasPendingChanges()
                          throws javax.jcr.RepositoryException,
                                 java.rmi.RemoteException

Remote version of the Session.hasPendingChanges() method.

Returns:

true if the session has pending changes, false otherwise

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

checkPermission

void checkPermission(java.lang.String path,
                     java.lang.String actions)
                     throws java.security.AccessControlException,
                            javax.jcr.RepositoryException,
                            java.rmi.RemoteException

Remote version of the Session.checkPermission(String,String) method.

Parameters:

path - item path

actions - actions

Throws:

java.security.AccessControlException - if permission is denied

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

importXML

void importXML(java.lang.String path,
               byte[] xml,
               int uuidBehaviour)
               throws java.io.IOException,
                      javax.jcr.RepositoryException,
                      java.rmi.RemoteException

Imports the system or document view XML data into a subtree of the identified node. Note that the entire XML stream is transferred as a single byte array over the network. This may cause problems with large XML streams. The remote server will wrap the XML data into a ByteArrayInputStream and feed it to the normal importXML method.

Parameters:

path - node path

xml - imported XML document

uuidBehaviour - UUID handling mode

Throws:

java.io.IOException - on IO errors

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

See Also:

Session.importXML(java.lang.String, java.io.InputStream, int)

setNamespacePrefix

void setNamespacePrefix(java.lang.String prefix,
                        java.lang.String uri)
                        throws javax.jcr.RepositoryException,
                               java.rmi.RemoteException

Remote version of the Session.setNamespacePrefix(String,String) method.

Parameters:

prefix - namespace prefix

uri - namespace uri

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

getNamespacePrefixes

java.lang.String[] getNamespacePrefixes()
                                        throws javax.jcr.RepositoryException,
                                               java.rmi.RemoteException

Remote version of the Session.getNamespacePrefixes() method.

Returns:

namespace prefixes

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

getNamespaceURI

java.lang.String getNamespaceURI(java.lang.String prefix)
                                 throws javax.jcr.RepositoryException,
                                        java.rmi.RemoteException

Remote version of the Session.getNamespaceURI(String) method.

Parameters:

prefix - namespace prefix

Returns:

namespace uri

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

getNamespacePrefix

java.lang.String getNamespacePrefix(java.lang.String uri)
                                    throws javax.jcr.RepositoryException,
                                           java.rmi.RemoteException

Remote version of the Session.getNamespacePrefix(String) method.

Parameters:

uri - namespace uri

Returns:

namespace prefix

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

addLockToken

void addLockToken(java.lang.String name)
                  throws java.rmi.RemoteException

Remote version of the Session.addLockToken(String) method.

Parameters:

name - lock token

Throws:

java.rmi.RemoteException - on RMI errors

getLockTokens

java.lang.String[] getLockTokens()
                                 throws java.rmi.RemoteException

Remote version of the Session.getLockTokens() method.

Returns:

lock tokens

Throws:

java.rmi.RemoteException - on RMI errors

removeLockToken

void removeLockToken(java.lang.String name)
                     throws java.rmi.RemoteException

Remote version of the Session.removeLockToken(String) method.

Parameters:

name - lock token

Throws:

java.rmi.RemoteException - on RMI errors

exportSystemView

byte[] exportSystemView(java.lang.String path,
                        boolean skipBinary,
                        boolean noRecurse)
                        throws java.io.IOException,
                               javax.jcr.RepositoryException,
                               java.rmi.RemoteException

Exports the identified repository subtree as a system view XML stream. Note that the entire XML stream is transferred as a single byte array over the network. This may cause problems with large exports. The remote server uses a ByteArrayOutputStream to capture the XML data written by the normal exportSysView method.

Parameters:

path - node path

skipBinary - binary skip flag

noRecurse - no recursion flag

Returns:

exported XML document

Throws:

java.io.IOException - on IO errors

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

See Also:

Session.exportSystemView(java.lang.String, org.xml.sax.ContentHandler, boolean, boolean)

exportDocumentView

byte[] exportDocumentView(java.lang.String path,
                          boolean skipBinary,
                          boolean noRecurse)
                          throws java.io.IOException,
                                 javax.jcr.RepositoryException,
                                 java.rmi.RemoteException

Exports the identified repository subtree as a document view XML stream. Note that the entire XML stream is transferred as a single byte array over the network. This may cause problems with large exports. The remote server uses a ByteArrayOutputStream to capture the XML data written by the normal exportDocView method.

Parameters:

path - node path

skipBinary - skip binary flag

noRecurse - no recursion flag

Returns:

exported XML document

Throws:

java.io.IOException - on IO errors

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

See Also:

Session.exportDocumentView(java.lang.String, org.xml.sax.ContentHandler, boolean, boolean)

getNamespaceURIByPrefix

java.lang.String getNamespaceURIByPrefix(java.lang.String prefix)
                                         throws javax.jcr.NamespaceException,
                                                javax.jcr.RepositoryException,
                                                java.rmi.RemoteException

Parameters:

prefix -

Returns:

URI by mapped prefix

Throws:

javax.jcr.NamespaceException

javax.jcr.RepositoryException

java.rmi.RemoteException

getNamespacePrefixByURI

java.lang.String getNamespacePrefixByURI(java.lang.String uri)
                                         throws javax.jcr.NamespaceException,
                                                javax.jcr.RepositoryException,
                                                java.rmi.RemoteException

Parameters:

uri -

Returns:

prefix by mapped URI

Throws:

javax.jcr.NamespaceException

javax.jcr.RepositoryException

java.rmi.RemoteException

getAllNamespacePrefixes

java.lang.String[] getAllNamespacePrefixes()
                                           throws javax.jcr.RepositoryException,
                                                  java.rmi.RemoteException

Returns:

all prefixes registered

Throws:

javax.jcr.RepositoryException

java.rmi.RemoteException