====== F.20 Entity Factory  ======
[[dido:public:ra:xapend:xapend.f_qos:start| Return to DDS Quality of Service ]]

The ENTITY_FACTORY policy controls the behavior of the ''[[dido:public:ra:xapend:xapend.a_glossary:e:entity|Entity]]'' as a factory for other entities.

This [[dido:public:ra:xapend:xapend.a_glossary:p:policy|policy]] concerns only [[dido:public:ra:xapend:xapend.a_glossary:d:domain_participant|Domain Participant]] (as factory for ''Publisher'', ''Subscriber'', and ''[[dido:public:ra:xapend:xapend.a_glossary:t:topic|Topic]]''), [[dido:public:ra:xapend:xapend.a_glossary:p:publisher|Publisher]] (as factory for ''DataWriter''), and [[dido:public:ra:xapend:xapend.a_glossary:s:subscriber|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 ''autoenable_created_entities'' to TRUE indicates that the factory ''create_<entity>'' operation will automatically invoke the ''enable'' operation each time a new ''[[dido:public:ra:xapend:xapend.a_glossary:e:entity|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 [[dido:public:ra:xapend:xapend.a_glossary:a:application|application]] will need to ''enable'' it explicitly by means of the ''enable'' operation (see 2.2.2.1.1.7).

The default setting of ''autoenable_created_entities = TRUE'' means that, by default, it is not necessary to explicitly call ''enable'' on newly created entities.

Source: [[https://www.omg.org/spec/DDS/1.4/PDF | DDS 1.4 Spec]]

/**=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
/* To add a discussion page to this page, comment out the line that says 
  ~~DISCUSSION:off~~
*/
~~DISCUSSION:on|Outstanding Issues~~
~~DISCUSSION:off~~