Package com.sun.corba.se.impl.naming.cosnaming

Interface NamingContextDataStore

All Known Implementing Classes:

NamingContextImpl, NamingContextImpl, TransientNamingContext

public interface NamingContextDataStore

This interface defines a set of methods that must be implemented by the "data store" associated with a NamingContext implementation. It allows for different implementations of naming contexts that support the same API but differ in storage mechanism.

Method Summary

Modifier and Type	Method	Description
void	Bind(NameComponent n, Object obj, BindingType bt)	Method which implements binding a name to an object as the specified binding type.
void	Destroy()	Method which implements destroying this NamingContext.
POA	getNSPOA()
boolean	IsEmpty()	Method which returns whether this NamingContext is empty or not.
void	List(int how_many, BindingListHolder bl, BindingIteratorHolder bi)	Method which implements listing the contents of this NamingContext and return a binding list and a binding iterator.
NamingContext	NewContext()	Method which implements creating a new NamingContext.
Object	Resolve(NameComponent n, BindingTypeHolder bth)	Method which implements resolving the specified name, returning the type of the binding and the bound object reference.
Object	Unbind(NameComponent n)	Method which implements unbinding a name.

Method Details

Bind

void Bind(NameComponent n,
 Object obj,
 BindingType bt)
   throws SystemException

Method which implements binding a name to an object as the specified binding type.

Parameters:

n - a NameComponent which is the name under which the object will be bound.

obj - the object reference to be bound.

bt - Type of binding (as object or as context).

Throws:

SystemException - One of a fixed set of CORBA system exceptions.

Resolve

Object Resolve(NameComponent n,
 BindingTypeHolder bth)
        throws SystemException

Method which implements resolving the specified name, returning the type of the binding and the bound object reference. If the id and kind of the NameComponent are both empty, the initial naming context (i.e., the local root) must be returned.

Parameters:

n - a NameComponent which is the name to be resolved.

bth - the BindingType as an out parameter.

Returns:

the object reference bound under the supplied name.

Throws:

SystemException - One of a fixed set of CORBA system exceptions.

Unbind

Object Unbind(NameComponent n)
       throws SystemException

Method which implements unbinding a name.

Returns:

the object reference bound to the name, or null if not found.

Throws:

SystemException - One of a fixed set of CORBA system exceptions.

List

void List(int how_many,
 BindingListHolder bl,
 BindingIteratorHolder bi)
   throws SystemException

Method which implements listing the contents of this NamingContext and return a binding list and a binding iterator.

Parameters:

how_many - The number of requested bindings in the BindingList.

bl - The BindingList as an out parameter.

bi - The BindingIterator as an out parameter.

Throws:

SystemException - One of a fixed set of CORBA system exceptions.

NewContext

NamingContext NewContext()
                  throws SystemException

Method which implements creating a new NamingContext.

Returns:

an object reference for a new NamingContext object implemented by this Name Server.

Throws:

SystemException - One of a fixed set of CORBA system exceptions.

Destroy

void Destroy()
      throws SystemException

Method which implements destroying this NamingContext.

Throws:

SystemException - One of a fixed set of CORBA system exceptions.

IsEmpty

boolean IsEmpty()

Method which returns whether this NamingContext is empty or not.

Returns:

true if this NamingContext contains no bindings.

getNSPOA

POA getNSPOA()