org.apache.jackrabbit.rmi.server
Class ServerSession

java.lang.Object
  java.rmi.server.RemoteObject
      java.rmi.server.RemoteServer
          java.rmi.server.UnicastRemoteObject
              org.apache.jackrabbit.rmi.server.ServerObject
                  org.apache.jackrabbit.rmi.server.ServerSession

All Implemented Interfaces:

java.io.Serializable, java.rmi.Remote, RemoteSession

Direct Known Subclasses:

ServerXASession

public class ServerSession
extends ServerObject
implements RemoteSession

Remote adapter for the JCR Session interface. This class makes a local session available as an RMI service using the RemoteSession interface.

See Also:

Session, RemoteSession, Serialized Form

Field Summary

Fields inherited from class java.rmi.server.RemoteObject

ref

Constructor Summary

ServerSession(javax.jcr.Session session, RemoteAdapterFactory factory)
Creates a remote adapter for the given local session.

Method Summary

void	addLockToken(java.lang.String token) 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 binaryAsLink, boolean noRecurse) Exports the identified repository subtree as a document view XML stream.
byte[]	exportSystemView(java.lang.String path, boolean binaryAsLink, boolean noRecurse) Exports the identified repository subtree as a system view XML stream.
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[]	getNamespacePrefixes() Remote version of the Session.getNamespacePrefixes() method.
java.lang.String	getNamespaceURI(java.lang.String prefix) Remote version of the Session.getNamespaceURI(String) method.
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 mode) 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 token) 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.

Methods inherited from class org.apache.jackrabbit.rmi.server.ServerObject

getFactory, getRemoteItem, getRemoteNode, getRemoteNodeTypeArray, getRepositoryException

Methods inherited from class java.rmi.server.UnicastRemoteObject

clone, exportObject, exportObject, exportObject, unexportObject

Methods inherited from class java.rmi.server.RemoteServer

getClientHost, getLog, setLog

Methods inherited from class java.rmi.server.RemoteObject

equals, getRef, hashCode, toString, toStub

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

ServerSession

public ServerSession(javax.jcr.Session session,
                     RemoteAdapterFactory factory)
              throws java.rmi.RemoteException

Creates a remote adapter for the given local session.

Parameters:

session - local session

factory - remote adapter factory

Throws:

java.rmi.RemoteException - on RMI errors

Method Detail

getUserID

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

Remote version of the Session.getUserID() method.

Specified by:

getUserID in interface RemoteSession

Returns:

user id

Throws:

java.rmi.RemoteException - on RMI errors

See Also:

Session.getUserID()

getAttribute

public 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.

Specified by:

getAttribute in interface RemoteSession

Parameters:

name - attribute name

Returns:

attribute value

Throws:

java.rmi.RemoteException - on RMI errors

See Also:

Session.getAttribute(java.lang.String)

getAttributeNames

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

Remote version of the Session.getAttributeNames() method.

Specified by:

getAttributeNames in interface RemoteSession

Returns:

attribute names

Throws:

java.rmi.RemoteException - on RMI errors

impersonate

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

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

Specified by:

impersonate in interface RemoteSession

Parameters:

credentials - credentials for the new session

Returns:

new session

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

getWorkspace

public RemoteWorkspace getWorkspace()
                             throws java.rmi.RemoteException

Remote version of the Session.getWorkspace() method.

Specified by:

getWorkspace in interface RemoteSession

Returns:

workspace

Throws:

java.rmi.RemoteException - on RMI errors

See Also:

Session.getWorkspace()

checkPermission

public 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.

Specified by:

checkPermission in interface RemoteSession

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

getNamespacePrefix

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

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

Specified by:

getNamespacePrefix in interface RemoteSession

Parameters:

uri - namespace uri

Returns:

namespace prefix

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

getNamespacePrefixes

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

Remote version of the Session.getNamespacePrefixes() method.

Specified by:

getNamespacePrefixes in interface RemoteSession

Returns:

namespace prefixes

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

getNamespaceURI

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

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

Specified by:

getNamespaceURI in interface RemoteSession

Parameters:

prefix - namespace prefix

Returns:

namespace uri

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

setNamespacePrefix

public 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.

Specified by:

setNamespacePrefix in interface RemoteSession

Parameters:

prefix - namespace prefix

uri - namespace uri

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

itemExists

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

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

Specified by:

itemExists in interface RemoteSession

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

getNodeByUUID

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

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

Specified by:

getNodeByUUID in interface RemoteSession

Parameters:

uuid - node uuid

Returns:

node

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

getRootNode

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

Remote version of the Session.getRootNode() method.

Specified by:

getRootNode in interface RemoteSession

Returns:

root node

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

getItem

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

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

Specified by:

getItem in interface RemoteSession

Parameters:

path - item path

Returns:

item

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

hasPendingChanges

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

Remote version of the Session.hasPendingChanges() method.

Specified by:

hasPendingChanges in interface RemoteSession

Returns:

true if the session has pending changes, false otherwise

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

move

public 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.

Specified by:

move in interface RemoteSession

Parameters:

from - source path

to - destination path

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

save

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

Remote version of the Session.save() method.

Specified by:

save in interface RemoteSession

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

refresh

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

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

Specified by:

refresh in interface RemoteSession

Parameters:

keepChanges - flag to keep transient changes

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

logout

public void logout()
            throws java.rmi.RemoteException

Remote version of the Session.logout() method.

Specified by:

logout in interface RemoteSession

Throws:

java.rmi.RemoteException - on RMI errors

isLive

public boolean isLive()
               throws java.rmi.RemoteException

Remote version of the Session.isLive() method.

Specified by:

isLive in interface RemoteSession

Returns:

true if the session is live, false otherwise

Throws:

java.rmi.RemoteException - on RMI errors

importXML

public void importXML(java.lang.String path,
                      byte[] xml,
                      int mode)
               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.

Specified by:

importXML in interface RemoteSession

Parameters:

path - node path

xml - imported XML document

mode - UUID handling mode

Throws:

java.io.IOException - on IO errors

java.rmi.RemoteException - on RMI errors

javax.jcr.RepositoryException - on repository errors

See Also:

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

addLockToken

public void addLockToken(java.lang.String token)
                  throws java.rmi.RemoteException

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

Specified by:

addLockToken in interface RemoteSession

Parameters:

token - lock token

Throws:

java.rmi.RemoteException - on RMI errors

getLockTokens

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

Remote version of the Session.getLockTokens() method.

Specified by:

getLockTokens in interface RemoteSession

Returns:

lock tokens

Throws:

java.rmi.RemoteException - on RMI errors

removeLockToken

public void removeLockToken(java.lang.String token)
                     throws java.rmi.RemoteException

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

Specified by:

removeLockToken in interface RemoteSession

Parameters:

token - lock token

Throws:

java.rmi.RemoteException - on RMI errors

exportDocumentView

public byte[] exportDocumentView(java.lang.String path,
                                 boolean binaryAsLink,
                                 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.

Specified by:

exportDocumentView in interface RemoteSession

Parameters:

path - node path

binaryAsLink - skip binary flag

noRecurse - no recursion flag

Returns:

exported XML document

Throws:

java.io.IOException - on IO errors

java.rmi.RemoteException - on RMI errors

javax.jcr.RepositoryException - on repository errors

See Also:

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

exportSystemView

public byte[] exportSystemView(java.lang.String path,
                               boolean binaryAsLink,
                               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.

Specified by:

exportSystemView in interface RemoteSession

Parameters:

path - node path

binaryAsLink - binary skip flag

noRecurse - no recursion flag

Returns:

exported XML document

Throws:

java.io.IOException - on IO errors

java.rmi.RemoteException - on RMI errors

javax.jcr.RepositoryException - on repository errors

See Also:

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