Package org.apache.jackrabbit.rmi.server.iterator

Class ServerIterator

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.iterator.ServerIterator

All Implemented Interfaces:

Serializable, Remote, RemoteIterator

Direct Known Subclasses:

ServerAccessControlPolicyIterator, ServerNodeIterator, ServerNodeTypeIterator, ServerPrincipalIterator, ServerPropertyIterator, ServerRowIterator, ServerVersionIterator

@Deprecated(forRemoval=true)
public abstract class ServerIterator
extends ServerObject
implements RemoteIterator

Deprecated, for removal: This API element is subject to removal in a future version.

RMI support is deprecated and will be removed in a future version of Jackrabbit; see Jira ticket JCR-4972 for more information.

Remote adapter for the JCR RangeIterator interface. This class makes a local iterator available as an RMI service using the RemoteIterator interface.

See Also:

Serialized Form

Field Summary

Fields inherited from class java.rmi.server.RemoteObject

ref

Constructor Summary

Constructors

Constructor	Description
ServerIterator(RangeIterator iterator, RemoteAdapterFactory factory, int maxBufferSize)	Deprecated, for removal: This API element is subject to removal in a future version. Creates a remote adapter for the given local item.

Method Summary

Modifier and Type	Method	Description
protected abstract Object	getRemoteObject(Object object)	Deprecated, for removal: This API element is subject to removal in a future version. Returns a remote adapter for the given local object.
long	getSize()	Deprecated, for removal: This API element is subject to removal in a future version. Returns the size of the iterator.
Object[]	nextObjects()	Deprecated, for removal: This API element is subject to removal in a future version. Returns an array of remote references to the next elements in this iteration.
void	skip(long items)	Deprecated, for removal: This API element is subject to removal in a future version. Skips the given number of elements.

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

getFactory, getRemoteItem, getRemoteNode, getRemoteNodeTypeArray, getRepositoryException, getSerialValue, getSerialValues

Methods inherited from class java.rmi.server.UnicastRemoteObject

clone, exportObject, exportObject, 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

ServerIterator

public ServerIterator(RangeIterator iterator,
                      RemoteAdapterFactory factory,
                      int maxBufferSize)
               throws RemoteException

Deprecated, for removal: This API element is subject to removal in a future version.

Creates a remote adapter for the given local item.

Parameters:

iterator - local iterator to be adapted

factory - remote adapter factory

maxBufferSize - maximum buffer size

Throws:

RemoteException - on RMI errors

Method Detail

getSize

public long getSize()
             throws RemoteException

Deprecated, for removal: This API element is subject to removal in a future version.

Returns the size of the iterator. The size is cached by invoking the adapted local iterator when this method is first called or by determining the size from an end-of-iterator condition in nextObjects().

Specified by:

getSize in interface RemoteIterator

Returns:

size of the iterator

Throws:

RemoteException - on RMI errors

See Also:

RangeIterator.getSize()

skip

public void skip(long items)
          throws NoSuchElementException,
                 RemoteException

Deprecated, for removal: This API element is subject to removal in a future version.

Skips the given number of elements.

Specified by:

skip in interface RemoteIterator

Parameters:

items - number of elements to skip

Throws:

NoSuchElementException - if skipped past the last element

RemoteException - on RMI errors

See Also:

RangeIterator.skip(long)

getRemoteObject

protected abstract Object getRemoteObject(Object object)
                                   throws RemoteException

Deprecated, for removal: This API element is subject to removal in a future version.

Returns a remote adapter for the given local object. This abstract method is used by nextObjects() to convert the local objects to remote references to be sent to the client.

Subclasses should implement this method to use the remote adapter factory to create remote adapters of the specific element type.

Parameters:

object - local object

Returns:

remote adapter

Throws:

RemoteException - on RMI errors

nextObjects

public Object[] nextObjects()
                     throws RemoteException

Deprecated, for removal: This API element is subject to removal in a future version.

Returns an array of remote references to the next elements in this iteration.

Specified by:

nextObjects in interface RemoteIterator

Returns:

array of remote references, or null

Throws:

RemoteException - on RMI errors

See Also:

Iterator.next()