Azure IoT
Microsoft Azure IoTHub client AMQP transport
Dependents: sht15_remote_monitoring RobotArmDemo iothub_client_sample_amqp iothub_client_sample_amqp ... more
This library implements the AMQP transport for Microsoft Azure IoTHub client. The code is replicated from https://github.com/Azure/azure-iot-sdks
iothubtransportamqp.c
- Committer:
- AzureIoTClient
- Date:
- 2015-09-22
- Revision:
- 2:1e6040e0c035
- Parent:
- 0:1b5f413bf328
File content as of revision 2:1e6040e0c035:
// 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>
#ifdef _CRTDBG_MAP_ALLOC
#include <crtdbg.h>
#endif
#include "gballoc.h"
#include "proton/message.h"
#include "proton/messenger.h"
#include "iot_logging.h"
#include "strings.h"
#include "urlencode.h"
#include "doublylinkedlist.h"
#include "crt_abstractions.h"
#include "sastoken.h"
#include "iothub_client_ll.h"
#include "iothub_client_private.h"
#include "iothubtransportamqp.h"
#include "iothub_client_amqp_internal.h"
static const size_t NUMBER_OF_MESSENGER_STOP_TRIES = PROTON_MESSENGER_STOP_TRIES;
static const size_t MAXIMUM_EVENT_LENGTH = PROTON_MAXIMUM_EVENT_LENGTH;
#define amqp_batch_result_values \
amqp_batch_nowork, \
amqp_batch_batch, \
amqp_batch_nobatch, \
amqp_batch_error \
DEFINE_ENUM(amqp_batch_result, amqp_batch_result_values);
static const int IO_PROCESSING_YIELD_IN_MILLISECONDS = PROTON_PROCESSING_YIELD_IN_MILLISECONDS;
static void processReceives(TRANSPORT_HANDLE handle);
typedef struct MESSENGER_CONTAINER_TAG
{
//
// This links all of these records onto the messageCorral in the transport state.
DLIST_ENTRY entry;
//
// This is a messenger that couldn't be stopped. (You have to admire its initiative.) We'll keep trying to stop it when
// we have a spare moment.
pn_messenger_t* messengerThatDidNotStop;
} MESSENGER_CONTAINER, *PMESSENGER_CONTAINER;
//
// Transport specific structure used to contain everything needed to send an event item.
//
typedef struct AMQP_WORK_ITEM_TAG
{
//
// At what time should we give up on sending this message.
size_t expiry;
//
// Used by the transport to determine if the IO operation is complete.
pn_tracker_t tracker;
//
// This acts as a listhead for all of the messages that make up one transfer frame.
// If no batching is being done then this list will have at most one item. If batching
// is being done then this could be lengthy!
DLIST_ENTRY eventMessages;
//
// This is used to hold this work item either on the work in progress list or on the available work item list.
DLIST_ENTRY link;
} AMQP_WORK_ITEM, *PAMQP_WORK_ITEM;
static void rollbackEvent(PAMQP_TRANSPORT_STATE transportState);
static bool checkForErrorsThenWork(PAMQP_TRANSPORT_STATE transportState)
{
pn_error_t* errorStruct;
bool result;
errorStruct = pn_messenger_error(transportState->messenger);
if (pn_error_code(errorStruct) != 0)
{
LogError("An error was detected in the networking manager: %d\r\n", pn_error_code(errorStruct));
transportState->messengerInitialized = false;
result = false;
}
else
{
int protonResult;
protonResult = pn_messenger_work(transportState->messenger, IO_PROCESSING_YIELD_IN_MILLISECONDS);
if ((protonResult < 0) && (protonResult != PN_TIMEOUT))
{
LogError("A networking error occured. Proton error code: %d\r\n", protonResult);
transportState->messengerInitialized = false;
result = false;
}
else
{
result = true;
}
}
return result;
}
/* Code_SRS_IOTHUBTRANSPORTTAMQP_07_001: [All IoTHubMessage_Properties shall be enumerated and entered in the pn_message_properties Map.] */
static int setProperties(PDLIST_ENTRY messagesMakingUpBatch, pn_message_t* msg)
{
int result = 0;
size_t index;
pn_data_t* propData;
const char*const* keys;
const char*const* values;
size_t propertyCount = 0;
IOTHUB_MESSAGE_LIST* currentMessage = containingRecord(messagesMakingUpBatch->Flink, IOTHUB_MESSAGE_LIST, entry);
MAP_HANDLE mapProperties = IoTHubMessage_Properties(currentMessage->messageHandle);
if (mapProperties == NULL)
{
LogError("Failure IoTHubMessage_Properties.\r\n");
result = __LINE__;
}
else if (Map_GetInternals(mapProperties, &keys, &values, &propertyCount) != MAP_OK)
{
LogError("Failure retrieving Map_GetInternals.\r\n");
result = __LINE__;
}
else if (propertyCount > 0)
{
if ( (propData = pn_message_properties(msg) ) == NULL)
{
LogError("Failure pn_message_properties.\r\n");
result = __LINE__;
}
else if (pn_data_put_map(propData) != 0)
{
LogError("Failure pn_data_put_map.\r\n");
result = __LINE__;
}
else if (pn_data_enter(propData) == false )
{
LogError("Failure pn_data_enter.\r\n");
result = __LINE__;
}
else
{
for (index = 0; index < propertyCount; index++)
{
if (pn_data_put_symbol(propData, pn_bytes(strlen(keys[index]), keys[index])) != 0)
{
LogError("Failure pn_data_put_symbol.\r\n");
break;
}
else if (pn_data_put_string(propData, pn_bytes(strlen(values[index]), values[index])) != 0)
{
LogError("Failure pn_data_put_string.\r\n");
break;
}
}
if (index != propertyCount)
{
result = __LINE__;
}
else if (!pn_data_exit(propData) )
{
LogError("Failure pn_data_exit.\r\n");
result = __LINE__;
}
else
{
result = 0;
}
}
}
return result;
}
static int getMapString(pn_data_t* propData, pn_bytes_t* mapValue)
{
int result;
if (pn_data_next(propData) == true)
{
if (pn_data_type(propData) == PN_STRING)
{
*mapValue = pn_data_get_string(propData);
result = 0;
}
else
{
LogError("Failure pn_data_type.\r\n");
result = __LINE__;
}
}
else
{
LogError("Failure pn_data_next.\r\n");
result = __LINE__;
}
return result;
}
static int getMapInt(pn_data_t* propData, int32_t* mapValue)
{
int result;
if (pn_data_next(propData) == true)
{
if (pn_data_type(propData) == PN_INT)
{
*mapValue = pn_data_get_int(propData);
result = 0;
}
else
{
LogError("Failure pn_data_type.\r\n");
result = __LINE__;
}
}
else
{
LogError("Failure pn_data_next.\r\n");
result = __LINE__;
}
return result;
}
/* Code_SRS_IOTHUBTRANSPORTTAMQP_07_002: [On messages the properties shall be retrieved from the message using pn_message_properties and will be entered in the IoTHubMessage_Properties Map.] */
static int cloneProperties(IOTHUB_MESSAGE_HANDLE ioTMessage, pn_message_t* msg)
{
int result = 0;
size_t index = 0;
pn_data_t* propData = pn_message_properties(msg);
if (propData == NULL)
{
LogError("Failure pn_message_properties.\r\n");
result = __LINE__;
}
else if (pn_data_next(propData) == false )
{
// This should fail if there is no next sibling which means that there
// are no property and it should continue
result = 0;
}
else
{
size_t propertyCount = pn_data_get_map(propData)/2;
if (propertyCount > 0)
{
if (pn_data_enter(propData) == false)
{
LogError("Failure pn_data_enter.\r\n");
result = __LINE__;
}
else
{
// Get the Properties from the Message
MAP_HANDLE properties = IoTHubMessage_Properties(ioTMessage);
if (properties == NULL)
{
result = __LINE__;
}
else
{
for (index = 0; index < propertyCount; index++)
{
pn_bytes_t propValue;
pn_bytes_t propName;
if (getMapString(propData, &propValue) != 0)
{
result = __LINE__;
break;
}
if (getMapString(propData, &propName) != 0)
{
result = __LINE__;
break;
}
if (Map_AddOrUpdate(properties, propValue.start, propName.start) != MAP_OK)
{
LogError("Failure Map_AddOrUpdate.\r\n");
result = __LINE__;
break;
}
}
if (index != propertyCount)
{
result = __LINE__;
}
else if (!pn_data_exit(propData) )
{
LogError("Failure pn_data_exit.\r\n");
result = __LINE__;
}
else
{
result = 0;
}
}
}
}
}
return result;
}
static void putSecondListAfterHeadOfFirst(PDLIST_ENTRY first, PDLIST_ENTRY second)
{
DList_AppendTailList(first->Flink, second);
DList_RemoveEntryList(second);
DList_InitializeListHead(second); // Just to be tidy.
}
static bool stopMessenger(pn_messenger_t* messenger)
{
bool succeeded;
int result;
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_021: [Invoke pn_messenger_stop on the messenger.]*/
result = pn_messenger_stop(messenger);
if (result == 0)
{
succeeded = true;
}
else if (result != PN_INPROGRESS)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_023: [If pn_messenger_stop returns any result other than PN_INPROGRESS then place the messenger on a list for attempting to stop later.]*/
succeeded = false;
}
else
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_024: [If pn_messenger_stop returns PN_INPROGRESS invoke pn_messenger_stopped a fixed number of time, seeking a return of true.]*/
size_t numberOfTrys;
succeeded = false;
for (numberOfTrys = NUMBER_OF_MESSENGER_STOP_TRIES; numberOfTrys > 0; numberOfTrys--)
{
pn_messenger_work(messenger,100);
if (pn_messenger_stopped(messenger))
{
succeeded = true;
break;
}
}
}
return succeeded;
}
static void herdTheMessengers(PAMQP_TRANSPORT_STATE state, bool logMessengerStopFailures)
{
PDLIST_ENTRY currentMessengerLink = state->messengerCorral.Flink;
//
// We walk the list of messenger containers. We try to stop each one in turn.
//
// If we are able to stop the contained messenger, we will free the actual messenger. We will then free the messenger container.
//
while (currentMessengerLink != &state->messengerCorral)
{
PDLIST_ENTRY nextLink = currentMessengerLink->Flink;
pn_messenger_t* oldMessenger = containingRecord(currentMessengerLink, MESSENGER_CONTAINER, entry)->messengerThatDidNotStop;
if (stopMessenger(oldMessenger))
{
(void)(DList_RemoveEntryList(currentMessengerLink));
free(containingRecord(currentMessengerLink, MESSENGER_CONTAINER, entry));
pn_messenger_free(oldMessenger);
}
else
{
if (logMessengerStopFailures == true)
{
LogError("Unable to free the messenger at address: %p\r\n", oldMessenger);
}
}
currentMessengerLink = nextLink;
}
}
static void disposeOfOldMessenger(PAMQP_TRANSPORT_STATE state)
{
if (state->messenger)
{
if (stopMessenger(state->messenger))
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_022: [If pn_messenger_stop returns 0 then invoke pn_messenger_free on the messenger.]*/
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_025: [If pn_messenger_stopped returns true, then call pn_messenger_free.]*/
//
// Yay. It successfully stopped.
//
pn_messenger_free(state->messenger);
}
else
{
//
// If we couldn't destroy it, then put it on a list and try to do it later in our "spare" time.
//
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_023: [If pn_messenger_stop returns any result other than PN_INPROGRESS then place the messenger on a list for attempting to stop later.]*/
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_026: [If pn_messenger_stopped never returns true, then place the messenger on a list for attempting to stop later.]*/
PMESSENGER_CONTAINER newContainer = malloc(sizeof(MESSENGER_CONTAINER));
if (newContainer == NULL)
{
//
// Darn! This is not good. These containers are not very big. If we can't allocate one, things are pretty bad.
// However, it doesn't make sense to actually free this messenger. It hasn't been stopped and we can NOT be sure who
// is referencing the memory that it has allocated. The safest thing to do in this very bad situation is to drop
// it on the floor. It's a leak, but a leak is better than anything else. There is a pretty good likelyhood that
// the app is exiting soon. The dropped memory will be cleaned up by exit.
;
}
else
{
newContainer->messengerThatDidNotStop = state->messenger;
DList_InsertTailList(&state->messengerCorral, &newContainer->entry);
}
}
state->messenger = NULL;
}
}
static void clientTransportAMQP_Destroy(TRANSPORT_HANDLE handle)
{
PAMQP_TRANSPORT_STATE transportState = (PAMQP_TRANSPORT_STATE)handle;
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_010: [clientTransportAMQP_Destroy shall do nothing if the handle is NULL.]*/
if (transportState)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_018: [clientTransportAMQP_Destroy shall free all the resources currently in use.]*/
//
// Go through all of the active work items. Complete their associated messages.
//
while (!DList_IsListEmpty(&transportState->workInProgress))
{
PDLIST_ENTRY currentEntry = DList_RemoveHeadList(&transportState->workInProgress);
PAMQP_WORK_ITEM currentItem = containingRecord(currentEntry, AMQP_WORK_ITEM, link);
IoTHubClient_LL_SendComplete(transportState->savedClientHandle, ¤tItem->eventMessages, IOTHUB_BATCHSTATE_FAILED);
DList_InsertTailList(&transportState->availableWorkItems, ¤tItem->link);
}
//
// Get rid of work items that aren't being used, and that should be everything given the above loop!
//
while (!DList_IsListEmpty(&transportState->availableWorkItems))
{
PDLIST_ENTRY currentEntry = DList_RemoveHeadList(&transportState->availableWorkItems);
free(containingRecord(currentEntry, AMQP_WORK_ITEM, link));
}
disposeOfOldMessenger(transportState);
//
// herdTheMessengers will NOT free a messenger that couldn't be stopped. Therefore the following
// function could result in a memory leak of old messengers. This is by FAR less of a problem then
// having memory returned in to pool that something else might still be referring to. (To get all folksy
// here, don't put a sick chicken back in the hen house.)
//
herdTheMessengers(transportState, true);
if (transportState->message)
{
pn_message_free(transportState->message);
}
STRING_delete(transportState->messageAddress);
STRING_delete(transportState->eventAddress);
STRING_delete(transportState->urledDeviceId);
STRING_delete(transportState->devicesPortionPath);
STRING_delete(transportState->cbsAddress);
STRING_delete(transportState->deviceKey);
STRING_delete(transportState->zeroLengthString);
if (transportState->trustedCertificates != NULL)
{
free(transportState->trustedCertificates);
}
free(transportState);
}
}
static int putToken(PAMQP_TRANSPORT_STATE transportState, STRING_HANDLE token)
{
int result = 0;
pn_data_t *properties;
pn_atom_t messageId;
messageId.u.as_ulong = transportState->sendTokenMessageId;
messageId.type = PN_ULONG;
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_130: [putToken clears the single messages that is used for all communication via proton.]*/
pn_message_clear(transportState->message);
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_131: [putToken obtains the properties of the message.]*/
properties = pn_message_properties(transportState->message);
if (properties == NULL)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_132: [If this fails then putToken fails.]*/
LogError("unable to pn_message_properties\r\n");
result = __LINE__;
}
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_133: [putToken constructs a proton map which describes the put token operation. If this construction fails then putToken fails.]*/
else if (!((pn_data_put_map(properties) == 0) &&
(pn_data_enter(properties) == true) &&
(pn_data_put_string(properties, pn_bytes(strlen(PROTON_MAP_OPERATIONS_KEY), PROTON_MAP_OPERATIONS_KEY)) == 0) && // key
(pn_data_put_string(properties, pn_bytes(strlen(PROTON_MAP_PUT_TOKEN_OPERATION), PROTON_MAP_PUT_TOKEN_OPERATION)) == 0) && // value
(pn_data_put_string(properties, pn_bytes(strlen(PROTON_MAP_TYPE_KEY), PROTON_MAP_TYPE_KEY)) == 0) && // key
(pn_data_put_string(properties, pn_bytes(strlen(PROTON_MAP_TOKEN_TYPE), PROTON_MAP_TOKEN_TYPE)) == 0) && // value
(pn_data_put_string(properties, pn_bytes(strlen(PROTON_MAP_NAME_KEY), PROTON_MAP_NAME_KEY)) == 0) && // key
(pn_data_put_string(properties, pn_bytes(STRING_length(transportState->devicesPortionPath), STRING_c_str(transportState->devicesPortionPath))) == 0) && // value
(pn_data_exit(properties))
))
{
LogError("unable to build CBS put token map\r\n");
result = __LINE__;
}
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_134: [putToken sets the address (CBS endpoint) that this put token operation is targeted to.]*/
else if (pn_message_set_reply_to(transportState->message, CBS_REPLY_TO) != 0)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_135: [If this fails then putToken fails.]*/
LogError("unable to pn_message_set_reply_to\r\n");
result = __LINE__;
}
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_136: [putToken sets the reply to address for the put token operation.]*/
else if (pn_message_set_address(transportState->message, STRING_c_str(transportState->cbsAddress)) != 0)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_137: [If this fails then putToken fails.] */
LogError("unable to pn_message_set_address\r\n");
result = __LINE__;
}
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_138: [putToken sets the message to not be inferred.]*/
else if (pn_message_set_inferred(transportState->message, false) != 0)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_139: [If this fails then putToken fails.]*/
LogError("unable to pn_message_set_inferred\r\n");
result = __LINE__;
}
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_140: [putToken sets the messageId of the message to the expiry of the token.]*/
else if (pn_message_set_id(transportState->message, messageId) != 0)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_141: [If this fails then putToken fails.]*/
LogError("Unable to set the message id on the transfer of the token to the CBS\r\n");
result = __LINE__;
}
else
{
pn_data_t* body;
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_142: [putToken obtains the body of the message.]*/
body = pn_message_body(transportState->message);
if (body == NULL)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_143: [If this fails then putToken fails.]*/
LogError("Unable to pn_message_body\r\n");
result = __LINE__;
}
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_144: [putToken places the actual SAS token into the body of the message.]*/
else if (pn_data_put_string(body, pn_bytes(STRING_length(token), STRING_c_str(token))) != 0)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_145: [If this fails then putToken fails.]*/
LogError("Unable to pn_data_put_string\r\n");
result = __LINE__;
}
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_146: [putToken invokes pn_messenger_put.]*/
else if (pn_messenger_put(transportState->messenger, transportState->message) != 0)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_147: [If this fails then putToken fails.]*/
LogError("Unable to pn_messenger_put\r\n");
result = __LINE__;
transportState->messengerInitialized = false;
}
else
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_148: [A proton tracker is obtained.]*/
pn_tracker_t tracker = pn_messenger_outgoing_tracker(transportState->messenger);
time_t beginningOfWaitLoop = get_time(NULL);
time_t currentTime;
result = __LINE__;
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_149: [putToken will loop invoking pn_messenger_work waiting for the message to reach a terminal delivery state.]*/
do
{
int protonResult;
if (checkForErrorsThenWork(transportState) == false)
{
break;
}
else
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_150: [If a terminal delivery state is not reached then putToken fails.]*/
if ((protonResult = pn_messenger_status(transportState->messenger, tracker)) != PN_STATUS_PENDING)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_151: [On reaching a terminal delivery state, if the message status is NOT accepted then putToken fails.]*/
if (protonResult != PN_STATUS_ACCEPTED)
{
LogError("Error sending the token: %s\r\n", pn_error_text(pn_messenger_error(transportState->messenger)));
result = __LINE__;
transportState->messengerInitialized = false;
}
else
{
result = 0;
}
break;
}
}
currentTime = get_time(NULL);
} while (difftime(currentTime, beginningOfWaitLoop) < transportState->cbsRequestAcceptTime);
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_152: [The tracker is settled.]*/
pn_messenger_settle(transportState->messenger, tracker, 0);
if (result == 0)
{
//
// Successfully sent the token. Wait around for a reply.
//
transportState->waitingForPutTokenReply = true;
beginningOfWaitLoop = get_time(NULL);
result = __LINE__;
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_153: [putToken will again loop waiting for a reply.]*/
do
{
processReceives(transportState);
if (transportState->waitingForPutTokenReply == true)
{
if (checkForErrorsThenWork(transportState) == false)
{
break;
}
}
else
{
result = 0;
break;
}
currentTime = get_time(NULL);
} while (difftime(currentTime, beginningOfWaitLoop) < transportState->cbsReplyTime);
}
else
{
LogError("An network error occured while waiting for a CBS reply.\r\n");
transportState->messengerInitialized = false;
}
}
}
pn_message_clear(transportState->message);
return result;
}
static void renewIfNecessaryTheCBS(PAMQP_TRANSPORT_STATE transportState)
{
//
// There is an expiry stored in the state. It has the last expiry value used to define a
// sas token. If we are within 20 minutes OR we're PAST that expiration generate a new
// expiry time and create a new sas token and "put" it to the cbs.
//
size_t secondsSinceEpoch;
int differenceWithLastExpiry;
transportState->putTokenWasSuccessful = false;
//
// Get the number of seconds since the epoch.
//
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_163: [Invocation of renewIfNecessaryTheCBS will first obtain the current number of seconds since the epoch.*/
secondsSinceEpoch = (size_t)(difftime(get_time(NULL), EPOCH_TIME_T_VALUE)+0); // adding zero because a compiler feels it's necessary.
differenceWithLastExpiry = transportState->lastExpiryUsed - secondsSinceEpoch;
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_164: [If the difference between lastExpiryUsed and the current value is less than refresh seconds then renewIfNecessaryTheCBS will attempt to renew the SAS.]*/
if ((differenceWithLastExpiry <= 0) ||
(((size_t)differenceWithLastExpiry) < transportState->sasRefreshLine)) // Within refresh minutes (or past if negative) of the expiration
{
//
// We already have the seconds since the epoch. Add an hour to it and generate the new SAS.
//
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_165: [If SAS renewal is to occur then lifetime seconds is added to the current number of seconds.]*/
size_t possibleNewExpiry = secondsSinceEpoch + transportState->sasTokenLifetime;
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_169: [SASToken_Create is invoked.] */
STRING_HANDLE newSASToken = SASToken_Create(transportState->deviceKey, transportState->devicesPortionPath, transportState->zeroLengthString, possibleNewExpiry);
if (newSASToken == NULL)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_170: [If SASToken_Create returns NULL then renewal is considered a failure and we move on to the next phase of DoWork.]*/
LogError("Could not generate a new SAS token for the CBS\r\n");
}
else
{
//
// We are going to save off in the transport state this POSSIBLE expiry value. Sending token and response processing code
// will use it as the message id and correlation id for the request/response. This will work
// because the code that sends the token will wait for AT LEAST one second for a valid response. If a valid response comes
// back in that period of time then even if for some bizarre reason we need to renew again in less than a second, we know
// there won't be a spurious response (because we just got the resonse!).
//
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_166: [This value is saved in the state as sendTokenMessageId.]*/
transportState->sendTokenMessageId = possibleNewExpiry;
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_171: [renewIfNecessaryTheCBS will invoke a local static function putToken.]*/
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_172: [If putToken fails then the renewal is considered a failure and we move on to the next phase of DoWork.]*/
if (putToken(transportState, newSASToken) == 0)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_173: [Note that putToken actually sets a state value which will indicate whether the CBS accepted the token and responded with success.]*/
if (transportState->putTokenWasSuccessful == true)
{
transportState->lastExpiryUsed = possibleNewExpiry;
}
}
STRING_delete(newSASToken);
}
}
}
static bool protonMessengerInit(PAMQP_TRANSPORT_STATE amqpState)
{
if (!amqpState->messengerInitialized)
{
rollbackEvent(amqpState);
disposeOfOldMessenger(amqpState);
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_027: [DoWork shall invoke pn_messenger to create a new messenger.]*/
if ((amqpState->messenger = pn_messenger(NULL)) == NULL)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_028: [If pn_messenger returns NULL then the messenger initialization fails.]*/
LogError("The messenger is not able to be created.\r\n");
}
/* Codes_SRS_IOTHUBTRANSPORTTAMQP_01_001: [If the option "TrustedCerts" has been set (length greater than 0), the trusted certificates string shall be passed to Proton by a call to pn_messenger_set_trusted_certificates.] */
else if ((amqpState->trustedCertificates != NULL) &&
(strlen(amqpState->trustedCertificates) > 0) &&
(pn_messenger_set_trusted_certificates(amqpState->messenger, amqpState->trustedCertificates) != 0))
{
/* Codes_SRS_IOTHUBTRANSPORTTAMQP_01_002: [If pn_messenger_set_trusted_certificates fails, then messenger initialization shall fail.] */
LogError("unable to pass certificate information via pn_messenger_set_trusted_certificates\r\n");
}
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_029: [pn_messenger_start shall be invoked.]*/
else if (pn_messenger_start(amqpState->messenger) != 0)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_030: [If pn_messenger_start returns a non-zero value then messenger initialization fails.]*/
LogError("unable to pn_messenger_start\r\n");
}
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_031: [pn_messenger_set_blocking shall be invoked.]*/
else if (pn_messenger_set_blocking(amqpState->messenger, false) != 0)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_032: [If pn_messenger_set_blocking returns a non-zero value then messenger initialization fails.]*/
LogError("unable to pn_messenger_set_blocking\r\n");
}
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_033: [pn_messenger_set_snd_settle_mode shall be invoked.]*/
else if (pn_messenger_set_snd_settle_mode(amqpState->messenger, PN_SND_UNSETTLED) != 0)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_034: [If pn_messenger_set_snd_settle_mode returns a non-zero value then messenger initialization fails.]*/
LogError("unable to set the send settle mode\r\n");
}
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_035: [pn_messenger_set_rcv_settle_mode shall be invoked.]*/
else if (pn_messenger_set_rcv_settle_mode(amqpState->messenger, PN_RCV_FIRST) != 0)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_036: [If pn_messenger_set_rcv_settle_mode returns a non-zero value then messenger initialization fails.]*/
LogError("unable to set the receive settle mode\r\n");
}
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_037: [pn_messenger_set_outgoing_window shall be invoked.]*/
else if (pn_messenger_set_outgoing_window(amqpState->messenger, PROTON_OUTGOING_WINDOW_SIZE) != 0)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_038: [If pn_messenger_set_outgoing_window returns a non-zero value then messenger initialization fails.]*/
LogError("unable to pn_messenger_set_outgoing_window\r\n");
}
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_039: [pn_messenger_set_incoming_window shall be invoked.]*/
else if (pn_messenger_set_incoming_window(amqpState->messenger, PROTON_INCOMING_WINDOW_SIZE) != 0)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_040: [If pn_messenger_set_incoming_window returns a non-zero value then messenger initialization fails.]*/
LogError("unable to pn_messenger_set_incoming_window\r\n");
}
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_156: [pn_messenger_subscribe will be invoked on the cbs address.]*/
else if ((amqpState->cbsSubscription = pn_messenger_subscribe(amqpState->messenger, (const char*)STRING_c_str(amqpState->cbsAddress))) == NULL)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_157: [If the pn_messenger_subscribe returns a non-zero value then messenger initialization fails.]*/
LogError("unable to create a subscription to the cbs address\r\n");
}
else
{
//We've got the subscription. Now we attempt to connect to the cbs.
/*Codes_During messenger initialization a state variable known as lastExpiryUsed will be set to zero.*/
amqpState->lastExpiryUsed = 0;
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_159: [renewIfNecessaryCBS will be invoked.]*/
renewIfNecessaryTheCBS(amqpState);
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_160: [If after renewIfNecessaryCBS is invoked, the state variable putTokenWasSuccessful is false then the messenger initialization fails.]*/
if (amqpState->putTokenWasSuccessful == true)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_041: [pn_messenger_subscribe shall be invoked.]*/
if ((amqpState->messageSubscription = pn_messenger_subscribe(amqpState->messenger, (const char*)STRING_c_str(amqpState->messageAddress))) == NULL)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_042: [If pn_messenger_subscribe returns a non-zero value then messenger initialization fails.]*/
LogError("unable to create a subscription to the message address\r\n");
}
else
{
amqpState->messengerInitialized = true;
}
}
}
}
return amqpState->messengerInitialized;
}
static amqp_batch_result prepareBatch(size_t maximumPayload, PDLIST_ENTRY waitingToSend, PDLIST_ENTRY messagesMakingUpBatch, size_t* payloadSize, const unsigned char** payload)
{
amqp_batch_result result;
if (DList_IsListEmpty(waitingToSend))
{
result = amqp_batch_nowork;
}
else
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_074: [If there is a waitingToSend entry remove it from the list.]*/
IOTHUB_MESSAGE_LIST* currentMessage;
IOTHUBMESSAGE_CONTENT_TYPE contentType;
size_t messageLength;
const unsigned char* messagePayload;
DList_InitializeListHead(messagesMakingUpBatch);
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_086: [If the pn_messenger_put succeeds then DoWork will save off a tracker obtained by invoking pn_messenger_outgoing_tracker and save it the head of the availableWorkItems. The eventMessages in the AMQP_WORK_ITEM head will also contain the IOTHUB_MESSAGE_LIST.]*/
DList_InsertTailList(messagesMakingUpBatch, DList_RemoveHeadList(waitingToSend));
currentMessage = containingRecord(messagesMakingUpBatch->Flink, IOTHUB_MESSAGE_LIST, entry);
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_075: [Get its size and payload address by calling IoTHubMessage_GetByteArray.]*/
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_02_008: [If the message type is IOTHUBMESSAGE_STRING then get the data by using IoTHubMesage_GetString and set the size to the length of the string.] */
contentType = IoTHubMessage_GetContentType(currentMessage->messageHandle);
if (!(
((contentType == IOTHUBMESSAGE_BYTEARRAY) && (IoTHubMessage_GetByteArray(currentMessage->messageHandle, &messagePayload, &messageLength) == IOTHUB_MESSAGE_OK)) ||
((contentType == IOTHUBMESSAGE_STRING) && (
messagePayload = (const unsigned char*)IoTHubMessage_GetString(currentMessage->messageHandle),
(messageLength = (messagePayload == NULL) ? 0 : strlen((const char*)messagePayload)),
messagePayload != NULL)
)
))
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_076: [If that fails then fail that event.]*/
LogError("Failure in getting message content. Type had decimal value = %d\r\n", contentType);
result = amqp_batch_error;
}
else if (messageLength > maximumPayload)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_077: [If the size of the payload is greater than the maximum (currently 256*1024) fail that event.]*/
LogError("Batch length is too large.\r\n");
result = amqp_batch_error;
}
else
{
*payloadSize = messageLength;
*payload = messagePayload;
result = amqp_batch_nobatch;
}
}
return result;
}
static bool prepareSimpleProtonMessage(pn_message_t* message, STRING_HANDLE endpoint, size_t payloadLength, const unsigned char* payload)
{
bool result = false;
pn_data_t * body;
pn_message_clear(message);
if (pn_message_set_address(message, STRING_c_str(endpoint)) != 0)
{
LogError("Unable to set amqp address for proton message.\r\n");
}
else if (pn_message_set_inferred(message, true) != 0)
{
LogError("Unable to set inferred to true for proton message.\r\n");
}
else if ((body = pn_message_body(message)) == NULL)
{
LogError("Unable to set proton message body.\r\n");
}
else if (pn_data_put_binary(body, pn_bytes(payloadLength, (const char*)payload)) != 0)
{
LogError("Unable to set binary data for message body.\r\n");
}
else
{
result = true;
}
return result;
}
static void rollbackEvent(PAMQP_TRANSPORT_STATE transportState)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_175: [The list of work in progress is tested to see if it is empty.]*/
while (!DList_IsListEmpty(&transportState->workInProgress))
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_176: [If it is not empty then the list is traversed.]*/
int settleResult;
int protonResult;
PDLIST_ENTRY newestEntry = transportState->workInProgress.Blink;
PAMQP_WORK_ITEM currentWork = containingRecord(newestEntry, AMQP_WORK_ITEM, link);
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_179: [The status of the work item is acquired.]*/
protonResult = pn_messenger_status(transportState->messenger, currentWork->tracker);
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_180: [The item is settled.]*/
if ((settleResult = pn_messenger_settle(transportState->messenger, currentWork->tracker, 0)) != 0)
{
LogError("Attempt to settle a tracker produced an error: %d\r\n", settleResult);
}
if ((protonResult == PN_STATUS_ACCEPTED) ||
(protonResult == PN_STATUS_REJECTED) ||
(protonResult == PN_STATUS_RELEASED))
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_182: [Items that have been settled by the service will have their IOTHUB_MESSAGE_LIST completed.]*/
IoTHubClient_LL_SendComplete(transportState->savedClientHandle, ¤tWork->eventMessages, (protonResult == PN_STATUS_ACCEPTED) ? IOTHUB_BATCHSTATE_SUCCESS : IOTHUB_BATCHSTATE_FAILED);
}
else
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_178: [Items that are not settled by the service will have their IOTHUB_MESSAGE_LIST removed from the work item and placed back on the waiting to send.]*/
putSecondListAfterHeadOfFirst(transportState->waitingToSend->Flink, ¤tWork->eventMessages);
}
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_181: [The work item is removed from the in progress list and placed on the available list.]*/
DList_RemoveEntryList(newestEntry);
DList_InsertTailList(&transportState->availableWorkItems, newestEntry);
}
}
static void reclaimEventResources(PAMQP_TRANSPORT_STATE transportState)
{
PDLIST_ENTRY currentListEntry;
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_064: [Obtain the head of the workInProgress]*/
currentListEntry = transportState->workInProgress.Flink;
while (currentListEntry != &transportState->workInProgress)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_065: [While head != listhead reclaimEventResources will do as follows.] */
int protonResult;
PAMQP_WORK_ITEM currentWork = containingRecord(currentListEntry, AMQP_WORK_ITEM, link);
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_066: [Check the current status via pn_messenger_status via the tracker stored in the AMQP_WORK_ITEM.]*/
if ((protonResult = pn_messenger_status(transportState->messenger, currentWork->tracker)) == PN_STATUS_PENDING)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_183: [if the amount of time that the work item has been pending exceeds a timeout stored in the work item, the messenger will be marked as not initialized.]*/
size_t secondsSinceTheEpoch = (size_t)(difftime(get_time(NULL), EPOCH_TIME_T_VALUE) + 0);
if (currentWork->expiry < secondsSinceTheEpoch)
{
LogError("A event operation timed out.\r\n");
transportState->messengerInitialized = false;
}
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_067: [reclaimEventResources shall go onto the next work item if the proton status is PN_STATUS_PENDING.]*/
currentListEntry = currentListEntry->Flink;
}
else
{
DLIST_ENTRY savedFromCurrentListEntry;
int settleResult;
// Yay! It's finished. Take it off the in progress list.
savedFromCurrentListEntry.Flink = currentListEntry->Flink; // We need to save this because it will be stomped on when we remove it from the work in progress.
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_068: [Otherwise reclaimEventResources will use the result of IOTHUB_BATCHSTATE_SUCCESS if the proton status was PN_STATUS_ACCEPTED.]*/
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_069: [Otherwise reclaimEventResources will use the status of IOTHUB_BATCHSTATE_FAILED if the proton status was NOT PN_STATUS_ACCEPTED.] */
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_070: [reclaimEventResources will invoke IotHubClient_SendBatchComplete with the IOTHUB_CLIENT_LL_HANDLE, supplied to reclaimEventResources, also pass the eventMessages stored in the AMQP_WORK_ITEM, and finally pass the above IOTHUB_BATCH status.]*/
IoTHubClient_LL_SendComplete(transportState->savedClientHandle, ¤tWork->eventMessages, (protonResult == PN_STATUS_ACCEPTED) ? IOTHUB_BATCHSTATE_SUCCESS : IOTHUB_BATCHSTATE_FAILED);
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_090: [reclaimEventResources will release the tracker by invoking pn_messenger_settle.]*/
if ((settleResult = pn_messenger_settle(transportState->messenger, currentWork->tracker, 0)) != 0)
{
LogError("Attempt to settle a tracker produced an error: %d\r\n", settleResult);
}
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_071: [reclaimEventResources will take the current work item from the workInProgress list and insert it on the tail of the availableWorkItems list.]*/
DList_RemoveEntryList(currentListEntry);
DList_InsertTailList(&transportState->availableWorkItems, currentListEntry);
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_072: [reclaimEventResources will continue to iterate over the workInProgress list until it returns to the list head.]*/
currentListEntry = savedFromCurrentListEntry.Flink;
}
}
}
static void sendEvent(PAMQP_TRANSPORT_STATE transportState)
{
while (!DList_IsListEmpty(&transportState->availableWorkItems))
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_073: [While the availableWorkItems is NOT empty loop.] */
PAMQP_WORK_ITEM headOfAvailable = containingRecord(transportState->availableWorkItems.Flink, AMQP_WORK_ITEM, link);
size_t payloadSize;
const unsigned char* payloadAddress;
amqp_batch_result amqpBatchResult;
amqpBatchResult = prepareBatch(MAXIMUM_EVENT_LENGTH, transportState->waitingToSend, &headOfAvailable->eventMessages, &payloadSize, &payloadAddress);
if (amqpBatchResult == amqp_batch_nowork)
{
// no work to do. Stop trying.
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_089: [If there is nothing on the list then go on to the message.]*/
break;
}
else if (amqpBatchResult == amqp_batch_error)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_078: [If the event failed call invoke IotHubClient_SendBatchComplete as above utilizing the eventMessages list of the head of the availableWorkItems and a status of IOTHUB_BATCHSTATE_FAILED.]*/
IoTHubClient_LL_SendComplete(transportState->savedClientHandle, &headOfAvailable->eventMessages, IOTHUB_BATCHSTATE_FAILED);
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_079: [Continue this send loop.]*/
}
else
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_080: [If the event did not fail then prepare a proton message using the following proton API: pn_message_set_address, pn_message_set_inferred, pn_message_body and pn_data_put_binary with the above saved size and address values.]*/
if (prepareSimpleProtonMessage(transportState->message, transportState->eventAddress, payloadSize, payloadAddress) == false)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_081: [sendEvent will take the item that had been the head of the waitingToSend and put it back at the head of the waitingToSend list.]*/
putSecondListAfterHeadOfFirst(transportState->waitingToSend, &headOfAvailable->eventMessages);
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_082: [sendEvent will then break out of the send loop.]*/
break;
}
else if (setProperties(&headOfAvailable->eventMessages, transportState->message) != 0)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_081: [sendEvent will take the item that had been the head of the waitingToSend and put it back at the head of the waitingToSend list.]*/
putSecondListAfterHeadOfFirst(transportState->waitingToSend, &headOfAvailable->eventMessages);
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_082: [sendEvent will then break out of the send loop.]*/
break;
}
else
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_083: [If the proton API is successful then invoke pn_messenger_put.]*/
int protonResult;
protonResult = pn_messenger_put(transportState->messenger, transportState->message);
if (protonResult != 0)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_084: [If that fails, sendEvent will take the item that had been the head of the waitingToSend and put it back at the head of the waitingToSend list.]*/
putSecondListAfterHeadOfFirst(transportState->waitingToSend, &headOfAvailable->eventMessages);
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_085: [sendEvent will then break out of the send loop.]*/
transportState->messengerInitialized = false;
break;
}
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_184: [The work item will also contain a timeout that shall denote how long the transport will wait before initiating error recovery.]*/
headOfAvailable->expiry = (size_t)(difftime(get_time(NULL), EPOCH_TIME_T_VALUE) + transportState->eventTimeout);
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_086: [If the pn_messenger_put succeeds then sendEvent will save off a tracker obtained by invoking pn_messenger_outgoing_tracker and save it the head of the availableWorkItems. The eventMessages in the AMQP_WORK_ITEM head will also contain the IOTHUB_MESSAGE_LIST.]*/
headOfAvailable->tracker = pn_messenger_outgoing_tracker(transportState->messenger);
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_087: [The head of the availableWorkItems will be removed and placed on the workInProgress list.]*/
DList_InsertTailList(&transportState->workInProgress, DList_RemoveHeadList(&transportState->availableWorkItems));
}
}
}
}
static void processCBSReply(PAMQP_TRANSPORT_STATE transportState, pn_tracker_t tracker)
{
bool goodMessage = false;
pn_atom_t correlationId;
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_112: [The correlationId message property is obtained via a call to pn_message_get_correlation_id.]*/
correlationId = pn_message_get_correlation_id(transportState->message);
//
// If it isn't the one we're looking for, simply accept it, because we don't want to see it and we can't do anything with it.
//
if (correlationId.u.as_ulong != transportState->sendTokenMessageId)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_113: [The id is compared to the state variable sendTokenMessageId. If there is no match, an error is logged, the message is abandoned and processCBSReply returns.]*/
LogError("An old reply from a CBS renewal drifed in. Moving on\r\n");
}
else
{
//
// This is the response we're looking for!
//
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_114: [Obtain the properties of the message by invoking pn_message_properties.]*/
pn_data_t* propertyData = pn_message_properties(transportState->message);
transportState->waitingForPutTokenReply = false;
if (propertyData == NULL)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_115: [If NULL then abandon the message and return.]*/
LogError("Invalid response back from the CBS - no application properties\r\n");
}
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_116: [Advance to the first property of the message via pn_data_next.]*/
else if (pn_data_next(propertyData) == false)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_117: [If this fails, abandon and return.]*/
LogError("Invalid response back from the CBS - application properties malformed\r\n");
}
else
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_118: [Invoke pn_data_get_map to obtain the number of properties.]*/
size_t numberOfProperties = pn_data_get_map(propertyData) / 2;
if (numberOfProperties < 1) // We MUST have at least the status property
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_119: [If the number of properties is 0 then abandon and return.]*/
LogError("Invalid response back from the CBS - invalid number of properties: %zu\r\n", pn_data_get_map(propertyData));
}
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_120: [Enter the property map by invoking pn_data_enter.]*/
else if (pn_data_enter(propertyData) == false)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_121: [If that fails then abandon and return.]*/
LogError("Invalid response back from the CBS - unable to access the sent properties\r\n");
}
else
{
pn_bytes_t propertyName;
int32_t resultStatus;
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_122: [Get the property name.]*/
if (getMapString(propertyData, &propertyName) != 0)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_123: [If that fails then abandon and return.]*/
LogError("Unable to acquire the status value from the cbs request\r\n");
}
else if (strcmp(propertyName.start, PROTON_MAP_STATUS_CODE) != 0)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_124: [If the property name is not "status-code" than abandon and return.]*/
LogError("Unknown application property returned: %s\r\n", propertyName.start);
}
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_125: [Get the actual status code.]*/
else if (getMapInt(propertyData, &resultStatus) != 0)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_126: [If that fails then abandon and return.]*/
LogError("Unable to acquire the actual status of the CBS put token\r\n");
}
else if (resultStatus != 200)
{
pn_bytes_t statusDescription;
//
// Yeah, it's not what we want to hear but it's not as though anything was wrong with
// the message.
//
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_127: [If the status code is not equal to 200 then attempt to acquire the explanation from the properties.]*/
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_128: [Accept the message and return.]*/
goodMessage = true;
LogError("The CBS put token operation failed: %d\r\n", resultStatus);
if (numberOfProperties >= 2)
{
//
// Well we have an error. See if the next property is the status description.
// If it is, then log the value as further explanation
//
if (getMapString(propertyData, &propertyName) == 0)
{
if (strcmp(propertyName.start, PROTON_MAP_STATUS_DESCRIPTION) == 0)
{
if (getMapString(propertyData, &statusDescription) == 0)
{
LogError("The CBS put token operation failed due to: %s\r\n", statusDescription.start);
}
}
}
}
}
else
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_129: [If the status code was 200 then set the state variable putTokenWasSuccessful, accept the message and return.]*/
goodMessage = true;
transportState->putTokenWasSuccessful = true;
}
}
}
}
if (goodMessage == true)
{
pn_messenger_accept(transportState->messenger, tracker, 0);
}
else
{
pn_messenger_release(transportState->messenger, tracker, 0);
}
pn_messenger_settle(transportState->messenger, tracker, 0);
}
static void processMessage(PAMQP_TRANSPORT_STATE transportState, pn_tracker_t tracker)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_111: [If the state variable DoWork_PullMessage is false then the message shall be rejected and processMessage shall return.]*/
if (transportState->DoWork_PullMessages == false)
{
//
// Nothing to do with the message. We reject it. In that way it can come back later.
//
pn_messenger_reject(transportState->messenger, tracker, 0);
pn_messenger_settle(transportState->messenger, tracker, 0);
}
else
{
pn_data_t *body;
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_050: [processMessage will acquire the body of the message by invoking pn_message_body.]*/
if ((body = pn_message_body(transportState->message)) == NULL)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_051: [If the body is NULL then the message will be abandoned.]*/
LogError("Failed to get the proton message body\r\n");
pn_messenger_release(transportState->messenger, tracker, 0);
pn_messenger_settle(transportState->messenger, tracker, 0);
}
else
{
pn_bytes_t sizeAndData;
bool keepProcessingThisMessage = true;
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_054: [processMessage will check for a null (note the lowercase) body by invoking pn_data_next.]*/
if (pn_data_next(body) == false)
{
//
// We have a null body. This is reasonable. It should also be pointed out that
// pn_data_next call shouldn't be thought of as checking for the existence of something.
// It should be thought of as actually MOVING through a tree structure in the message.
//
sizeAndData.size = 0;
sizeAndData.start = NULL;
}
else
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_055: [If the body is NOT null then processMessage will check that the body is of type PN_BINARY.]*/
if (PN_BINARY != pn_data_type(body))
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_056: [processMessage will abandon the message with body types that are NOT PN_BINARY, the IOTHUB_MESSAGE_HANDLE will be destroyed and the loop will be continued.]*/
LogError("Message received via AMQP was not PN_BINARY\r\n");
sizeAndData.size = 0; // Compilers get upset.
sizeAndData.start = NULL;
pn_messenger_release(transportState->messenger, tracker, 0);
pn_messenger_settle(transportState->messenger, tracker, 0);
keepProcessingThisMessage = false;
}
else
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_057: [The length and a pointer to the payload will be acquired and saved by invoking pn_data_get_binary.]*/
sizeAndData = pn_data_get_binary(body);
}
}
if (keepProcessingThisMessage == true)
{
IOTHUB_MESSAGE_HANDLE ioTMessage;
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_058: [The IOTHUB_MESSAGE_HANDLE will be set by invoking IotHubMessage_SetData with the previously saved length and pointer to payload.]*/
if ((ioTMessage = IoTHubMessage_CreateFromByteArray((const unsigned char*)sizeAndData.start, sizeAndData.size)) == NULL)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_059: [processMessage will abandon the message if IotHubMessage_SetData returns any status other than IOTHUB_MESSAGE_OK.]*/
LogError("Failed to set data for IoT hub message\r\n");
pn_messenger_release(transportState->messenger, tracker, 0);
pn_messenger_settle(transportState->messenger, tracker, 0);
}
else if (cloneProperties(ioTMessage, transportState->message) != 0)
{
LogError("Failed to set data for IoT hub message\r\n");
pn_messenger_release(transportState->messenger, tracker, 0);
pn_messenger_settle(transportState->messenger, tracker, 0);
}
else
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_060: [If IOTHUB_MESSAGE_OK had been returned IoTHubClient_LL_MessageCallback will be invoked with the IOTHUB_MESSAGE_HANDLE.]*/
IOTHUBMESSAGE_DISPOSITION_RESULT upperLayerDisposition = IoTHubClient_LL_MessageCallback(transportState->savedClientHandle, ioTMessage);
if (upperLayerDisposition == IOTHUBMESSAGE_ACCEPTED)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_02_006: [If IoTHubClient_MessageCallback returns IOTHUBMESSAGE_ACCEPTED value then the message will be accepted.] */
pn_messenger_accept(transportState->messenger, tracker, 0);
}
else if (upperLayerDisposition == IOTHUBMESSAGE_ABANDONED)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_02_007: [If IoTHubClient_MessageCallback returns IOTHUBMESSAGE_ABANDONED value then the message will be abandoned.] */
pn_messenger_release(transportState->messenger, tracker, 0);
}
else
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_061: [If IoTHubClient_MessageCallback returns IOTHUBMESSAGE_REJECTED value then the message will be rejected.]*/
pn_messenger_reject(transportState->messenger, tracker, 0);
}
pn_messenger_settle(transportState->messenger, tracker, 0);
}
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_063: [processMessage will destroy the IOTHUB_MESSAGE_HANDLE by invoking IoTHubMessage_Destroy.]*/
IoTHubMessage_Destroy(ioTMessage);
}
}
}
}
static void processReceives(TRANSPORT_HANDLE handle)
{
PAMQP_TRANSPORT_STATE transportState = (PAMQP_TRANSPORT_STATE)handle;
int receiveResult;
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_043: [If DoWork_PullMessage is false then DoWork will cancel any preceding messages by invoking pn_messenger_recv.]*/
if ((transportState->DoWork_PullMessages == false) && (transportState->waitingForPutTokenReply == false))
{
if ((receiveResult = pn_messenger_recv(transportState->messenger, 0)) != 0)
{
if ((receiveResult != PN_INPROGRESS) && (receiveResult != PN_TIMEOUT))
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_046: [If pn_messenger_recv fails it will be logged.]*/
LogError("Error attempting to receive messages: %d\r\n", receiveResult);
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_105: [processReceives will then go on to the next action of DoWork.]*/
transportState->messengerInitialized = false;
}
}
}
else
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_044: [If the DoWork_PullMessage or the waitingForPutTokenReply flag is true then processReceives will pull messages with pn_messenger_recv.]*/
if ((receiveResult = pn_messenger_recv(transportState->messenger, PROTON_INCOMING_WINDOW_SIZE)) != 0)
{
if ((receiveResult != PN_INPROGRESS) && (receiveResult != PN_TIMEOUT))
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_046: [If pn_messenger_recv fails it will be logged.]*/
LogError("Error attempting to receive messages: %d\r\n", receiveResult);
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_105: [processReceives will then go on to the next action of DoWork.]*/
transportState->messengerInitialized = false;
}
}
else
{
//
// If any are present we need to dispose of messages in the incoming queue.
//
size_t depthOfReceiveQueue;
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_045: [processReceives will check the number of messages received by invoking pn_messenger_incoming.]*/
for (depthOfReceiveQueue = pn_messenger_incoming(transportState->messenger); depthOfReceiveQueue > 0; depthOfReceiveQueue--)
{
int result;
pn_message_clear(transportState->message);
//
// Ok something is there. First thing is to get it.
//
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_047: [processReceives will retrieve a message with pn_messenger_get.]*/
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_048: [If pn_messenger_get fails we log and break the receive loop.]*/
if ((result = pn_messenger_get(transportState->messenger, transportState->message)) != 0)
{
//
// Well that's pretty odd. We shouldn't have gotten here if the message queue was empty!
//
LogError("Message reception queue unexpectedly empty! Code: %d\r\n", result);
break;
}
else
{
//
// We'll need a tracker to dispose of the message. We need the subscription to determine who should process it.
//
pn_subscription_t* theMessageSource;
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_049: [processReceives shall acquire a tracker by invoking pn_messenger_incoming_tracker.]*/
pn_tracker_t tracker = pn_messenger_incoming_tracker(transportState->messenger);
//
// Currently we can receive two types of messages. We can recieve status messages from the $CBS that indicates the success
// or failure of renewing the SAS for the device.
//
// Otherwise we can recieve a simple message. We can get a pointer to the subscription from the tracker. We can compare
// that pointer to the subscriptions that we stored when we initialized the messenger. We then dispatch appropriately.
//
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_106: [processReceives acquires the subscription of the message by invoking pn_messneger_incoming_subscription.] This value is henceforth known as theMessageSource.*/
theMessageSource = pn_messenger_incoming_subscription(transportState->messenger);
if (theMessageSource == transportState->messageSubscription)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_108: [If theMessageSource is equal to the state variable cbsSubscription invoke processCBSReply.]*/
processMessage(transportState, tracker);
}
else if (theMessageSource == transportState->cbsSubscription)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_108: [If theMessageSource is equal to the state variable cbsSubscription invoke processCBSReply.]*/
processCBSReply(transportState, tracker);
}
else
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_109: [Otherwise, log an error and abandon the message so that it never returns.]*/
LogError("Message received from an unknown sender\r\n");
pn_messenger_release(transportState->messenger, tracker, 0);
pn_messenger_settle(transportState->messenger, tracker, 0);
}
}
}
pn_message_clear(transportState->message);
}
}
}
static void clientTransportAMQP_DoWork(TRANSPORT_HANDLE handle, IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle)
{
PAMQP_TRANSPORT_STATE transportState = (PAMQP_TRANSPORT_STATE)handle;
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_019: [clientTransportAMQP_Dowork shall do no work if handle is NULL.]*/
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_020: [clientTransportAMQP_Dowork shall do no work if iotHubClientHandle is NULL.]*/
if (transportState && iotHubClientHandle)
{
transportState->savedClientHandle = iotHubClientHandle;
if (protonMessengerInit(transportState))
{
renewIfNecessaryTheCBS(transportState);
if (transportState->messengerInitialized == true) reclaimEventResources(transportState);
if (transportState->messengerInitialized == true) sendEvent(transportState);
if (transportState->messengerInitialized == true) processReceives(transportState);
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_088: [pn_messenger_work shall be invoked following all the above actions.]*/
if (transportState->messengerInitialized == true) checkForErrorsThenWork(transportState);
}
//
// Try to get rid of any old messengers that we were NOT able to stop.
//
herdTheMessengers(transportState, false);
}
return;
}
static bool createUrledDeviceId(PAMQP_TRANSPORT_STATE state, const IOTHUBTRANSPORT_CONFIG* config)
{
return ((state->urledDeviceId = URL_EncodeString(config->upperConfig->deviceId)) == NULL) ? (false) : (true);
}
static bool createDevicesPortionPath(PAMQP_TRANSPORT_STATE state, const char* host)
{
return (((state->devicesPortionPath = STRING_construct(host)) == NULL) ||
(STRING_concat(state->devicesPortionPath, "/devices/") != 0) ||
(STRING_concat_with_STRING(state->devicesPortionPath, state->urledDeviceId) != 0)) ? (false) : (true);
}
static bool createEventAddress(PAMQP_TRANSPORT_STATE state)
{
return (((state->eventAddress = STRING_construct(AMQPS_SCHEME)) == NULL) ||
(STRING_concat_with_STRING(state->eventAddress, state->devicesPortionPath) != 0) ||
(STRING_concat(state->eventAddress, EVENT_ENDPOINT) != 0)) ? (false) : (true);
}
static bool createMessageAddress(PAMQP_TRANSPORT_STATE state)
{
return (((state->messageAddress = STRING_construct(AMQPS_SCHEME)) == NULL) ||
(STRING_concat_with_STRING(state->messageAddress, state->devicesPortionPath) != 0) ||
(STRING_concat(state->messageAddress, MESSAGE_ENDPOINT) != 0)) ? (false) : (true);
}
static bool createCbsAddress(PAMQP_TRANSPORT_STATE state, const char* host)
{
return (((state->cbsAddress = STRING_construct(AMQPS_SCHEME)) == NULL) ||
(STRING_concat(state->cbsAddress,host) != 0) ||
(STRING_concat(state->cbsAddress, CBS_ENDPOINT) != 0)) ? (false) : (true);
}
static STRING_HANDLE createHost(const IOTHUBTRANSPORT_CONFIG* config)
{
STRING_HANDLE result = NULL;
if (((result = STRING_construct(config->upperConfig->iotHubName)) == NULL) ||
(STRING_concat(result, ".") != 0) ||
(STRING_concat(result, config->upperConfig->iotHubSuffix) != 0))
{
if (result != NULL)
{
STRING_delete(result);
result = NULL;
}
}
return result;
}
static TRANSPORT_HANDLE clientTransportAMQP_Create(const IOTHUBTRANSPORT_CONFIG* config)
{
PAMQP_TRANSPORT_STATE amqpState = NULL;
if (!config)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_001: [If parameter config is NULL then clientTransportAMQP_Create shall fail and return NULL.]*/
LogError("IoTHub amqp client tranport null configuration parameter.\r\n");
}
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_002: [clientTransportAMQP_Create shall fail and return NULL if any other fields of the config structure are NULL.]*/
else if (config->upperConfig->protocol == NULL)
{
LogError("invalid configuration (NULL protocol detected)\r\n");
}
else if (config->upperConfig->deviceId == NULL)
{
LogError("invalid configuration (NULL deviceId detected)\r\n");
}
else if (config->upperConfig->deviceKey == NULL)
{
LogError("invalid configuration (NULL deviceKey detected)\r\n");
}
else if (config->upperConfig->iotHubName == NULL)
{
LogError("invalid configuration (NULL iotHubName detected)\r\n");
}
else if (config->upperConfig->iotHubSuffix == NULL)
{
LogError("invalid configuration (NULL iotHubSuffix detected)\r\n");
}
else if (!config->waitingToSend)
{
LogError("invalid configuration (NULL waitingToSend list detected)\r\n");
}
else if (strlen(config->upperConfig->deviceId) > 128U)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_016: [clientTransportAMQP_Create shall fail and return NULL if the deviceId length is greater than 128.]*/
LogError("deviceName is too long\r\n");
}
else if ((strlen(config->upperConfig->deviceId) == 0) ||
(strlen(config->upperConfig->deviceKey) == 0) ||
(strlen(config->upperConfig->iotHubName) == 0) ||
(strlen(config->upperConfig->iotHubSuffix) == 0))
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_017: [clientTransportAMQP_Create shall fail and return NULL if any string config field is zero length.]*/
LogError("zero length config parameter\r\n");
}
else
{
amqpState = malloc(sizeof(AMQP_TRANSPORT_STATE));
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_003: [clientTransportAMQP_Create shall fail and return NULL if memory allocation of the transports basic internal state structures fails.]*/
if (amqpState == NULL)
{
LogError("Could not allocate AMQP transport state\r\n");
}
else
{
amqpState->messageAddress = NULL;
amqpState->eventAddress = NULL;
amqpState->urledDeviceId = NULL;
amqpState->devicesPortionPath = NULL;
amqpState->cbsAddress = NULL;
amqpState->deviceKey = NULL;
amqpState->savedClientHandle = NULL;
amqpState->messenger = NULL;
amqpState->messageSubscription = NULL;
amqpState->cbsSubscription = NULL;
amqpState->zeroLengthString = NULL;
amqpState->messengerInitialized = false;
amqpState->waitingForPutTokenReply = false;
amqpState->cbsRequestAcceptTime = CBS_DEFAULT_REQUEST_ACCEPT_TIME;
amqpState->cbsReplyTime = CBS_DEFAULT_REPLY_TIME;
amqpState->sasTokenLifetime = SAS_TOKEN_DEFAULT_LIFETIME;
amqpState->sasRefreshLine = SAS_TOKEN_DEFAULT_REFRESH_LINE;
amqpState->eventTimeout = EVENT_TIMEOUT_DEFAULT;
amqpState->waitingToSend = config->waitingToSend;
DList_InitializeListHead(&amqpState->workInProgress);
DList_InitializeListHead(&amqpState->availableWorkItems);
DList_InitializeListHead(&amqpState->messengerCorral);
amqpState->DoWork_PullMessages = false;
amqpState->trustedCertificates = NULL;
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_003: [clientTransportAMQP_Create shall fail and return NULL if memory allocation of the transports basic internal state structures fails.]*/
if ((amqpState->message = pn_message()) == NULL)
{
LogError("Unable to preallocate the proton message!\r\n");
clientTransportAMQP_Destroy(amqpState);
amqpState = NULL;
}
else
{
size_t workItemsToPreallocate;
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_003: [clientTransportAMQP_Create shall fail and return NULL if memory allocation of the transports basic internal state structures fails.]*/
for (workItemsToPreallocate = PROTON_EVENT_OUTGOING_WINDOW_SIZE; workItemsToPreallocate > 0; workItemsToPreallocate--)
{
PAMQP_WORK_ITEM currentItem = malloc(sizeof(AMQP_WORK_ITEM));
if (!currentItem)
{
//
// Not a particularly good sign. Fail the create.
//
LogError("Unable to preallocate work item!\r\n");
clientTransportAMQP_Destroy(amqpState);
amqpState = NULL;
break;
}
else
{
DList_InsertTailList(&amqpState->availableWorkItems, ¤tItem->link);
}
}
if (amqpState != NULL)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_095: [clientTransportAMQP_Create shall create an immutable string, referred henceforth as host, from the following pieces: "config->iotHubName + "." + config->iotHubSuffix.]*/
STRING_HANDLE host = createHost(config);
if (host != NULL)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_091: [clientTransportAMQP_Create shall create an immutable string, referred henceforth as urledDeviceId, by url encoding the config->deviceId.]*/
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_093: [clientTransportAMQP_Create shall create an immutable string, referred henceforth as devicePortionOfPath, from the following pieces: host + "/devices/" + urledDeviceId.]*/
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_097: [clientTransportAMQP_Create shall create an immutable string, referred henceforth as eventAddress, from the following pieces: "amqps://" + devicesPortionOfPath + "/messages/events".]*/
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_099: [clientTransportAMQP_Create shall create an immutable string, referred henceforth as messageAddress, from the following pieces: "amqps://" + devicesPortionOfPath + "/messages/devicebound".]*/
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_101: [clientTransportAMQP_Create shall create an immutable string, referred henceforth as cbsAddress, from the following pieces: "amqps://" + host + "/$cbs".]*/
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_103: [clientTransportAMQP_Create shall create an immutable string, referred henceforth as deviceKey, from the config->deviceKey.]*/
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_186: [An empty string shall be created. If this fails then clientTransportAMQP shall fail and return NULL.]*/
if ((!createUrledDeviceId(amqpState, config)) ||
(!createDevicesPortionPath(amqpState, STRING_c_str(host))) ||
(!createEventAddress(amqpState)) ||
(!createMessageAddress(amqpState)) ||
(!createCbsAddress(amqpState, STRING_c_str(host))) ||
((amqpState->deviceKey = STRING_construct(config->upperConfig->deviceKey)) == NULL) ||
((amqpState->zeroLengthString = STRING_new()) == NULL))
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_092: [If creating the urledDeviceId fails for any reason then clientTransportAMQP_Create shall fail and return NULL.]*/
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_094: [If creating the devicePortionOfPath fails for any reason then clientTransportAMQP_Create shall fail and return NULL.]*/
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_098: [If creating the eventAddress fails for any reason then clientTransportAMQP_Create shall fail and return NULL.]*/
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_100: [If creating the messageAddress fails for any reason then clientTransportAMQP_Create shall fail and return NULL.]*/
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_102: [If creating the cbsAddress fails for any reason then clientTransportAMQP_Create shall fail and return NULL.]*/
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_104: [If creating the deviceKey fails for any reason then clientTransportAMQP_Create shall fail and return NULL.]*/
clientTransportAMQP_Destroy(amqpState);
amqpState = NULL;
}
STRING_delete(host);
}
else
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_096: [If creating the schemeAndHost fails for any reason then clientTransportAMQP_Create shall fail and return NULL.]*/
clientTransportAMQP_Destroy(amqpState);
amqpState = NULL;
}
}
}
}
}
return amqpState;
}
static int clientTransportAMQP_Subscribe(TRANSPORT_HANDLE handle)
{
int result;
if (handle == NULL)
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_013: [If the parameter handle is NULL then clientTransportAMQP_Subscribe shall fail and return a non-zero value.]*/
LogError("Invalid handle to IoTHubClient amqp subscribe.\r\n");
result = 1;
}
else
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_014: [clientTransportAMQP_Subscribe shall succeed and return a value of zero.]*/
PAMQP_TRANSPORT_STATE transportState = (PAMQP_TRANSPORT_STATE)handle;
transportState->DoWork_PullMessages = true;
result = 0;
}
return result;
}
static void clientTransportAMQP_Unsubscribe(TRANSPORT_HANDLE handle)
{
PAMQP_TRANSPORT_STATE transportState = (PAMQP_TRANSPORT_STATE)handle;
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_06_015: [clientTransportAMQP_Unsubscribe shall do nothing if handle is NULL.]*/
if (transportState)
{
transportState->DoWork_PullMessages = false;
}
}
static IOTHUB_CLIENT_RESULT clientTransportAMQP_GetSendStatus(TRANSPORT_HANDLE handle, IOTHUB_CLIENT_STATUS *iotHubClientStatus)
{
IOTHUB_CLIENT_RESULT result;
/* Codes_SRS_IOTHUBTRANSPORTTAMQP_09_001: [clientTransportAMQP_GetSendStatus IoTHubTransportHttp_GetSendStatus shall return IOTHUB_CLIENT_INVALID_ARG if called with NULL parameter] */
if (handle == NULL)
{
result = IOTHUB_CLIENT_INVALID_ARG;
LogError("Invalid handle to IoTHubClient AMQP transport instance.\r\n");
}
else if (iotHubClientStatus == NULL)
{
result = IOTHUB_CLIENT_INVALID_ARG;
LogError("Invalid pointer to output parameter IOTHUB_CLIENT_STATUS.\r\n");
}
else
{
PAMQP_TRANSPORT_STATE handleData = (PAMQP_TRANSPORT_STATE)handle;
/* Codes_SRS_IOTHUBTRANSPORTTAMQP_09_002: [clientTransportAMQP_GetSendStatus shall return IOTHUB_CLIENT_OK and status IOTHUB_CLIENT_SEND_STATUS_IDLE if there are currently no event items to be sent or being sent] */
if (!DList_IsListEmpty(handleData->waitingToSend) || !DList_IsListEmpty(&(handleData->workInProgress)))
{
*iotHubClientStatus = IOTHUB_CLIENT_SEND_STATUS_BUSY;
}
/* Codes_SRS_IOTHUBTRANSPORTTAMQP_09_003: [clientTransportAMQP_GetSendStatus shall return IOTHUB_CLIENT_OK and status IOTHUB_CLIENT_SEND_STATUS_BUSY if there are currently event items to be sent or being sent] */
else
{
*iotHubClientStatus = IOTHUB_CLIENT_SEND_STATUS_IDLE;
}
result = IOTHUB_CLIENT_OK;
}
return result;
}
static IOTHUB_CLIENT_RESULT clientTransportAMQP_SetOption(TRANSPORT_HANDLE handle, const char* option, const void* value)
{
IOTHUB_CLIENT_RESULT result;
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_02_001: [If handle parameter is NULL then clientTransportAMQP_SetOption shall return IOTHUB_CLIENT_INVALID_ARG.] */
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_02_002: [If parameter optionName is NULL then clientTransportAMQP_SetOption shall return IOTHUB_CLIENT_INVALID_ARG.] */
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_02_003: [If parameter value is NULL then clientTransportAMQP_SetOption shall return IOTHUB_CLIENT_INVALID_ARG.] */
if (
(handle == NULL) ||
(option == NULL) ||
(value == NULL)
)
{
result = IOTHUB_CLIENT_INVALID_ARG;
LogError("invalid parameter (NULL) passed to clientTransportAMQP_SetOption\r\n");
}
else
{
/* Codes_SRS_IOTHUBTRANSPORTTAMQP_02_005: [clientTransportAMQP_SetOption shall set the option "optionName" to *value.] */
/* Codes_SRS_IOTHUBTRANSPORTTAMQP_01_003: ["TrustedCerts"] */
if (strcmp("TrustedCerts", option) == 0)
{
PAMQP_TRANSPORT_STATE handleData = (PAMQP_TRANSPORT_STATE)handle;
char* newTrsutedCertificates;
if (mallocAndStrcpy_s(&newTrsutedCertificates, (const char*)value) != 0)
{
/* Codes_SRS_IOTHUBTRANSPORTTAMQP_01_006: [If any other error occurs while setting the option, clientTransportAMQP_SetOption shall return IOTHUB_CLIENT_ERROR.] */
result = IOTHUB_CLIENT_ERROR;
}
else
{
/* Codes_SRS_IOTHUBTRANSPORTTAMQP_01_004: [Sets a string that should be used as trusted certificates by the transport, freeing any previous TrustedCerts option value.] */
if (handleData->trustedCertificates != NULL)
{
free(handleData->trustedCertificates);
}
handleData->trustedCertificates = newTrsutedCertificates;
result = IOTHUB_CLIENT_OK;
}
}
else
{
/*Codes_SRS_IOTHUBTRANSPORTTAMQP_02_004: [If optionName is not an option supported then clientTransportAMQP_SetOption shall return IOTHUB_CLIENT_INVALID_ARG.]*/
result = IOTHUB_CLIENT_INVALID_ARG;
}
}
return result;
}
static TRANSPORT_PROVIDER myfunc = {
clientTransportAMQP_SetOption,
clientTransportAMQP_Create, clientTransportAMQP_Destroy, clientTransportAMQP_Subscribe, clientTransportAMQP_Unsubscribe, clientTransportAMQP_DoWork, clientTransportAMQP_GetSendStatus
};
extern const void* AMQP_Protocol(void)
{
return &myfunc;
}
