NAME

CORBA::Object::repository_id - (operation) return the repository identifier associated with the referenced object


SYNOPSIS

IDL

  module CORBA
    {
    interface Object
      {
      string repository_id ( ) ;
      } ;
    } ;

C

  #include <orb.h>
  CORBA_string CORBA_Object_repository_id
      ( CORBA_Object o, CORBA_Environment * ev ) ;

C++

  #include <orb.h>
  namespace CORBA
    {
    class Object
      {
        public:
          char *_repository_id ( ) ;
      } ;
    } ;

Java

  package org.omg.CORBA ;
  public interface Object
    {
      String _repository_id ( ) ;
    }

Perl

(TBS)

Lisp

(TBS)


DESCRIPTION

The CORBA::Object::repository_id operation returns the repository identifier of the referenced object.


PARAMETERS

o

(C mapping only) the target object

ev

(C mapping only) a pointer to the CORBA_Environment


RETURN VALUE

The repository identifier string for the object's interface.


EXCEPTIONS

(standard system exceptions)


NOTES

  1. The repository id is a string, which should uniquely identify the object's interface definition. This uniqueness should be global, not just within the interface repository, but also across all CORBA systems, if things are done as expected. If.

    Although normally defined in the IDL describing the interface, repository ids also may be created by portable servants implementing the object, and may be modified by interceptors.

    While knowing the repository id may uniquely identify the interface definition, it doesn't tell you anything about the definition itself.

  2. (C++ mapping only) The IDL header is named orb.idl. The C++ mapping specification does not mention a specific header name. One might presume the header name should be orb.h. However, some ORB vendors are more imaginative, and use other, different header file names.

  3. (C++ mapping only) The C++ mapping of names may vary, depending on the implementation's support for nested classes and namespaces. The rules are:

        if C++ namespace is supported,
            then map IDL module to C++ namespace
        else if C++ nested classes are supported,
            then map IDL module to a C++ class
        else
            use the C mapping for names

    The C++ synopsis, above, assumes namespace support. For other situations, adjust accordingly.


SEE ALSO

CORBA::Object(3corba)


COPYRIGHT

Copyright 2012 Michael Marking. This document is distributed as part of corbadoc, a documentation-only package with the goal of describing the main CORBA-related definitions from the OMG specifications. This is version corbadoc-0.1.3-prototype, released 2011.12.23. corbadoc is an incomplete work in progress; this is a snapshot release. New releases will be posted at http://www.tatanka.com/software/corbadoc/.

The corbadoc documents, including this one, are licensed under the GNU Free Documentation License, v.1.3.