001 package org.omg.CosNaming; 002 003 004 /** 005 * org/omg/CosNaming/NamingContextOperations.java . 006 * Generated by the IDL-to-Java compiler (portable), version "3.2" 007 * from /builddir/build/BUILD/geronimo-specs-1.6/geronimo-spec-corba/src/main/idl/CosNaming.idl 008 * Monday, June 18, 2012 10:36:14 AM CEST 009 */ 010 011 012 /** 013 * A naming context is an object that contains a set of name bindings in 014 * which each name is unique. Different names can be bound to an object 015 * in the same or different contexts at the same time. <p> 016 * 017 * See <a href=" http://www.omg.org/corba/sectrans.htm#nam">CORBA COS 018 * Naming Specification.</a> 019 */ 020 public interface NamingContextOperations 021 { 022 023 /** 024 * Creates a binding of a name and an object in the naming context. 025 * Naming contexts that are bound using bind do not participate in name 026 * resolution when compound names are passed to be resolved. 027 * 028 * @param n Name of the object <p> 029 * 030 * @param obj The Object to bind with the given name<p> 031 * 032 * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p> 033 * 034 * @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has 035 * given up for some reason. The client, however, may be able to 036 * continue the operation at the returned naming context.<p> 037 * 038 * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p> 039 * 040 * @exception org.omg.CosNaming.NamingContextPackage.AlreadyBound Indicates an object is already 041 * bound to the specified name.<p> 042 */ 043 void bind (org.omg.CosNaming.NameComponent[] n, org.omg.CORBA.Object obj) throws org.omg.CosNaming.NamingContextPackage.NotFound, org.omg.CosNaming.NamingContextPackage.CannotProceed, org.omg.CosNaming.NamingContextPackage.InvalidName, org.omg.CosNaming.NamingContextPackage.AlreadyBound; 044 045 /** 046 * Names an object that is a naming context. Naming contexts that 047 * are bound using bind_context() participate in name resolution 048 * when compound names are passed to be resolved. 049 * 050 * @param n Name of the object <p> 051 * 052 * @param nc NamingContect object to bind with the given name <p> 053 * 054 * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p> 055 * 056 * @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has 057 * given up for some reason. The client, however, may be able to 058 * continue the operation at the returned naming context.<p> 059 * 060 * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p> 061 * 062 * @exception org.omg.CosNaming.NamingContextPackage.AlreadyBound Indicates an object is already 063 * bound to the specified name.<p> 064 */ 065 void bind_context (org.omg.CosNaming.NameComponent[] n, org.omg.CosNaming.NamingContext nc) throws org.omg.CosNaming.NamingContextPackage.NotFound, org.omg.CosNaming.NamingContextPackage.CannotProceed, org.omg.CosNaming.NamingContextPackage.InvalidName, org.omg.CosNaming.NamingContextPackage.AlreadyBound; 066 067 /** 068 * Creates a binding of a name and an object in the naming context 069 * even if the name is already bound in the context. Naming contexts 070 * that are bound using rebind do not participate in name resolution 071 * when compound names are passed to be resolved. 072 * 073 * @param n Name of the object <p> 074 * 075 * @parm obj The Object to rebind with the given name <p> 076 * 077 * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p> 078 * 079 * @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has 080 * given up for some reason. The client, however, may be able to 081 * continue the operation at the returned naming context.<p> 082 * 083 * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p> 084 */ 085 void rebind (org.omg.CosNaming.NameComponent[] n, org.omg.CORBA.Object obj) throws org.omg.CosNaming.NamingContextPackage.NotFound, org.omg.CosNaming.NamingContextPackage.CannotProceed, org.omg.CosNaming.NamingContextPackage.InvalidName; 086 087 /** 088 * Creates a binding of a name and a naming context in the naming 089 * context even if the name is already bound in the context. Naming 090 * contexts that are bound using rebind_context() participate in name 091 * resolution when compound names are passed to be resolved. 092 * 093 * @param n Name of the object <p> 094 * 095 * @param nc NamingContect object to rebind with the given name <p> 096 * 097 * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p> 098 * 099 * @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has 100 * given up for some reason. The client, however, may be able to 101 * continue the operation at the returned naming context.<p> 102 * 103 * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p> 104 */ 105 void rebind_context (org.omg.CosNaming.NameComponent[] n, org.omg.CosNaming.NamingContext nc) throws org.omg.CosNaming.NamingContextPackage.NotFound, org.omg.CosNaming.NamingContextPackage.CannotProceed, org.omg.CosNaming.NamingContextPackage.InvalidName; 106 107 /** 108 * The resolve operation is the process of retrieving an object 109 * bound to a name in a given context. The given name must exactly 110 * match the bound name. The naming service does not return the type 111 * of the object. Clients are responsible for "narrowing" the object 112 * to the appropriate type. That is, clients typically cast the returned 113 * object from Object to a more specialized interface. 114 * 115 * @param n Name of the object <p> 116 * 117 * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p> 118 * 119 * @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has 120 * given up for some reason. The client, however, may be able to 121 * continue the operation at the returned naming context.<p> 122 * 123 * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p> 124 */ 125 org.omg.CORBA.Object resolve (org.omg.CosNaming.NameComponent[] n) throws org.omg.CosNaming.NamingContextPackage.NotFound, org.omg.CosNaming.NamingContextPackage.CannotProceed, org.omg.CosNaming.NamingContextPackage.InvalidName; 126 127 /** 128 * The unbind operation removes a name binding from a context. 129 * 130 * @param n Name of the object <p> 131 * 132 * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p> 133 * 134 * @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has 135 * given up for some reason. The client, however, may be able to 136 * continue the operation at the returned naming context.<p> 137 * 138 * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p> 139 */ 140 void unbind (org.omg.CosNaming.NameComponent[] n) throws org.omg.CosNaming.NamingContextPackage.NotFound, org.omg.CosNaming.NamingContextPackage.CannotProceed, org.omg.CosNaming.NamingContextPackage.InvalidName; 141 142 /** 143 * The list operation allows a client to iterate through a set of 144 * bindings in a naming context. <p> 145 * 146 * The list operation returns at most the requested number of 147 * bindings in BindingList bl. 148 * <ul> 149 * <li>If the naming context contains additional 150 * bindings, the list operation returns a BindingIterator with the 151 * additional bindings. 152 * <li>If the naming context does not contain additional 153 * bindings, the binding iterator is a nil object reference. 154 * </ul> 155 * 156 * @param how_many the maximum number of bindings to return <p> 157 * 158 * @param bl the returned list of bindings <p> 159 * 160 * @param bi the returned binding iterator <p> 161 */ 162 void list (int how_many, org.omg.CosNaming.BindingListHolder bl, org.omg.CosNaming.BindingIteratorHolder bi); 163 164 /** 165 * This operation returns a naming context implemented by the same 166 * naming server as the context on which the operation was invoked. 167 * The new context is not bound to any name. 168 */ 169 org.omg.CosNaming.NamingContext new_context (); 170 171 /** 172 * This operation creates a new context and binds it to the name 173 * supplied as an argument. The newly-created context is implemented 174 * by the same naming server as the context in which it was bound (that 175 * is, the naming server that implements the context denoted by the 176 * name argument excluding the last component). 177 * 178 * @param n Name of the object <p> 179 * 180 * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p> 181 * 182 * @exception org.omg.CosNaming.NamingContextPackage.AlreadyBound Indicates an object is already 183 * bound to the specified name.<p> 184 * 185 * @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has 186 * given up for some reason. The client, however, may be able to 187 * continue the operation at the returned naming context.<p> 188 * 189 * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p> 190 */ 191 org.omg.CosNaming.NamingContext bind_new_context (org.omg.CosNaming.NameComponent[] n) throws org.omg.CosNaming.NamingContextPackage.NotFound, org.omg.CosNaming.NamingContextPackage.AlreadyBound, org.omg.CosNaming.NamingContextPackage.CannotProceed, org.omg.CosNaming.NamingContextPackage.InvalidName; 192 } // interface NamingContextOperations