Merge pull request #97 from osmanhadzic/feature/implement-allow-unest-mapping

Implement allow unest mapping

Author: harlem88

AstarteDeviceSDKCSharp/Protocol/AstarteDevicePropertyInterface.cs

@@ -84,15 +84,25 @@ public void UnsetProperty(string path)
                 throw new AstarteTransportException("No available transport");
             }
 
-            transport.SendIndividualValue(this, path, null);
+            bool allowUnset = this.FindMappingInInterface(path).AllowUnset;
 
-            try
+            if (allowUnset)
             {
-                propertyStorage.RemoveStoredPath(GetInterfaceName(), path, GetMajorVersion());
+                transport.SendIndividualValue(this, path, null);
+
+                try
+                {
+                    propertyStorage.RemoveStoredPath(GetInterfaceName(), path, GetMajorVersion());
+                }
+                catch (AstartePropertyStorageException e)
+                {
+                    throw new AstarteTransportException("Property storage failure", e);
+                }
             }
-            catch (AstartePropertyStorageException e)
+            else
             {
-                throw new AstarteTransportException("Property storage failure", e);
+                throw new AstarteInvalidValueException(
+                    $"Unset operation not allowed for path {path}");
             }
         }
     }

AstarteDeviceSDKCSharp/Protocol/AstarteInterfaceMapping.cs

@@ -27,6 +27,7 @@ public class AstarteInterfaceMapping
         public string? Path { get; set; }
         public Type? MapType { get; set; }
         public Type? PrimitiveArrayType { get; set; }
+        public bool AllowUnset { get; set; } = false;
 
         public static AstarteInterfaceMapping FromAstarteInterfaceMapping(Mapping astarteMapping)
         {
@@ -40,6 +41,7 @@ protected void ParseMappingFromAstarteInterface(Mapping astarteMappingObject)
             Path = astarteMappingObject.Endpoint;
             MapType = StringToCSharpType(astarteMappingObject.Type);
             PrimitiveArrayType = StringToPrimitiveArrayCSharpType(astarteMappingObject.Type);
+            AllowUnset = astarteMappingObject.AllowUnset;
         }
 
         public string? GetPath()

AstarteDeviceSDKCSharp/Protocol/AstarteInterfaceModel.cs

@@ -73,5 +73,8 @@ public class Mapping
         [JsonProperty("expiry")]
         public int? Expiry { get; set; }
 
+        [JsonProperty("allow_unset")]
+        public bool AllowUnset { get; set; } = false;
+
     }
 }

AstarteDeviceSDKExample/Resources/standard-interfaces/org.astarte-platform.genericsensors.AvailableSensors.json

@@ -11,12 +11,14 @@
             "endpoint": "/%{sensor_id}/name",
             "type": "string",
             "description": "Sensor name.",
+            "allow_unset": true,
             "doc": "An arbitrary sensor name."
         },
         {
             "endpoint": "/%{sensor_id}/unit",
             "type": "string",
             "description": "Sample data measurement unit.",
+            "allow_unset": true,
             "doc": "SI unit such as m, kg, K, etc..."
         }
     ]