com.sun.corba.ee.impl.naming.cosnaming

Interface NamingContextDataStore

All Known Implementing Classes:

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 and Description
void	bindImpl(NameComponent n, Object obj, BindingType bt) Method which implements binding a name to an object as the specified binding type.
void	destroyImpl() Method which implements destroying this NamingContext.
POA	getNSPOA()
boolean	isEmptyImpl() Method which returns whether this NamingContext is empty or not.
void	listImpl(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	newContextImpl() Method which implements creating a new NamingContext.
Object	resolveImpl(NameComponent n, BindingTypeHolder bth) Method which implements resolving the specified name, returning the type of the binding and the bound object reference.
Object	unbindImpl(NameComponent n) Method which implements unbinding a name.

Method Detail

bindImpl

void bindImpl(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.

resolveImpl

Object resolveImpl(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.

unbindImpl

Object unbindImpl(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.

listImpl

void listImpl(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.

newContextImpl

NamingContext newContextImpl()
                      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.

destroyImpl

void destroyImpl()
          throws SystemException

Method which implements destroying this NamingContext.

Throws:

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

isEmptyImpl

boolean isEmptyImpl()

Method which returns whether this NamingContext is empty or not.

Returns:

true if this NamingContext contains no bindings.

getNSPOA

POA getNSPOA()