org.omg.CosNaming
Class _NamingContextStub

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

All Implemented Interfaces:

IDLEntity, NamingContext, NamingContextOperations, Object, java.io.Serializable

public class _NamingContextStub

extends ObjectImpl

implements NamingContext

This interface provides all functions to bind, rebind and resolve an object into the naming graph.

See Also:

Serialized Form

Constructor Summary

_NamingContextStub()

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(NameComponent[] n) Operation resolve
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

_NamingContextStub

public _NamingContextStub()

Method Detail

_ids

public java.lang.String[] _ids()

Overrides:

_ids in class ObjectImpl

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.