A modelling and serializer library for Microsoft Azure IoTHub client applications

Dependents:   sht15_remote_monitoring f767zi_mqtt remote_monitoring simplesample_amqp ... more

This library implements a serializer library to be used in projects involving Microsoft Azure IoT Hub connectivity. The code is replicated from https://github.com/Azure/azure-iot-sdks

Revision:
0:1f9b2707ec7d
Child:
5:c08e3ffc68e4
diff -r 000000000000 -r 1f9b2707ec7d datamarshaller.c
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/datamarshaller.c	Tue Sep 15 21:57:26 2015 -0700
@@ -0,0 +1,223 @@
+// Copyright (c) Microsoft. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+
+#include <stdlib.h> /*for free*/
+#ifdef _CRTDBG_MAP_ALLOC
+#include <crtdbg.h>
+#endif
+#include "gballoc.h"
+
+#include <stdbool.h>
+#include "datamarshaller.h"
+#include "crt_abstractions.h"
+#include "schema.h"
+#include "jsonencoder.h"
+#include "agenttypesystem.h"
+#include "iot_logging.h"
+
+DEFINE_ENUM_STRINGS(DATA_MARSHALLER_RESULT, DATA_MARSHALLER_RESULT_VALUES);
+
+#define LOG_DATA_MARSHALLER_ERROR \
+    LogError("(result = %s)\r\n", ENUM_TO_STRING(DATA_MARSHALLER_RESULT, result));
+
+typedef struct DATA_MARSHALLER_INSTANCE_TAG
+{
+    SCHEMA_MODEL_TYPE_HANDLE ModelHandle;
+    bool IncludePropertyPath;
+} DATA_MARSHALLER_INSTANCE;
+
+static int NoCloneFunction(void** destination, const void* source)
+{
+    *destination = (void*)source;
+    return 0;
+}
+
+static void NoFreeFunction(void* value)
+{
+    (void)value;
+}
+
+DATA_MARSHALLER_HANDLE DataMarshaller_Create(SCHEMA_MODEL_TYPE_HANDLE modelHandle, bool includePropertyPath)
+{
+    DATA_MARSHALLER_HANDLE result;
+    DATA_MARSHALLER_INSTANCE* dataMarshallerInstance;
+
+    /*Codes_SRS_DATA_MARSHALLER_99_019:[ DataMarshaller_Create shall return NULL if any argument is NULL.]*/
+    if (
+        (modelHandle == NULL) 
+        )
+    {
+        result = NULL;
+        LogError("(result = %s)\r\n", ENUM_TO_STRING(DATA_MARSHALLER_RESULT, DATA_MARSHALLER_INVALID_ARG));
+    }
+    else if ((dataMarshallerInstance = (DATA_MARSHALLER_INSTANCE*)malloc(sizeof(DATA_MARSHALLER_INSTANCE))) == NULL)
+    {
+        /* Codes_SRS_DATA_MARSHALLER_99_048:[On any other errors not explicitly specified, DataMarshaller_Create shall return NULL.] */
+        result = NULL;
+        LogError("(result = %s)\r\n", ENUM_TO_STRING(DATA_MARSHALLER_RESULT, DATA_MARSHALLER_ERROR));
+    }
+    else
+    {
+        /*everything ok*/
+        dataMarshallerInstance->ModelHandle = modelHandle;
+        dataMarshallerInstance->IncludePropertyPath = includePropertyPath;
+
+        /*Codes_SRS_DATA_MARSHALLER_99_018:[ DataMarshaller_Create shall create a new DataMarshaller instance and on success it shall return a non NULL handle.]*/
+        result = dataMarshallerInstance;
+    }
+    return result;
+}
+
+void DataMarshaller_Destroy(DATA_MARSHALLER_HANDLE dataMarshallerHandle)
+{
+    /* Codes_SRS_DATA_MARSHALLER_99_024:[ When called with a NULL handle, DataMarshaller_Destroy shall do nothing.] */
+    if (dataMarshallerHandle != NULL)
+    {
+        /* Codes_SRS_DATA_MARSHALLER_99_022:[ DataMarshaller_Destroy shall free all resources associated with the dataMarshallerHandle argument.] */
+        DATA_MARSHALLER_INSTANCE* dataMarshallerInstance = (DATA_MARSHALLER_INSTANCE*)dataMarshallerHandle;
+        free(dataMarshallerInstance);
+    }
+}
+
+DATA_MARSHALLER_RESULT DataMarshaller_SendData(DATA_MARSHALLER_HANDLE dataMarshallerHandle, size_t valueCount, const DATA_MARSHALLER_VALUE* values, unsigned char** destination, size_t* destinationSize)
+{
+    DATA_MARSHALLER_INSTANCE* dataMarshallerInstance = (DATA_MARSHALLER_INSTANCE*)dataMarshallerHandle;
+    DATA_MARSHALLER_RESULT result;
+    MULTITREE_HANDLE treeHandle;
+
+    /* Codes_SRS_DATA_MARSHALLER_99_034:[All argument checks shall be performed before calling any other modules.] */
+    /* Codes_SRS_DATA_MARSHALLER_99_004:[ DATA_MARSHALLER_INVALID_ARG shall be returned when the function has detected an invalid parameter (NULL) being passed to the function.] */
+    if ((values == NULL) ||
+        (dataMarshallerHandle == NULL) ||
+        (destination == NULL) ||
+        (destinationSize == NULL) ||
+        /* Codes_SRS_DATA_MARSHALLER_99_033:[ DATA_MARSHALLER_INVALID_ARG shall be returned if the valueCount is zero.] */
+        (valueCount == 0))
+    {
+        result = DATA_MARSHALLER_INVALID_ARG;
+        LOG_DATA_MARSHALLER_ERROR
+    }
+    else
+    {
+        size_t i;
+        /* VS complains wrongly that result is not initialized */
+        result = DATA_MARSHALLER_ERROR;
+        bool includePropertyPath = dataMarshallerInstance->IncludePropertyPath;
+
+        for (i = 0; i < valueCount; i++)
+        {
+            if ((values[i].PropertyPath == NULL) ||
+                (values[i].Value == NULL))
+            {
+                /*Codes_SRS_DATA_MARSHALLER_99_007:[ DATA_MARSHALLER_INVALID_MODEL_PROPERTY shall be returned when any of the items in values contain invalid data]*/
+                result = DATA_MARSHALLER_INVALID_MODEL_PROPERTY;
+                LOG_DATA_MARSHALLER_ERROR
+                break;
+            }
+
+            if ((!dataMarshallerInstance->IncludePropertyPath) &&
+                (values[i].Value->type == EDM_COMPLEX_TYPE_TYPE) &&
+                (valueCount > 1))
+            {
+                /* Codes_SRS_DATAMARSHALLER_01_002: [If the includePropertyPath argument passed to DataMarshaller_Create was false and the number of values passed to SendData is greater than 1 and at least one of them is a struct, DataMarshaller_SendData shall fallback to  including the complete property path in the output JSON.] */
+                includePropertyPath = true;
+            }
+        }
+
+        if (i == valueCount)
+        {
+            /* Codes_SRS_DATA_MARSHALLER_99_037:[DataMarshaller shall store as MultiTree the data to be encoded by the JSONEncoder module.] */
+            if ((treeHandle = MultiTree_Create(NoCloneFunction, NoFreeFunction)) == NULL)
+            {
+                /* Codes_SRS_DATA_MARSHALLER_99_035:[DATA_MARSHALLER_MULTITREE_ERROR shall be returned in case any MultiTree API call fails.] */
+                result = DATA_MARSHALLER_MULTITREE_ERROR;
+                LOG_DATA_MARSHALLER_ERROR
+            }
+            else
+            {
+                size_t j;
+                result = DATA_MARSHALLER_OK; /* addressing warning in VS compiler */
+                /* Codes_SRS_DATA_MARSHALLER_99_038:[For each pair in the values argument, a string : value pair shall exist in the JSON object in the form of propertyName : value.] */
+                for (j = 0; j < valueCount; j++)
+                {
+                    if ((includePropertyPath == false) && (values[j].Value->type == EDM_COMPLEX_TYPE_TYPE))
+                    {
+                        size_t k;
+
+                        /* Codes_SRS_DATAMARSHALLER_01_001: [If the includePropertyPath argument passed to DataMarshaller_Create was false and only one struct is being sent, the relative path of the value passed to DataMarshaller_SendData - including property name - shall be ignored and the value shall be placed at JSON root.] */
+                        for (k = 0; k < values[j].Value->value.edmComplexType.nMembers; k++)
+                        {
+                            /* Codes_SRS_DATAMARSHALLER_01_004: [In this case the members of the struct shall be added as leafs into the MultiTree, each leaf having the name of the struct member.] */
+                            if (MultiTree_AddLeaf(treeHandle, values[j].Value->value.edmComplexType.fields[k].fieldName, (void*)values[j].Value->value.edmComplexType.fields[k].value) != MULTITREE_OK)
+                            {
+                                break;
+                            }
+                        }
+
+                        if (k < values[j].Value->value.edmComplexType.nMembers)
+                        {
+                            /* Codes_SRS_DATA_MARSHALLER_99_035:[DATA_MARSHALLER_MULTITREE_ERROR shall be returned in case any MultiTree API call fails.] */
+                            result = DATA_MARSHALLER_MULTITREE_ERROR;
+                            LOG_DATA_MARSHALLER_ERROR
+                            break;
+                        }
+                    }
+                    else
+                    {
+                        /* Codes_SRS_DATA_MARSHALLER_99_039:[ If the includePropertyPath argument passed to DataMarshaller_Create was true each property shall be placed in the appropriate position in the JSON according to its path in the model.] */
+                        if (MultiTree_AddLeaf(treeHandle, values[j].PropertyPath, (void*)values[j].Value) != MULTITREE_OK)
+                        {
+                            /* Codes_SRS_DATA_MARSHALLER_99_035:[DATA_MARSHALLER_MULTITREE_ERROR shall be returned in case any MultiTree API call fails.] */
+                            result = DATA_MARSHALLER_MULTITREE_ERROR;
+                            LOG_DATA_MARSHALLER_ERROR
+                            break;
+                        }
+                    }
+
+                }
+
+                if (j == valueCount)
+                {
+                    STRING_HANDLE payload = STRING_new();
+                    if (payload == NULL)
+                    {
+                        result = DATA_MARSHALLER_ERROR;
+                        LOG_DATA_MARSHALLER_ERROR
+                    }
+                    else
+                    {
+                        if (JSONEncoder_EncodeTree(treeHandle, payload, (JSON_ENCODER_TOSTRING_FUNC)AgentDataTypes_ToString) != JSON_ENCODER_OK)
+                        {
+                            /* Codes_SRS_DATA_MARSHALLER_99_027:[ DATA_MARSHALLER_JSON_ENCODER_ERROR shall be returned when JSONEncoder returns an error code.] */
+                            result = DATA_MARSHALLER_JSON_ENCODER_ERROR;
+                            LOG_DATA_MARSHALLER_ERROR
+                        }
+                        else
+                        {
+                            /*Codes_SRS_DATAMARSHALLER_02_007: [DataMarshaller_SendData shall copy in the output parameters *destination, *destinationSize the content and the content length of the encoded JSON tree.] */
+                            size_t resultSize = STRING_length(payload);
+                            unsigned char* temp = malloc(resultSize);
+                            if (temp == NULL)
+                            {
+                                /*Codes_SRS_DATA_MARSHALLER_99_015:[ DATA_MARSHALLER_ERROR shall be returned in all the other error cases not explicitly defined here.]*/
+                                result = DATA_MARSHALLER_ERROR;
+                                LOG_DATA_MARSHALLER_ERROR;
+                            }
+                            else
+                            {
+                                memcpy(temp, STRING_c_str(payload), resultSize);
+                                *destination = temp;
+                                *destinationSize = resultSize;
+                                result = DATA_MARSHALLER_OK;
+                            }
+                        }
+                        STRING_delete(payload);
+                    }
+                } /* if (j==valueCount)*/
+                MultiTree_Destroy(treeHandle);
+            } /* MultiTree_Create */
+        }
+    }
+
+    return result;
+}