com.sssw.jbroker.api.naming
Class _NamingContextStub

java.lang.Object
  org.omg.CORBA.portable.ObjectImpl
      com.sssw.jbroker.api.naming._NamingContextStub

All Implemented Interfaces:

IDLEntity, NamingContext, NamingContext, NamingContextExt, NamingContextExtOperations, NamingContextOperations, Object, Serializable

public class _NamingContextStub

extends ObjectImpl

implements NamingContext

Stub for NamingContext

See Also:

Serialized Form

Constructor Summary

_NamingContextStub()

Method Summary

String[]	_ids() Retrieves a string array containing the repository identifiers supported by this ObjectImpl object.
AccessPolicy	access_policy() Get the Access Policy for the NameService.
void	add_context(NameComponent[] n, NamingContext nc) Add a naming context with the given name.
void	add(NameComponent[] n, Object obj) Add an object with the given name.
void	bind_context(NameComponent[] n, NamingContext nc) Names an object that is a naming context.
NamingContext	bind_new_context(NameComponent[] n) Create a new context and bind it with the given name.
void	bind(NameComponent[] n, Object obj) Creates a binding of a name and a CORBA Object in a Naming Context.
void	destroy() Destroy the context.
void	list(int how_many, BindingListHolder bl, BindingIteratorHolder bi) List atmost how_many number of bindings.
NamingContext	new_context() Create a new Context.
void	rebind_context(NameComponent[] n, NamingContext nc) Creates a binding of a name and a naming context in the naming context even if the name is already bound in the context.
void	rebind(NameComponent[] n, Object obj) Creates a binding of a name and an object in the naming context even if the name is already bound in the context.
Object	resolve_str(String n) This is a convenience operation that performs a resolve in the same manner as NamingContext::resolve.
Object	resolve(NameComponent[] n) The resolve operation is the process of retrieving an object bound to a name in a given context.
String	security_realm() Get the realm for the NameService.
NameComponent[]	to_name(String sn) This operation accepts a stringified name and returns a Name.
String	to_string(NameComponent[] n) This operation accepts a Name and returns a stringified name.
String	to_url(String addr, String sn) This operation takes a URL component such as "myhost.xyz.com" and a stringified name.
void	unbind(NameComponent[] n) The unbind operation removes a binding from a Naming Context.

Methods inherited from class org.omg.CORBA.portable.ObjectImpl

_create_request, _create_request, _duplicate, _get_delegate, _get_domain_managers, _get_interface_def, _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_policy, _hash, _is_a, _is_equivalent, _non_existent, _release, _request, _set_policy_override

Constructor Detail

_NamingContextStub

public _NamingContextStub()

Method Detail

bind

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

Description copied from interface: NamingContextOperations

Creates a binding of a name and a CORBA Object in a Naming Context. Naming contexts that are bound using bind do not participate in name resolution when compound names are passed to be resolved.

Specified by:

bind in interface NamingContextOperations

Throws:

NotFound

CannotProceed

InvalidName

AlreadyBound

bind_context

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

Description copied from interface: NamingContextOperations

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.

Specified by:

bind_context in interface NamingContextOperations

Throws:

NotFound

CannotProceed

InvalidName

AlreadyBound

rebind

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

Description copied from interface: NamingContextOperations

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.

Specified by:

rebind in interface NamingContextOperations

Throws:

NotFound

CannotProceed

InvalidName

rebind_context

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

Description copied from interface: NamingContextOperations

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.

Specified by:

rebind_context in interface NamingContextOperations

Throws:

NotFound

CannotProceed

InvalidName

resolve

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

Description copied from interface: NamingContextOperations

The resolve operation is the process of retrieving an object bound to a name in a given context. The given name must exactly 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.

Specified by:

resolve in interface NamingContextOperations

Throws:

NotFound

CannotProceed

InvalidName

unbind

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

Description copied from interface: NamingContextOperations

The unbind operation removes a binding from a Naming Context.

Specified by:

unbind in interface NamingContextOperations

Throws:

NotFound

CannotProceed

InvalidName

list

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

Description copied from interface: NamingContextOperations

List atmost how_many number of bindings. The bindings are put in the BindingList. If there are more bindings, then the BindingIterator can be used to further list them.

Specified by:

list in interface NamingContextOperations

new_context

public NamingContext new_context()

Description copied from interface: NamingContextOperations

Create a new Context.

Specified by:

new_context in interface NamingContextOperations

bind_new_context

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

Description copied from interface: NamingContextOperations

Create a new context and bind it with the given name.

Specified by:

bind_new_context in interface NamingContextOperations

Throws:

NotFound

AlreadyBound

CannotProceed

InvalidName

destroy

public void destroy()
             throws NotEmpty

Description copied from interface: NamingContextOperations

Destroy the context. If the context is not empty NotEmpty exception is thrown.

Specified by:

destroy in interface NamingContextOperations

Throws:

NotEmpty

to_string

public String to_string(NameComponent[] n)
                 throws InvalidName

Description copied from interface: NamingContextOperations

This operation accepts a Name and returns a stringified name. If the Name is invalid, an InvalidName exception is raised.

Specified by:

to_string in interface NamingContextOperations

Throws:

InvalidName

to_name

public NameComponent[] to_name(String sn)
                        throws InvalidName

Description copied from interface: NamingContextOperations

This operation accepts a stringified name and returns a Name. If the stringified name is syntactically malformed or violates an implementation limit, an InvalidName exception is raised.

Specified by:

to_name in interface NamingContextOperations

Throws:

InvalidName

to_url

public String to_url(String addr,
                     String sn)
              throws InvalidAddress,
                     InvalidName

Description copied from interface: NamingContextOperations

This operation takes a URL

component such as "myhost.xyz.com" and a stringified name. It then performs any escapes necessary on the stringified name and returns a fully formed URL string. An exception is raised if either the protocol or name parameters are invalid.

It is legal for the address and/or stringified_name to be empty. If the address is empty, it means the local host.

Specified by:

to_url in interface NamingContextOperations

Throws:

InvalidAddress

InvalidName

resolve_str

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

Description copied from interface: NamingContextOperations

This is a convenience operation that performs a resolve in the same manner as NamingContext::resolve. It accepts a stringified name as an argument instead of a Name.

Specified by:

resolve_str in interface NamingContextOperations

Throws:

NotFound

CannotProceed

InvalidName

add

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

Description copied from interface: NamingContextOperations

Add an object with the given name. This method is used to bind more than one object with a given name. That is, you can invoke the method multiple times and bind multiple objects with the same name to form an Object Group. When a NamingContext has no binding with the given name, add is equivalent to a bind.

Specified by:

add in interface NamingContextOperations

Throws:

NotFound

CannotProceed

InvalidName

AlreadyBound

add_context

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

Description copied from interface: NamingContextOperations

Add a naming context with the given name. This method is used to bind more than one NamingContexts with a given name. That is, you can invoke the method multiple times and bind contexts with the same name to form a Context Group. When a NamingContext has no bindings with the given name, add_context is equivalent to a bind_context.

Specified by:

add_context in interface NamingContextOperations

Throws:

NotFound

CannotProceed

InvalidName

AlreadyBound

access_policy

public AccessPolicy access_policy()

Description copied from interface: NamingContextOperations

Get the Access Policy for the NameService.

Specified by:

access_policy in interface NamingContextOperations

security_realm

public String security_realm()

Description copied from interface: NamingContextOperations

Get the realm for the NameService.

Specified by:

security_realm in interface NamingContextOperations

_ids

public String[] _ids()

Description copied from class: ObjectImpl

Retrieves a string array containing the repository identifiers supported by this ObjectImpl object. For example, for a stub, this method returns information about all the interfaces supported by the stub.

Specified by:

_ids in class ObjectImpl

Returns:

the array of all repository identifiers supported by this ObjectImpl instance