org.sblim.slp

Interface ServiceLocationEnumeration

All Superinterfaces:

Enumeration<Object>

All Known Implementing Classes:

SLEnumerationImpl

public interface ServiceLocationEnumeration
extends Enumeration<Object>

The ServiceLocationEnumeration class is the return type for all Locator SLP operations. The Java API library may implement this class to block until results are available from the SLP operation, so that the client can achieve asynchronous operation by retrieving results from the enumeration in a separate thread. Clients use the superclass nextElement() method if they are unconcerned with SLP exceptions (this method will never ever throw one).

Method Summary

Methods

Modifier and Type	Method and Description
boolean	hasMoreExceptions()
Object	next() Return the next value or block until it becomes available.
Object	nextException()

Methods inherited from interface java.util.Enumeration

hasMoreElements, nextElement

Method Detail

next

Object next()
            throws ServiceLocationException,
                   NoSuchElementException

Return the next value or block until it becomes available.

Returns:

The next value

Throws:

ServiceLocationException - Thrown if the SLP operation encounters an error.

NoSuchElementException - If there are no more elements to return.

nextException

Object nextException()
                     throws NoSuchElementException

Returns:

next Object in Exception table

Throws:

NoSuchElementException - This in internal implementation to get list of all exceptions thrown/caught by parser This can throw RuntimeExceptions. They can be ignored or used for analysis. use hasNextException to check whether there exists another element in Exception table

hasMoreExceptions

boolean hasMoreExceptions()

Returns:

true if there exists another element in Exception table