public interface EntityFactory extends QosPolicy.ForDomainParticipantFactory, QosPolicy.ForDomainParticipant, QosPolicy.ForPublisher, QosPolicy.ForSubscriber
Entity
when acting as a factory for
other entities. In other words, configures the side-effects of the
create_*
operations.
Concerns: DomainParticipantFactory
,
DomainParticipant
, Publisher
,
Subscriber
RxO: No
Changeable: Yes
This policy controls the behavior of the Entity as a factory for other entities.
This policy concerns only DomainParticipant (as factory for Publisher,
Subscriber, and Topic
), Publisher (as factory for
DataWriter
), and Subscriber (as factory for DataReader
).
This policy is mutable. A change in the policy affects only the entities
created after the change; not the previously created entities.
The setting of autoenableCreatedEntities to true indicates that the
factory create<entity>
operation will
automatically invoke the Entity.enable()
operation each time a new
Entity is created. Therefore, the Entity returned by
create<entity>
will already be enabled. A
setting of false indicates that the Entity will not be automatically
enabled. The application will need to enable it explicitly by means of the
enable operation.
The default setting of autoenableCreatedEntities = true means that, by
default, it is not necessary to explicitly call enable on newly created
entities.QosPolicy.ForDataReader, QosPolicy.ForDataWriter, QosPolicy.ForDomainParticipant, QosPolicy.ForDomainParticipantFactory, QosPolicy.ForPublisher, QosPolicy.ForSubscriber, QosPolicy.ForTopic
Modifier and Type | Method and Description |
---|---|
boolean |
isAutoEnableCreatedEntities() |
EntityFactory |
withAutoEnableCreatedEntities(boolean autoEnableCreatedEntities)
Copy this policy and override the value of the property.
|
getEnvironment
boolean isAutoEnableCreatedEntities()
EntityFactory withAutoEnableCreatedEntities(boolean autoEnableCreatedEntities)
Copyright © 2014. All rights reserved.