aas 0.3.0

Data type bindings for the Asset Administration Shell Specs
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

use crate::part_1::v3_1::primitives::data_type_def_xs::DataXsd;
use crate::part_1::v3_1::reference::Reference;
use serde::{Deserialize, Serialize};
#[cfg(feature = "openapi")]
use utoipa::ToSchema;

/// HasExtensions
#[derive(Clone, PartialEq, Debug, Serialize, Deserialize, Default)]
#[cfg_attr(feature = "openapi", derive(ToSchema))]
pub struct HasExtensions {
    #[serde(skip_serializing_if = "Option::is_none")]
    #[serde(rename = "extensions")]
    pub extension: Option<Vec<Extension>>,
}

/// `Extension` represents AAS elements that can hold additional, user-defined data through extensions.
///
/// This structure contains an optional list of `Extension` objects, allowing elements to be augmented
/// with supplementary information that extends the standard AAS metamodel.
///
/// Each contained `Extension` must have a unique name within its context to avoid conflicts.
///
/// The `HasExtension` structure enables flexible data modeling and customization,
/// supporting evolving use cases without compromising core interoperability.
///
/// Constraints:
/// - If present, the extensions list must contain at least one element.
/// - Extension names must be unique within this container.
#[derive(Clone, PartialEq, Debug, Deserialize, Serialize)]
#[cfg_attr(feature = "openapi", derive(ToSchema))]
pub struct Extension {
    pub name: String,

    /// semantic definition
    #[serde(skip_serializing_if = "Option::is_none")]
    #[serde(rename = "semanticId")]
    pub semantic_id: Option<Reference>,

    #[serde(skip_serializing_if = "Option::is_none")]
    #[serde(rename = "supplementalSemanticIds")]
    pub supplemental_semantic_ids: Option<Vec<Reference>>,

    #[serde(flatten)]
    pub value: DataXsd,

    #[serde(skip_serializing_if = "Option::is_none")]
    #[serde(rename = "refersTo")]
    pub refers_to: Option<Vec<Reference>>,
}

impl Extension {
    pub fn new(name: String) -> Self {
        Self {
            semantic_id: None,
            supplemental_semantic_ids: None,
            name,
            //value_type: None,
            value: DataXsd::default(),
            refers_to: None,
        }
    }
}

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

    #[test]
    fn test_serialize() {
        let extension = Extension {
            name: "".to_string(),
            semantic_id: None,
            supplemental_semantic_ids: None,
            value: DataXsd::Int(Some(123)),
            refers_to: None,
        };

        let expected = r#"{"name":"","valueType":"xs:int","value":123}"#;

        let actual = serde_json::to_string(&extension).expect("Should serialize");
        assert_eq!(expected, actual);
    }

    #[test]
    fn test_deserialize_no_data() {
        let expected = Extension {
            name: "".to_string(),
            semantic_id: None,
            supplemental_semantic_ids: None,
            value: DataXsd::String(None),
            refers_to: None,
        };

        let json = r#"{"name":"","valueType":"xs:string"}"#;

        let actual = serde_json::from_str(&json).expect("Should deserialize");
        assert_eq!(expected, actual);
    }
}