NAME

CORBA::Object - base interface inherited by all objects


DESCRIPTION

The CORBA::Object interface is inherited by all objects. That is, the operations defined in CORBA::Object may be invoked on all objects.

Unlike operations defined explicitly on the derived interfaces, however, the operations defined on CORBA::Object are not performed by the object implementation itself. Instead, these operations are performed by the local ORB, and, if the object is implemented in a different ORB, possibly in conjunction with the object implementation's ORB.


CONTENTS

The defined operations are:

CORBA::Object::create_request (operation)

Creates a CORBA::Request object which can be used with the dynamic invocation interface.

CORBA::Object::duplicate (operation)

Returns a copy of the object reference. (Duplicates the reference, not the object itself.)

CORBA::Object::get_client_policy (operation)

Returns the effective, overriding policy of the given type.

CORBA::Object::get_domain_managers (operation)

Returns the domain managers associated with the object.

CORBA::Object::get_interface (operation)

Returns the interface repository object (of type CORBA::InterfaceDef) describing the object's most derived interface.

CORBA::Object::get_policy (operation)

Returns the effective policy of the given type; that is, the policy which would be in effect if an invocation were to be made.

CORBA::Object::get_component (operation)

If the reference is to a component, or to a facet of a component, returns the component reference. Otherwise, returns the nil object.

CORBA::Object::get_ORB (operation)

Returns the local ORB handling the object reference.

CORBA::Object::get_policy_overrides (operation)

Returns a list of policy overrides set at the object scope.

CORBA::Object::hash (operation)

Returns a hash value on the object reference.

CORBA::Object::is_a (operation)

Determines whether the object's interface matches the definition for the specified repository identifier.

CORBA::Object::is_equivalent (operation)

Compares two object references. Do they refer to the same object?

CORBA::Object::is_nil (operation)

Determines whether the target object reference is that of the nil object (CORBA::OBJECT_NIL).

CORBA::Object::non_existent (operation)

Determines whether the object has been destroyed.

CORBA::Object::release (operation)

Releases an object reference. Does not affect the object itself.

CORBA::Object::repository_id (operation)

Returns the repository identifier string associated with the target object's interface.

CORBA::Object::set_policy_overrides (operation)

Returns a new object reference, to the same object, but with the specified policy overrides in effect.

CORBA::Object::validate_connection (operation)

Determines whether, under the effective policies, an invocation would be permitted.


NOTES

  1. Local objects do not have some of these operations. They raise CORBA::NO_IMPLEMENT for the following operations: get_interface, get_domain_managers, get_policy, get_client_policy, set_policy_overrides, get_policy_overrides, validate_connection, get_component, and respository_id.

    Certain implemented operations return fixed or restricted values; refer to the operations themselves for details.


SEE ALSO

CORBA(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.