## org.omg.CosNaming
Class _NamingContextExtStub

    java.lang.Object
      |
      +--org.omg.CORBA.portable.ObjectImpl
            |
            +--org.omg.CosNaming._NamingContextExtStub

All Implemented Interfaces:
  IDLEntity, NamingContext, NamingContextExt, NamingContextExtOperations, NamingContextOperations, Object, java.io.Serializable

public class _NamingContextExtStub
extends ObjectImpl
implements NamingContextExt

This interface has been introduced for the Interoperable Name Service. This interface extends NamingContext and provides several new methods to manage CORBA URL.

See Also:
  Serialized Form

Constructor Summary
`_NamingContextExtStub()`

Method Summary
`java.lang.String[]` `_ids()`
`void` `bind_context(NameComponent[] n, NamingContext nc)` Operation bind_context
`NamingContext` `bind_new_context(NameComponent[] n)` Operation bind_new_context
`void` `bind(NameComponent[] n, Object obj)` Operation bind
`void` `destroy()` Operation destroy
`void` `list(int how_many, BindingListHolder bl, BindingIteratorHolder bi)` Operation list
`NamingContext` `new_context()` Operation new_context
`void` `rebind_context(NameComponent[] n, NamingContext nc)` Operation rebind_context
`void` `rebind(NameComponent[] n, Object obj)` Operation rebind
`Object` `resolve_str(java.lang.String n)` Operation resolve_str
`Object` `resolve(NameComponent[] n)` Operation resolve
`NameComponent[]` `to_name(java.lang.String sn)` Operation to_name
`java.lang.String` `to_string(NameComponent[] n)` Operation to_string
`java.lang.String` `to_url(java.lang.String addr, java.lang.String sn)` Operation to_url
`void` `unbind(NameComponent[] n)` Operation unbind

Methods inherited from class org.omg.CORBA.portable.ObjectImpl
`_create_request, _create_request, _duplicate, _get_delegate, _get_domain_managers, _get_interface_def, _get_interface, _get_policy, _hash, _invoke, _is_a, _is_equivalent, _is_local, _non_existent, _orb, _release, _releaseReply, _request, _request, _servant_postinvoke, _servant_preinvoke, _set_delegate, _set_policy_override, equals, hashCode, toString`

Methods inherited from class java.lang.Object
`getClass, notify, notifyAll, wait, wait, wait`

Methods inherited from interface org.omg.CORBA.Object
`_create_request, _create_request, _duplicate, _get_domain_managers, _get_interface_def, _get_interface, _get_policy, _hash, _is_a, _is_equivalent, _non_existent, _release, _request, _set_policy_override`

Constructor Detail

### _NamingContextExtStub

    public _NamingContextExtStub()

Method Detail

### _ids

    public java.lang.String[] _ids()

  Overrides:
    `_ids` in class `ObjectImpl`

### to_string

    public java.lang.String to_string(NameComponent[] n)
                               throws InvalidName

  Operation to_string
  Specified by:
    `to_string` in interface `NamingContextExtOperations`
  Following copied from interface: `org.omg.CosNaming.NamingContextExtOperations`
  Parameters:
    `n` - the name to stringified.
  Throws:
    `InvalidName` - This exception is raised if the name is invalid.

### to_name

    public NameComponent[] to_name(java.lang.String sn)
                            throws InvalidName

  Operation to_name
  Specified by:
    `to_name` in interface `NamingContextExtOperations`
  Following copied from interface: `org.omg.CosNaming.NamingContextExtOperations`
  Parameters:
    `sn` - the stringified name to transform to a name.
  Throws:
    `InvalideName` - This exception is raised if the stringified name is syntactically malformed or violates an implementation limit.

### to_url

    public java.lang.String to_url(java.lang.String addr,
                                   java.lang.String sn)
                            throws InvalidAddress,
                                   InvalidName

  Operation to_url
  Specified by:
    `to_url` in interface `NamingContextExtOperations`
  Following copied from interface: `org.omg.CosNaming.NamingContextExtOperations`
  Parameters:
    `addr` - the address ( for example myhost.xyz.com )
    `sn` - the stringified name to add to the URL
  Returns:
    the URL string format.
  Throws:
    `InvalidAddress` - This exception is raises if a address is invalid ( it means that the address does not respect the address format ).
    `InvalidName` - This exception is raised if the stringified name is syntactically malformed or violates an implementation limit.

### resolve_str

    public Object resolve_str(java.lang.String n)
                       throws NotFound,
                              CannotProceed,
                              InvalidName

  Operation resolve_str
  Specified by:
    `resolve_str` in interface `NamingContextExtOperations`
  Following copied from interface: `org.omg.CosNaming.NamingContextExtOperations`
  Parameters:
    `n` - the stringified name of the object (or naming context) to resolve
  Returns:
    the resolved object.
  Throws:
    `NotFound` - Indicates the name does not identify a binding.
    `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.
    `InvalidName` - Indicates the name is invalid. (A name of length 0 is invalid; implementations may place other restrictions on names.)

### bind

    public void bind(NameComponent[] n,
                     Object obj)
              throws NotFound,
                     CannotProceed,
                     InvalidName,
                     AlreadyBound

  Operation bind
  Specified by:
    `bind` in interface `NamingContextOperations`
  Following copied from interface: `org.omg.CosNaming.NamingContextOperations`
  Parameters:
    `n` - The compound name for the object to bind
    `obj` - The object to bind
  Throws:
    `NotFound` - Indicates the name does not identify a binding.
    `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.
    `Indicates` - the name is invalid. (A name of length 0 is invalid; implementations may place other restrictions on names.)
    `AlreadyBound` - Indicates an object is already bound to the specified name. Only one object can be bound to a particular name in a context. The bind and the bind_context operations raise the AlreadyBound exception if the name is bound in the context; the rebind and rebind_context operations unbind the name and rebind the name to the object passed as an argument.

### rebind

    public void rebind(NameComponent[] n,
                       Object obj)
                throws NotFound,
                       CannotProceed,
                       InvalidName

  Operation rebind
  Specified by:
    `rebind` in interface `NamingContextOperations`
  Following copied from interface: `org.omg.CosNaming.NamingContextOperations`
  Parameters:
    `n` - The compound name for the object to rebind
    `obj` - The object to rebind
  Throws:
    `NotFound` - Indicates the name does not identify a binding.
    `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.
    `InvalidName` - Indicates the name is invalid. (A name of length 0 is invalid; implementations may place other restrictions on names.)
    `AlreadyBound` - Indicates an object is already bound to the specified name. Only one object can be bound to a particular name in a context. The bind and the bind_context operations raise the AlreadyBound exception if the name is bound in the context; the rebind and rebind_context operations unbind the name and rebind the name to the object passed as an argument.

### bind_context

    public void bind_context(NameComponent[] n,
                             NamingContext nc)
                      throws NotFound,
                             CannotProceed,
                             InvalidName,
                             AlreadyBound

  Operation bind_context
  Specified by:
    `bind_context` in interface `NamingContextOperations`
  Following copied from interface: `org.omg.CosNaming.NamingContextOperations`
  Parameters:
    `n` - The compound name for the naming context to bind
    `obj` - The naming context to bind
  Throws:
    `NotFound` - Indicates the name does not identify a binding.
    `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.
    `InvalidName` - Indicates the name is invalid. (A name of length 0 is invalid; implementations may place other restrictions on names.)
    `AlreadyBound` - Indicates an object is already bound to the specified name. Only one object can be bound to a particular name in a context. The bind and the bind_context operations raise the AlreadyBound exception if the name is bound in the context; the rebind and rebind_context operations unbind the name and rebind the name to the object passed as an argument.

### rebind_context

    public void rebind_context(NameComponent[] n,
                               NamingContext nc)
                        throws NotFound,
                               CannotProceed,
                               InvalidName

  Operation rebind_context
  Specified by:
    `rebind_context` in interface `NamingContextOperations`
  Following copied from interface: `org.omg.CosNaming.NamingContextOperations`
  Parameters:
    `n` - The compound name for the naming context to rebind
    `obj` - The naming context to rebind
  Throws:
    `NotFound` - Indicates the name does not identify a binding.
    `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.
    `InvalidName` - Indicates the name is invalid. (A name of length 0 is invalid; implementations may place other restrictions on names.)
    `AlreadyBound` - Indicates an object is already bound to the specified name. Only one object can be bound to a particular name in a context. The bind and the bind_context operations raise the AlreadyBound exception if the name is bound in the context; the rebind and rebind_context operations unbind the name and rebind the name to the object passed as an argument.

### resolve

    public Object resolve(NameComponent[] n)
                   throws NotFound,
                          CannotProceed,
                          InvalidName

  Operation resolve
  Specified by:
    `resolve` in interface `NamingContextOperations`
  Following copied from interface: `org.omg.CosNaming.NamingContextOperations`
  Parameters:
    `n` - The compound name for the object to resolve.
  Returns:
    the resolved object.
  Throws:
    `NotFound` - Indicates the name does not identify a binding.
    `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.
    `InvalidName` - Indicates the name is invalid. (A name of length 0 is invalid; implementations may place other restrictions on names.)

### unbind

    public void unbind(NameComponent[] n)
                throws NotFound,
                       CannotProceed,
                       InvalidName

  Operation unbind
  Specified by:
    `unbind` in interface `NamingContextOperations`
  Following copied from interface: `org.omg.CosNaming.NamingContextOperations`
  Parameters:
    `n` - The compound name for the node to unbind ( an object or a naming context )
  Throws:
    `NotFound` - Indicates the name does not identify a binding.
    `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.
    `InvalidName` - Indicates the name is invalid. (A name of length 0 is invalid; implementations may place other restrictions on names.)

### new_context

    public NamingContext new_context()

  Operation new_context
  Specified by:
    `new_context` in interface `NamingContextOperations`
  Following copied from interface: `org.omg.CosNaming.NamingContextOperations`
  Returns:
    A new naming context ( this new naming context must be binded )

### bind_new_context

    public NamingContext bind_new_context(NameComponent[] n)
                                   throws NotFound,
                                          AlreadyBound,
                                          CannotProceed,
                                          InvalidName

  Operation bind_new_context
  Specified by:
    `bind_new_context` in interface `NamingContextOperations`
  Following copied from interface: `org.omg.CosNaming.NamingContextOperations`
  Parameters:
    `n` - The compound name for the naming context to create and to bind.
  Throws:
    `NotFound` - Indicates the name does not identify a binding.
    `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.
    `InvalidName` - Indicates the name is invalid. (A name of length 0 is invalid; implementations may place other restrictions on names.)
    `AlreadyBound` - Indicates an object is already bound to the specified name. Only one object can be bound to a particular name in a context.

### destroy

    public void destroy()
                 throws NotEmpty

  Operation destroy
  Specified by:
    `destroy` in interface `NamingContextOperations`
  Following copied from interface: `org.omg.CosNaming.NamingContextOperations`
  Throws:
    `NotEmpty` - If the naming context contains bindings, the NotEmpty exception is raised.

### list

    public void list(int how_many,
                     BindingListHolder bl,
                     BindingIteratorHolder bi)

  Operation list
  Specified by:
    `list` in interface `NamingContextOperations`
  Following copied from interface: `org.omg.CosNaming.NamingContextOperations`
  Parameters:
    `how_many` - Maximum number of elements into the binding list.
    `bl` - This parameter returns a list that contains all node of the naming context
    `bi` - This parameter returns a binding iterator to iterate in the list.
  Returns:
    The list operation returns at most the requested number of bindings in BindingList bl. - If the naming context contains additional bindings, the list operation returns a BindingIterator with the additional bindings. - If the naming context does not contain additional bindings, the binding iterator is a nil object reference.