com.sun.jini.outrigger
Interface AdminIterator

public abstract interface AdminIterator

Interface for the iterators returned by the contents() method of JavaSpaceAdmin. Note AdminIterators do not survive restarts of the underlying space.

See Also:

JavaSpaceAdmin

Method Summary

void	close() Tell the server that this iterator is no longer in use.
void	delete() The effect of this call depends on the most recent call to next(): If the last call to next() returned an Entry that entry will be removed from the space.
Entry	next() Return the next entry in the sequence.

Method Detail

next

public Entry next()
           throws UnusableEntryException,
                  java.rmi.RemoteException

Return the next entry in the sequence. Returns null if there are no more matching entries in the space.

This method is idempotent in the face of RemoteExceptions.

Throws:

UnusableEntryException - if the field of next entry in sequence can't be deserialized (usually this is because the class in question could not be loaded).

delete

public void delete()
            throws java.rmi.RemoteException

The effect of this call depends on the most recent call to next():

• If the last call to next() returned an Entry that entry will be removed from the space.

• If the last call to next() threw a UnusableEntryException the Entry that could not be deserialized will be removed from the space.

• If the last call to next() returned null, threw a RemoteException, or next() has not yet been called on this iterator a IllegalStateException will be thrown and no entry will be removed.

This method is idempotent in the face of RemoteException.

Throws:

java.lang.IllegalStateException - if next() has not be called on this iterator, or the last invocation of next() returned null or threw RemoteException.

close

public void close()
           throws java.rmi.RemoteException

Tell the server that this iterator is no longer in use. All operations on a closed iterator have undefined results, except the close() method.

This method is idempotent in the face of RemoteException.