OpenJDK 27 · com.sun.jndi.toolkit.dir.LazySearchEnumerationImpl

Field Summary

Modifier and Type	Field and Description
private NamingEnumeration<Binding>	candidates
private SearchControls	cons
private Context	context
private Hashtable<String, Object>	env
private AttrFilter	filter
private SearchResult	nextMatch
private boolean	useFactory

Constructor Summary

Access	Constructor and Description
public	LazySearchEnumerationImpl(NamingEnumeration<Binding> candidates, AttrFilter filter, SearchControls cons)
public	LazySearchEnumerationImpl(NamingEnumeration<Binding> candidates, AttrFilter filter, SearchControls cons, Context ctx, Hashtable<String, Object> env, boolean useFactory)
public	LazySearchEnumerationImpl(NamingEnumeration<Binding> candidates, AttrFilter filter, SearchControls cons, Context ctx, Hashtable<String, Object> env)

Method Summary

Modifier and Type	Method and Description
public void	close() Implements javax.naming.NamingEnumeration.close. Closes this enumeration.
private SearchResult	findNextMatch(boolean remove)
public boolean	hasMore() Implements javax.naming.NamingEnumeration.hasMore. Determines whether there are any more elements in the enumeration.
public boolean	hasMoreElements() Implements java.util.Enumeration.hasMoreElements. Tests if this enumeration contains more elements.
public SearchResult	next() Implements javax.naming.NamingEnumeration.next. Retrieves the next element in the enumeration.
public SearchResult	nextElement() Implements java.util.Enumeration.nextElement. Returns the next element of this enumeration if this enumeration object has at least one more element to provide.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

candidates	back to summary
private NamingEnumeration<Binding> candidates

cons	back to summary
private SearchControls cons

context	back to summary
private Context context

env	back to summary
private Hashtable<String, Object> env

filter	back to summary
private AttrFilter filter

nextMatch	back to summary
private SearchResult nextMatch

useFactory	back to summary
private boolean useFactory

Constructor Detail

LazySearchEnumerationImpl	back to summary
public LazySearchEnumerationImpl(NamingEnumeration<Binding> candidates, AttrFilter filter, SearchControls cons) throws NamingException

LazySearchEnumerationImpl	back to summary
public LazySearchEnumerationImpl(NamingEnumeration<Binding> candidates, AttrFilter filter, SearchControls cons, Context ctx, Hashtable<String, Object> env, boolean useFactory) throws NamingException Annotations @SuppressWarnings:unchecked

LazySearchEnumerationImpl	back to summary
public LazySearchEnumerationImpl(NamingEnumeration<Binding> candidates, AttrFilter filter, SearchControls cons, Context ctx, Hashtable<String, Object> env) throws NamingException

Method Detail

close back to summary

close	back to summary
public void close() throws NamingException Implements javax.naming.NamingEnumeration.close. Doc from javax.naming.NamingEnumeration.close. 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. Exceptions NamingException: If a naming exception is encountered while closing the enumeration.

public void close() throws NamingException

Implements javax.naming.NamingEnumeration.close.

Doc from javax.naming.NamingEnumeration.close.

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.

Exceptions

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

findNextMatch	back to summary
private SearchResult findNextMatch(boolean remove) throws NamingException

hasMore	back to summary
public boolean hasMore() throws NamingException Implements javax.naming.NamingEnumeration.hasMore. Doc from javax.naming.NamingEnumeration.hasMore. 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. Exceptions 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.

hasMore

back to summary

public boolean hasMore() throws NamingException

Implements javax.naming.NamingEnumeration.hasMore.

Doc from javax.naming.NamingEnumeration.hasMore.

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.

Exceptions

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.

hasMoreElements	back to summary
public boolean hasMoreElements() Implements java.util.Enumeration.hasMoreElements. Doc from java.util.Enumeration.hasMoreElements. Tests if this enumeration contains more elements.

hasMoreElements

back to summary

public boolean hasMoreElements()

Implements java.util.Enumeration.hasMoreElements.

Doc from java.util.Enumeration.hasMoreElements.

Tests if this enumeration contains more elements.

next back to summary

next	back to summary
public SearchResult next() throws NamingException Implements javax.naming.NamingEnumeration.next. Doc from javax.naming.NamingEnumeration.next. 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. Exceptions NamingException: If a naming exception is encountered while attempting to retrieve the next element. See NamingException and its subclasses for the possible naming exceptions.

public SearchResult next() throws NamingException

Implements javax.naming.NamingEnumeration.next.

Doc from javax.naming.NamingEnumeration.next.

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.

Exceptions

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

nextElement	back to summary
public SearchResult nextElement() Implements java.util.Enumeration.nextElement. Doc from java.util.Enumeration.nextElement. Returns the next element of this enumeration if this enumeration object has at least one more element to provide.

nextElement

back to summary

public SearchResult nextElement()

Implements java.util.Enumeration.nextElement.

Doc from java.util.Enumeration.nextElement.

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

public final Class LazySearchEnumerationImpl

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail