< prev index next >
src/java.corba/share/classes/org/omg/CosNaming/nameservice.idl
Print this page
*** 1,7 ****
/*
! * Copyright (c) 1996, 2010, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
--- 1,7 ----
/*
! * Copyright (c) 1996, 2015, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
*** 114,124 ****
boolean next_one(out Binding b);
/**
* This operation returns at most the requested number of bindings.
*
! * @param how_many the maximum number of bindings tro return <p>
*
* @param bl the returned bindings
*/
boolean next_n(in unsigned long how_many,
out BindingList bl);
--- 114,124 ----
boolean next_one(out Binding b);
/**
* This operation returns at most the requested number of bindings.
*
! * @param how_many the maximum number of bindings to return
*
* @param bl the returned bindings
*/
boolean next_n(in unsigned long how_many,
out BindingList bl);
*** 194,220 ****
/**
* Creates a binding of a name and an object in the naming context.
* Naming contexts that are bound using bind do not participate in name
* resolution when compound names are passed to be resolved.
*
! * @param n Name of the object <p>
*
! * @param obj The Object to bind with the given name<p>
*
* @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates
! * the name does not identify a binding.<p>
*
* @exception org.omg.CosNaming.NamingContextPackage.CannotProceed
* Indicates that the implementation has given up for some reason.
* The client, however, may be able to continue the operation
! * at the returned naming context.<p>
*
* @exception org.omg.CosNaming.NamingContextPackage.InvalidName
! * Indicates that the name is invalid. <p>
*
* @exception org.omg.CosNaming.NamingContextPackage.AlreadyBound
! * Indicates an object is already bound to the specified name.<p>
*/
void bind(in Name n,
in Object obj)
raises(NotFound,
CannotProceed,
--- 194,220 ----
/**
* Creates a binding of a name and an object in the naming context.
* Naming contexts that are bound using bind do not participate in name
* resolution when compound names are passed to be resolved.
*
! * @param n Name of the object.
*
! * @param obj The Object to bind with the given name.
*
* @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates
! * the name does not identify a binding.
*
* @exception org.omg.CosNaming.NamingContextPackage.CannotProceed
* Indicates that the implementation has given up for some reason.
* The client, however, may be able to continue the operation
! * at the returned naming context.
*
* @exception org.omg.CosNaming.NamingContextPackage.InvalidName
! * Indicates that the name is invalid.
*
* @exception org.omg.CosNaming.NamingContextPackage.AlreadyBound
! * Indicates an object is already bound to the specified name.
*/
void bind(in Name n,
in Object obj)
raises(NotFound,
CannotProceed,
*** 224,247 ****
/**
* Names an object that is a naming context. Naming contexts that
* are bound using bind_context() participate in name resolution
* when compound names are passed to be resolved.
*
! * @param n Name of the object <p>
*
! * @param nc NamingContect object to bind with the given name <p>
*
! * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>
*
* @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has
* given up for some reason. The client, however, may be able to
! * continue the operation at the returned naming context.<p>
*
! * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>
*
* @exception org.omg.CosNaming.NamingContextPackage.AlreadyBound Indicates an object is already
! * bound to the specified name.<p>
*/
void bind_context(in Name n,
in NamingContext nc)
raises(NotFound,
CannotProceed,
--- 224,247 ----
/**
* Names an object that is a naming context. Naming contexts that
* are bound using bind_context() participate in name resolution
* when compound names are passed to be resolved.
*
! * @param n Name of the object.
*
! * @param nc NamingContect object to bind with the given name.
*
! * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.
*
* @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has
* given up for some reason. The client, however, may be able to
! * continue the operation at the returned naming context.
*
! * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid.
*
* @exception org.omg.CosNaming.NamingContextPackage.AlreadyBound Indicates an object is already
! * bound to the specified name.
*/
void bind_context(in Name n,
in NamingContext nc)
raises(NotFound,
CannotProceed,
*** 252,272 ****
* Creates a binding of a name and an object in the naming context
* even if the name is already bound in the context. Naming contexts
* that are bound using rebind do not participate in name resolution
* when compound names are passed to be resolved.
*
! * @param n Name of the object <p>
*
! * @param obj The Object to rebind with the given name <p>
*
! * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>
*
* @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has
* given up for some reason. The client, however, may be able to
! * continue the operation at the returned naming context.<p>
*
! * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>
*/
void rebind(in Name n,
in Object obj)
raises(NotFound,
CannotProceed,
--- 252,272 ----
* Creates a binding of a name and an object in the naming context
* even if the name is already bound in the context. Naming contexts
* that are bound using rebind do not participate in name resolution
* when compound names are passed to be resolved.
*
! * @param n Name of the object.
*
! * @param obj The Object to rebind with the given name.
*
! * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.
*
* @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has
* given up for some reason. The client, however, may be able to
! * continue the operation at the returned naming context.
*
! * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid.
*/
void rebind(in Name n,
in Object obj)
raises(NotFound,
CannotProceed,
*** 276,296 ****
* Creates a binding of a name and a naming context in the naming
* context even if the name is already bound in the context. Naming
* contexts that are bound using rebind_context() participate in name
* resolution when compound names are passed to be resolved.
*
! * @param n Name of the object <p>
*
! * @param nc NamingContect object to rebind with the given name <p>
*
! * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>
*
* @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has
* given up for some reason. The client, however, may be able to
! * continue the operation at the returned naming context.<p>
*
! * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>
*/
void rebind_context(in Name n,
in NamingContext nc)
raises(NotFound,
CannotProceed,
--- 276,296 ----
* Creates a binding of a name and a naming context in the naming
* context even if the name is already bound in the context. Naming
* contexts that are bound using rebind_context() participate in name
* resolution when compound names are passed to be resolved.
*
! * @param n Name of the object.
*
! * @param nc NamingContect object to rebind with the given name.
*
! * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.
*
* @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has
* given up for some reason. The client, however, may be able to
! * continue the operation at the returned naming context.
*
! * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid.
*/
void rebind_context(in Name n,
in NamingContext nc)
raises(NotFound,
CannotProceed,
*** 302,338 ****
* match the bound name. The naming service does not return the type
* of the object. Clients are responsible for "narrowing" the object
* to the appropriate type. That is, clients typically cast the returned
* object from Object to a more specialized interface.
*
! * @param n Name of the object <p>
*
! * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>
*
* @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has
* given up for some reason. The client, however, may be able to
! * continue the operation at the returned naming context.<p>
*
! * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>
*/
Object resolve(in Name n)
raises(NotFound,
CannotProceed,
InvalidName);
/**
* The unbind operation removes a name binding from a context.
*
! * @param n Name of the object <p>
*
! * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>
*
* @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has
* given up for some reason. The client, however, may be able to
! * continue the operation at the returned naming context.<p>
*
! * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>
*/
void unbind(in Name n)
raises(NotFound,
CannotProceed,
InvalidName);
--- 302,338 ----
* match the bound name. The naming service does not return the type
* of the object. Clients are responsible for "narrowing" the object
* to the appropriate type. That is, clients typically cast the returned
* object from Object to a more specialized interface.
*
! * @param n Name of the object.
*
! * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.
*
* @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has
* given up for some reason. The client, however, may be able to
! * continue the operation at the returned naming context.
*
! * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid.
*/
Object resolve(in Name n)
raises(NotFound,
CannotProceed,
InvalidName);
/**
* The unbind operation removes a name binding from a context.
*
! * @param n Name of the object.
*
! * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.
*
* @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has
* given up for some reason. The client, however, may be able to
! * continue the operation at the returned naming context.
*
! * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid.
*/
void unbind(in Name n)
raises(NotFound,
CannotProceed,
InvalidName);
*** 349,363 ****
* additional bindings.
* <li>If the naming context does not contain additional
* bindings, the binding iterator is a nil object reference.
* </ul>
*
! * @param how_many the maximum number of bindings to return <p>
*
! * @param bl the returned list of bindings <p>
*
! * @param bi the returned binding iterator <p>
*/
void list(in unsigned long how_many,
out BindingList bl,
out BindingIterator bi);
--- 349,363 ----
* additional bindings.
* <li>If the naming context does not contain additional
* bindings, the binding iterator is a nil object reference.
* </ul>
*
! * @param how_many the maximum number of bindings to return.
*
! * @param bl the returned list of bindings.
*
! * @param bi the returned binding iterator.
*/
void list(in unsigned long how_many,
out BindingList bl,
out BindingIterator bi);
*** 373,394 ****
* supplied as an argument. The newly-created context is implemented
* by the same naming server as the context in which it was bound (that
* is, the naming server that implements the context denoted by the
* name argument excluding the last component).
*
! * @param n Name of the object <p>
*
! * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.<p>
*
* @exception org.omg.CosNaming.NamingContextPackage.AlreadyBound Indicates an object is already
! * bound to the specified name.<p>
*
* @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has
* given up for some reason. The client, however, may be able to
! * continue the operation at the returned naming context.<p>
*
! * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid. <p>
*/
NamingContext bind_new_context(in Name n)
raises(NotFound,
AlreadyBound,
CannotProceed,
--- 373,394 ----
* supplied as an argument. The newly-created context is implemented
* by the same naming server as the context in which it was bound (that
* is, the naming server that implements the context denoted by the
* name argument excluding the last component).
*
! * @param n Name of the object.
*
! * @exception org.omg.CosNaming.NamingContextPackage.NotFound Indicates the name does not identify a binding.
*
* @exception org.omg.CosNaming.NamingContextPackage.AlreadyBound Indicates an object is already
! * bound to the specified name.
*
* @exception org.omg.CosNaming.NamingContextPackage.CannotProceed Indicates that the implementation has
* given up for some reason. The client, however, may be able to
! * continue the operation at the returned naming context.
*
! * @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid.
*/
NamingContext bind_new_context(in Name n)
raises(NotFound,
AlreadyBound,
CannotProceed,
*** 411,421 ****
* which
* contains a set of name bindings in which each name is unique and is
* part of Interoperable Naming Service.
* Different names can be bound to an object in the same or different
* contexts at the same time. Using <tt>NamingContextExt</tt>, you can use
! * URL-based names to bind and resolve. <p>
*
* See <a href="http://www.omg.org/technology/documents/formal/naming_service.htm">
* CORBA COS
* Naming Specification.</a>
*/
--- 411,421 ----
* which
* contains a set of name bindings in which each name is unique and is
* part of Interoperable Naming Service.
* Different names can be bound to an object in the same or different
* contexts at the same time. Using <tt>NamingContextExt</tt>, you can use
! * URL-based names to bind and resolve.
*
* See <a href="http://www.omg.org/technology/documents/formal/naming_service.htm">
* CORBA COS
* Naming Specification.</a>
*/
*** 440,465 ****
/**
* This operation creates a stringified name from the array of Name
* components.
*
! * @param n Name of the object <p>
*
* @exception org.omg.CosNaming.NamingContextExtPackage.InvalidName
! * Indicates the name does not identify a binding.<p>
*
*/
StringName to_string( in Name n ) raises (InvalidName);
/**
* This operation converts a Stringified Name into an equivalent array
* of Name Components.
*
! * @param sn Stringified Name of the object <p>
*
* @exception org.omg.CosNaming.NamingContextExtPackage.InvalidName
! * Indicates the name does not identify a binding.<p>
*
*/
Name to_name( in StringName sn ) raises (InvalidName);
--- 440,465 ----
/**
* This operation creates a stringified name from the array of Name
* components.
*
! * @param n Name of the object.
*
* @exception org.omg.CosNaming.NamingContextExtPackage.InvalidName
! * Indicates the name does not identify a binding.
*
*/
StringName to_string( in Name n ) raises (InvalidName);
/**
* This operation converts a Stringified Name into an equivalent array
* of Name Components.
*
! * @param sn Stringified Name of the object.
*
* @exception org.omg.CosNaming.NamingContextExtPackage.InvalidName
! * Indicates the name does not identify a binding.
*
*/
Name to_name( in StringName sn ) raises (InvalidName);
*** 472,507 ****
/**
* This operation creates a URL based "iiopname://" format name
* from the Stringified Name of the object.
*
! * @param addr internet based address of the host machine where Name Service is running <p>
! * @param sn Stringified Name of the object <p>
*
* @exception org.omg.CosNaming.NamingContextExtPackage.InvalidName
! * Indicates the name does not identify a binding.<p>
* @exception org.omg.CosNaming.NamingContextPackage.InvalidAddress
! * Indicates the internet based address of the host machine is
! * incorrect <p>
! *
*/
URLString to_url( in Address addr, in StringName sn )
raises( InvalidAddress, InvalidName );
/**
* This operation resolves the Stringified name into the object
* reference.
*
! * @param sn Stringified Name of the object <p>
*
* @exception org.omg.CosNaming.NamingContextPackage.NotFound
! * Indicates there is no object reference for the given name. <p>
* @exception org.omg.CosNaming.NamingContextPackage.CannotProceed
! * Indicates that the given compound name is incorrect <p>
* @exception org.omg.CosNaming.NamingContextExtPackage.InvalidName
! * Indicates the name does not identify a binding.<p>
*
*/
Object resolve_str( in StringName sn)
raises( NotFound, CannotProceed,
InvalidName);
--- 472,505 ----
/**
* This operation creates a URL based "iiopname://" format name
* from the Stringified Name of the object.
*
! * @param addr internet based address of the host machine where Name Service is running.
! * @param sn Stringified Name of the object.
*
* @exception org.omg.CosNaming.NamingContextExtPackage.InvalidName
! * Indicates the name does not identify a binding.
* @exception org.omg.CosNaming.NamingContextPackage.InvalidAddress
! * Indicates the internet based address of the host machine is incorrect
*/
URLString to_url( in Address addr, in StringName sn )
raises( InvalidAddress, InvalidName );
/**
* This operation resolves the Stringified name into the object
* reference.
*
! * @param sn Stringified Name of the object.
*
* @exception org.omg.CosNaming.NamingContextPackage.NotFound
! * Indicates there is no object reference for the given name.
* @exception org.omg.CosNaming.NamingContextPackage.CannotProceed
! * Indicates that the given compound name is incorrect.
* @exception org.omg.CosNaming.NamingContextExtPackage.InvalidName
! * Indicates the name does not identify a binding.
*
*/
Object resolve_str( in StringName sn)
raises( NotFound, CannotProceed,
InvalidName);
< prev index next >