org.omg.PortableInterceptor
Interface ObjectReferenceFactory

All Superinterfaces:

IDLEntity, java.io.Serializable, ValueBase

All Known Subinterfaces:

ObjectReferenceTemplate

public interface ObjectReferenceFactory
extends ValueBase

The ObjectReferenceFactory valuetype provides the capability to create new object references, while the ObjectReferenceTemplate valuetype extends the factory capability with the identity of the template. This division is convenient because the current_factory attribute in IORInfo only requires the capability to create an object reference, while the adapter_template attribute also requires identity information.

The ObjectReferenceFactory provides only the capability to create an object reference. Note that a factory is immutable: after it has been created, it cannot be modified.

Also, note that it is possible to create a concrete valuetype (unknown to the ORB implementation) that subclasses the ObjectReferenceFactory valuetype, and to use this factory in the IOR interceptor as current_factory. In such cases, the implementation must either be immutable after it is created, or the implementation must not change the behavior of make_object. Failure to observe this requirement may result in undefined behavior.

Method Summary

Object

make_object(java.lang.String repository_id, byte[] id) Creates an Object Reference from this factory using the given repository ID and object ID.

Methods inherited from interface org.omg.CORBA.portable.ValueBase

_truncatable_ids

Method Detail

make_object

Object make_object(java.lang.String repository_id,
                   byte[] id)

Creates an Object Reference from this factory using the given repository ID and object ID. All object references created from the same factory share the same profiles and tagged components in their profiles. They may also share some of the data in their object keys, but this is not required.