org.apache.river.admin

Interface AdminIterator

Deprecated.

Use MatchSet instead. MatchSets can be obtained using the JavaSpace05.contents method.

public interface AdminIterator

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

Author:

Sun Microsystems, Inc.

See Also:

JavaSpaceAdmin

Method Summary

Modifier and Type	Method and Description
void	close() Deprecated. Tell the server that this iterator is no longer in use.
void	delete() Deprecated. 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() Deprecated. Return the next entry in the sequence.

Method Detail

next

Entry next()
    throws UnusableEntryException,
           RemoteException

Deprecated.

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.

Returns:

next Entry in the sequence.

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

RemoteException - if connection problem occurs.

delete

void delete()
     throws RemoteException

Deprecated.

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:

RemoteException - if connection problem occurs.

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

close

void close()
    throws RemoteException

Deprecated.

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.

Throws:

RemoteException - if connection problem occurs, or if connection already closed.