- /*
- * @(#)NamingContextDataStore.java 1.18 03/01/23
- *
- * Copyright 2003 Sun Microsystems, Inc. All rights reserved.
- * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
- */
-
- package com.sun.corba.se.internal.CosNaming;
-
- // Import general CORBA classes
- import org.omg.CORBA.Object;
-
- // Import org.omg.CosNaming classes
- import org.omg.CosNaming.BindingType;
- import org.omg.CosNaming.BindingTypeHolder;
- import org.omg.CosNaming.BindingListHolder;
- import org.omg.CosNaming.BindingIteratorHolder;
- import org.omg.CosNaming.NameComponent;
- import org.omg.CosNaming.NamingContext;
- import org.omg.PortableServer.POA;
-
- /**
- * 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.
- */
- public interface NamingContextDataStore {
- /**
- * Method which implements binding a name to an object as
- * the specified binding type.
- * @param n a NameComponent which is the name under which the object
- * will be bound.
- * @param obj the object reference to be bound.
- * @param bt Type of binding (as object or as context).
- * @exception org.omg.CORBA.SystemException One of a fixed set of CORBA system exceptions.
- */
- void Bind(NameComponent n, org.omg.CORBA.Object obj, BindingType bt)
- throws org.omg.CORBA.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.
- * @param n a NameComponent which is the name to be resolved.
- * @param bth the BindingType as an out parameter.
- * @return the object reference bound under the supplied name.
- * @exception org.omg.CORBA.SystemException One of a fixed set of CORBA system exceptions.
- */
- org.omg.CORBA.Object Resolve(NameComponent n,BindingTypeHolder bth)
- throws org.omg.CORBA.SystemException;
-
- /**
- * Method which implements unbinding a name.
- * @return the object reference bound to the name, or null if not found.
- * @exception org.omg.CORBA.SystemException One of a fixed set of CORBA system exceptions.
- */
- org.omg.CORBA.Object Unbind(NameComponent n)
- throws org.omg.CORBA.SystemException;
-
- /**
- * Method which implements listing the contents of this
- * NamingContext and return a binding list and a binding iterator.
- * @param how_many The number of requested bindings in the BindingList.
- * @param bl The BindingList as an out parameter.
- * @param bi The BindingIterator as an out parameter.
- * @exception org.omg.CORBA.SystemException One of a fixed set of CORBA system exceptions.
- */
- void List(int how_many, BindingListHolder bl, BindingIteratorHolder bi)
- throws org.omg.CORBA.SystemException;
-
- /**
- * Method which implements creating a new NamingContext.
- * @return an object reference for a new NamingContext object implemented
- * by this Name Server.
- * @exception org.omg.CORBA.SystemException One of a fixed set of CORBA system exceptions.
- */
- NamingContext NewContext()
- throws org.omg.CORBA.SystemException;
-
- /**
- * Method which implements destroying this NamingContext.
- * @exception org.omg.CORBA.SystemException One of a fixed set of CORBA system exceptions.
- */
- void Destroy()
- throws org.omg.CORBA.SystemException;
-
- /**
- * Method which returns whether this NamingContext is empty
- * or not.
- * @return true if this NamingContext contains no bindings.
- */
- boolean IsEmpty();
-
- POA getNSPOA( );
- }