type Ref_Access is access all Ref'Class;
procedure Enable
| ( | Self | : not null access Ref) is abstract; |
This operation enables the Entity. Entity objects can be created either enabled or disabled. This is controlled by the value of the DDSEntityFactoryQosModule QoS policy on the corresponding factory for the DDS.Entity.
By default, DDSEntityFactoryQosModule is set so that it is not necessary to explicitly call DDS.Entity.enable on newly created entities.
The DDS.Entity.enable operation is idempotent. Calling enable on an already enabled Entity returns OK and has no effect.
If a DDS.Entity has not yet been enabled, the following kinds of operations may be invoked on it:
Other operations may explicitly state that they may be called on disabled entities; those that do not will return the error DDS.RETCODE_NOT_ENABLED.
It is legal to delete an DDS.Entity that has not been enabled \ifnot CPP2_LANGUAGE_ONLY by calling the proper operation on its factory\endif.
Entities created from a factory Entity that is disabled are created disabled, regardless of the setting of the DDS.EntityFactoryQosPolicy.
Calling enable on an Entity whose factory Entity is not enabled will fail and return DDS.RETCODE_PRECONDITION_NOT_MET.
If DDS.EntityFactoryQosPolicy.autoenable_created_entities is TRUE, the enable operation on a factory will automatically enable all entities created from that factory (for example, enabling a DDS.Publisher will enable all its contained DDS.DataWriter objects)
Listeners associated with an entity are not called until the entity is enabled.
Conditions associated with a disabled entity are "inactive," that is, they have a trigger_value == FALSE.
self: <<in>> Cannot be NULL
Raises: One of the DDSReturnTypesModules_std_retcodes, DDSReturnTypesModule_std_retcodes or DDS.RETCODE_PRECONDITION_NOT_MET.
function Get_StatusCondition
| ( | Self | : not null access Ref) return DDS.StatusCondition.Ref_Access is abstract; |
The returned condition can then be added to a DDS.WaitSet so that the application can wait for specific status changes that affect the DDS.Entity.
self: <<in>> Cannot be NULL
Returns: the status condition associated with this entity.
function Get_Status_Changes
| ( | Self | : not null access Ref) return DDS.StatusMask is abstract; |
That is, the list of statuses whose value has changed since the last time the application read the status using the get_*_status() procedure.
When the entity is first created or if the entity is not enabled, all communication statuses are in the "untriggered" state so the list returned by the get_status_changes operation will be empty.
The list of statuses returned by the get_status_changes operation refers to the status that are triggered on the Entity itself and does not include statuses that apply to contained entities.
self: <<in>> Cannot be NULL
Returns: list of communication statuses in the DDS.Entity that are triggered.
See also: DDSStatusTypesModule
function Get_Instance_Handle
| ( | Self | : not null access Ref) return DDS.InstanceHandle_T is abstract; |
This operation returns the DDS.InstanceHandle_t that represents the DDS.Entity.
self: <<in>> Cannot be NULL
Returns: the instance handle associated with this entity.
function Get_Entity_Kind
| ( | Self | : not null access Ref) return DDS.EntityKind_T is abstract; |
function GetInterface
| ( | Self | : not null access constant Ref) return System.Address is abstract; |
All operations except for set_qos(), get_qos(), set_listener(), get_listener() and enable(), may return the value DDS.RETCODE_NOT_ENABLED.
QoS:
DDSQosTypesModule
Status:
DDSStatusTypesModule
Listener:
DDS.Listener
Abstract operations
Each derived entity provides the following operations specific to its role in dds. exceptions thrown in addition to DDSReturnTypesModule_std_retcodes : DDS.RETCODE_IMMUTABLE_POLICY, DDS.RETCODE_INCONSISTENT_POLICY.
get_qos (abstract)
This operation allows access to the existing set of QoS policies for the DDS.Entity. This operation must be provided by each of the derived DDS.Entity classes (DDS.DomainParticipant, DDS.Topic, DDS.Publisher, DDS.DataWriter, DDS.Subscriber, and DDS.DataReader), so that the policies that are meaningful to each DDS.Entity can be retrieved.
Possible error codes are DDSReturnTypesModule_std_retcodes.
set_listener (abstract)
This operation installs a DDS.Listener on the DDS.Entity. The listener will only be invoked on the changes of communication status indicated by the specified mask.
This operation must be provided by each of the derived DDS.Entity classes (DDS.DomainParticipant, DDS.Topic, DDS.Publisher, DDS.DataWriter, DDS.Subscriber, and DDS.DataReader), so that the listener is of the concrete type suitable to the particular DDS.Entity.
It is permitted to use ull_value as the value of the listener. The ull_value listener behaves as if the mask is DDS.STATUS_MASK_NONE.
Postcondition: Only one listener can be attached to each DDS.Entity. If a listener was already set, the operation set_listener() will replace it with the new one. Consequently, if the value ull_value is passed for the listener parameter to the set_listener operation, any existing listener will be removed.
If no listener is installed on the DDS.Entity, this operation will return ull_value.