org.sblim.slp
Interface ServiceLocationEnumeration

All Superinterfaces:
java.util.Enumeration<java.lang.Object>
All Known Implementing Classes:
SLEnumerationImpl

public interface ServiceLocationEnumeration
extends java.util.Enumeration<java.lang.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
 boolean hasMoreExceptions()
           
 java.lang.Object next()
          Return the next value or block until it becomes available.
 java.lang.Object nextException()
           
 
Methods inherited from interface java.util.Enumeration
hasMoreElements, nextElement
 

Method Detail

next

java.lang.Object next()
                      throws ServiceLocationException,
                             java.util.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.
java.util.NoSuchElementException - If there are no more elements to return.

nextException

java.lang.Object nextException()
                               throws java.util.NoSuchElementException
Returns:
next Object in Exception table
Throws:
java.util.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


Copyright © 2005, 2009 IBM Corporation. All Rights Reserved.