org.huihoo.jfox.jndi
Class NamingEnumerationImpl

java.lang.Object
  org.huihoo.jfox.jndi.NamingEnumerationImpl

All Implemented Interfaces:

java.util.Enumeration, javax.naming.NamingEnumeration

public class NamingEnumerationImpl

extends java.lang.Object

implements javax.naming.NamingEnumeration

Constructor Summary

NamingEnumerationImpl(java.util.List list)

Method Summary

void	close() Closes this enumeration.
boolean	hasMore() Determines whether there are any more elements in the enumeration.
boolean	hasMoreElements() Tests if this enumeration contains more elements.
java.lang.Object	next() Retrieves the next element in the enumeration.
java.lang.Object	nextElement() Returns the next element of this enumeration if this enumeration object has at least one more element to provide.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

NamingEnumerationImpl

public NamingEnumerationImpl(java.util.List list)

Method Detail

next

public java.lang.Object next()
                      throws javax.naming.NamingException

Description copied from interface: javax.naming.NamingEnumeration

Retrieves the next element in the enumeration. This method allows naming exceptions encountered while retrieving the next element to be caught and handled by the application.

Note that next() can also throw the runtime exception NoSuchElementException to indicate that the caller is attempting to enumerate beyond the end of the enumeration. This is different from a NamingException, which indicates that there was a problem in obtaining the next element, for example, due to a referral or server unavailability, etc.

Specified by:

next in interface javax.naming.NamingEnumeration

Returns:

The possibly null element in the enumeration. null is only valid for enumerations that can return null (e.g. Attribute.getAll() returns an enumeration of attribute values, and an attribute value can be null).

Throws:

javax.naming.NamingException - If a naming exception is encountered while attempting to retrieve the next element. See NamingException and its subclasses for the possible naming exceptions.

See Also:

Enumeration.nextElement()

hasMoreElements

public boolean hasMoreElements()

Description copied from interface: java.util.Enumeration

Tests if this enumeration contains more elements.

Specified by:

hasMoreElements in interface java.util.Enumeration

Returns:

true if and only if this enumeration object contains at least one more element to provide; false otherwise.

hasMore

public boolean hasMore()
                throws javax.naming.NamingException

Description copied from interface: javax.naming.NamingEnumeration

Determines whether there are any more elements in the enumeration. This method allows naming exceptions encountered while determining whether there are more elements to be caught and handled by the application.

Specified by:

hasMore in interface javax.naming.NamingEnumeration

Returns:

true if there is more in the enumeration ; false otherwise.

Throws:

javax.naming.NamingException - If a naming exception is encountered while attempting to determine whether there is another element in the enumeration. See NamingException and its subclasses for the possible naming exceptions.

See Also:

Enumeration.hasMoreElements()

nextElement

public java.lang.Object nextElement()

Description copied from interface: java.util.Enumeration

Returns the next element of this enumeration if this enumeration object has at least one more element to provide.

Specified by:

nextElement in interface java.util.Enumeration

Returns:

the next element of this enumeration.

close

public void close()
           throws javax.naming.NamingException

Description copied from interface: javax.naming.NamingEnumeration

Closes this enumeration. After this method has been invoked on this enumeration, the enumeration becomes invalid and subsequent invocation of any of its methods will yield undefined results. This method is intended for aborting an enumeration to free up resources. If an enumeration proceeds to the end--that is, until hasMoreElements() or hasMore() returns false-- resources will be freed up automatically and there is no need to explicitly call close().

This method indicates to the service provider that it is free to release resources associated with the enumeration, and can notify servers to cancel any outstanding requests. The close() method is a hint to implementations for managing their resources. Implementations are encouraged to use appropriate algorithms to manage their resources when client omits the close() calls.

Specified by:

close in interface javax.naming.NamingEnumeration

Throws:

javax.naming.NamingException - If a naming exception is encountered while closing the enumeration.