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

All Superinterfaces:

java.rmi.Remote, RemoteItem

All Known Subinterfaces:

RemoteExtendedNode, RemoteVersion, RemoteVersionHistory

All Known Implementing Classes:

ServerNode, ServerVersion, ServerVersionHistory

public interface RemoteNode
extends RemoteItem

Remote version of the JCR Node interface.

The methods in this interface are documented only with a reference to a corresponding Node method. The remote object will simply forward the method call to the underlying Node instance. Argument and return values, as well as possible exceptions, are copied over the network. Compex return values (like Nodes and Properties) are returned as remote references to the corresponding remote interfaces. Iterator values are transmitted as object arrays. RMI errors are signalled with RemoteExceptions.

Note that only two generic setProperty methods are included in this interface. Clients should implement the type-specific setProperty methods by wrapping the argument values into generic Value objects and calling the generic setProperty methods. Note also that the Value objects must be serializable and implemented using classes available on both the client and server side.

Method Summary

void	addMixin(java.lang.String name) Remote version of the Node.addMixin(String) method.
RemoteNode	addNode(java.lang.String path) Remote version of the Node.addNode(Sring) method.
RemoteNode	addNode(java.lang.String path, java.lang.String type) Remote version of the Node.addNode(String,String) method.
boolean	canAddMixin(java.lang.String name) Remote version of the Node.canAddMixin(String) method.
void	cancelMerge(java.lang.String versionUUID) Remote version of the Node.cancelMerge(Version) method.
RemoteVersion	checkin() Remote version of the Node.checkin() method.
void	checkout() Remote version of the Node.checkout() method.
void	doneMerge(java.lang.String versionUUID) Remote version of the Node.doneMerge(Version) method.
RemoteVersion	getBaseVersion() Remote version of the Node.getBaseVersion() method.
java.lang.String	getCorrespondingNodePath(java.lang.String workspace) Remote version of the Node.getCorrespondingNodePath(String) method.
RemoteNodeDefinition	getDefinition() Remote version of the Node.getDefinition() method.
int	getIndex() Remote version of the Node.getIndex() method.
RemoteLock	getLock() Remote version of the Node.getLock() method.
RemoteNodeType[]	getMixinNodeTypes() Remote version of the Node.getMixinNodeTypes() method.
RemoteNode	getNode(java.lang.String path) Remote version of the Node.getNode(String) method.
RemoteIterator	getNodes() Remote version of the Node.getNodes() method.
RemoteIterator	getNodes(java.lang.String pattern) Remote version of the Node.getNodes(String) method.
RemoteItem	getPrimaryItem() Remote version of the Node.getPrimaryItem() method.
RemoteNodeType	getPrimaryNodeType() Remote version of the Node.getPrimaryNodeType() method.
RemoteIterator	getProperties() Remote version of the Node.getProperties() method.
RemoteIterator	getProperties(java.lang.String pattern) Remote version of the Node.getProperties(String) method.
RemoteProperty	getProperty(java.lang.String path) Remote version of the Node.getProperty(String) method.
RemoteIterator	getReferences() Remote version of the Node.getReferences() method.
java.lang.String	getUUID() Remote version of the Node.getUUID() method.
RemoteVersionHistory	getVersionHistory() Remote version of the Node.getVersionHistory() method.
boolean	hasNode(java.lang.String path) Remote version of the Node.hasNode(String) method.
boolean	hasNodes() Remote version of the Node.hasNodes() method.
boolean	hasProperties() Remote version of the Node.hasProperties() method.
boolean	hasProperty(java.lang.String path) Remote version of the Node.hasProperty() method.
boolean	holdsLock() Remote version of the Node.holdsLock() method.
boolean	isCheckedOut() Remote version of the Node.isCheckedOut() method.
boolean	isLocked() Remote version of the Node.isLocked() method.
boolean	isNodeType(java.lang.String type) Remote version of the Node.isNodeType(String) method.
RemoteLock	lock(boolean isDeep, boolean isSessionScoped) Remote version of the Node.lock(boolean,boolean) method.
RemoteIterator	merge(java.lang.String workspace, boolean bestEffort) Remote version of the Node.merge(String,boolean) method.
void	orderBefore(java.lang.String src, java.lang.String dst) Remote version of the Node.orderBefore(String,String) method.
void	removeMixin(java.lang.String name) Remote version of the Node.removeMixin(String) method.
void	restore(java.lang.String version, boolean removeExisting) Remote version of the Node.restore(String,boolean) method.
void	restore(java.lang.String versionUUID, java.lang.String path, boolean removeExisting) Remote version of the Node.restore(Version,String,boolean) method.
void	restoreByLabel(java.lang.String label, boolean removeExisting) Remote version of the Node.restoreByLabel(String,boolean) method.
void	restoreByUUID(java.lang.String versionUUID, boolean removeExisting) Remote version of the Node.restore(Version,boolean) method.
RemoteProperty	setProperty(java.lang.String name, javax.jcr.Value value) Remote version of the Node.setProperty(String,Value) method.
RemoteProperty	setProperty(java.lang.String name, javax.jcr.Value[] values) Remote version of the Node.setProperty(String,Value[]) method.
RemoteProperty	setProperty(java.lang.String name, javax.jcr.Value[] values, int type) Remote version of the Node.setProperty(String,Value[],int) method.
RemoteProperty	setProperty(java.lang.String name, javax.jcr.Value value, int type) Remote version of the Node.setProperty(String,Value) method.
void	unlock() Remote version of the Node.unlock() method.
void	update(java.lang.String workspace) Remote version of the Node.update(String) method.

Methods inherited from interface org.exoplatform.services.jcr.rmi.api.remote.RemoteItem

getAncestor, getDepth, getName, getParent, getPath, isModified, isNew, refresh, remove, save

Method Detail

addNode

RemoteNode addNode(java.lang.String path)
                   throws javax.jcr.RepositoryException,
                          java.rmi.RemoteException

Remote version of the Node.addNode(Sring) method.

Parameters:

path - relative path

Returns:

new node

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

addNode

RemoteNode addNode(java.lang.String path,
                   java.lang.String type)
                   throws javax.jcr.RepositoryException,
                          java.rmi.RemoteException

Remote version of the Node.addNode(String,String) method.

Parameters:

path - relative path

type - node type name

Returns:

new node

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

getProperty

RemoteProperty getProperty(java.lang.String path)
                           throws javax.jcr.RepositoryException,
                                  java.rmi.RemoteException

Remote version of the Node.getProperty(String) method.

Parameters:

path - relative path

Returns:

node property

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

getProperties

RemoteIterator getProperties()
                             throws javax.jcr.RepositoryException,
                                    java.rmi.RemoteException

Remote version of the Node.getProperties() method.

Returns:

node properties

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

getProperties

RemoteIterator getProperties(java.lang.String pattern)
                             throws javax.jcr.RepositoryException,
                                    java.rmi.RemoteException

Remote version of the Node.getProperties(String) method.

Parameters:

pattern - property name pattern

Returns:

matching node properties

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

getPrimaryItem

RemoteItem getPrimaryItem()
                          throws javax.jcr.RepositoryException,
                                 java.rmi.RemoteException

Remote version of the Node.getPrimaryItem() method.

Returns:

primary item

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

getUUID

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

Remote version of the Node.getUUID() method.

Returns:

node uuid

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

getReferences

RemoteIterator getReferences()
                             throws javax.jcr.RepositoryException,
                                    java.rmi.RemoteException

Remote version of the Node.getReferences() method.

Returns:

reference properties

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

getNodes

RemoteIterator getNodes()
                        throws javax.jcr.RepositoryException,
                               java.rmi.RemoteException

Remote version of the Node.getNodes() method.

Returns:

child nodes

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

getNodes

RemoteIterator getNodes(java.lang.String pattern)
                        throws javax.jcr.RepositoryException,
                               java.rmi.RemoteException

Remote version of the Node.getNodes(String) method.

Parameters:

pattern - node name pattern

Returns:

matching child nodes

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

hasNode

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

Remote version of the Node.hasNode(String) method.

Parameters:

path - relative path

Returns:

true if the identified node exists, false otherwise

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

hasProperty

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

Remote version of the Node.hasProperty() method.

Parameters:

path - relative path

Returns:

true if the identified property exists, false otherwise

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

hasNodes

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

Remote version of the Node.hasNodes() method.

Returns:

true if this node has child nodes, false otherwise

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

hasProperties

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

Remote version of the Node.hasProperties() method.

Returns:

true if this node has properties, false otherwise

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

getPrimaryNodeType

RemoteNodeType getPrimaryNodeType()
                                  throws javax.jcr.RepositoryException,
                                         java.rmi.RemoteException

Remote version of the Node.getPrimaryNodeType() method.

Returns:

primary node type

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

getMixinNodeTypes

RemoteNodeType[] getMixinNodeTypes()
                                   throws javax.jcr.RepositoryException,
                                          java.rmi.RemoteException

Remote version of the Node.getMixinNodeTypes() method.

Returns:

mixin node types

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

isNodeType

boolean isNodeType(java.lang.String type)
                   throws javax.jcr.RepositoryException,
                          java.rmi.RemoteException

Remote version of the Node.isNodeType(String) method.

Parameters:

type - node type name

Returns:

true if this node is an instance of the identified type, false otherwise

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

getNode

RemoteNode getNode(java.lang.String path)
                   throws javax.jcr.RepositoryException,
                          java.rmi.RemoteException

Remote version of the Node.getNode(String) method.

Parameters:

path - relative path

Returns:

node

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

orderBefore

void orderBefore(java.lang.String src,
                 java.lang.String dst)
                 throws javax.jcr.RepositoryException,
                        java.rmi.RemoteException

Remote version of the Node.orderBefore(String,String) method.

Parameters:

src - source path

dst - destination path

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

setProperty

RemoteProperty setProperty(java.lang.String name,
                           javax.jcr.Value value)
                           throws javax.jcr.RepositoryException,
                                  java.rmi.RemoteException

Remote version of the Node.setProperty(String,Value) method.

Parameters:

name - property name

value - property value

Returns:

property

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

setProperty

RemoteProperty setProperty(java.lang.String name,
                           javax.jcr.Value value,
                           int type)
                           throws javax.jcr.RepositoryException,
                                  java.rmi.RemoteException

Remote version of the Node.setProperty(String,Value) method.

Parameters:

name - property name

value - property value

type - property type

Returns:

property

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

setProperty

RemoteProperty setProperty(java.lang.String name,
                           javax.jcr.Value[] values)
                           throws javax.jcr.RepositoryException,
                                  java.rmi.RemoteException

Remote version of the Node.setProperty(String,Value[]) method.

Parameters:

name - property name

values - property values

Returns:

property

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

addMixin

void addMixin(java.lang.String name)
              throws javax.jcr.RepositoryException,
                     java.rmi.RemoteException

Remote version of the Node.addMixin(String) method.

Parameters:

name - mixin type name

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

removeMixin

void removeMixin(java.lang.String name)
                 throws javax.jcr.RepositoryException,
                        java.rmi.RemoteException

Remote version of the Node.removeMixin(String) method.

Parameters:

name - mixin type name

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

canAddMixin

boolean canAddMixin(java.lang.String name)
                    throws javax.jcr.RepositoryException,
                           java.rmi.RemoteException

Remote version of the Node.canAddMixin(String) method.

Parameters:

name - mixin type name

Returns:

true if the mixin type can be added, false otherwise

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

getDefinition

RemoteNodeDefinition getDefinition()
                                   throws javax.jcr.RepositoryException,
                                          java.rmi.RemoteException

Remote version of the Node.getDefinition() method.

Returns:

node definition

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

checkin

RemoteVersion checkin()
                      throws javax.jcr.RepositoryException,
                             java.rmi.RemoteException

Remote version of the Node.checkin() method.

Returns:

checked in version

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

checkout

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

Remote version of the Node.checkout() method.

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

update

void update(java.lang.String workspace)
            throws javax.jcr.RepositoryException,
                   java.rmi.RemoteException

Remote version of the Node.update(String) method.

Parameters:

workspace - source workspace name

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

merge

RemoteIterator merge(java.lang.String workspace,
                     boolean bestEffort)
                     throws javax.jcr.RepositoryException,
                            java.rmi.RemoteException

Remote version of the Node.merge(String,boolean) method.

Parameters:

workspace - source workspace name

bestEffort - best effort flag

Returns:

nodes that failed to merge

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

cancelMerge

void cancelMerge(java.lang.String versionUUID)
                 throws javax.jcr.RepositoryException,
                        java.rmi.RemoteException

Remote version of the Node.cancelMerge(Version) method.

Parameters:

versionUUID - The UUID of the version whose labels are to be returned.

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

doneMerge

void doneMerge(java.lang.String versionUUID)
               throws javax.jcr.RepositoryException,
                      java.rmi.RemoteException

Remote version of the Node.doneMerge(Version) method.

Parameters:

versionUUID - The UUID of the version whose labels are to be returned.

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

getCorrespondingNodePath

java.lang.String getCorrespondingNodePath(java.lang.String workspace)
                                          throws javax.jcr.RepositoryException,
                                                 java.rmi.RemoteException

Remote version of the Node.getCorrespondingNodePath(String) method.

Parameters:

workspace - workspace name

Returns:

corresponding node path

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

getIndex

int getIndex()
             throws javax.jcr.RepositoryException,
                    java.rmi.RemoteException

Remote version of the Node.getIndex() method.

Returns:

node index

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

restore

void restore(java.lang.String version,
             boolean removeExisting)
             throws javax.jcr.RepositoryException,
                    java.rmi.RemoteException

Remote version of the Node.restore(String,boolean) method.

Parameters:

version - version name

removeExisting - flag to remove conflicting nodes

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

restoreByUUID

void restoreByUUID(java.lang.String versionUUID,
                   boolean removeExisting)
                   throws javax.jcr.RepositoryException,
                          java.rmi.RemoteException

Remote version of the Node.restore(Version,boolean) method.

This method has been rename to prevent a naming clash with restore(String, boolean).

Parameters:

versionUUID - The UUID of the version whose labels are to be returned.

removeExisting - flag to remove conflicting nodes

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

restore

void restore(java.lang.String versionUUID,
             java.lang.String path,
             boolean removeExisting)
             throws javax.jcr.RepositoryException,
                    java.rmi.RemoteException

Remote version of the Node.restore(Version,String,boolean) method.

Parameters:

versionUUID - The UUID of the version whose labels are to be returned.

path - the path to which the version is to be restored

removeExisting - flag to remove conflicting nodes

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

restoreByLabel

void restoreByLabel(java.lang.String label,
                    boolean removeExisting)
                    throws javax.jcr.RepositoryException,
                           java.rmi.RemoteException

Remote version of the Node.restoreByLabel(String,boolean) method.

Parameters:

label - version label

removeExisting - flag to remove conflicting nodes

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

unlock

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

Remote version of the Node.unlock() method.

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

holdsLock

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

Remote version of the Node.holdsLock() method.

Returns:

true if this node holds a lock, false otherwise

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

isLocked

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

Remote version of the Node.isLocked() method.

Returns:

true if this node is locked, false otherwise

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

isCheckedOut

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

Remote version of the Node.isCheckedOut() method.

Returns:

true if this node is checked out, false otherwise

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

getVersionHistory

RemoteVersionHistory getVersionHistory()
                                       throws javax.jcr.RepositoryException,
                                              java.rmi.RemoteException

Remote version of the Node.getVersionHistory() method.

Returns:

the remote version history.

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

getBaseVersion

RemoteVersion getBaseVersion()
                             throws javax.jcr.RepositoryException,
                                    java.rmi.RemoteException

Remote version of the Node.getBaseVersion() method.

Returns:

the remote base version

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

setProperty

RemoteProperty setProperty(java.lang.String name,
                           javax.jcr.Value[] values,
                           int type)
                           throws javax.jcr.RepositoryException,
                                  java.rmi.RemoteException

Remote version of the Node.setProperty(String,Value[],int) method.

Parameters:

name - property name

values - property values

type - property type

Returns:

property

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

lock

RemoteLock lock(boolean isDeep,
                boolean isSessionScoped)
                throws javax.jcr.RepositoryException,
                       java.rmi.RemoteException

Remote version of the Node.lock(boolean,boolean) method.

Parameters:

isDeep - flag to create a deep lock

isSessionScoped - flag to create a session-scoped lock

Returns:

lock

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors

getLock

RemoteLock getLock()
                   throws javax.jcr.RepositoryException,
                          java.rmi.RemoteException

Remote version of the Node.getLock() method.

Returns:

lock

Throws:

javax.jcr.RepositoryException - on repository errors

java.rmi.RemoteException - on RMI errors