IOTHUB_CLIENT_LL_HANDLE IoTHubClient_LL_Create(const IOTHUB_CLIENT_CONFIG* config)
{
IOTHUB_CLIENT_LL_HANDLE result;
/*Codes_SRS_IOTHUBCLIENT_LL_02_001: [IoTHubClient_LL_Create shall return NULL if config parameter is NULL or protocol field is NULL.]*/
if(
(config == NULL) ||
(config->protocol == NULL)
)
{
result = NULL;
LogError("invalid configuration (NULL detected)");
}
else
{
IOTHUB_CLIENT_LL_HANDLE_DATA* handleData = (IOTHUB_CLIENT_LL_HANDLE_DATA*)malloc(sizeof(IOTHUB_CLIENT_LL_HANDLE_DATA));
if (handleData == NULL)
{
LogError("malloc failed");
result = NULL;
}
else
{
/*Codes_SRS_IOTHUBCLIENT_LL_02_094: [ IoTHubClient_LL_Create shall create a IOTHUB_CLIENT_LL_UPLOADTOBLOB_HANDLE from IOTHUB_CLIENT_CONFIG. ]*/
/*Codes_SRS_IOTHUBCLIENT_LL_02_092: [ IoTHubClient_LL_CreateFromConnectionString shall create a IOTHUB_CLIENT_LL_UPLOADTOBLOB_HANDLE from IOTHUB_CLIENT_CONFIG. ]*/
handleData->uploadToBlobHandle = IoTHubClient_LL_UploadToBlob_Create(config);
if (handleData->uploadToBlobHandle == NULL)
{
/*Codes_SRS_IOTHUBCLIENT_LL_02_093: [ If creating the IOTHUB_CLIENT_LL_UPLOADTOBLOB_HANDLE fails then IoTHubClient_LL_CreateFromConnectionString shall fail and return NULL. ]*/
/*Codes_SRS_IOTHUBCLIENT_LL_02_095: [ If creating the IOTHUB_CLIENT_LL_UPLOADTOBLOB_HANDLE fails then IoTHubClient_LL_Create shall fail and return NULL. ]*/
LogError("unable to IoTHubClient_LL_UploadToBlob_Create");
free(handleData);
result = NULL;
}
else
{
/*Codes_SRS_IOTHUBCLIENT_LL_02_045: [ Otherwise IoTHubClient_LL_Create shall create a new TICK_COUNTER_HANDLE ]*/
if ((handleData->tickCounter = tickcounter_create()) == NULL)
{
/*Codes_SRS_IOTHUBCLIENT_LL_02_046: [ If creating the TICK_COUNTER_HANDLE fails then IoTHubClient_LL_Create shall fail and return NULL. ]*/
IoTHubClient_LL_UploadToBlob_Destroy(handleData->uploadToBlobHandle);
LogError("unable to get a tickcounter");
free(handleData);
result = NULL;
}
else
{
/*Codes_SRS_IOTHUBCLIENT_LL_02_004: [Otherwise IoTHubClient_LL_Create shall initialize a new DLIST (further called "waitingToSend") containing records with fields of the following types: IOTHUB_MESSAGE_HANDLE, IOTHUB_CLIENT_EVENT_CONFIRMATION_CALLBACK, void*.]*/
IOTHUBTRANSPORT_CONFIG lowerLayerConfig;
DList_InitializeListHead(&(handleData->waitingToSend));
setTransportProtocol(handleData, (TRANSPORT_PROVIDER*)config->protocol());
handleData->messageCallback = NULL;
handleData->messageUserContextCallback = NULL;
handleData->lastMessageReceiveTime = INDEFINITE_TIME;
/*Codes_SRS_IOTHUBCLIENT_LL_02_006: [IoTHubClient_LL_Create shall populate a structure of type IOTHUBTRANSPORT_CONFIG with the information from config parameter and the previous DLIST and shall pass that to the underlying layer _Create function.]*/
lowerLayerConfig.upperConfig = config;
lowerLayerConfig.waitingToSend = &(handleData->waitingToSend);
/*Codes_SRS_IOTHUBCLIENT_LL_02_007: [If the underlaying layer _Create function fails them IoTHubClient_LL_Create shall fail and return NULL.] */
if ((handleData->transportHandle = handleData->IoTHubTransport_Create(&lowerLayerConfig)) == NULL)
{
LogError("underlying transport failed");
IoTHubClient_LL_UploadToBlob_Destroy(handleData->uploadToBlobHandle);
tickcounter_destroy(handleData->tickCounter);
free(handleData);
result = NULL;
}
else
{
IOTHUB_DEVICE_CONFIG deviceConfig;
deviceConfig.deviceId = config->deviceId;
deviceConfig.deviceKey = config->deviceKey;
deviceConfig.deviceSasToken = config->deviceSasToken;
/*Codes_SRS_IOTHUBCLIENT_LL_17_008: [IoTHubClient_LL_Create shall call the transport _Register function with a populated structure of type IOTHUB_DEVICE_CONFIG and waitingToSend list.] */
if ((handleData->deviceHandle = handleData->IoTHubTransport_Register(handleData->transportHandle, &deviceConfig, handleData, &(handleData->waitingToSend))) == NULL)
{
/*Codes_SRS_IOTHUBCLIENT_LL_17_009: [If the _Register function fails, this function shall fail and return NULL.]*/
LogError("Registering device in transport failed");
handleData->IoTHubTransport_Destroy(handleData->transportHandle);
IoTHubClient_LL_UploadToBlob_Destroy(handleData->uploadToBlobHandle);
tickcounter_destroy(handleData->tickCounter);
free(handleData);
result = NULL;
}
else
{
/*Codes_SRS_IOTHUBCLIENT_LL_02_008: [Otherwise, IoTHubClient_LL_Create shall succeed and return a non-NULL handle.] */
handleData->isSharedTransport = false;
/*Codes_SRS_IOTHUBCLIENT_LL_02_042: [ By default, messages shall not timeout. ]*/
handleData->currentMessageTimeout = 0;
result = handleData;
}
}
}
}
}
}
return result;
}
IOTHUB_CLIENT_LL_HANDLE IoTHubClient_LL_CreateWithTransport(const IOTHUB_CLIENT_DEVICE_CONFIG * config)
{
IOTHUB_CLIENT_LL_HANDLE result;
/*Codes_SRS_IOTHUBCLIENT_LL_17_001: [IoTHubClient_LL_CreateWithTransport shall return NULL if config parameter is NULL, or protocol field is NULL or transportHandle is NULL.]*/
if (
(config == NULL) ||
(config->protocol == NULL) ||
(config->transportHandle == NULL)
)
{
result = NULL;
LogError("invalid configuration (NULL detected)");
}
else
{
/*Codes_SRS_IOTHUBCLIENT_LL_17_002: [IoTHubClient_LL_CreateWithTransport shall allocate data for the IOTHUB_CLIENT_LL_HANDLE.]*/
IOTHUB_CLIENT_LL_HANDLE_DATA* handleData = (IOTHUB_CLIENT_LL_HANDLE_DATA*)malloc(sizeof(IOTHUB_CLIENT_LL_HANDLE_DATA));
if (handleData == NULL)
{
/*Codes_SRS_IOTHUBCLIENT_LL_17_003: [If allocation fails, the function shall fail and return NULL.] */
LogError("malloc failed");
result = NULL;
}
else
{
handleData->uploadToBlobHandle = NULL;
/*Codes_SRS_IOTHUBCLIENT_LL_02_047: [ IoTHubClient_LL_CreateWithTransport shall create a TICK_COUNTER_HANDLE. ]*/
if ((handleData->tickCounter = tickcounter_create()) == NULL)
{
/*Codes_SRS_IOTHUBCLIENT_LL_02_048: [ If creating the handle fails, then IoTHubClient_LL_CreateWithTransport shall fail and return NULL ]*/
LogError("unable to get a tickcounter");
free(handleData);
result = NULL;
}
else
{
/*Codes_SRS_IOTHUBCLIENT_LL_17_004: [IoTHubClient_LL_CreateWithTransport shall initialize a new DLIST (further called "waitingToSend") containing records with fields of the following types: IOTHUB_MESSAGE_HANDLE, IOTHUB_CLIENT_EVENT_CONFIRMATION_CALLBACK, void*.]*/
DList_InitializeListHead(&(handleData->waitingToSend));
setTransportProtocol(handleData, (TRANSPORT_PROVIDER*)config->protocol());
handleData->messageCallback = NULL;
handleData->messageUserContextCallback = NULL;
handleData->lastMessageReceiveTime = INDEFINITE_TIME;
handleData->transportHandle = config->transportHandle;
IOTHUB_DEVICE_CONFIG deviceConfig;
deviceConfig.deviceId = config->deviceId;
deviceConfig.deviceKey = config->deviceKey;
deviceConfig.deviceSasToken = config->deviceSasToken;
/*Codes_SRS_IOTHUBCLIENT_LL_17_006: [IoTHubClient_LL_CreateWithTransport shall call the transport _Register function with the IOTHUB_DEVICE_CONFIG populated structure and waitingToSend list.]*/
if ((handleData->deviceHandle = handleData->IoTHubTransport_Register(config->transportHandle, &deviceConfig, handleData, &(handleData->waitingToSend))) == NULL)
{
/*Codes_SRS_IOTHUBCLIENT_LL_17_007: [If the _Register function fails, this function shall fail and return NULL.]*/
LogError("Registering device in transport failed");
tickcounter_destroy(handleData->tickCounter);
free(handleData);
result = NULL;
}
else
{
/*Codes_SRS_IOTHUBCLIENT_LL_17_005: [IoTHubClient_LL_CreateWithTransport shall save the transport handle and mark this transport as shared.]*/
handleData->isSharedTransport = true;
/*Codes_SRS_IOTHUBCLIENT_LL_02_042: [ By default, messages shall not timeout. ]*/
handleData->currentMessageTimeout = 0;
result = handleData;
}
}
}
}
return result;
}
IOTHUB_CLIENT_LL_HANDLE IoTHubClient_LL_CreateWithTransport(const IOTHUB_CLIENT_DEVICE_CONFIG * config)
{
IOTHUB_CLIENT_LL_HANDLE result;
/*Codes_SRS_IOTHUBCLIENT_LL_17_001: [IoTHubClient_LL_CreateWithTransport shall return NULL if config parameter is NULL, or protocol field is NULL or transportHandle is NULL.]*/
if (
(config == NULL) ||
(config->protocol == NULL) ||
(config->transportHandle == NULL) ||
/*Codes_SRS_IOTHUBCLIENT_LL_02_098: [ IoTHubClient_LL_CreateWithTransport shall fail and return NULL if both config->deviceKey AND config->deviceSasToken are NULL. ]*/
((config->deviceKey == NULL) && (config->deviceSasToken == NULL))
)
{
result = NULL;
LogError("invalid configuration (NULL detected)");
}
else
{
/*Codes_SRS_IOTHUBCLIENT_LL_17_002: [IoTHubClient_LL_CreateWithTransport shall allocate data for the IOTHUB_CLIENT_LL_HANDLE.]*/
IOTHUB_CLIENT_LL_HANDLE_DATA* handleData = (IOTHUB_CLIENT_LL_HANDLE_DATA*)malloc(sizeof(IOTHUB_CLIENT_LL_HANDLE_DATA));
if (handleData == NULL)
{
/*Codes_SRS_IOTHUBCLIENT_LL_17_003: [If allocation fails, the function shall fail and return NULL.] */
LogError("malloc failed");
result = NULL;
}
else
{
handleData->transportHandle = config->transportHandle;
setTransportProtocol(handleData, (TRANSPORT_PROVIDER*)config->protocol());
#ifndef DONT_USE_UPLOADTOBLOB
const char* hostname = STRING_c_str(handleData->IoTHubTransport_GetHostname(handleData->transportHandle));
/*Codes_SRS_IOTHUBCLIENT_LL_02_096: [ IoTHubClient_LL_CreateWithTransport shall create the data structures needed to instantiate a IOTHUB_CLIENT_LL_UPLOADTOBLOB_HANDLE. ]*/
/*the first '.' says where the iothubname finishes*/
const char* whereIsDot = strchr(hostname, '.');
if (whereIsDot == NULL)
{
/*Codes_SRS_IOTHUBCLIENT_LL_02_097: [ If creating the data structures fails or instantiating the IOTHUB_CLIENT_LL_UPLOADTOBLOB_HANDLE fails then IoTHubClient_LL_CreateWithTransport shall fail and return NULL. ]*/
LogError("unable to determine the IoTHub name");
free(handleData);
result = NULL;
}
else
{
/*Codes_SRS_IOTHUBCLIENT_LL_02_096: [ IoTHubClient_LL_CreateWithTransport shall create the data structures needed to instantiate a IOTHUB_CLIENT_LL_UPLOADTOBLOB_HANDLE. ]*/
char* IoTHubName = malloc(whereIsDot - hostname + 1);
if (IoTHubName == NULL)
{
/*Codes_SRS_IOTHUBCLIENT_LL_02_097: [ If creating the data structures fails or instantiating the IOTHUB_CLIENT_LL_UPLOADTOBLOB_HANDLE fails then IoTHubClient_LL_CreateWithTransport shall fail and return NULL. ]*/
LogError("unable to malloc");
free(handleData);
result = NULL;
}
else
{
const char* IotHubSuffix = whereIsDot + 1;
memcpy(IoTHubName, hostname, whereIsDot - hostname);
IoTHubName[whereIsDot - hostname ] = '\0';
IOTHUB_CLIENT_CONFIG temp;
temp.deviceId = config->deviceId;
temp.deviceKey = config->deviceKey;
temp.deviceSasToken = config->deviceSasToken;
temp.iotHubName = IoTHubName;
temp.iotHubSuffix = IotHubSuffix;
temp.protocol = NULL; /*irrelevant to IoTHubClient_LL_UploadToBlob*/
temp.protocolGatewayHostName = NULL; /*irrelevant to IoTHubClient_LL_UploadToBlob*/
/*Codes_SRS_IOTHUBCLIENT_LL_02_097: [ If creating the data structures fails or instantiating the IOTHUB_CLIENT_LL_UPLOADTOBLOB_HANDLE fails then IoTHubClient_LL_CreateWithTransport shall fail and return NULL. ]*/
handleData->uploadToBlobHandle = IoTHubClient_LL_UploadToBlob_Create(&temp);
if (handleData->uploadToBlobHandle == NULL)
{
/*Codes_SRS_IOTHUBCLIENT_LL_02_096: [ IoTHubClient_LL_CreateWithTransport shall create the data structures needed to instantiate a IOTHUB_CLIENT_LL_UPLOADTOBLOB_HANDLE. ]*/
LogError("unable to IoTHubClient_LL_UploadToBlob_Create");
free(handleData);
result = NULL;
}
else
#endif
{
/*Codes_SRS_IOTHUBCLIENT_LL_02_047: [ IoTHubClient_LL_CreateWithTransport shall create a TICK_COUNTER_HANDLE. ]*/
if ((handleData->tickCounter = tickcounter_create()) == NULL)
{
/*Codes_SRS_IOTHUBCLIENT_LL_02_048: [ If creating the handle fails, then IoTHubClient_LL_CreateWithTransport shall fail and return NULL ]*/
LogError("unable to get a tickcounter");
#ifndef DONT_USE_UPLOADTOBLOB
IoTHubClient_LL_UploadToBlob_Destroy(handleData->uploadToBlobHandle);
#endif
free(handleData);
result = NULL;
}
else
{
/*Codes_SRS_IOTHUBCLIENT_LL_17_004: [IoTHubClient_LL_CreateWithTransport shall initialize a new DLIST (further called "waitingToSend") containing records with fields of the following types: IOTHUB_MESSAGE_HANDLE, IOTHUB_CLIENT_EVENT_CONFIRMATION_CALLBACK, void*.]*/
DList_InitializeListHead(&(handleData->waitingToSend));
handleData->messageCallback = NULL;
handleData->messageUserContextCallback = NULL;
handleData->lastMessageReceiveTime = INDEFINITE_TIME;
IOTHUB_DEVICE_CONFIG deviceConfig;
deviceConfig.deviceId = config->deviceId;
deviceConfig.deviceKey = config->deviceKey;
deviceConfig.deviceSasToken = config->deviceSasToken;
/*Codes_SRS_IOTHUBCLIENT_LL_17_006: [IoTHubClient_LL_CreateWithTransport shall call the transport _Register function with the IOTHUB_DEVICE_CONFIG populated structure and waitingToSend list.]*/
if ((handleData->deviceHandle = handleData->IoTHubTransport_Register(config->transportHandle, &deviceConfig, handleData, &(handleData->waitingToSend))) == NULL)
{
/*Codes_SRS_IOTHUBCLIENT_LL_17_007: [If the _Register function fails, this function shall fail and return NULL.]*/
LogError("Registering device in transport failed");
#ifndef DONT_USE_UPLOADTOBLOB
IoTHubClient_LL_UploadToBlob_Destroy(handleData->uploadToBlobHandle);
#endif
tickcounter_destroy(handleData->tickCounter);
free(handleData);
result = NULL;
}
else
{
/*Codes_SRS_IOTHUBCLIENT_LL_17_005: [IoTHubClient_LL_CreateWithTransport shall save the transport handle and mark this transport as shared.]*/
handleData->isSharedTransport = true;
/*Codes_SRS_IOTHUBCLIENT_LL_02_042: [ By default, messages shall not timeout. ]*/
handleData->currentMessageTimeout = 0;
result = handleData;
}
}
}
#ifndef DONT_USE_UPLOADTOBLOB
free(IoTHubName);
}
}
#endif
}
}
return result;
}