reactive_graph_graphql_schema/mutation/instances/
relation_instance_definition.rs

1use async_graphql::InputObject;
2use serde::Deserialize;
3use serde::Serialize;
4
5use crate::mutation::GraphQLExtensionDefinition;
6use crate::mutation::GraphQLRelationInstanceId;
7use crate::query::GraphQLPropertyInstance;
8use reactive_graph_graph::Extension;
9use reactive_graph_graph::Extensions;
10use reactive_graph_graph::PropertyInstances;
11use reactive_graph_graph::RelationInstance;
12use reactive_graph_graph::RelationInstanceId;
13use reactive_graph_graph::RelationInstanceTypeIdError;
14use reactive_graph_graph::RelationInstances;
15
16/// Relation instances are edges from an outbound entity instance to an
17/// inbound entity instance.
18///
19/// The relation instance is of a relation type. The relation type defines
20/// the entity types of the outbound entity instance and the inbound entity
21/// instance. Furthermore, the relation type defines which properties
22/// (name, data type, socket type) a relation instance have to have.
23///
24/// In contrast to the relation type, the relation instance stores values/
25/// documents in its properties.
26#[derive(Serialize, Deserialize, Clone, Debug, InputObject)]
27#[graphql(name = "RelationInstanceDefinition")]
28pub struct GraphQLRelationInstanceDefinition {
29    /// The fully qualified namespace, outbound id, inbound id and instance id of the relation instance
30    pub relation_instance_id: GraphQLRelationInstanceId,
31
32    /// The name of the relation instance.
33    pub name: String,
34
35    /// Textual description of the relation instance.
36    pub description: String,
37
38    /// The properties of then relation instance.
39    ///
40    /// Each property is represented by its name (String) and it's value. The value is
41    /// a representation of a JSON. Therefore, the value can be boolean, number, string,
42    /// array or an object. For more information about the data types please look at
43    /// https://docs.serde.rs/serde_json/value/enum.Value.html
44    pub properties: Vec<GraphQLPropertyInstance>,
45
46    // TODO: components
47    /// Relation instance specific extensions.
48    pub extensions: Vec<GraphQLExtensionDefinition>,
49}
50
51impl TryFrom<GraphQLRelationInstanceDefinition> for RelationInstance {
52    type Error = RelationInstanceTypeIdError;
53
54    fn try_from(relation_instance: GraphQLRelationInstanceDefinition) -> Result<Self, Self::Error> {
55        let relation_instance_id = RelationInstanceId::try_from(relation_instance.relation_instance_id)?;
56        let properties: PropertyInstances = relation_instance
57            .properties
58            .iter()
59            .map(|property_instance| (property_instance.name.clone(), property_instance.value.clone()))
60            .collect();
61        let extensions = Extensions::new();
62        for extension in relation_instance.extensions {
63            extensions.push(Extension::try_from(extension.clone())?);
64        }
65        // let extensions: Extensions = relation_instance.extensions.iter().map(|e| Extension::from(e.clone())).collect();
66        // let components; relation_instance.components.iter().map(|e| ComponentTypeId::from(e.clone())).collect();
67        Ok(RelationInstance::builder()
68            .outbound_id(relation_instance_id.outbound_id)
69            .ty(relation_instance_id.ty)
70            .inbound_id(relation_instance_id.inbound_id)
71            .description(relation_instance.description)
72            .properties(properties)
73            // .components(components) ???
74            .extensions(extensions)
75            .build())
76    }
77}
78
79#[derive(Default)]
80pub struct GraphQLRelationInstanceDefinitions(pub Vec<GraphQLRelationInstanceDefinition>);
81
82impl GraphQLRelationInstanceDefinitions {
83    pub fn new(relation_instances: Vec<GraphQLRelationInstanceDefinition>) -> Self {
84        Self(relation_instances)
85    }
86}
87
88impl TryFrom<GraphQLRelationInstanceDefinitions> for RelationInstances {
89    type Error = RelationInstanceTypeIdError;
90
91    fn try_from(relation_instance_definitions: GraphQLRelationInstanceDefinitions) -> Result<Self, Self::Error> {
92        let relation_instances = RelationInstances::new();
93        for relation_instance_definition in relation_instance_definitions.0 {
94            relation_instances.push(RelationInstance::try_from(relation_instance_definition)?);
95        }
96        // relation_instances.0.into_iter().map(|entity_instance| entity_instance.into()).collect()
97        Ok(relation_instances)
98    }
99}