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

public abstract class ServerIterator
extends ServerObject
implements RemoteIterator

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

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
ServerIterator(RangeIterator iterator, RemoteAdapterFactory factory, int maxBufferSize) Creates a remote adapter for the given local item.

Method Summary

Modifier and Type	Method and Description
long	getSize() Returns the size of the iterator.
Object[]	nextObjects() Returns an array of remote references to the next elements in this iteration.
void	skip(long items) Skips the given number of elements.

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

getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

ServerIterator

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

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

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:

RemoteIterator.getSize(), RangeIterator#getSize()

skip

public void skip(long items)
          throws NoSuchElementException,
                 RemoteException

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:

javax.jcr.RangeIterator#skip(long)

nextObjects

public Object[] nextObjects()
                     throws RemoteException

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:

RemoteIterator#nextObjects(int), Iterator.next()