org.omg.CosNaming
Interface BindingIterator

All Superinterfaces:

IDLEntity, Object, Serializable

All Known Implementing Classes:

_BindingIteratorImplBase, _BindingIteratorStub

public interface BindingIterator

extends Object, IDLEntity

The BindingIterator interface allows a client to iterate through the binding using next_one, and next_n operations.

The BindingIterator is returned by the list method on the NamingContext.

See Also:

NamingContext.list(int, org.omg.CosNaming.BindingListHolder, org.omg.CosNaming.BindingIteratorHolder)

Method Summary

void	destroy() Destroy the BindingIterator.
boolean	next_n(int how_many, BindingListHolder bl) Get atmost the specified number of bindings.
boolean	next_one(BindingHolder b) Get the next binding.

Methods inherited from interface org.omg.CORBA.Object

_create_request, _create_request, _duplicate, _get_domain_managers, _get_interface_def, _get_policy, _hash, _is_a, _is_equivalent, _non_existent, _release, _request, _set_policy_override

Method Detail

next_one

public boolean next_one(BindingHolder b)

Get the next binding. The binding is in the BindingHolder

Returns:

If there are no more bindings, then false is returned. Otherwise true is returned.

next_n

public boolean next_n(int how_many,
                      BindingListHolder bl)

Get atmost the specified number of bindings. The BindingListHolder contains an array of bindings.

Returns:

If there are no more bindings, then false is returned. Otherwise true is returned.

destroy

public void destroy()

Destroy the BindingIterator. It is a good programming practice to destroy the iterator once you are done using it.