Interface CosNaming::NamingContextExt

A naming context extension is an extenrion to naming context that contains a set of name bindings in which each name is unique. Different names can be bound to an object in the same or different contexts at the same time.

See CORBA COS Naming Specification.

Inherits From

• CosNaming::NamingContext

Exception Index

• InvalidAddress

Operation Index

• resolve_str
• to_name
• to_string
• to_url

Type Index

• Address
• StringName
• URLString

Exceptions

• InvalidAddress

      exception InvalidAddress
      {
      };
  

Operations

• resolve_str

  The resolve_str operation is the process of retrieving an object bound to a stringified 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. @param n String Name of the object

      Object resolve_str
      (
          in CosNaming::NamingContextExt::StringName n
      )
      raises (CosNaming::NamingContext::NotFound, CosNaming::NamingContext::CannotProceed, CosNaming::NamingContext::InvalidName);
  

  @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.

• to_name

  The to_name operation is the process of retrieving a name object to a stringified name. @param n String Name of the object

      CosNaming::Name to_name
      (
          in CosNaming::NamingContextExt::StringName sn
      )
      raises (CosNaming::NamingContext::InvalidName);
  

  @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid.

• to_string

  The to_string operation is the process of retrieving a stringified name from a name object. @param n String Name of the object

      CosNaming::NamingContextExt::StringName to_string
      (
          in CosNaming::Name n
      )
      raises (CosNaming::NamingContext::InvalidName);
  

  @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid.

• to_url

  The to_url operation is the process of retrieving a url representation from a stringified name and address. @param addr Address of the object

      CosNaming::NamingContextExt::URLString to_url
      (
          in CosNaming::NamingContextExt::Address addr,
          in CosNaming::NamingContextExt::StringName sn
      )
      raises (CosNaming::NamingContextExt::InvalidAddress, CosNaming::NamingContext::InvalidName);
  

  @param sn String Name of the object

  @exception org.omg.CosNaming.NamingContextPackage.InvalidName Indicates that the name is invalid.

  @exception org.omg.CosNaming.NamingContextPackage.InvalidAddress Indicates that the Address is invalid.

Types

• Address

      typedef string Address;
  

• StringName

      typedef string StringName;
  

• URLString

      typedef string URLString;