javax.naming.directory
Class BasicAttributes.AttrEnumImpl
java.lang.Object
|
+--javax.naming.directory.BasicAttributes.AttrEnumImpl
- All Implemented Interfaces:
- Enumeration, NamingEnumeration
- Enclosing class:
- BasicAttributes
- class BasicAttributes.AttrEnumImpl
- extends Object
- implements NamingEnumeration
Methods inherited from class java.lang.Object |
, clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
elements
Enumeration elements
BasicAttributes.AttrEnumImpl
public BasicAttributes.AttrEnumImpl()
hasMoreElements
public boolean hasMoreElements()
- Specified by:
hasMoreElements
in interface Enumeration
nextElement
public Object nextElement()
- Specified by:
nextElement
in interface Enumeration
hasMore
public boolean hasMore()
throws NamingException
- Description copied from interface:
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 NamingEnumeration
- Following copied from interface:
javax.naming.NamingEnumeration
- Returns:
- true if there is more in the enumeration ; false otherwise.
- Throws:
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()
next
public Object next()
throws NamingException
- Description copied from interface:
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 NamingEnumeration
- Following copied from 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:
NamingException
- If a naming exception is encountered while attempting
to retrieve the next element. See NamingException
and its subclasses for the possible naming exceptions.NoSuchElementException
- If attempting to get the next element when none is available.- See Also:
Enumeration.nextElement()
close
public void close()
throws NamingException
- Description copied from interface:
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 NamingEnumeration
- Following copied from interface:
javax.naming.NamingEnumeration
- Throws:
NamingException
- If a naming exception is encountered
while closing the enumeration.