zerodds-web 1.0.0-rc.1

OMG DDS-WEB 1.0 (formal/2014-12-01) WebDDS Object Model + REST PSM
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131

// SPDX-License-Identifier: Apache-2.0
// Copyright 2026 ZeroDDS Contributors

//! XML Object-Representation Tags — Spec §8.3.4 Tab 6.

/// Spec §8.3.5 — Content-Type fuer alle WebDDS-REST-Bodies.
pub const CONTENT_TYPE_DDS_WEB_XML: &str = "application/zerodds-web+xml";

/// Spec §8.3.4 Tab 6 — Object-Representation-Kategorien.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub enum RepresentationKind {
    /// Single object (e.g., `<application>`).
    Object,
    /// List of objects (e.g., `<application_list>`).
    List,
}

/// Wire-Element-Name fuer ein Object/List Tab 6 (Spec §8.3.4).
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub enum ContentType {
    /// `qos_library` / `qos_library_list`.
    QosLibrary,
    /// `qos_profile` / `qos_profile_list`.
    QosProfile,
    /// `application` / `application_list`.
    Application,
    /// `domain_participant` / `domain_participant_list`.
    DomainParticipant,
    /// `types` (XML-Type-Definition aus DDS-XTYPES).
    Types,
    /// `waitset` / `waitset_list`.
    Waitset,
    /// `topic` / `topic_list`.
    Topic,
    /// `publisher` / `publisher_list`.
    Publisher,
    /// `subscriber` / `subscriber_list`.
    Subscriber,
    /// `data_writer` / `data_writer_list`.
    DataWriter,
    /// `data_reader` / `data_reader_list`.
    DataReader,
    /// `read_sample_seq` (DataReader::read).
    ReadSampleSeq,
    /// `write_sample_seq` (DataWriter::write).
    WriteSampleSeq,
}

/// Liefert das XML-Element-Name aus Spec §8.3.4 Tab 6.
#[must_use]
pub const fn element_name(kind: ContentType, repr: RepresentationKind) -> &'static str {
    use RepresentationKind::*;
    match (kind, repr) {
        (ContentType::QosLibrary, Object) => "qos_library",
        (ContentType::QosLibrary, List) => "qos_library_list",
        (ContentType::QosProfile, Object) => "qos_profile",
        (ContentType::QosProfile, List) => "qos_profile_list",
        (ContentType::Application, Object) => "application",
        (ContentType::Application, List) => "application_list",
        (ContentType::DomainParticipant, Object) => "domain_participant",
        (ContentType::DomainParticipant, List) => "domain_participant_list",
        (ContentType::Types, _) => "types",
        (ContentType::Waitset, Object) => "waitset",
        (ContentType::Waitset, List) => "waitset_list",
        (ContentType::Topic, Object) => "topic",
        (ContentType::Topic, List) => "topic_list",
        (ContentType::Publisher, Object) => "publisher",
        (ContentType::Publisher, List) => "publisher_list",
        (ContentType::Subscriber, Object) => "subscriber",
        (ContentType::Subscriber, List) => "subscriber_list",
        (ContentType::DataWriter, Object) => "data_writer",
        (ContentType::DataWriter, List) => "data_writer_list",
        (ContentType::DataReader, Object) => "data_reader",
        (ContentType::DataReader, List) => "data_reader_list",
        (ContentType::ReadSampleSeq, _) => "read_sample_seq",
        (ContentType::WriteSampleSeq, _) => "write_sample_seq",
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn content_type_constant() {
        // Spec §8.3.5 Tab 7+8.
        assert_eq!(CONTENT_TYPE_DDS_WEB_XML, "application/zerodds-web+xml");
    }

    #[test]
    fn element_names_match_spec_tab_6() {
        use ContentType as C;
        use RepresentationKind::{List, Object};
        // Spec §8.3.4 Tab 6 — Object + List Names.
        assert_eq!(element_name(C::QosLibrary, Object), "qos_library");
        assert_eq!(element_name(C::QosLibrary, List), "qos_library_list");
        assert_eq!(element_name(C::QosProfile, Object), "qos_profile");
        assert_eq!(element_name(C::QosProfile, List), "qos_profile_list");
        assert_eq!(element_name(C::Application, Object), "application");
        assert_eq!(element_name(C::Application, List), "application_list");
        assert_eq!(
            element_name(C::DomainParticipant, Object),
            "domain_participant"
        );
        assert_eq!(
            element_name(C::DomainParticipant, List),
            "domain_participant_list"
        );
        assert_eq!(element_name(C::Waitset, Object), "waitset");
        assert_eq!(element_name(C::Topic, Object), "topic");
        assert_eq!(element_name(C::Publisher, Object), "publisher");
        assert_eq!(element_name(C::Subscriber, Object), "subscriber");
        assert_eq!(element_name(C::DataWriter, Object), "data_writer");
        assert_eq!(element_name(C::DataReader, Object), "data_reader");
        assert_eq!(element_name(C::ReadSampleSeq, Object), "read_sample_seq");
        assert_eq!(element_name(C::WriteSampleSeq, Object), "write_sample_seq");
    }

    #[test]
    fn types_representation_uses_dds_xtypes_root() {
        // Spec — types-XML wird via DDS-XTYPES Root-Element representiert.
        assert_eq!(
            element_name(ContentType::Types, RepresentationKind::Object),
            "types"
        );
        assert_eq!(
            element_name(ContentType::Types, RepresentationKind::List),
            "types"
        );
    }
}