Trait Entity

Source

pub trait Entity {
    type Qos: Clone;

    // Required methods
    fn get_qos(&self) -> Self::Qos;
    fn set_qos(&self, qos: Self::Qos) -> Result<()>;
    fn enable(&self) -> Result<()>;
    fn entity_state(&self) -> Arc<EntityState> ⓘ;

    // Provided methods
    fn is_enabled(&self) -> bool { ... }
    fn get_status_condition(&self) -> StatusCondition { ... }
    fn get_status_changes(&self) -> StatusMask { ... }
    fn get_instance_handle(&self) -> InstanceHandle { ... }
}

Expand description

Entity-Trait — gemeinsame Lifecycle-API der 6 Entity-Typen (DCPS §2.2.2.1).

Nicht-blocking, Send+Sync — alle Methoden delegieren auf Arc<EntityState>.

Required Associated Types§

Source

type Qos: Clone

QoS-Typ fuer diese Entity (z.B. DomainParticipantQos, DataWriterQos, …).

Required Methods§

Source

fn get_qos(&self) -> Self::Qos

Liefert die aktuelle QoS (clone). Spec §2.2.2.1.2 get_qos.

Source

fn set_qos(&self, qos: Self::Qos) -> Result<()>

Aendert QoS. Pre-enable: alles erlaubt. Post-enable: nur Felder mit “Changeable=YES” — sonst ImmutablePolicy-Error. Spec §2.2.2.1.2 set_qos.

§Errors

DdsError::ImmutablePolicy wenn ein immutables Feld nach enable() geaendert werden soll.
DdsError::InconsistentPolicy wenn die neue QoS-Kombination inkonsistent ist.

Source

fn enable(&self) -> Result<()>

Enabled die Entity (idempotent). Spec §2.2.2.1.4 enable.

§Errors

DdsError::PreconditionNotMet wenn das Parent-Entity nicht enabled ist (Spec: Children koennen nicht vor Parent enabled werden — ausser Factory selbst).

Source