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

Committer:
AzureIoTClient
Date:
Tue Jun 26 19:13:11 2018 -0700
Revision:
54:830550fef7ea
Parent:
53:e21e1e88460f
Child:
56:8704100b3b54
1.2.6

Who changed what in which revision?

UserRevisionLine numberNew contents of line
AzureIoTClient 39:e98d5df6dc74 1 // Copyright (c) Microsoft. All rights reserved.
AzureIoTClient 39:e98d5df6dc74 2 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
AzureIoTClient 39:e98d5df6dc74 3
AzureIoTClient 39:e98d5df6dc74 4 #include <stdlib.h>
AzureIoTClient 39:e98d5df6dc74 5 #include <stdbool.h>
AzureIoTClient 39:e98d5df6dc74 6 #include "azure_c_shared_utility/optimize_size.h"
AzureIoTClient 39:e98d5df6dc74 7 #include "azure_c_shared_utility/crt_abstractions.h"
AzureIoTClient 39:e98d5df6dc74 8 #include "azure_c_shared_utility/gballoc.h"
AzureIoTClient 39:e98d5df6dc74 9 #include "azure_c_shared_utility/agenttime.h"
AzureIoTClient 39:e98d5df6dc74 10 #include "azure_c_shared_utility/xlogging.h"
AzureIoTClient 39:e98d5df6dc74 11 #include "azure_c_shared_utility/uniqueid.h"
AzureIoTClient 39:e98d5df6dc74 12 #include "azure_uamqp_c/link.h"
AzureIoTClient 39:e98d5df6dc74 13 #include "azure_uamqp_c/messaging.h"
AzureIoTClient 39:e98d5df6dc74 14 #include "azure_uamqp_c/message_sender.h"
AzureIoTClient 39:e98d5df6dc74 15 #include "azure_uamqp_c/message_receiver.h"
AzureIoTClient 53:e21e1e88460f 16 #include "internal/message_queue.h"
AzureIoTClient 53:e21e1e88460f 17 #include "internal/iothub_client_retry_control.h"
AzureIoTClient 53:e21e1e88460f 18 #include "internal/iothubtransport_amqp_messenger.h"
AzureIoTClient 39:e98d5df6dc74 19
AzureIoTClient 39:e98d5df6dc74 20 DEFINE_ENUM_STRINGS(AMQP_MESSENGER_SEND_STATUS, AMQP_MESSENGER_SEND_STATUS_VALUES);
AzureIoTClient 39:e98d5df6dc74 21 DEFINE_ENUM_STRINGS(AMQP_MESSENGER_SEND_RESULT, AMQP_MESSENGER_SEND_RESULT_VALUES);
AzureIoTClient 39:e98d5df6dc74 22 DEFINE_ENUM_STRINGS(AMQP_MESSENGER_REASON, AMQP_MESSENGER_REASON_VALUES);
AzureIoTClient 39:e98d5df6dc74 23 DEFINE_ENUM_STRINGS(AMQP_MESSENGER_DISPOSITION_RESULT, AMQP_MESSENGER_DISPOSITION_RESULT_VALUES);
AzureIoTClient 39:e98d5df6dc74 24 DEFINE_ENUM_STRINGS(AMQP_MESSENGER_STATE, AMQP_MESSENGER_STATE_VALUES);
AzureIoTClient 39:e98d5df6dc74 25
AzureIoTClient 39:e98d5df6dc74 26
AzureIoTClient 39:e98d5df6dc74 27 #define RESULT_OK 0
AzureIoTClient 39:e98d5df6dc74 28 #define INDEFINITE_TIME ((time_t)(-1))
AzureIoTClient 39:e98d5df6dc74 29
AzureIoTClient 39:e98d5df6dc74 30 // AMQP Link address format: "amqps://<iot hub fqdn>/devices/<device-id>/<suffix>"
AzureIoTClient 39:e98d5df6dc74 31 #define LINK_ADDRESS_FORMAT "amqps://%s/devices/%s/%s"
AzureIoTClient 54:830550fef7ea 32 #define LINK_ADDRESS_MODULE_FORMAT "amqps://%s/devices/%s/modules/%s/%s"
AzureIoTClient 39:e98d5df6dc74 33 #define SEND_LINK_NAME_PREFIX "link-snd"
AzureIoTClient 39:e98d5df6dc74 34 #define MESSAGE_SENDER_MAX_LINK_SIZE UINT64_MAX
AzureIoTClient 39:e98d5df6dc74 35 #define RECEIVE_LINK_NAME_PREFIX "link-rcv"
AzureIoTClient 39:e98d5df6dc74 36 #define MESSAGE_RECEIVER_MAX_LINK_SIZE 65536
AzureIoTClient 39:e98d5df6dc74 37 #define DEFAULT_EVENT_SEND_RETRY_LIMIT 0
AzureIoTClient 39:e98d5df6dc74 38 #define DEFAULT_EVENT_SEND_TIMEOUT_SECS 600
AzureIoTClient 39:e98d5df6dc74 39 #define DEFAULT_MAX_SEND_ERROR_COUNT 10
AzureIoTClient 39:e98d5df6dc74 40 #define MAX_MESSAGE_SENDER_STATE_CHANGE_TIMEOUT_SECS 300
AzureIoTClient 39:e98d5df6dc74 41 #define MAX_MESSAGE_RECEIVER_STATE_CHANGE_TIMEOUT_SECS 300
AzureIoTClient 39:e98d5df6dc74 42 #define UNIQUE_ID_BUFFER_SIZE 37
AzureIoTClient 39:e98d5df6dc74 43
AzureIoTClient 39:e98d5df6dc74 44 static const char* MESSENGER_SAVED_MQ_OPTIONS = "amqp_message_queue_options";
AzureIoTClient 39:e98d5df6dc74 45
AzureIoTClient 39:e98d5df6dc74 46 typedef struct AMQP_MESSENGER_INSTANCE_TAG
AzureIoTClient 39:e98d5df6dc74 47 {
AzureIoTClient 39:e98d5df6dc74 48 AMQP_MESSENGER_CONFIG* config;
AzureIoTClient 39:e98d5df6dc74 49
AzureIoTClient 39:e98d5df6dc74 50 bool receive_messages;
AzureIoTClient 39:e98d5df6dc74 51 ON_AMQP_MESSENGER_MESSAGE_RECEIVED on_message_received_callback;
AzureIoTClient 39:e98d5df6dc74 52 void* on_message_received_context;
AzureIoTClient 39:e98d5df6dc74 53
AzureIoTClient 39:e98d5df6dc74 54 MESSAGE_QUEUE_HANDLE send_queue;
AzureIoTClient 39:e98d5df6dc74 55 AMQP_MESSENGER_STATE state;
AzureIoTClient 39:e98d5df6dc74 56
AzureIoTClient 39:e98d5df6dc74 57 SESSION_HANDLE session_handle;
AzureIoTClient 39:e98d5df6dc74 58
AzureIoTClient 39:e98d5df6dc74 59 LINK_HANDLE sender_link;
AzureIoTClient 39:e98d5df6dc74 60 MESSAGE_SENDER_HANDLE message_sender;
AzureIoTClient 39:e98d5df6dc74 61 MESSAGE_SENDER_STATE message_sender_current_state;
AzureIoTClient 39:e98d5df6dc74 62 MESSAGE_SENDER_STATE message_sender_previous_state;
AzureIoTClient 39:e98d5df6dc74 63
AzureIoTClient 39:e98d5df6dc74 64 LINK_HANDLE receiver_link;
AzureIoTClient 39:e98d5df6dc74 65 MESSAGE_RECEIVER_HANDLE message_receiver;
AzureIoTClient 39:e98d5df6dc74 66 MESSAGE_RECEIVER_STATE message_receiver_current_state;
AzureIoTClient 39:e98d5df6dc74 67 MESSAGE_RECEIVER_STATE message_receiver_previous_state;
AzureIoTClient 39:e98d5df6dc74 68
AzureIoTClient 39:e98d5df6dc74 69 size_t send_error_count;
AzureIoTClient 39:e98d5df6dc74 70 size_t max_send_error_count;
AzureIoTClient 39:e98d5df6dc74 71
AzureIoTClient 39:e98d5df6dc74 72 time_t last_message_sender_state_change_time;
AzureIoTClient 39:e98d5df6dc74 73 time_t last_message_receiver_state_change_time;
AzureIoTClient 39:e98d5df6dc74 74 } AMQP_MESSENGER_INSTANCE;
AzureIoTClient 39:e98d5df6dc74 75
AzureIoTClient 39:e98d5df6dc74 76 typedef struct MESSAGE_SEND_CONTEXT_TAG
AzureIoTClient 39:e98d5df6dc74 77 {
AzureIoTClient 39:e98d5df6dc74 78 MESSAGE_HANDLE message;
AzureIoTClient 39:e98d5df6dc74 79 bool is_destroyed;
AzureIoTClient 39:e98d5df6dc74 80
AzureIoTClient 39:e98d5df6dc74 81 AMQP_MESSENGER_INSTANCE* messenger;
AzureIoTClient 39:e98d5df6dc74 82
AzureIoTClient 39:e98d5df6dc74 83 AMQP_MESSENGER_SEND_COMPLETE_CALLBACK on_send_complete_callback;
AzureIoTClient 39:e98d5df6dc74 84 void* user_context;
AzureIoTClient 39:e98d5df6dc74 85
AzureIoTClient 39:e98d5df6dc74 86 PROCESS_MESSAGE_COMPLETED_CALLBACK on_process_message_completed_callback;
AzureIoTClient 39:e98d5df6dc74 87 } MESSAGE_SEND_CONTEXT;
AzureIoTClient 39:e98d5df6dc74 88
AzureIoTClient 39:e98d5df6dc74 89
AzureIoTClient 39:e98d5df6dc74 90
AzureIoTClient 39:e98d5df6dc74 91 static MESSAGE_SEND_CONTEXT* create_message_send_context()
AzureIoTClient 39:e98d5df6dc74 92 {
AzureIoTClient 39:e98d5df6dc74 93 MESSAGE_SEND_CONTEXT* result;
AzureIoTClient 39:e98d5df6dc74 94
AzureIoTClient 39:e98d5df6dc74 95 if ((result = (MESSAGE_SEND_CONTEXT*)malloc(sizeof(MESSAGE_SEND_CONTEXT))) == NULL)
AzureIoTClient 39:e98d5df6dc74 96 {
AzureIoTClient 39:e98d5df6dc74 97 LogError("Failed creating the message send context");
AzureIoTClient 39:e98d5df6dc74 98 }
AzureIoTClient 39:e98d5df6dc74 99 else
AzureIoTClient 39:e98d5df6dc74 100 {
AzureIoTClient 39:e98d5df6dc74 101 memset(result, 0, sizeof(MESSAGE_SEND_CONTEXT));
AzureIoTClient 39:e98d5df6dc74 102 }
AzureIoTClient 39:e98d5df6dc74 103
AzureIoTClient 39:e98d5df6dc74 104 return result;
AzureIoTClient 39:e98d5df6dc74 105 }
AzureIoTClient 39:e98d5df6dc74 106
AzureIoTClient 39:e98d5df6dc74 107 static bool is_valid_configuration(const AMQP_MESSENGER_CONFIG* config)
AzureIoTClient 39:e98d5df6dc74 108 {
AzureIoTClient 39:e98d5df6dc74 109 bool result;
AzureIoTClient 39:e98d5df6dc74 110
AzureIoTClient 39:e98d5df6dc74 111 if (config == NULL)
AzureIoTClient 39:e98d5df6dc74 112 {
AzureIoTClient 39:e98d5df6dc74 113 LogError("Invalid configuration (NULL)");
AzureIoTClient 39:e98d5df6dc74 114 result = false;
AzureIoTClient 39:e98d5df6dc74 115 }
AzureIoTClient 39:e98d5df6dc74 116 else if (config->client_version == NULL ||
AzureIoTClient 39:e98d5df6dc74 117 config->device_id == NULL ||
AzureIoTClient 39:e98d5df6dc74 118 config->iothub_host_fqdn == NULL ||
AzureIoTClient 39:e98d5df6dc74 119 config->receive_link.source_suffix == NULL ||
AzureIoTClient 39:e98d5df6dc74 120 config->send_link.target_suffix == NULL)
AzureIoTClient 39:e98d5df6dc74 121 {
AzureIoTClient 39:e98d5df6dc74 122 LogError("Invalid configuration (client_version=%p, device_id=%p, iothub_host_fqdn=%p, receive_link (source_suffix=%p), send_link (target_suffix=%p))",
AzureIoTClient 39:e98d5df6dc74 123 config->client_version, config->device_id, config->iothub_host_fqdn,
AzureIoTClient 39:e98d5df6dc74 124 config->receive_link.source_suffix, config->send_link.target_suffix);
AzureIoTClient 39:e98d5df6dc74 125 result = false;
AzureIoTClient 39:e98d5df6dc74 126 }
AzureIoTClient 39:e98d5df6dc74 127 else
AzureIoTClient 39:e98d5df6dc74 128 {
AzureIoTClient 39:e98d5df6dc74 129 result = true;
AzureIoTClient 39:e98d5df6dc74 130 }
AzureIoTClient 39:e98d5df6dc74 131
AzureIoTClient 39:e98d5df6dc74 132 return result;
AzureIoTClient 39:e98d5df6dc74 133 }
AzureIoTClient 39:e98d5df6dc74 134
AzureIoTClient 39:e98d5df6dc74 135 static void destroy_link_configuration(AMQP_MESSENGER_LINK_CONFIG* link_config)
AzureIoTClient 39:e98d5df6dc74 136 {
AzureIoTClient 39:e98d5df6dc74 137 if (link_config->target_suffix != NULL)
AzureIoTClient 39:e98d5df6dc74 138 {
AzureIoTClient 39:e98d5df6dc74 139 free((void*)link_config->target_suffix);
AzureIoTClient 39:e98d5df6dc74 140 link_config->target_suffix = NULL;
AzureIoTClient 39:e98d5df6dc74 141 }
AzureIoTClient 39:e98d5df6dc74 142
AzureIoTClient 39:e98d5df6dc74 143 if (link_config->source_suffix != NULL)
AzureIoTClient 39:e98d5df6dc74 144 {
AzureIoTClient 39:e98d5df6dc74 145 free((void*)link_config->source_suffix);
AzureIoTClient 39:e98d5df6dc74 146 link_config->source_suffix = NULL;
AzureIoTClient 39:e98d5df6dc74 147 }
AzureIoTClient 39:e98d5df6dc74 148
AzureIoTClient 39:e98d5df6dc74 149 if (link_config->attach_properties != NULL)
AzureIoTClient 39:e98d5df6dc74 150 {
AzureIoTClient 39:e98d5df6dc74 151 Map_Destroy(link_config->attach_properties);
AzureIoTClient 39:e98d5df6dc74 152 link_config->attach_properties = NULL;
AzureIoTClient 39:e98d5df6dc74 153 }
AzureIoTClient 39:e98d5df6dc74 154 }
AzureIoTClient 39:e98d5df6dc74 155
AzureIoTClient 39:e98d5df6dc74 156 static void destroy_configuration(AMQP_MESSENGER_CONFIG* config)
AzureIoTClient 39:e98d5df6dc74 157 {
AzureIoTClient 39:e98d5df6dc74 158 if (config != NULL)
AzureIoTClient 39:e98d5df6dc74 159 {
AzureIoTClient 39:e98d5df6dc74 160 if (config->client_version != NULL)
AzureIoTClient 39:e98d5df6dc74 161 {
AzureIoTClient 39:e98d5df6dc74 162 free((void*)config->client_version);
AzureIoTClient 39:e98d5df6dc74 163 }
AzureIoTClient 39:e98d5df6dc74 164
AzureIoTClient 39:e98d5df6dc74 165 if (config->device_id != NULL)
AzureIoTClient 39:e98d5df6dc74 166 {
AzureIoTClient 39:e98d5df6dc74 167 free((void*)config->device_id);
AzureIoTClient 39:e98d5df6dc74 168 }
AzureIoTClient 39:e98d5df6dc74 169
AzureIoTClient 54:830550fef7ea 170 if (config->module_id != NULL)
AzureIoTClient 54:830550fef7ea 171 {
AzureIoTClient 54:830550fef7ea 172 free((void*)config->module_id);
AzureIoTClient 54:830550fef7ea 173 }
AzureIoTClient 54:830550fef7ea 174
AzureIoTClient 39:e98d5df6dc74 175 if (config->iothub_host_fqdn != NULL)
AzureIoTClient 39:e98d5df6dc74 176 {
AzureIoTClient 39:e98d5df6dc74 177 free((void*)config->iothub_host_fqdn);
AzureIoTClient 39:e98d5df6dc74 178 }
AzureIoTClient 39:e98d5df6dc74 179
AzureIoTClient 39:e98d5df6dc74 180 destroy_link_configuration(&config->send_link);
AzureIoTClient 39:e98d5df6dc74 181 destroy_link_configuration(&config->receive_link);
AzureIoTClient 39:e98d5df6dc74 182
AzureIoTClient 39:e98d5df6dc74 183 free(config);
AzureIoTClient 39:e98d5df6dc74 184 }
AzureIoTClient 39:e98d5df6dc74 185 }
AzureIoTClient 39:e98d5df6dc74 186
AzureIoTClient 39:e98d5df6dc74 187 static int clone_link_configuration(role link_role, AMQP_MESSENGER_LINK_CONFIG* dst_config, const AMQP_MESSENGER_LINK_CONFIG* src_config)
AzureIoTClient 39:e98d5df6dc74 188 {
AzureIoTClient 39:e98d5df6dc74 189 int result;
AzureIoTClient 39:e98d5df6dc74 190
AzureIoTClient 39:e98d5df6dc74 191 if (link_role == role_sender &&
AzureIoTClient 39:e98d5df6dc74 192 mallocAndStrcpy_s(&dst_config->target_suffix, src_config->target_suffix) != 0)
AzureIoTClient 39:e98d5df6dc74 193 {
AzureIoTClient 39:e98d5df6dc74 194 LogError("Failed copying send_link_target_suffix");
AzureIoTClient 39:e98d5df6dc74 195 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 196 }
AzureIoTClient 39:e98d5df6dc74 197 else if (link_role == role_receiver &&
AzureIoTClient 39:e98d5df6dc74 198 mallocAndStrcpy_s(&dst_config->source_suffix, src_config->source_suffix) != 0)
AzureIoTClient 39:e98d5df6dc74 199 {
AzureIoTClient 39:e98d5df6dc74 200 LogError("Failed copying receive_link_source_suffix");
AzureIoTClient 39:e98d5df6dc74 201 destroy_link_configuration(dst_config);
AzureIoTClient 39:e98d5df6dc74 202 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 203 }
AzureIoTClient 39:e98d5df6dc74 204 else if (src_config->attach_properties != NULL &&
AzureIoTClient 39:e98d5df6dc74 205 (dst_config->attach_properties = Map_Clone(src_config->attach_properties)) == NULL)
AzureIoTClient 39:e98d5df6dc74 206 {
AzureIoTClient 39:e98d5df6dc74 207 LogError("Failed copying link attach properties");
AzureIoTClient 39:e98d5df6dc74 208 destroy_link_configuration(dst_config);
AzureIoTClient 39:e98d5df6dc74 209 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 210 }
AzureIoTClient 39:e98d5df6dc74 211 else
AzureIoTClient 39:e98d5df6dc74 212 {
AzureIoTClient 39:e98d5df6dc74 213 dst_config->snd_settle_mode = src_config->snd_settle_mode;
AzureIoTClient 39:e98d5df6dc74 214 dst_config->rcv_settle_mode = src_config->rcv_settle_mode;
AzureIoTClient 39:e98d5df6dc74 215
AzureIoTClient 39:e98d5df6dc74 216 result = RESULT_OK;
AzureIoTClient 39:e98d5df6dc74 217 }
AzureIoTClient 39:e98d5df6dc74 218
AzureIoTClient 39:e98d5df6dc74 219 return result;
AzureIoTClient 39:e98d5df6dc74 220 }
AzureIoTClient 39:e98d5df6dc74 221
AzureIoTClient 39:e98d5df6dc74 222 static AMQP_MESSENGER_CONFIG* clone_configuration(const AMQP_MESSENGER_CONFIG* config)
AzureIoTClient 39:e98d5df6dc74 223 {
AzureIoTClient 39:e98d5df6dc74 224 AMQP_MESSENGER_CONFIG* result;
AzureIoTClient 39:e98d5df6dc74 225
AzureIoTClient 39:e98d5df6dc74 226 if ((result = (AMQP_MESSENGER_CONFIG*)malloc(sizeof(AMQP_MESSENGER_CONFIG))) == NULL)
AzureIoTClient 39:e98d5df6dc74 227 {
AzureIoTClient 39:e98d5df6dc74 228 LogError("Failed allocating AMQP_MESSENGER_CONFIG");
AzureIoTClient 39:e98d5df6dc74 229 }
AzureIoTClient 39:e98d5df6dc74 230 else
AzureIoTClient 39:e98d5df6dc74 231 {
AzureIoTClient 39:e98d5df6dc74 232 memset(result, 0, sizeof(AMQP_MESSENGER_CONFIG));
AzureIoTClient 39:e98d5df6dc74 233
AzureIoTClient 39:e98d5df6dc74 234 if (mallocAndStrcpy_s(&result->client_version, config->client_version) != 0)
AzureIoTClient 39:e98d5df6dc74 235 {
AzureIoTClient 39:e98d5df6dc74 236 LogError("Failed copying device_id");
AzureIoTClient 39:e98d5df6dc74 237 destroy_configuration(result);
AzureIoTClient 39:e98d5df6dc74 238 result = NULL;
AzureIoTClient 39:e98d5df6dc74 239 }
AzureIoTClient 39:e98d5df6dc74 240 else if (mallocAndStrcpy_s(&result->device_id, config->device_id) != 0)
AzureIoTClient 39:e98d5df6dc74 241 {
AzureIoTClient 39:e98d5df6dc74 242 LogError("Failed copying device_id");
AzureIoTClient 39:e98d5df6dc74 243 destroy_configuration(result);
AzureIoTClient 39:e98d5df6dc74 244 result = NULL;
AzureIoTClient 39:e98d5df6dc74 245 }
AzureIoTClient 54:830550fef7ea 246 else if ((config->module_id != NULL) && (mallocAndStrcpy_s(&result->module_id, config->module_id) != 0))
AzureIoTClient 54:830550fef7ea 247 {
AzureIoTClient 54:830550fef7ea 248 LogError("Failed copying module_id");
AzureIoTClient 54:830550fef7ea 249 destroy_configuration(result);
AzureIoTClient 54:830550fef7ea 250 result = NULL;
AzureIoTClient 54:830550fef7ea 251 }
AzureIoTClient 39:e98d5df6dc74 252 else if (mallocAndStrcpy_s(&result->iothub_host_fqdn, config->iothub_host_fqdn) != 0)
AzureIoTClient 39:e98d5df6dc74 253 {
AzureIoTClient 39:e98d5df6dc74 254 LogError("Failed copying iothub_host_fqdn");
AzureIoTClient 39:e98d5df6dc74 255 destroy_configuration(result);
AzureIoTClient 39:e98d5df6dc74 256 result = NULL;
AzureIoTClient 39:e98d5df6dc74 257 }
AzureIoTClient 39:e98d5df6dc74 258 else if (clone_link_configuration(role_sender, &result->send_link, &config->send_link) != RESULT_OK)
AzureIoTClient 39:e98d5df6dc74 259 {
AzureIoTClient 39:e98d5df6dc74 260 LogError("Failed copying send link configuration");
AzureIoTClient 39:e98d5df6dc74 261 destroy_configuration(result);
AzureIoTClient 39:e98d5df6dc74 262 result = NULL;
AzureIoTClient 39:e98d5df6dc74 263 }
AzureIoTClient 39:e98d5df6dc74 264 else if (clone_link_configuration(role_receiver, &result->receive_link, &config->receive_link) != RESULT_OK)
AzureIoTClient 39:e98d5df6dc74 265 {
AzureIoTClient 39:e98d5df6dc74 266 LogError("Failed copying receive link configuration");
AzureIoTClient 39:e98d5df6dc74 267 destroy_configuration(result);
AzureIoTClient 39:e98d5df6dc74 268 result = NULL;
AzureIoTClient 39:e98d5df6dc74 269 }
AzureIoTClient 39:e98d5df6dc74 270 else
AzureIoTClient 39:e98d5df6dc74 271 {
AzureIoTClient 39:e98d5df6dc74 272 result->on_state_changed_callback = config->on_state_changed_callback;
AzureIoTClient 39:e98d5df6dc74 273 result->on_state_changed_context = config->on_state_changed_context;
AzureIoTClient 39:e98d5df6dc74 274 result->on_subscription_changed_callback = config->on_subscription_changed_callback;
AzureIoTClient 39:e98d5df6dc74 275 result->on_subscription_changed_context = config->on_subscription_changed_context;
AzureIoTClient 39:e98d5df6dc74 276 }
AzureIoTClient 39:e98d5df6dc74 277 }
AzureIoTClient 39:e98d5df6dc74 278
AzureIoTClient 39:e98d5df6dc74 279 return result;
AzureIoTClient 39:e98d5df6dc74 280 }
AzureIoTClient 39:e98d5df6dc74 281
AzureIoTClient 39:e98d5df6dc74 282 static void destroy_message_send_context(MESSAGE_SEND_CONTEXT* context)
AzureIoTClient 39:e98d5df6dc74 283 {
AzureIoTClient 54:830550fef7ea 284 free(context);
AzureIoTClient 39:e98d5df6dc74 285 }
AzureIoTClient 39:e98d5df6dc74 286
AzureIoTClient 54:830550fef7ea 287 static STRING_HANDLE create_link_address(const char* host_fqdn, const char* device_id, const char* module_id, const char* address_suffix)
AzureIoTClient 39:e98d5df6dc74 288 {
AzureIoTClient 54:830550fef7ea 289 STRING_HANDLE link_address;
AzureIoTClient 39:e98d5df6dc74 290
AzureIoTClient 54:830550fef7ea 291 if ((link_address = STRING_new()) == NULL)
AzureIoTClient 54:830550fef7ea 292 {
AzureIoTClient 54:830550fef7ea 293 LogError("failed creating link_address (STRING_new failed)");
AzureIoTClient 54:830550fef7ea 294 }
AzureIoTClient 54:830550fef7ea 295 else
AzureIoTClient 54:830550fef7ea 296 {
AzureIoTClient 54:830550fef7ea 297 if (module_id != NULL)
AzureIoTClient 54:830550fef7ea 298 {
AzureIoTClient 54:830550fef7ea 299 if (STRING_sprintf(link_address, LINK_ADDRESS_MODULE_FORMAT, host_fqdn, device_id, module_id, address_suffix) != RESULT_OK)
AzureIoTClient 54:830550fef7ea 300 {
AzureIoTClient 54:830550fef7ea 301 LogError("Failed creating the link_address for a module (STRING_sprintf failed)");
AzureIoTClient 54:830550fef7ea 302 STRING_delete(link_address);
AzureIoTClient 54:830550fef7ea 303 link_address = NULL;
AzureIoTClient 54:830550fef7ea 304 }
AzureIoTClient 54:830550fef7ea 305 }
AzureIoTClient 54:830550fef7ea 306 else
AzureIoTClient 54:830550fef7ea 307 {
AzureIoTClient 54:830550fef7ea 308 if (STRING_sprintf(link_address, LINK_ADDRESS_FORMAT, host_fqdn, device_id, address_suffix) != RESULT_OK)
AzureIoTClient 54:830550fef7ea 309 {
AzureIoTClient 54:830550fef7ea 310 LogError("Failed creating the link_address (STRING_sprintf failed)");
AzureIoTClient 54:830550fef7ea 311 STRING_delete(link_address);
AzureIoTClient 54:830550fef7ea 312 link_address = NULL;
AzureIoTClient 54:830550fef7ea 313 }
AzureIoTClient 54:830550fef7ea 314 }
AzureIoTClient 54:830550fef7ea 315 }
AzureIoTClient 54:830550fef7ea 316 return link_address;
AzureIoTClient 39:e98d5df6dc74 317 }
AzureIoTClient 39:e98d5df6dc74 318
AzureIoTClient 39:e98d5df6dc74 319 static STRING_HANDLE create_link_terminus_name(STRING_HANDLE link_name, const char* suffix)
AzureIoTClient 39:e98d5df6dc74 320 {
AzureIoTClient 39:e98d5df6dc74 321 STRING_HANDLE terminus_name;
AzureIoTClient 39:e98d5df6dc74 322
AzureIoTClient 39:e98d5df6dc74 323 if ((terminus_name = STRING_new()) == NULL)
AzureIoTClient 39:e98d5df6dc74 324 {
AzureIoTClient 39:e98d5df6dc74 325 LogError("Failed creating the terminus name (STRING_new failed; %s)", suffix);
AzureIoTClient 39:e98d5df6dc74 326 }
AzureIoTClient 39:e98d5df6dc74 327 else
AzureIoTClient 39:e98d5df6dc74 328 {
AzureIoTClient 39:e98d5df6dc74 329 const char* link_name_char_ptr = STRING_c_str(link_name);
AzureIoTClient 39:e98d5df6dc74 330
AzureIoTClient 39:e98d5df6dc74 331 if (STRING_sprintf(terminus_name, "%s-%s", link_name_char_ptr, suffix) != RESULT_OK)
AzureIoTClient 39:e98d5df6dc74 332 {
AzureIoTClient 39:e98d5df6dc74 333 STRING_delete(terminus_name);
AzureIoTClient 39:e98d5df6dc74 334 terminus_name = NULL;
AzureIoTClient 39:e98d5df6dc74 335 LogError("Failed creating the terminus name (STRING_sprintf failed; %s)", suffix);
AzureIoTClient 39:e98d5df6dc74 336 }
AzureIoTClient 39:e98d5df6dc74 337 }
AzureIoTClient 39:e98d5df6dc74 338
AzureIoTClient 39:e98d5df6dc74 339 return terminus_name;
AzureIoTClient 39:e98d5df6dc74 340 }
AzureIoTClient 39:e98d5df6dc74 341
AzureIoTClient 39:e98d5df6dc74 342 static STRING_HANDLE create_link_name(role link_role, const char* device_id)
AzureIoTClient 39:e98d5df6dc74 343 {
AzureIoTClient 39:e98d5df6dc74 344 char* unique_id;
AzureIoTClient 39:e98d5df6dc74 345 STRING_HANDLE result;
AzureIoTClient 39:e98d5df6dc74 346
AzureIoTClient 39:e98d5df6dc74 347 if ((unique_id = (char*)malloc(sizeof(char) * UNIQUE_ID_BUFFER_SIZE + 1)) == NULL)
AzureIoTClient 39:e98d5df6dc74 348 {
AzureIoTClient 39:e98d5df6dc74 349 LogError("Failed generating an unique tag (malloc failed)");
AzureIoTClient 39:e98d5df6dc74 350 result = NULL;
AzureIoTClient 39:e98d5df6dc74 351 }
AzureIoTClient 39:e98d5df6dc74 352 else
AzureIoTClient 39:e98d5df6dc74 353 {
AzureIoTClient 39:e98d5df6dc74 354 memset(unique_id, 0, sizeof(char) * UNIQUE_ID_BUFFER_SIZE + 1);
AzureIoTClient 39:e98d5df6dc74 355
AzureIoTClient 39:e98d5df6dc74 356 if (UniqueId_Generate(unique_id, UNIQUE_ID_BUFFER_SIZE) != UNIQUEID_OK)
AzureIoTClient 39:e98d5df6dc74 357 {
AzureIoTClient 39:e98d5df6dc74 358 LogError("Failed generating an unique tag (UniqueId_Generate failed)");
AzureIoTClient 39:e98d5df6dc74 359 result = NULL;
AzureIoTClient 39:e98d5df6dc74 360 }
AzureIoTClient 39:e98d5df6dc74 361 else if ((result = STRING_new()) == NULL)
AzureIoTClient 39:e98d5df6dc74 362 {
AzureIoTClient 39:e98d5df6dc74 363 LogError("Failed generating an unique tag (STRING_new failed)");
AzureIoTClient 39:e98d5df6dc74 364 }
AzureIoTClient 39:e98d5df6dc74 365 else if (STRING_sprintf(result, "%s-%s-%s", (link_role == role_sender ? SEND_LINK_NAME_PREFIX : RECEIVE_LINK_NAME_PREFIX), device_id, unique_id) != 0)
AzureIoTClient 39:e98d5df6dc74 366 {
AzureIoTClient 39:e98d5df6dc74 367 LogError("Failed generating an unique tag (STRING_sprintf failed)");
AzureIoTClient 39:e98d5df6dc74 368 STRING_delete(result);
AzureIoTClient 39:e98d5df6dc74 369 result = NULL;
AzureIoTClient 39:e98d5df6dc74 370 }
AzureIoTClient 39:e98d5df6dc74 371
AzureIoTClient 39:e98d5df6dc74 372 free(unique_id);
AzureIoTClient 39:e98d5df6dc74 373 }
AzureIoTClient 39:e98d5df6dc74 374
AzureIoTClient 39:e98d5df6dc74 375 return result;
AzureIoTClient 39:e98d5df6dc74 376 }
AzureIoTClient 39:e98d5df6dc74 377
AzureIoTClient 39:e98d5df6dc74 378 static void update_messenger_state(AMQP_MESSENGER_INSTANCE* instance, AMQP_MESSENGER_STATE new_state)
AzureIoTClient 39:e98d5df6dc74 379 {
AzureIoTClient 39:e98d5df6dc74 380 if (new_state != instance->state)
AzureIoTClient 39:e98d5df6dc74 381 {
AzureIoTClient 39:e98d5df6dc74 382 AMQP_MESSENGER_STATE previous_state = instance->state;
AzureIoTClient 39:e98d5df6dc74 383 instance->state = new_state;
AzureIoTClient 39:e98d5df6dc74 384
AzureIoTClient 39:e98d5df6dc74 385 if (instance->config != NULL && instance->config->on_state_changed_callback != NULL)
AzureIoTClient 39:e98d5df6dc74 386 {
AzureIoTClient 39:e98d5df6dc74 387 instance->config->on_state_changed_callback(instance->config->on_state_changed_context, previous_state, new_state);
AzureIoTClient 39:e98d5df6dc74 388 }
AzureIoTClient 39:e98d5df6dc74 389 }
AzureIoTClient 39:e98d5df6dc74 390 }
AzureIoTClient 39:e98d5df6dc74 391
AzureIoTClient 39:e98d5df6dc74 392 static int add_link_attach_properties(LINK_HANDLE link, MAP_HANDLE user_defined_properties)
AzureIoTClient 39:e98d5df6dc74 393 {
AzureIoTClient 39:e98d5df6dc74 394 int result;
AzureIoTClient 39:e98d5df6dc74 395 fields attach_properties;
AzureIoTClient 39:e98d5df6dc74 396
AzureIoTClient 39:e98d5df6dc74 397 if ((attach_properties = amqpvalue_create_map()) == NULL)
AzureIoTClient 39:e98d5df6dc74 398 {
AzureIoTClient 39:e98d5df6dc74 399 LogError("Failed to create the map for attach properties.");
AzureIoTClient 39:e98d5df6dc74 400 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 401 }
AzureIoTClient 39:e98d5df6dc74 402 else
AzureIoTClient 39:e98d5df6dc74 403 {
AzureIoTClient 39:e98d5df6dc74 404 const char* const* keys;
AzureIoTClient 39:e98d5df6dc74 405 const char* const* values;
AzureIoTClient 39:e98d5df6dc74 406 size_t count;
AzureIoTClient 39:e98d5df6dc74 407
AzureIoTClient 39:e98d5df6dc74 408 if (Map_GetInternals(user_defined_properties, &keys, &values, &count) != MAP_OK)
AzureIoTClient 39:e98d5df6dc74 409 {
AzureIoTClient 39:e98d5df6dc74 410 LogError("failed getting user defined properties details.");
AzureIoTClient 39:e98d5df6dc74 411 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 412 }
AzureIoTClient 39:e98d5df6dc74 413 else
AzureIoTClient 39:e98d5df6dc74 414 {
AzureIoTClient 39:e98d5df6dc74 415 size_t i;
AzureIoTClient 39:e98d5df6dc74 416 result = RESULT_OK;
AzureIoTClient 39:e98d5df6dc74 417
AzureIoTClient 39:e98d5df6dc74 418 for (i = 0; i < count && result == RESULT_OK; i++)
AzureIoTClient 39:e98d5df6dc74 419 {
AzureIoTClient 39:e98d5df6dc74 420 AMQP_VALUE key;
AzureIoTClient 39:e98d5df6dc74 421 AMQP_VALUE value;
AzureIoTClient 39:e98d5df6dc74 422
AzureIoTClient 39:e98d5df6dc74 423 if ((key = amqpvalue_create_symbol(keys[i])) == NULL)
AzureIoTClient 39:e98d5df6dc74 424 {
AzureIoTClient 39:e98d5df6dc74 425 LogError("Failed creating AMQP_VALUE For key %s.", keys[i]);
AzureIoTClient 39:e98d5df6dc74 426 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 427 }
AzureIoTClient 39:e98d5df6dc74 428 else
AzureIoTClient 39:e98d5df6dc74 429 {
AzureIoTClient 39:e98d5df6dc74 430 if ((value = amqpvalue_create_string(values[i])) == NULL)
AzureIoTClient 39:e98d5df6dc74 431 {
AzureIoTClient 39:e98d5df6dc74 432 LogError("Failed creating AMQP_VALUE For key %s value", keys[i]);
AzureIoTClient 39:e98d5df6dc74 433 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 434 }
AzureIoTClient 39:e98d5df6dc74 435 else
AzureIoTClient 39:e98d5df6dc74 436 {
AzureIoTClient 39:e98d5df6dc74 437 if (amqpvalue_set_map_value(attach_properties, key, value) != 0)
AzureIoTClient 39:e98d5df6dc74 438 {
AzureIoTClient 39:e98d5df6dc74 439 LogError("Failed adding property %s to map", keys[i]);
AzureIoTClient 39:e98d5df6dc74 440 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 441 }
AzureIoTClient 39:e98d5df6dc74 442
AzureIoTClient 39:e98d5df6dc74 443 amqpvalue_destroy(value);
AzureIoTClient 39:e98d5df6dc74 444 }
AzureIoTClient 39:e98d5df6dc74 445
AzureIoTClient 39:e98d5df6dc74 446 amqpvalue_destroy(key);
AzureIoTClient 39:e98d5df6dc74 447 }
AzureIoTClient 39:e98d5df6dc74 448 }
AzureIoTClient 39:e98d5df6dc74 449
AzureIoTClient 39:e98d5df6dc74 450 if (result == RESULT_OK)
AzureIoTClient 39:e98d5df6dc74 451 {
AzureIoTClient 39:e98d5df6dc74 452 if (link_set_attach_properties(link, attach_properties) != 0)
AzureIoTClient 39:e98d5df6dc74 453 {
AzureIoTClient 39:e98d5df6dc74 454 LogError("Failed attaching properties to link");
AzureIoTClient 39:e98d5df6dc74 455 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 456 }
AzureIoTClient 39:e98d5df6dc74 457 else
AzureIoTClient 39:e98d5df6dc74 458 {
AzureIoTClient 39:e98d5df6dc74 459 result = RESULT_OK;
AzureIoTClient 39:e98d5df6dc74 460 }
AzureIoTClient 39:e98d5df6dc74 461 }
AzureIoTClient 39:e98d5df6dc74 462 }
AzureIoTClient 39:e98d5df6dc74 463
AzureIoTClient 39:e98d5df6dc74 464 amqpvalue_destroy(attach_properties);
AzureIoTClient 39:e98d5df6dc74 465 }
AzureIoTClient 39:e98d5df6dc74 466
AzureIoTClient 39:e98d5df6dc74 467 return result;
AzureIoTClient 39:e98d5df6dc74 468 }
AzureIoTClient 39:e98d5df6dc74 469
AzureIoTClient 39:e98d5df6dc74 470 static int create_link_terminus(role link_role, STRING_HANDLE link_name, STRING_HANDLE link_address, AMQP_VALUE* source, AMQP_VALUE* target)
AzureIoTClient 39:e98d5df6dc74 471 {
AzureIoTClient 39:e98d5df6dc74 472 int result;
AzureIoTClient 39:e98d5df6dc74 473 STRING_HANDLE terminus_name;
AzureIoTClient 39:e98d5df6dc74 474 const char* source_name;
AzureIoTClient 39:e98d5df6dc74 475 const char* target_name;
AzureIoTClient 39:e98d5df6dc74 476
AzureIoTClient 39:e98d5df6dc74 477 if (link_role == role_sender)
AzureIoTClient 39:e98d5df6dc74 478 {
AzureIoTClient 39:e98d5df6dc74 479 if ((terminus_name = create_link_terminus_name(link_name, "source")) == NULL)
AzureIoTClient 39:e98d5df6dc74 480 {
AzureIoTClient 39:e98d5df6dc74 481 LogError("Failed creating terminus name");
AzureIoTClient 39:e98d5df6dc74 482 source_name = NULL;
AzureIoTClient 39:e98d5df6dc74 483 target_name = NULL;
AzureIoTClient 39:e98d5df6dc74 484 }
AzureIoTClient 39:e98d5df6dc74 485 else
AzureIoTClient 39:e98d5df6dc74 486 {
AzureIoTClient 39:e98d5df6dc74 487 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_077: [The AMQP link source shall be defined as "<link name>-source"]
AzureIoTClient 39:e98d5df6dc74 488 source_name = STRING_c_str(terminus_name);
AzureIoTClient 39:e98d5df6dc74 489 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_094: [The AMQP link source shall be defined as <link address>]
AzureIoTClient 39:e98d5df6dc74 490 target_name = STRING_c_str(link_address);
AzureIoTClient 39:e98d5df6dc74 491 }
AzureIoTClient 39:e98d5df6dc74 492 }
AzureIoTClient 39:e98d5df6dc74 493 else
AzureIoTClient 39:e98d5df6dc74 494 {
AzureIoTClient 39:e98d5df6dc74 495 if ((terminus_name = create_link_terminus_name(link_name, "target")) == NULL)
AzureIoTClient 39:e98d5df6dc74 496 {
AzureIoTClient 39:e98d5df6dc74 497 LogError("Failed creating terminus name");
AzureIoTClient 39:e98d5df6dc74 498 source_name = NULL;
AzureIoTClient 39:e98d5df6dc74 499 target_name = NULL;
AzureIoTClient 39:e98d5df6dc74 500 }
AzureIoTClient 39:e98d5df6dc74 501 else
AzureIoTClient 39:e98d5df6dc74 502 {
AzureIoTClient 39:e98d5df6dc74 503 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_078: [The AMQP link target shall be defined as <link address>]
AzureIoTClient 39:e98d5df6dc74 504 source_name = STRING_c_str(link_address);
AzureIoTClient 39:e98d5df6dc74 505 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_095: [The AMQP link target shall be defined as "<link name>-target"]
AzureIoTClient 39:e98d5df6dc74 506 target_name = STRING_c_str(terminus_name);
AzureIoTClient 39:e98d5df6dc74 507 }
AzureIoTClient 39:e98d5df6dc74 508 }
AzureIoTClient 39:e98d5df6dc74 509
AzureIoTClient 39:e98d5df6dc74 510 if (source_name == NULL || target_name == NULL)
AzureIoTClient 39:e98d5df6dc74 511 {
AzureIoTClient 39:e98d5df6dc74 512 LogError("Failed creating link source and/or target name (source=%p, target=%p)", source_name, target_name);
AzureIoTClient 39:e98d5df6dc74 513 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 514 }
AzureIoTClient 39:e98d5df6dc74 515 else
AzureIoTClient 39:e98d5df6dc74 516 {
AzureIoTClient 39:e98d5df6dc74 517 if ((*source = messaging_create_source(source_name)) == NULL)
AzureIoTClient 39:e98d5df6dc74 518 {
AzureIoTClient 39:e98d5df6dc74 519 LogError("Failed creating link source");
AzureIoTClient 39:e98d5df6dc74 520 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 521 }
AzureIoTClient 39:e98d5df6dc74 522 else
AzureIoTClient 39:e98d5df6dc74 523 {
AzureIoTClient 39:e98d5df6dc74 524 if ((*target = messaging_create_target(target_name)) == NULL)
AzureIoTClient 39:e98d5df6dc74 525 {
AzureIoTClient 39:e98d5df6dc74 526 LogError("Failed creating link target");
AzureIoTClient 39:e98d5df6dc74 527 amqpvalue_destroy(*source);
AzureIoTClient 39:e98d5df6dc74 528 *source = NULL;
AzureIoTClient 39:e98d5df6dc74 529 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 530 }
AzureIoTClient 39:e98d5df6dc74 531 else
AzureIoTClient 39:e98d5df6dc74 532 {
AzureIoTClient 39:e98d5df6dc74 533 result = RESULT_OK;
AzureIoTClient 39:e98d5df6dc74 534 }
AzureIoTClient 39:e98d5df6dc74 535 }
AzureIoTClient 39:e98d5df6dc74 536 }
AzureIoTClient 39:e98d5df6dc74 537
AzureIoTClient 39:e98d5df6dc74 538
AzureIoTClient 39:e98d5df6dc74 539 STRING_delete(terminus_name);
AzureIoTClient 39:e98d5df6dc74 540
AzureIoTClient 39:e98d5df6dc74 541 return result;
AzureIoTClient 39:e98d5df6dc74 542 }
AzureIoTClient 39:e98d5df6dc74 543
AzureIoTClient 54:830550fef7ea 544 static LINK_HANDLE create_link(role link_role, SESSION_HANDLE session_handle, AMQP_MESSENGER_LINK_CONFIG* link_config, const char* iothub_host_fqdn, const char* device_id, const char* module_id)
AzureIoTClient 39:e98d5df6dc74 545 {
AzureIoTClient 39:e98d5df6dc74 546 LINK_HANDLE result = NULL;
AzureIoTClient 39:e98d5df6dc74 547 STRING_HANDLE link_address;
AzureIoTClient 39:e98d5df6dc74 548
AzureIoTClient 39:e98d5df6dc74 549 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_075: [The AMQP link address shall be defined as "amqps://<`iothub_host_fqdn`>/devices/<`device_id`>/<`instance-config->send_link.source_suffix`>"]
AzureIoTClient 39:e98d5df6dc74 550 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_092: [The AMQP link address shall be defined as "amqps://<`iothub_host_fqdn`>/devices/<`device_id`>/<`instance-config->receive_link.target_suffix`>"]
AzureIoTClient 54:830550fef7ea 551 if ((link_address = create_link_address(iothub_host_fqdn, device_id, module_id, (link_role == role_sender ? link_config->target_suffix : link_config->source_suffix))) == NULL)
AzureIoTClient 39:e98d5df6dc74 552 {
AzureIoTClient 39:e98d5df6dc74 553 LogError("Failed creating the message sender (failed creating the 'link_address')");
AzureIoTClient 39:e98d5df6dc74 554 result = NULL;
AzureIoTClient 39:e98d5df6dc74 555 }
AzureIoTClient 39:e98d5df6dc74 556 else
AzureIoTClient 39:e98d5df6dc74 557 {
AzureIoTClient 39:e98d5df6dc74 558 STRING_HANDLE link_name;
AzureIoTClient 39:e98d5df6dc74 559
AzureIoTClient 39:e98d5df6dc74 560 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_076: [The AMQP link name shall be defined as "link-snd-<`device_id`>-<locally generated UUID>"]
AzureIoTClient 39:e98d5df6dc74 561 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_093: [The AMQP link name shall be defined as "link-rcv-<`device_id`>-<locally generated UUID>"]
AzureIoTClient 39:e98d5df6dc74 562 if ((link_name = create_link_name(link_role, device_id)) == NULL)
AzureIoTClient 39:e98d5df6dc74 563 {
AzureIoTClient 39:e98d5df6dc74 564 LogError("Failed creating the link name");
AzureIoTClient 39:e98d5df6dc74 565 result = NULL;
AzureIoTClient 39:e98d5df6dc74 566 }
AzureIoTClient 39:e98d5df6dc74 567 else
AzureIoTClient 39:e98d5df6dc74 568 {
AzureIoTClient 39:e98d5df6dc74 569 AMQP_VALUE source = NULL;
AzureIoTClient 39:e98d5df6dc74 570 AMQP_VALUE target = NULL;
AzureIoTClient 39:e98d5df6dc74 571
AzureIoTClient 39:e98d5df6dc74 572 if (create_link_terminus(link_role, link_name, link_address, &source, &target) == RESULT_OK)
AzureIoTClient 39:e98d5df6dc74 573 {
AzureIoTClient 39:e98d5df6dc74 574 if ((result = link_create(session_handle, STRING_c_str(link_name), link_role, source, target)) == NULL)
AzureIoTClient 39:e98d5df6dc74 575 {
AzureIoTClient 39:e98d5df6dc74 576 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_079: [If the link fails to be created, amqp_messenger_do_work() shall change the state to AMQP_MESSENGER_STATE_ERROR]
AzureIoTClient 39:e98d5df6dc74 577 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_096: [If the link fails to be created, amqp_messenger_do_work() shall change the state to AMQP_MESSENGER_STATE_ERROR]
AzureIoTClient 39:e98d5df6dc74 578 LogError("Failed creating the AMQP link");
AzureIoTClient 39:e98d5df6dc74 579 }
AzureIoTClient 39:e98d5df6dc74 580 else
AzureIoTClient 39:e98d5df6dc74 581 {
AzureIoTClient 39:e98d5df6dc74 582 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_082: [The AMQP link maximum message size shall be set to UINT64_MAX using link_set_max_message_size()]
AzureIoTClient 39:e98d5df6dc74 583 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_099: [The AMQP link maximum message size shall be set to UINT64_MAX using link_set_max_message_size()]
AzureIoTClient 39:e98d5df6dc74 584 if (link_set_max_message_size(result, MESSAGE_SENDER_MAX_LINK_SIZE) != RESULT_OK)
AzureIoTClient 39:e98d5df6dc74 585 {
AzureIoTClient 39:e98d5df6dc74 586 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_083: [If link_set_max_message_size() fails, it shall be logged and ignored.]
AzureIoTClient 39:e98d5df6dc74 587 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_100: [If link_set_max_message_size() fails, it shall be logged and ignored.]
AzureIoTClient 39:e98d5df6dc74 588 LogError("Failed setting link max message size.");
AzureIoTClient 39:e98d5df6dc74 589 }
AzureIoTClient 39:e98d5df6dc74 590
AzureIoTClient 39:e98d5df6dc74 591 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_080: [The AMQP link shall have its ATTACH properties set using `instance->config->send_link.attach_properties`]
AzureIoTClient 39:e98d5df6dc74 592 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_097: [The AMQP link shall have its ATTACH properties set using `instance->config->receive_link.attach_properties`]
AzureIoTClient 39:e98d5df6dc74 593 if (link_config->attach_properties != NULL &&
AzureIoTClient 39:e98d5df6dc74 594 add_link_attach_properties(result, link_config->attach_properties) != RESULT_OK)
AzureIoTClient 39:e98d5df6dc74 595 {
AzureIoTClient 39:e98d5df6dc74 596 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_081: [If the AMQP link attach properties fail to be set, amqp_messenger_do_work() shall change the state to AMQP_MESSENGER_STATE_ERROR]
AzureIoTClient 39:e98d5df6dc74 597 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_098: [If the AMQP link attach properties fail to be set, amqp_messenger_do_work() shall change the state to AMQP_MESSENGER_STATE_ERROR]
AzureIoTClient 39:e98d5df6dc74 598 LogError("Failed setting link attach properties");
AzureIoTClient 39:e98d5df6dc74 599 link_destroy(result);
AzureIoTClient 39:e98d5df6dc74 600 result = NULL;
AzureIoTClient 39:e98d5df6dc74 601 }
AzureIoTClient 39:e98d5df6dc74 602 }
AzureIoTClient 39:e98d5df6dc74 603
AzureIoTClient 39:e98d5df6dc74 604 amqpvalue_destroy(source);
AzureIoTClient 39:e98d5df6dc74 605 amqpvalue_destroy(target);
AzureIoTClient 39:e98d5df6dc74 606 }
AzureIoTClient 39:e98d5df6dc74 607
AzureIoTClient 39:e98d5df6dc74 608 STRING_delete(link_name);
AzureIoTClient 39:e98d5df6dc74 609 }
AzureIoTClient 39:e98d5df6dc74 610
AzureIoTClient 39:e98d5df6dc74 611 STRING_delete(link_address);
AzureIoTClient 39:e98d5df6dc74 612 }
AzureIoTClient 39:e98d5df6dc74 613
AzureIoTClient 39:e98d5df6dc74 614 return result;
AzureIoTClient 39:e98d5df6dc74 615 }
AzureIoTClient 39:e98d5df6dc74 616
AzureIoTClient 39:e98d5df6dc74 617 static void destroy_message_sender(AMQP_MESSENGER_INSTANCE* instance)
AzureIoTClient 39:e98d5df6dc74 618 {
AzureIoTClient 39:e98d5df6dc74 619 if (instance->message_sender != NULL)
AzureIoTClient 39:e98d5df6dc74 620 {
AzureIoTClient 39:e98d5df6dc74 621 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_090: [`instance->message_sender` shall be destroyed using messagesender_destroy()]
AzureIoTClient 39:e98d5df6dc74 622 messagesender_destroy(instance->message_sender);
AzureIoTClient 39:e98d5df6dc74 623 instance->message_sender = NULL;
AzureIoTClient 39:e98d5df6dc74 624 }
AzureIoTClient 39:e98d5df6dc74 625
AzureIoTClient 45:c09fac270e60 626 instance->message_sender_current_state = MESSAGE_SENDER_STATE_IDLE;
AzureIoTClient 45:c09fac270e60 627 instance->message_sender_previous_state = MESSAGE_SENDER_STATE_IDLE;
AzureIoTClient 45:c09fac270e60 628 instance->last_message_sender_state_change_time = INDEFINITE_TIME;
AzureIoTClient 45:c09fac270e60 629
AzureIoTClient 39:e98d5df6dc74 630 if (instance->sender_link != NULL)
AzureIoTClient 39:e98d5df6dc74 631 {
AzureIoTClient 39:e98d5df6dc74 632 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_091: [`instance->sender_link` shall be destroyed using link_destroy()]
AzureIoTClient 39:e98d5df6dc74 633 link_destroy(instance->sender_link);
AzureIoTClient 39:e98d5df6dc74 634 instance->sender_link = NULL;
AzureIoTClient 39:e98d5df6dc74 635 }
AzureIoTClient 39:e98d5df6dc74 636 }
AzureIoTClient 39:e98d5df6dc74 637
AzureIoTClient 39:e98d5df6dc74 638 static void on_message_sender_state_changed_callback(void* context, MESSAGE_SENDER_STATE new_state, MESSAGE_SENDER_STATE previous_state)
AzureIoTClient 39:e98d5df6dc74 639 {
AzureIoTClient 39:e98d5df6dc74 640 if (context == NULL)
AzureIoTClient 39:e98d5df6dc74 641 {
AzureIoTClient 39:e98d5df6dc74 642 LogError("on_message_sender_state_changed_callback was invoked with a NULL context; although unexpected, this failure will be ignored");
AzureIoTClient 39:e98d5df6dc74 643 }
AzureIoTClient 39:e98d5df6dc74 644 else if (new_state != previous_state)
AzureIoTClient 39:e98d5df6dc74 645 {
AzureIoTClient 39:e98d5df6dc74 646 AMQP_MESSENGER_INSTANCE* instance = (AMQP_MESSENGER_INSTANCE*)context;
AzureIoTClient 39:e98d5df6dc74 647
AzureIoTClient 39:e98d5df6dc74 648 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_088: [`new_state`, `previous_state` shall be saved into `instance->message_sender_previous_state` and `instance->message_sender_current_state`]
AzureIoTClient 39:e98d5df6dc74 649 instance->message_sender_current_state = new_state;
AzureIoTClient 39:e98d5df6dc74 650 instance->message_sender_previous_state = previous_state;
AzureIoTClient 39:e98d5df6dc74 651 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_089: [`instance->last_message_sender_state_change_time` shall be set using get_time()]
AzureIoTClient 39:e98d5df6dc74 652 instance->last_message_sender_state_change_time = get_time(NULL);
AzureIoTClient 39:e98d5df6dc74 653 }
AzureIoTClient 39:e98d5df6dc74 654 }
AzureIoTClient 39:e98d5df6dc74 655
AzureIoTClient 39:e98d5df6dc74 656 static int create_message_sender(AMQP_MESSENGER_INSTANCE* instance)
AzureIoTClient 39:e98d5df6dc74 657 {
AzureIoTClient 39:e98d5df6dc74 658 int result;
AzureIoTClient 39:e98d5df6dc74 659
AzureIoTClient 39:e98d5df6dc74 660 if ((instance->sender_link = create_link(role_sender,
AzureIoTClient 54:830550fef7ea 661 instance->session_handle, &instance->config->send_link, instance->config->iothub_host_fqdn, instance->config->device_id, instance->config->module_id)) == NULL)
AzureIoTClient 39:e98d5df6dc74 662 {
AzureIoTClient 39:e98d5df6dc74 663 LogError("Failed creating the message sender link");
AzureIoTClient 39:e98d5df6dc74 664 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 665 }
AzureIoTClient 39:e98d5df6dc74 666 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_084: [`instance->message_sender` shall be created using messagesender_create(), passing the `instance->sender_link` and `on_message_sender_state_changed_callback`]
AzureIoTClient 39:e98d5df6dc74 667 else if ((instance->message_sender = messagesender_create(instance->sender_link, on_message_sender_state_changed_callback, (void*)instance)) == NULL)
AzureIoTClient 39:e98d5df6dc74 668 {
AzureIoTClient 39:e98d5df6dc74 669 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_085: [If messagesender_create() fails, amqp_messenger_do_work() shall fail and return]
AzureIoTClient 39:e98d5df6dc74 670 LogError("Failed creating the message sender (messagesender_create failed)");
AzureIoTClient 39:e98d5df6dc74 671 destroy_message_sender(instance);
AzureIoTClient 39:e98d5df6dc74 672 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 673 }
AzureIoTClient 39:e98d5df6dc74 674 else
AzureIoTClient 39:e98d5df6dc74 675 {
AzureIoTClient 39:e98d5df6dc74 676 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_086: [`instance->message_sender` shall be opened using messagesender_open()]
AzureIoTClient 39:e98d5df6dc74 677 if (messagesender_open(instance->message_sender) != RESULT_OK)
AzureIoTClient 39:e98d5df6dc74 678 {
AzureIoTClient 39:e98d5df6dc74 679 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_087: [If messagesender_open() fails, amqp_messenger_do_work() shall fail and return]
AzureIoTClient 39:e98d5df6dc74 680 LogError("Failed opening the AMQP message sender.");
AzureIoTClient 39:e98d5df6dc74 681 destroy_message_sender(instance);
AzureIoTClient 39:e98d5df6dc74 682 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 683 }
AzureIoTClient 39:e98d5df6dc74 684 else
AzureIoTClient 39:e98d5df6dc74 685 {
AzureIoTClient 39:e98d5df6dc74 686 result = RESULT_OK;
AzureIoTClient 39:e98d5df6dc74 687 }
AzureIoTClient 39:e98d5df6dc74 688 }
AzureIoTClient 39:e98d5df6dc74 689
AzureIoTClient 39:e98d5df6dc74 690 return result;
AzureIoTClient 39:e98d5df6dc74 691 }
AzureIoTClient 39:e98d5df6dc74 692
AzureIoTClient 39:e98d5df6dc74 693 static void destroy_message_receiver(AMQP_MESSENGER_INSTANCE* instance)
AzureIoTClient 39:e98d5df6dc74 694 {
AzureIoTClient 39:e98d5df6dc74 695 if (instance->message_receiver != NULL)
AzureIoTClient 39:e98d5df6dc74 696 {
AzureIoTClient 39:e98d5df6dc74 697 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_113: [`instance->message_receiver` shall be closed using messagereceiver_close()]
AzureIoTClient 39:e98d5df6dc74 698 if (messagereceiver_close(instance->message_receiver) != RESULT_OK)
AzureIoTClient 39:e98d5df6dc74 699 {
AzureIoTClient 39:e98d5df6dc74 700 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_114: [If messagereceiver_close() fails, it shall be logged and ignored]
AzureIoTClient 39:e98d5df6dc74 701 LogError("Failed closing the AMQP message receiver (this failure will be ignored).");
AzureIoTClient 39:e98d5df6dc74 702 }
AzureIoTClient 39:e98d5df6dc74 703
AzureIoTClient 39:e98d5df6dc74 704 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_115: [`instance->message_receiver` shall be destroyed using messagereceiver_destroy()]
AzureIoTClient 39:e98d5df6dc74 705 messagereceiver_destroy(instance->message_receiver);
AzureIoTClient 39:e98d5df6dc74 706
AzureIoTClient 39:e98d5df6dc74 707 instance->message_receiver = NULL;
AzureIoTClient 39:e98d5df6dc74 708 }
AzureIoTClient 39:e98d5df6dc74 709
AzureIoTClient 45:c09fac270e60 710 instance->message_receiver_current_state = MESSAGE_RECEIVER_STATE_IDLE;
AzureIoTClient 45:c09fac270e60 711 instance->message_receiver_previous_state = MESSAGE_RECEIVER_STATE_IDLE;
AzureIoTClient 45:c09fac270e60 712 instance->last_message_receiver_state_change_time = INDEFINITE_TIME;
AzureIoTClient 45:c09fac270e60 713
AzureIoTClient 39:e98d5df6dc74 714 if (instance->receiver_link != NULL)
AzureIoTClient 39:e98d5df6dc74 715 {
AzureIoTClient 39:e98d5df6dc74 716 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_116: [`instance->receiver_link` shall be destroyed using link_destroy()]
AzureIoTClient 39:e98d5df6dc74 717 link_destroy(instance->receiver_link);
AzureIoTClient 39:e98d5df6dc74 718 instance->receiver_link = NULL;
AzureIoTClient 39:e98d5df6dc74 719 }
AzureIoTClient 39:e98d5df6dc74 720 }
AzureIoTClient 39:e98d5df6dc74 721
AzureIoTClient 39:e98d5df6dc74 722 static void on_message_receiver_state_changed_callback(const void* context, MESSAGE_RECEIVER_STATE new_state, MESSAGE_RECEIVER_STATE previous_state)
AzureIoTClient 39:e98d5df6dc74 723 {
AzureIoTClient 39:e98d5df6dc74 724 if (context == NULL)
AzureIoTClient 39:e98d5df6dc74 725 {
AzureIoTClient 39:e98d5df6dc74 726 LogError("on_message_receiver_state_changed_callback was invoked with a NULL context; although unexpected, this failure will be ignored");
AzureIoTClient 39:e98d5df6dc74 727 }
AzureIoTClient 39:e98d5df6dc74 728 else
AzureIoTClient 39:e98d5df6dc74 729 {
AzureIoTClient 39:e98d5df6dc74 730 if (new_state != previous_state)
AzureIoTClient 39:e98d5df6dc74 731 {
AzureIoTClient 39:e98d5df6dc74 732 AMQP_MESSENGER_INSTANCE* instance = (AMQP_MESSENGER_INSTANCE*)context;
AzureIoTClient 39:e98d5df6dc74 733
AzureIoTClient 39:e98d5df6dc74 734 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_105: [`new_state`, `previous_state` shall be saved into `instance->message_receiver_previous_state` and `instance->message_receiver_current_state`]
AzureIoTClient 39:e98d5df6dc74 735 instance->message_receiver_current_state = new_state;
AzureIoTClient 39:e98d5df6dc74 736 instance->message_receiver_previous_state = previous_state;
AzureIoTClient 39:e98d5df6dc74 737 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_106: [`instance->last_message_receiver_state_change_time` shall be set using get_time()]
AzureIoTClient 39:e98d5df6dc74 738 instance->last_message_receiver_state_change_time = get_time(NULL);
AzureIoTClient 39:e98d5df6dc74 739
AzureIoTClient 39:e98d5df6dc74 740 if (new_state == MESSAGE_RECEIVER_STATE_OPEN)
AzureIoTClient 39:e98d5df6dc74 741 {
AzureIoTClient 39:e98d5df6dc74 742 if (instance->config->on_subscription_changed_callback != NULL)
AzureIoTClient 39:e98d5df6dc74 743 {
AzureIoTClient 39:e98d5df6dc74 744 instance->config->on_subscription_changed_callback(instance->config->on_subscription_changed_context, true);
AzureIoTClient 39:e98d5df6dc74 745 }
AzureIoTClient 39:e98d5df6dc74 746 }
AzureIoTClient 39:e98d5df6dc74 747 else if (previous_state == MESSAGE_RECEIVER_STATE_OPEN && new_state != MESSAGE_RECEIVER_STATE_OPEN)
AzureIoTClient 39:e98d5df6dc74 748 {
AzureIoTClient 39:e98d5df6dc74 749 if (instance->config->on_subscription_changed_callback != NULL)
AzureIoTClient 39:e98d5df6dc74 750 {
AzureIoTClient 39:e98d5df6dc74 751 instance->config->on_subscription_changed_callback(instance->config->on_subscription_changed_context, false);
AzureIoTClient 39:e98d5df6dc74 752 }
AzureIoTClient 39:e98d5df6dc74 753 }
AzureIoTClient 39:e98d5df6dc74 754 }
AzureIoTClient 39:e98d5df6dc74 755 }
AzureIoTClient 39:e98d5df6dc74 756 }
AzureIoTClient 39:e98d5df6dc74 757
AzureIoTClient 39:e98d5df6dc74 758 static AMQP_MESSENGER_MESSAGE_DISPOSITION_INFO* create_message_disposition_info(AMQP_MESSENGER_INSTANCE* messenger)
AzureIoTClient 39:e98d5df6dc74 759 {
AzureIoTClient 39:e98d5df6dc74 760 AMQP_MESSENGER_MESSAGE_DISPOSITION_INFO* result;
AzureIoTClient 39:e98d5df6dc74 761
AzureIoTClient 39:e98d5df6dc74 762 if ((result = (AMQP_MESSENGER_MESSAGE_DISPOSITION_INFO*)malloc(sizeof(AMQP_MESSENGER_MESSAGE_DISPOSITION_INFO))) == NULL)
AzureIoTClient 39:e98d5df6dc74 763 {
AzureIoTClient 39:e98d5df6dc74 764 LogError("Failed creating AMQP_MESSENGER_MESSAGE_DISPOSITION_INFO container (malloc failed)");
AzureIoTClient 39:e98d5df6dc74 765 result = NULL;
AzureIoTClient 39:e98d5df6dc74 766 }
AzureIoTClient 39:e98d5df6dc74 767 else
AzureIoTClient 39:e98d5df6dc74 768 {
AzureIoTClient 39:e98d5df6dc74 769 delivery_number message_id;
AzureIoTClient 39:e98d5df6dc74 770
AzureIoTClient 39:e98d5df6dc74 771 if (messagereceiver_get_received_message_id(messenger->message_receiver, &message_id) != RESULT_OK)
AzureIoTClient 39:e98d5df6dc74 772 {
AzureIoTClient 39:e98d5df6dc74 773 LogError("Failed creating AMQP_MESSENGER_MESSAGE_DISPOSITION_INFO container (messagereceiver_get_received_message_id failed)");
AzureIoTClient 39:e98d5df6dc74 774 free(result);
AzureIoTClient 39:e98d5df6dc74 775 result = NULL;
AzureIoTClient 39:e98d5df6dc74 776 }
AzureIoTClient 39:e98d5df6dc74 777 else
AzureIoTClient 39:e98d5df6dc74 778 {
AzureIoTClient 39:e98d5df6dc74 779 const char* link_name;
AzureIoTClient 39:e98d5df6dc74 780
AzureIoTClient 39:e98d5df6dc74 781 if (messagereceiver_get_link_name(messenger->message_receiver, &link_name) != RESULT_OK)
AzureIoTClient 39:e98d5df6dc74 782 {
AzureIoTClient 39:e98d5df6dc74 783 LogError("Failed creating AMQP_MESSENGER_MESSAGE_DISPOSITION_INFO container (messagereceiver_get_link_name failed)");
AzureIoTClient 39:e98d5df6dc74 784 free(result);
AzureIoTClient 39:e98d5df6dc74 785 result = NULL;
AzureIoTClient 39:e98d5df6dc74 786 }
AzureIoTClient 39:e98d5df6dc74 787 else if (mallocAndStrcpy_s(&result->source, link_name) != RESULT_OK)
AzureIoTClient 39:e98d5df6dc74 788 {
AzureIoTClient 39:e98d5df6dc74 789 LogError("Failed creating AMQP_MESSENGER_MESSAGE_DISPOSITION_INFO container (failed copying link name)");
AzureIoTClient 39:e98d5df6dc74 790 free(result);
AzureIoTClient 39:e98d5df6dc74 791 result = NULL;
AzureIoTClient 39:e98d5df6dc74 792 }
AzureIoTClient 39:e98d5df6dc74 793 else
AzureIoTClient 39:e98d5df6dc74 794 {
AzureIoTClient 39:e98d5df6dc74 795 result->message_id = message_id;
AzureIoTClient 39:e98d5df6dc74 796 }
AzureIoTClient 39:e98d5df6dc74 797 }
AzureIoTClient 39:e98d5df6dc74 798 }
AzureIoTClient 39:e98d5df6dc74 799
AzureIoTClient 39:e98d5df6dc74 800 return result;
AzureIoTClient 39:e98d5df6dc74 801 }
AzureIoTClient 39:e98d5df6dc74 802
AzureIoTClient 39:e98d5df6dc74 803 static void destroy_message_disposition_info(AMQP_MESSENGER_MESSAGE_DISPOSITION_INFO* disposition_info)
AzureIoTClient 39:e98d5df6dc74 804 {
AzureIoTClient 39:e98d5df6dc74 805 free(disposition_info->source);
AzureIoTClient 39:e98d5df6dc74 806 free(disposition_info);
AzureIoTClient 39:e98d5df6dc74 807 }
AzureIoTClient 39:e98d5df6dc74 808
AzureIoTClient 39:e98d5df6dc74 809 static AMQP_VALUE create_uamqp_disposition_result_from(AMQP_MESSENGER_DISPOSITION_RESULT disposition_result)
AzureIoTClient 39:e98d5df6dc74 810 {
AzureIoTClient 39:e98d5df6dc74 811 AMQP_VALUE uamqp_disposition_result;
AzureIoTClient 39:e98d5df6dc74 812
AzureIoTClient 39:e98d5df6dc74 813 if (disposition_result == AMQP_MESSENGER_DISPOSITION_RESULT_NONE)
AzureIoTClient 39:e98d5df6dc74 814 {
AzureIoTClient 39:e98d5df6dc74 815 uamqp_disposition_result = NULL; // intentionally not sending an answer.
AzureIoTClient 39:e98d5df6dc74 816 }
AzureIoTClient 39:e98d5df6dc74 817 else if (disposition_result == AMQP_MESSENGER_DISPOSITION_RESULT_ACCEPTED)
AzureIoTClient 39:e98d5df6dc74 818 {
AzureIoTClient 39:e98d5df6dc74 819 uamqp_disposition_result = messaging_delivery_accepted();
AzureIoTClient 39:e98d5df6dc74 820 }
AzureIoTClient 39:e98d5df6dc74 821 else if (disposition_result == AMQP_MESSENGER_DISPOSITION_RESULT_RELEASED)
AzureIoTClient 39:e98d5df6dc74 822 {
AzureIoTClient 39:e98d5df6dc74 823 uamqp_disposition_result = messaging_delivery_released();
AzureIoTClient 39:e98d5df6dc74 824 }
AzureIoTClient 39:e98d5df6dc74 825 else // id est, if (disposition_result == AMQP_MESSENGER_DISPOSITION_RESULT_REJECTED)
AzureIoTClient 39:e98d5df6dc74 826 {
AzureIoTClient 39:e98d5df6dc74 827 uamqp_disposition_result = messaging_delivery_rejected("Rejected by application", "Rejected by application");
AzureIoTClient 39:e98d5df6dc74 828 }
AzureIoTClient 39:e98d5df6dc74 829
AzureIoTClient 39:e98d5df6dc74 830 return uamqp_disposition_result;
AzureIoTClient 39:e98d5df6dc74 831 }
AzureIoTClient 39:e98d5df6dc74 832
AzureIoTClient 39:e98d5df6dc74 833 static AMQP_VALUE on_message_received_internal_callback(const void* context, MESSAGE_HANDLE message)
AzureIoTClient 39:e98d5df6dc74 834 {
AzureIoTClient 39:e98d5df6dc74 835 AMQP_VALUE result;
AzureIoTClient 39:e98d5df6dc74 836 AMQP_MESSENGER_INSTANCE* instance = (AMQP_MESSENGER_INSTANCE*)context;
AzureIoTClient 39:e98d5df6dc74 837 AMQP_MESSENGER_MESSAGE_DISPOSITION_INFO* message_disposition_info;
AzureIoTClient 39:e98d5df6dc74 838
AzureIoTClient 39:e98d5df6dc74 839 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_107: [A AMQP_MESSENGER_MESSAGE_DISPOSITION_INFO instance shall be created containing the source link name and message delivery ID]
AzureIoTClient 39:e98d5df6dc74 840 if ((message_disposition_info = create_message_disposition_info(instance)) == NULL)
AzureIoTClient 39:e98d5df6dc74 841 {
AzureIoTClient 39:e98d5df6dc74 842 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_108: [If the AMQP_MESSENGER_MESSAGE_DISPOSITION_INFO instance fails to be created, on_message_received_internal_callback shall return the result of messaging_delivery_released()]
AzureIoTClient 39:e98d5df6dc74 843 LogError("on_message_received_internal_callback failed (failed creating AMQP_MESSENGER_MESSAGE_DISPOSITION_INFO).");
AzureIoTClient 39:e98d5df6dc74 844 result = messaging_delivery_released();
AzureIoTClient 39:e98d5df6dc74 845 }
AzureIoTClient 39:e98d5df6dc74 846 else
AzureIoTClient 39:e98d5df6dc74 847 {
AzureIoTClient 39:e98d5df6dc74 848 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_109: [`instance->on_message_received_callback` shall be invoked passing the `message` and AMQP_MESSENGER_MESSAGE_DISPOSITION_INFO instance]
AzureIoTClient 39:e98d5df6dc74 849 AMQP_MESSENGER_DISPOSITION_RESULT disposition_result = instance->on_message_received_callback(message, message_disposition_info, instance->on_message_received_context);
AzureIoTClient 39:e98d5df6dc74 850
AzureIoTClient 39:e98d5df6dc74 851 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_110: [If `instance->on_message_received_callback` returns AMQP_MESSENGER_DISPOSITION_RESULT_ACCEPTED, on_message_received_internal_callback shall return the result of messaging_delivery_accepted()]
AzureIoTClient 39:e98d5df6dc74 852 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_111: [If `instance->on_message_received_callback` returns AMQP_MESSENGER_DISPOSITION_RESULT_RELEASED, on_message_received_internal_callback shall return the result of messaging_delivery_released()]
AzureIoTClient 39:e98d5df6dc74 853 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_112: [If `instance->on_message_received_callback` returns AMQP_MESSENGER_DISPOSITION_RESULT_REJECTED, on_message_received_internal_callback shall return the result of messaging_delivery_rejected()]
AzureIoTClient 39:e98d5df6dc74 854 result = create_uamqp_disposition_result_from(disposition_result);
AzureIoTClient 39:e98d5df6dc74 855 }
AzureIoTClient 39:e98d5df6dc74 856
AzureIoTClient 39:e98d5df6dc74 857 return result;
AzureIoTClient 39:e98d5df6dc74 858 }
AzureIoTClient 39:e98d5df6dc74 859
AzureIoTClient 39:e98d5df6dc74 860 static int create_message_receiver(AMQP_MESSENGER_INSTANCE* instance)
AzureIoTClient 39:e98d5df6dc74 861 {
AzureIoTClient 39:e98d5df6dc74 862 int result;
AzureIoTClient 39:e98d5df6dc74 863
AzureIoTClient 39:e98d5df6dc74 864 if ((instance->receiver_link = create_link(role_receiver,
AzureIoTClient 54:830550fef7ea 865 instance->session_handle, &instance->config->receive_link, instance->config->iothub_host_fqdn, instance->config->device_id, instance->config->module_id)) == NULL)
AzureIoTClient 39:e98d5df6dc74 866 {
AzureIoTClient 39:e98d5df6dc74 867 LogError("Failed creating the message receiver link");
AzureIoTClient 39:e98d5df6dc74 868 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 869 }
AzureIoTClient 39:e98d5df6dc74 870 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_101: [`instance->message_receiver` shall be created using messagereceiver_create(), passing the `instance->receiver_link` and `on_message_receiver_state_changed_callback`]
AzureIoTClient 39:e98d5df6dc74 871 else if ((instance->message_receiver = messagereceiver_create(instance->receiver_link, on_message_receiver_state_changed_callback, (void*)instance)) == NULL)
AzureIoTClient 39:e98d5df6dc74 872 {
AzureIoTClient 39:e98d5df6dc74 873 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_102: [If messagereceiver_create() fails, amqp_messenger_do_work() shall fail and return]
AzureIoTClient 39:e98d5df6dc74 874 LogError("Failed creating the message receiver (messagereceiver_create failed)");
AzureIoTClient 39:e98d5df6dc74 875 destroy_message_receiver(instance);
AzureIoTClient 39:e98d5df6dc74 876 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 877 }
AzureIoTClient 39:e98d5df6dc74 878 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_103: [`instance->message_receiver` shall be opened using messagereceiver_open() passing `on_message_received_internal_callback`]
AzureIoTClient 39:e98d5df6dc74 879 else if (messagereceiver_open(instance->message_receiver, on_message_received_internal_callback, (void*)instance) != RESULT_OK)
AzureIoTClient 39:e98d5df6dc74 880 {
AzureIoTClient 39:e98d5df6dc74 881 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_104: [If messagereceiver_open() fails, amqp_messenger_do_work() shall fail and return]
AzureIoTClient 39:e98d5df6dc74 882 LogError("Failed opening the AMQP message receiver.");
AzureIoTClient 39:e98d5df6dc74 883 destroy_message_receiver(instance);
AzureIoTClient 39:e98d5df6dc74 884 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 885 }
AzureIoTClient 39:e98d5df6dc74 886 else
AzureIoTClient 39:e98d5df6dc74 887 {
AzureIoTClient 39:e98d5df6dc74 888 result = RESULT_OK;
AzureIoTClient 39:e98d5df6dc74 889 }
AzureIoTClient 39:e98d5df6dc74 890
AzureIoTClient 39:e98d5df6dc74 891 return result;
AzureIoTClient 39:e98d5df6dc74 892 }
AzureIoTClient 39:e98d5df6dc74 893
AzureIoTClient 39:e98d5df6dc74 894 static void on_send_complete_callback(void* context, MESSAGE_SEND_RESULT send_result)
AzureIoTClient 39:e98d5df6dc74 895 {
AzureIoTClient 39:e98d5df6dc74 896 if (context != NULL)
AzureIoTClient 39:e98d5df6dc74 897 {
AzureIoTClient 39:e98d5df6dc74 898 MESSAGE_QUEUE_RESULT mq_result;
AzureIoTClient 39:e98d5df6dc74 899 MESSAGE_SEND_CONTEXT* msg_ctx = (MESSAGE_SEND_CONTEXT*)context;
AzureIoTClient 39:e98d5df6dc74 900
AzureIoTClient 39:e98d5df6dc74 901 if (send_result == MESSAGE_SEND_OK)
AzureIoTClient 39:e98d5df6dc74 902 {
AzureIoTClient 39:e98d5df6dc74 903 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_121: [If no failure occurs, `context->on_process_message_completed_callback` shall be invoked with result MESSAGE_QUEUE_SUCCESS]
AzureIoTClient 39:e98d5df6dc74 904 mq_result = MESSAGE_QUEUE_SUCCESS;
AzureIoTClient 39:e98d5df6dc74 905 }
AzureIoTClient 39:e98d5df6dc74 906 else
AzureIoTClient 39:e98d5df6dc74 907 {
AzureIoTClient 39:e98d5df6dc74 908 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_122: [If a failure occurred, `context->on_process_message_completed_callback` shall be invoked with result MESSAGE_QUEUE_ERROR]
AzureIoTClient 39:e98d5df6dc74 909 mq_result = MESSAGE_QUEUE_ERROR;
AzureIoTClient 39:e98d5df6dc74 910 }
AzureIoTClient 39:e98d5df6dc74 911
AzureIoTClient 39:e98d5df6dc74 912 msg_ctx->on_process_message_completed_callback(msg_ctx->messenger->send_queue, (MQ_MESSAGE_HANDLE)msg_ctx->message, mq_result, NULL);
AzureIoTClient 39:e98d5df6dc74 913 }
AzureIoTClient 39:e98d5df6dc74 914 }
AzureIoTClient 39:e98d5df6dc74 915
AzureIoTClient 39:e98d5df6dc74 916 static void on_process_message_callback(MESSAGE_QUEUE_HANDLE message_queue, MQ_MESSAGE_HANDLE message, PROCESS_MESSAGE_COMPLETED_CALLBACK on_process_message_completed_callback, void* context)
AzureIoTClient 39:e98d5df6dc74 917 {
AzureIoTClient 39:e98d5df6dc74 918 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_117: [If any argument is NULL, `on_process_message_callback` shall return immediatelly]
AzureIoTClient 39:e98d5df6dc74 919 if (message_queue == NULL || message == NULL || on_process_message_completed_callback == NULL || context == NULL)
AzureIoTClient 39:e98d5df6dc74 920 {
AzureIoTClient 39:e98d5df6dc74 921 LogError("Invalid argument (message_queue=%p, message=%p, on_process_message_completed_callback=%p, context=%p)", message_queue, message, on_process_message_completed_callback, context);
AzureIoTClient 39:e98d5df6dc74 922 }
AzureIoTClient 39:e98d5df6dc74 923 else
AzureIoTClient 39:e98d5df6dc74 924 {
AzureIoTClient 39:e98d5df6dc74 925 MESSAGE_SEND_CONTEXT* message_context = (MESSAGE_SEND_CONTEXT*)context;
AzureIoTClient 39:e98d5df6dc74 926 message_context->on_process_message_completed_callback = on_process_message_completed_callback;
AzureIoTClient 39:e98d5df6dc74 927
AzureIoTClient 39:e98d5df6dc74 928 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_118: [The MESSAGE_HANDLE shall be submitted for sending using messagesender_send(), passing `on_send_complete_callback`]
AzureIoTClient 43:3da2d93bb955 929 if (messagesender_send_async(message_context->messenger->message_sender, (MESSAGE_HANDLE)message, on_send_complete_callback, context, 0) == NULL)
AzureIoTClient 39:e98d5df6dc74 930 {
AzureIoTClient 39:e98d5df6dc74 931 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_119: [If messagesender_send() fails, `on_process_message_completed_callback` shall be invoked with result MESSAGE_QUEUE_ERROR]
AzureIoTClient 39:e98d5df6dc74 932 LogError("Failed sending AMQP message");
AzureIoTClient 39:e98d5df6dc74 933 on_process_message_completed_callback(message_queue, message, MESSAGE_QUEUE_ERROR, NULL);
AzureIoTClient 39:e98d5df6dc74 934 }
AzureIoTClient 39:e98d5df6dc74 935
AzureIoTClient 39:e98d5df6dc74 936 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_120: [The MESSAGE_HANDLE shall be destroyed using message_destroy() and marked as destroyed in the context provided]
AzureIoTClient 39:e98d5df6dc74 937 message_destroy((MESSAGE_HANDLE)message);
AzureIoTClient 39:e98d5df6dc74 938 message_context->is_destroyed = true;
AzureIoTClient 39:e98d5df6dc74 939 }
AzureIoTClient 39:e98d5df6dc74 940 }
AzureIoTClient 39:e98d5df6dc74 941
AzureIoTClient 39:e98d5df6dc74 942 static void on_message_processing_completed_callback(MQ_MESSAGE_HANDLE message, MESSAGE_QUEUE_RESULT result, USER_DEFINED_REASON reason, void* message_context)
AzureIoTClient 39:e98d5df6dc74 943 {
AzureIoTClient 39:e98d5df6dc74 944 (void)reason;
AzureIoTClient 39:e98d5df6dc74 945
AzureIoTClient 39:e98d5df6dc74 946 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_020: [If `messenger_context` is NULL, `on_message_processing_completed_callback` shall return immediately]
AzureIoTClient 39:e98d5df6dc74 947 if (message_context == NULL)
AzureIoTClient 39:e98d5df6dc74 948 {
AzureIoTClient 39:e98d5df6dc74 949 LogError("on_message_processing_completed_callback invoked with NULL context");
AzureIoTClient 39:e98d5df6dc74 950 }
AzureIoTClient 39:e98d5df6dc74 951 else
AzureIoTClient 39:e98d5df6dc74 952 {
AzureIoTClient 39:e98d5df6dc74 953 MESSAGE_SEND_CONTEXT* msg_ctx = (MESSAGE_SEND_CONTEXT*)message_context;
AzureIoTClient 39:e98d5df6dc74 954 AMQP_MESSENGER_SEND_RESULT messenger_send_result;
AzureIoTClient 39:e98d5df6dc74 955 AMQP_MESSENGER_REASON messenger_send_reason;
AzureIoTClient 39:e98d5df6dc74 956
AzureIoTClient 39:e98d5df6dc74 957 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_021: [If `result` is MESSAGE_QUEUE_SUCCESS, `send_ctx->on_send_complete_callback` shall be invoked with AMQP_MESSENGER_SEND_RESULT_SUCCESS and AMQP_MESSENGER_REASON_NONE]
AzureIoTClient 39:e98d5df6dc74 958 if (result == MESSAGE_QUEUE_SUCCESS)
AzureIoTClient 39:e98d5df6dc74 959 {
AzureIoTClient 39:e98d5df6dc74 960 messenger_send_result = AMQP_MESSENGER_SEND_RESULT_SUCCESS;
AzureIoTClient 39:e98d5df6dc74 961 messenger_send_reason = AMQP_MESSENGER_REASON_NONE;
AzureIoTClient 39:e98d5df6dc74 962
AzureIoTClient 39:e98d5df6dc74 963 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_025: [If `result` is MESSAGE_QUEUE_SUCCESS or MESSAGE_QUEUE_CANCELLED, `instance->send_error_count` shall be set to 0]
AzureIoTClient 39:e98d5df6dc74 964 msg_ctx->messenger->send_error_count = 0;
AzureIoTClient 39:e98d5df6dc74 965 }
AzureIoTClient 39:e98d5df6dc74 966 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_022: [If `result` is MESSAGE_QUEUE_TIMEOUT, `send_ctx->on_send_complete_callback` shall be invoked with AMQP_MESSENGER_SEND_RESULT_ERROR and AMQP_MESSENGER_REASON_TIMEOUT]
AzureIoTClient 39:e98d5df6dc74 967 else if (result == MESSAGE_QUEUE_TIMEOUT)
AzureIoTClient 39:e98d5df6dc74 968 {
AzureIoTClient 39:e98d5df6dc74 969 messenger_send_result = AMQP_MESSENGER_SEND_RESULT_ERROR;
AzureIoTClient 39:e98d5df6dc74 970 messenger_send_reason = AMQP_MESSENGER_REASON_TIMEOUT;
AzureIoTClient 39:e98d5df6dc74 971
AzureIoTClient 39:e98d5df6dc74 972 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_026: [Otherwise `instance->send_error_count` shall be incremented by 1]
AzureIoTClient 39:e98d5df6dc74 973 msg_ctx->messenger->send_error_count++;
AzureIoTClient 39:e98d5df6dc74 974 }
AzureIoTClient 39:e98d5df6dc74 975 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_023: [If `result` is MESSAGE_QUEUE_CANCELLED and the messenger is STOPPED, `send_ctx->on_send_complete_callback` shall be invoked with AMQP_MESSENGER_SEND_RESULT_CANCELLED and AMQP_MESSENGER_REASON_MESSENGER_DESTROYED]
AzureIoTClient 39:e98d5df6dc74 976 else if (result == MESSAGE_QUEUE_CANCELLED && msg_ctx->messenger->state == AMQP_MESSENGER_STATE_STOPPED)
AzureIoTClient 39:e98d5df6dc74 977 {
AzureIoTClient 39:e98d5df6dc74 978 messenger_send_result = AMQP_MESSENGER_SEND_RESULT_CANCELLED;
AzureIoTClient 39:e98d5df6dc74 979 messenger_send_reason = AMQP_MESSENGER_REASON_MESSENGER_DESTROYED;
AzureIoTClient 39:e98d5df6dc74 980
AzureIoTClient 39:e98d5df6dc74 981 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_025: [If `result` is MESSAGE_QUEUE_SUCCESS or MESSAGE_QUEUE_CANCELLED, `instance->send_error_count` shall be set to 0]
AzureIoTClient 39:e98d5df6dc74 982 msg_ctx->messenger->send_error_count = 0;
AzureIoTClient 39:e98d5df6dc74 983 }
AzureIoTClient 39:e98d5df6dc74 984 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_024: [Otherwise `send_ctx->on_send_complete_callback` shall be invoked with AMQP_MESSENGER_SEND_RESULT_ERROR and AMQP_MESSENGER_REASON_FAIL_SENDING]
AzureIoTClient 39:e98d5df6dc74 985 else
AzureIoTClient 39:e98d5df6dc74 986 {
AzureIoTClient 39:e98d5df6dc74 987 messenger_send_result = AMQP_MESSENGER_SEND_RESULT_ERROR;
AzureIoTClient 39:e98d5df6dc74 988 messenger_send_reason = AMQP_MESSENGER_REASON_FAIL_SENDING;
AzureIoTClient 39:e98d5df6dc74 989
AzureIoTClient 39:e98d5df6dc74 990 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_026: [Otherwise `instance->send_error_count` shall be incremented by 1]
AzureIoTClient 39:e98d5df6dc74 991 msg_ctx->messenger->send_error_count++;
AzureIoTClient 39:e98d5df6dc74 992 }
AzureIoTClient 39:e98d5df6dc74 993
AzureIoTClient 39:e98d5df6dc74 994 if (msg_ctx->on_send_complete_callback != NULL)
AzureIoTClient 39:e98d5df6dc74 995 {
AzureIoTClient 39:e98d5df6dc74 996 msg_ctx->on_send_complete_callback(messenger_send_result, messenger_send_reason, msg_ctx->user_context);
AzureIoTClient 39:e98d5df6dc74 997 }
AzureIoTClient 39:e98d5df6dc74 998
AzureIoTClient 39:e98d5df6dc74 999 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_027: [If `message` has not been destroyed, it shall be destroyed using message_destroy()]
AzureIoTClient 39:e98d5df6dc74 1000 if (!msg_ctx->is_destroyed)
AzureIoTClient 39:e98d5df6dc74 1001 {
AzureIoTClient 39:e98d5df6dc74 1002 message_destroy((MESSAGE_HANDLE)message);
AzureIoTClient 39:e98d5df6dc74 1003 }
AzureIoTClient 39:e98d5df6dc74 1004
AzureIoTClient 39:e98d5df6dc74 1005 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_028: [`send_ctx` shall be destroyed]
AzureIoTClient 39:e98d5df6dc74 1006 destroy_message_send_context(msg_ctx);
AzureIoTClient 39:e98d5df6dc74 1007 }
AzureIoTClient 39:e98d5df6dc74 1008 }
AzureIoTClient 39:e98d5df6dc74 1009
AzureIoTClient 39:e98d5df6dc74 1010
AzureIoTClient 39:e98d5df6dc74 1011 // ---------- Set/Retrieve Options Helpers ----------//
AzureIoTClient 39:e98d5df6dc74 1012
AzureIoTClient 39:e98d5df6dc74 1013 static void* amqp_messenger_clone_option(const char* name, const void* value)
AzureIoTClient 39:e98d5df6dc74 1014 {
AzureIoTClient 39:e98d5df6dc74 1015 void* result;
AzureIoTClient 39:e98d5df6dc74 1016
AzureIoTClient 39:e98d5df6dc74 1017 if (name == NULL || value == NULL)
AzureIoTClient 39:e98d5df6dc74 1018 {
AzureIoTClient 39:e98d5df6dc74 1019 LogError("invalid argument (name=%p, value=%p)", name, value);
AzureIoTClient 39:e98d5df6dc74 1020 result = NULL;
AzureIoTClient 39:e98d5df6dc74 1021 }
AzureIoTClient 39:e98d5df6dc74 1022 else
AzureIoTClient 39:e98d5df6dc74 1023 {
AzureIoTClient 39:e98d5df6dc74 1024 if (strcmp(MESSENGER_SAVED_MQ_OPTIONS, name) == 0)
AzureIoTClient 39:e98d5df6dc74 1025 {
AzureIoTClient 39:e98d5df6dc74 1026 if ((result = (void*)OptionHandler_Clone((OPTIONHANDLER_HANDLE)value)) == NULL)
AzureIoTClient 39:e98d5df6dc74 1027 {
AzureIoTClient 39:e98d5df6dc74 1028 LogError("failed cloning option '%s'", name);
AzureIoTClient 39:e98d5df6dc74 1029 }
AzureIoTClient 39:e98d5df6dc74 1030 }
AzureIoTClient 39:e98d5df6dc74 1031 else
AzureIoTClient 39:e98d5df6dc74 1032 {
AzureIoTClient 39:e98d5df6dc74 1033 LogError("Failed to clone messenger option (option with name '%s' is not suppported)", name);
AzureIoTClient 39:e98d5df6dc74 1034 result = NULL;
AzureIoTClient 39:e98d5df6dc74 1035 }
AzureIoTClient 39:e98d5df6dc74 1036 }
AzureIoTClient 39:e98d5df6dc74 1037
AzureIoTClient 39:e98d5df6dc74 1038 return result;
AzureIoTClient 39:e98d5df6dc74 1039 }
AzureIoTClient 39:e98d5df6dc74 1040
AzureIoTClient 39:e98d5df6dc74 1041 static void amqp_messenger_destroy_option(const char* name, const void* value)
AzureIoTClient 39:e98d5df6dc74 1042 {
AzureIoTClient 39:e98d5df6dc74 1043 if (name == NULL || value == NULL)
AzureIoTClient 39:e98d5df6dc74 1044 {
AzureIoTClient 39:e98d5df6dc74 1045 LogError("invalid argument (name=%p, value=%p)", name, value);
AzureIoTClient 39:e98d5df6dc74 1046 }
AzureIoTClient 39:e98d5df6dc74 1047 else if (strcmp(MESSENGER_SAVED_MQ_OPTIONS, name) == 0)
AzureIoTClient 39:e98d5df6dc74 1048 {
AzureIoTClient 39:e98d5df6dc74 1049 OptionHandler_Destroy((OPTIONHANDLER_HANDLE)value);
AzureIoTClient 39:e98d5df6dc74 1050 }
AzureIoTClient 39:e98d5df6dc74 1051 else
AzureIoTClient 39:e98d5df6dc74 1052 {
AzureIoTClient 39:e98d5df6dc74 1053 LogError("invalid argument (option '%s' is not suppported)", name);
AzureIoTClient 39:e98d5df6dc74 1054 }
AzureIoTClient 39:e98d5df6dc74 1055 }
AzureIoTClient 39:e98d5df6dc74 1056
AzureIoTClient 39:e98d5df6dc74 1057
AzureIoTClient 39:e98d5df6dc74 1058 // Public API:
AzureIoTClient 39:e98d5df6dc74 1059
AzureIoTClient 39:e98d5df6dc74 1060 int amqp_messenger_subscribe_for_messages(AMQP_MESSENGER_HANDLE messenger_handle, ON_AMQP_MESSENGER_MESSAGE_RECEIVED on_message_received_callback, void* context)
AzureIoTClient 39:e98d5df6dc74 1061 {
AzureIoTClient 39:e98d5df6dc74 1062 int result;
AzureIoTClient 39:e98d5df6dc74 1063
AzureIoTClient 39:e98d5df6dc74 1064 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_035: [If `messenger_handle` or `on_message_received_callback` are NULL, amqp_messenger_subscribe_for_messages() shall fail and return non-zero value]
AzureIoTClient 39:e98d5df6dc74 1065 if (messenger_handle == NULL || on_message_received_callback == NULL || context == NULL)
AzureIoTClient 39:e98d5df6dc74 1066 {
AzureIoTClient 39:e98d5df6dc74 1067 LogError("Invalid argument (messenger_handle=%p, on_message_received_callback=%p, context=%p)", messenger_handle, on_message_received_callback, context);
AzureIoTClient 39:e98d5df6dc74 1068 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 1069 }
AzureIoTClient 39:e98d5df6dc74 1070 else
AzureIoTClient 39:e98d5df6dc74 1071 {
AzureIoTClient 39:e98d5df6dc74 1072 AMQP_MESSENGER_INSTANCE* instance = (AMQP_MESSENGER_INSTANCE*)messenger_handle;
AzureIoTClient 39:e98d5df6dc74 1073
AzureIoTClient 39:e98d5df6dc74 1074 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_036: [`on_message_received_callback` and `context` shall be saved on `instance->on_message_received_callback`]
AzureIoTClient 39:e98d5df6dc74 1075 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_037: [amqp_messenger_subscribe_for_messages() shall set `instance->receive_messages` to true]
AzureIoTClient 39:e98d5df6dc74 1076 instance->on_message_received_callback = on_message_received_callback;
AzureIoTClient 39:e98d5df6dc74 1077 instance->on_message_received_context = context;
AzureIoTClient 39:e98d5df6dc74 1078 instance->receive_messages = true;
AzureIoTClient 39:e98d5df6dc74 1079
AzureIoTClient 39:e98d5df6dc74 1080 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_038: [If no failures occurr, amqp_messenger_subscribe_for_messages() shall return 0]
AzureIoTClient 39:e98d5df6dc74 1081 result = RESULT_OK;
AzureIoTClient 39:e98d5df6dc74 1082 }
AzureIoTClient 39:e98d5df6dc74 1083
AzureIoTClient 39:e98d5df6dc74 1084 return result;
AzureIoTClient 39:e98d5df6dc74 1085 }
AzureIoTClient 39:e98d5df6dc74 1086
AzureIoTClient 39:e98d5df6dc74 1087 int amqp_messenger_unsubscribe_for_messages(AMQP_MESSENGER_HANDLE messenger_handle)
AzureIoTClient 39:e98d5df6dc74 1088 {
AzureIoTClient 39:e98d5df6dc74 1089 int result;
AzureIoTClient 39:e98d5df6dc74 1090
AzureIoTClient 39:e98d5df6dc74 1091 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_039: [If `messenger_handle` is NULL, amqp_messenger_unsubscribe_for_messages() shall fail and return non-zero value]
AzureIoTClient 39:e98d5df6dc74 1092 if (messenger_handle == NULL)
AzureIoTClient 39:e98d5df6dc74 1093 {
AzureIoTClient 39:e98d5df6dc74 1094 LogError("Invalid argument (messenger_handle is NULL)");
AzureIoTClient 39:e98d5df6dc74 1095 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 1096 }
AzureIoTClient 39:e98d5df6dc74 1097 else
AzureIoTClient 39:e98d5df6dc74 1098 {
AzureIoTClient 39:e98d5df6dc74 1099 AMQP_MESSENGER_INSTANCE* instance = (AMQP_MESSENGER_INSTANCE*)messenger_handle;
AzureIoTClient 39:e98d5df6dc74 1100
AzureIoTClient 39:e98d5df6dc74 1101 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_040: [`instance->receive_messages` shall be saved to false]
AzureIoTClient 39:e98d5df6dc74 1102 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_041: [`instance->on_message_received_callback` and `instance->on_message_received_context` shall be set to NULL]
AzureIoTClient 39:e98d5df6dc74 1103 instance->receive_messages = false;
AzureIoTClient 39:e98d5df6dc74 1104 instance->on_message_received_callback = NULL;
AzureIoTClient 39:e98d5df6dc74 1105 instance->on_message_received_context = NULL;
AzureIoTClient 39:e98d5df6dc74 1106
AzureIoTClient 39:e98d5df6dc74 1107 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_042: [If no failures occurr, amqp_messenger_unsubscribe_for_messages() shall return 0]
AzureIoTClient 39:e98d5df6dc74 1108 result = RESULT_OK;
AzureIoTClient 39:e98d5df6dc74 1109 }
AzureIoTClient 39:e98d5df6dc74 1110
AzureIoTClient 39:e98d5df6dc74 1111 return result;
AzureIoTClient 39:e98d5df6dc74 1112 }
AzureIoTClient 39:e98d5df6dc74 1113
AzureIoTClient 39:e98d5df6dc74 1114 int amqp_messenger_send_message_disposition(AMQP_MESSENGER_HANDLE messenger_handle, AMQP_MESSENGER_MESSAGE_DISPOSITION_INFO* disposition_info, AMQP_MESSENGER_DISPOSITION_RESULT disposition_result)
AzureIoTClient 39:e98d5df6dc74 1115 {
AzureIoTClient 39:e98d5df6dc74 1116 int result;
AzureIoTClient 39:e98d5df6dc74 1117
AzureIoTClient 39:e98d5df6dc74 1118 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_043: [If `messenger_handle` or `disposition_info` are NULL, amqp_messenger_send_message_disposition() shall fail and return non-zero value]
AzureIoTClient 39:e98d5df6dc74 1119 if (messenger_handle == NULL || disposition_info == NULL)
AzureIoTClient 39:e98d5df6dc74 1120 {
AzureIoTClient 39:e98d5df6dc74 1121 LogError("Invalid argument (messenger_handle=%p, disposition_info=%p)", messenger_handle, disposition_info);
AzureIoTClient 39:e98d5df6dc74 1122 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 1123 }
AzureIoTClient 39:e98d5df6dc74 1124 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_044: [If `disposition_info->source` is NULL, amqp_messenger_send_message_disposition() shall fail and return non-zero value]
AzureIoTClient 39:e98d5df6dc74 1125 else if (disposition_info->source == NULL)
AzureIoTClient 39:e98d5df6dc74 1126 {
AzureIoTClient 39:e98d5df6dc74 1127 LogError("Failed sending message disposition (disposition_info->source is NULL)");
AzureIoTClient 39:e98d5df6dc74 1128 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 1129 }
AzureIoTClient 39:e98d5df6dc74 1130 else
AzureIoTClient 39:e98d5df6dc74 1131 {
AzureIoTClient 39:e98d5df6dc74 1132 AMQP_MESSENGER_INSTANCE* messenger = (AMQP_MESSENGER_INSTANCE*)messenger_handle;
AzureIoTClient 39:e98d5df6dc74 1133
AzureIoTClient 39:e98d5df6dc74 1134 if (messenger->message_receiver == NULL)
AzureIoTClient 39:e98d5df6dc74 1135 {
AzureIoTClient 39:e98d5df6dc74 1136 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_045: [If `messenger_handle->message_receiver` is NULL, amqp_messenger_send_message_disposition() shall fail and return non-zero value]
AzureIoTClient 39:e98d5df6dc74 1137 LogError("Failed sending message disposition (message_receiver is not created; check if it is subscribed)");
AzureIoTClient 39:e98d5df6dc74 1138 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 1139 }
AzureIoTClient 39:e98d5df6dc74 1140 else
AzureIoTClient 39:e98d5df6dc74 1141 {
AzureIoTClient 39:e98d5df6dc74 1142 AMQP_VALUE uamqp_disposition_result;
AzureIoTClient 39:e98d5df6dc74 1143
AzureIoTClient 39:e98d5df6dc74 1144 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_046: [An AMQP_VALUE disposition result shall be created corresponding to the `disposition_result` provided]
AzureIoTClient 39:e98d5df6dc74 1145 if ((uamqp_disposition_result = create_uamqp_disposition_result_from(disposition_result)) == NULL)
AzureIoTClient 39:e98d5df6dc74 1146 {
AzureIoTClient 39:e98d5df6dc74 1147 LogError("Failed sending message disposition (disposition result %d is not supported)", disposition_result);
AzureIoTClient 39:e98d5df6dc74 1148 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 1149 }
AzureIoTClient 39:e98d5df6dc74 1150 else
AzureIoTClient 39:e98d5df6dc74 1151 {
AzureIoTClient 39:e98d5df6dc74 1152 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_047: [`messagereceiver_send_message_disposition()` shall be invoked passing `disposition_info->source`, `disposition_info->message_id` and the AMQP_VALUE disposition result]
AzureIoTClient 39:e98d5df6dc74 1153 if (messagereceiver_send_message_disposition(messenger->message_receiver, disposition_info->source, disposition_info->message_id, uamqp_disposition_result) != RESULT_OK)
AzureIoTClient 39:e98d5df6dc74 1154 {
AzureIoTClient 39:e98d5df6dc74 1155 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_048: [If `messagereceiver_send_message_disposition()` fails, amqp_messenger_send_message_disposition() shall fail and return non-zero value]
AzureIoTClient 39:e98d5df6dc74 1156 LogError("Failed sending message disposition (messagereceiver_send_message_disposition failed)");
AzureIoTClient 39:e98d5df6dc74 1157 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 1158 }
AzureIoTClient 39:e98d5df6dc74 1159 else
AzureIoTClient 39:e98d5df6dc74 1160 {
AzureIoTClient 39:e98d5df6dc74 1161 destroy_message_disposition_info(disposition_info);
AzureIoTClient 39:e98d5df6dc74 1162
AzureIoTClient 39:e98d5df6dc74 1163 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_050: [If no failures occurr, amqp_messenger_send_message_disposition() shall return 0]
AzureIoTClient 39:e98d5df6dc74 1164 result = RESULT_OK;
AzureIoTClient 39:e98d5df6dc74 1165 }
AzureIoTClient 39:e98d5df6dc74 1166
AzureIoTClient 39:e98d5df6dc74 1167 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_049: [amqp_messenger_send_message_disposition() shall destroy the AMQP_VALUE disposition result]
AzureIoTClient 39:e98d5df6dc74 1168 amqpvalue_destroy(uamqp_disposition_result);
AzureIoTClient 39:e98d5df6dc74 1169 }
AzureIoTClient 39:e98d5df6dc74 1170 }
AzureIoTClient 39:e98d5df6dc74 1171 }
AzureIoTClient 39:e98d5df6dc74 1172
AzureIoTClient 39:e98d5df6dc74 1173 return result;
AzureIoTClient 39:e98d5df6dc74 1174 }
AzureIoTClient 39:e98d5df6dc74 1175
AzureIoTClient 39:e98d5df6dc74 1176 int amqp_messenger_send_async(AMQP_MESSENGER_HANDLE messenger_handle, MESSAGE_HANDLE message, AMQP_MESSENGER_SEND_COMPLETE_CALLBACK on_user_defined_send_complete_callback, void* user_context)
AzureIoTClient 39:e98d5df6dc74 1177 {
AzureIoTClient 39:e98d5df6dc74 1178 int result;
AzureIoTClient 39:e98d5df6dc74 1179
AzureIoTClient 39:e98d5df6dc74 1180 if (messenger_handle == NULL || message == NULL || on_user_defined_send_complete_callback == NULL)
AzureIoTClient 39:e98d5df6dc74 1181 {
AzureIoTClient 39:e98d5df6dc74 1182 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_010: [If `messenger_handle`, `message` or `on_event_send_complete_callback` are NULL, amqp_messenger_send_async() shall fail and return a non-zero value]
AzureIoTClient 39:e98d5df6dc74 1183 LogError("Invalid argument (messenger_handle=%p, message=%p, on_user_defined_send_complete_callback=%p)", messenger_handle, message, on_user_defined_send_complete_callback);
AzureIoTClient 39:e98d5df6dc74 1184 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 1185 }
AzureIoTClient 39:e98d5df6dc74 1186 else
AzureIoTClient 39:e98d5df6dc74 1187 {
AzureIoTClient 39:e98d5df6dc74 1188 MESSAGE_HANDLE cloned_message;
AzureIoTClient 39:e98d5df6dc74 1189
AzureIoTClient 39:e98d5df6dc74 1190 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_011: [`message` shall be cloned using message_clone()]
AzureIoTClient 39:e98d5df6dc74 1191 if ((cloned_message = message_clone(message)) == NULL)
AzureIoTClient 39:e98d5df6dc74 1192 {
AzureIoTClient 39:e98d5df6dc74 1193 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_012: [If message_clone() fails, amqp_messenger_send_async() shall fail and return a non-zero value]
AzureIoTClient 39:e98d5df6dc74 1194 LogError("Failed cloning AMQP message");
AzureIoTClient 39:e98d5df6dc74 1195 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 1196 }
AzureIoTClient 39:e98d5df6dc74 1197 else
AzureIoTClient 39:e98d5df6dc74 1198 {
AzureIoTClient 39:e98d5df6dc74 1199 MESSAGE_SEND_CONTEXT* message_context;
AzureIoTClient 39:e98d5df6dc74 1200 AMQP_MESSENGER_INSTANCE *instance = (AMQP_MESSENGER_INSTANCE*)messenger_handle;
AzureIoTClient 39:e98d5df6dc74 1201
AzureIoTClient 39:e98d5df6dc74 1202 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_013: [amqp_messenger_send_async() shall allocate memory for a MESSAGE_SEND_CONTEXT structure (aka `send_ctx`)]
AzureIoTClient 39:e98d5df6dc74 1203 if ((message_context = create_message_send_context()) == NULL)
AzureIoTClient 39:e98d5df6dc74 1204 {
AzureIoTClient 39:e98d5df6dc74 1205 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_014: [If malloc() fails, amqp_messenger_send_async() shall fail and return a non-zero value]
AzureIoTClient 39:e98d5df6dc74 1206 LogError("Failed creating context for sending message");
AzureIoTClient 39:e98d5df6dc74 1207 message_destroy(cloned_message);
AzureIoTClient 39:e98d5df6dc74 1208 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 1209 }
AzureIoTClient 39:e98d5df6dc74 1210 else
AzureIoTClient 39:e98d5df6dc74 1211 {
AzureIoTClient 39:e98d5df6dc74 1212 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_015: [The cloned `message`, callback and context shall be saved in ``send_ctx`]
AzureIoTClient 39:e98d5df6dc74 1213 message_context->message = cloned_message;
AzureIoTClient 39:e98d5df6dc74 1214 message_context->messenger = instance;
AzureIoTClient 39:e98d5df6dc74 1215 message_context->on_send_complete_callback = on_user_defined_send_complete_callback;
AzureIoTClient 39:e98d5df6dc74 1216 message_context->user_context = user_context;
AzureIoTClient 39:e98d5df6dc74 1217
AzureIoTClient 39:e98d5df6dc74 1218 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_016: [`send_ctx` shall be added to `instance->send_queue` using message_queue_add(), passing `on_message_processing_completed_callback`]
AzureIoTClient 39:e98d5df6dc74 1219 if (message_queue_add(instance->send_queue, (MQ_MESSAGE_HANDLE)cloned_message, on_message_processing_completed_callback, (void*)message_context) != RESULT_OK)
AzureIoTClient 39:e98d5df6dc74 1220 {
AzureIoTClient 39:e98d5df6dc74 1221 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_017: [If message_queue_add() fails, amqp_messenger_send_async() shall fail and return a non-zero value]
AzureIoTClient 39:e98d5df6dc74 1222 LogError("Failed adding message to send queue");
AzureIoTClient 39:e98d5df6dc74 1223 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_018: [If any failure occurs, amqp_messenger_send_async() shall free any memory it has allocated]
AzureIoTClient 39:e98d5df6dc74 1224 destroy_message_send_context(message_context);
AzureIoTClient 39:e98d5df6dc74 1225 message_destroy(cloned_message);
AzureIoTClient 39:e98d5df6dc74 1226 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 1227 }
AzureIoTClient 39:e98d5df6dc74 1228 else
AzureIoTClient 39:e98d5df6dc74 1229 {
AzureIoTClient 39:e98d5df6dc74 1230 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_019: [If no failures occur, amqp_messenger_send_async() shall return zero]
AzureIoTClient 39:e98d5df6dc74 1231 result = RESULT_OK;
AzureIoTClient 39:e98d5df6dc74 1232 }
AzureIoTClient 39:e98d5df6dc74 1233 }
AzureIoTClient 39:e98d5df6dc74 1234 }
AzureIoTClient 39:e98d5df6dc74 1235 }
AzureIoTClient 39:e98d5df6dc74 1236
AzureIoTClient 39:e98d5df6dc74 1237 return result;
AzureIoTClient 39:e98d5df6dc74 1238 }
AzureIoTClient 39:e98d5df6dc74 1239
AzureIoTClient 39:e98d5df6dc74 1240 int amqp_messenger_get_send_status(AMQP_MESSENGER_HANDLE messenger_handle, AMQP_MESSENGER_SEND_STATUS* send_status)
AzureIoTClient 39:e98d5df6dc74 1241 {
AzureIoTClient 39:e98d5df6dc74 1242 int result;
AzureIoTClient 39:e98d5df6dc74 1243
AzureIoTClient 39:e98d5df6dc74 1244 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_029: [If `messenger_handle` or `send_status` are NULL, amqp_messenger_get_send_status() shall fail and return a non-zero value]
AzureIoTClient 39:e98d5df6dc74 1245 if (messenger_handle == NULL || send_status == NULL)
AzureIoTClient 39:e98d5df6dc74 1246 {
AzureIoTClient 39:e98d5df6dc74 1247 LogError("Invalid argument (messenger_handle=%p, send_status=%p)", messenger_handle, send_status);
AzureIoTClient 39:e98d5df6dc74 1248 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 1249 }
AzureIoTClient 39:e98d5df6dc74 1250 else
AzureIoTClient 39:e98d5df6dc74 1251 {
AzureIoTClient 39:e98d5df6dc74 1252 AMQP_MESSENGER_INSTANCE* instance = (AMQP_MESSENGER_INSTANCE*)messenger_handle;
AzureIoTClient 39:e98d5df6dc74 1253 bool is_empty;
AzureIoTClient 39:e98d5df6dc74 1254
AzureIoTClient 39:e98d5df6dc74 1255 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_030: [message_queue_is_empty() shall be invoked for `instance->send_queue`]
AzureIoTClient 39:e98d5df6dc74 1256 if (message_queue_is_empty(instance->send_queue, &is_empty) != 0)
AzureIoTClient 39:e98d5df6dc74 1257 {
AzureIoTClient 39:e98d5df6dc74 1258 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_031: [If message_queue_is_empty() fails, amqp_messenger_get_send_status() shall fail and return a non-zero value]
AzureIoTClient 39:e98d5df6dc74 1259 LogError("Failed verifying if send queue is empty");
AzureIoTClient 39:e98d5df6dc74 1260 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 1261 }
AzureIoTClient 39:e98d5df6dc74 1262 else
AzureIoTClient 39:e98d5df6dc74 1263 {
AzureIoTClient 39:e98d5df6dc74 1264 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_032: [If message_queue_is_empty() returns `true`, `send_status` shall be set to AMQP_MESSENGER_SEND_STATUS_IDLE]
AzureIoTClient 39:e98d5df6dc74 1265 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_033: [Otherwise, `send_status` shall be set to AMQP_MESSENGER_SEND_STATUS_BUSY]
AzureIoTClient 39:e98d5df6dc74 1266 *send_status = (is_empty ? AMQP_MESSENGER_SEND_STATUS_IDLE : AMQP_MESSENGER_SEND_STATUS_BUSY);
AzureIoTClient 39:e98d5df6dc74 1267 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_034: [If no failures occur, amqp_messenger_get_send_status() shall return 0]
AzureIoTClient 39:e98d5df6dc74 1268 result = RESULT_OK;
AzureIoTClient 39:e98d5df6dc74 1269 }
AzureIoTClient 39:e98d5df6dc74 1270 }
AzureIoTClient 39:e98d5df6dc74 1271
AzureIoTClient 39:e98d5df6dc74 1272 return result;
AzureIoTClient 39:e98d5df6dc74 1273 }
AzureIoTClient 39:e98d5df6dc74 1274
AzureIoTClient 39:e98d5df6dc74 1275 int amqp_messenger_start(AMQP_MESSENGER_HANDLE messenger_handle, SESSION_HANDLE session_handle)
AzureIoTClient 39:e98d5df6dc74 1276 {
AzureIoTClient 39:e98d5df6dc74 1277 int result;
AzureIoTClient 39:e98d5df6dc74 1278
AzureIoTClient 39:e98d5df6dc74 1279 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_051: [If `messenger_handle` or `session_handle` are NULL, amqp_messenger_start() shall fail and return non-zero value]
AzureIoTClient 39:e98d5df6dc74 1280 if (messenger_handle == NULL || session_handle == NULL)
AzureIoTClient 39:e98d5df6dc74 1281 {
AzureIoTClient 39:e98d5df6dc74 1282 LogError("Invalid argument (session_handle is NULL)");
AzureIoTClient 39:e98d5df6dc74 1283 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 1284 }
AzureIoTClient 39:e98d5df6dc74 1285 else
AzureIoTClient 39:e98d5df6dc74 1286 {
AzureIoTClient 39:e98d5df6dc74 1287 AMQP_MESSENGER_INSTANCE* instance = (AMQP_MESSENGER_INSTANCE*)messenger_handle;
AzureIoTClient 39:e98d5df6dc74 1288
AzureIoTClient 39:e98d5df6dc74 1289 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_052: [If `instance->state` is not AMQP_MESSENGER_STATE_STOPPED, amqp_messenger_start() shall fail and return non-zero value]
AzureIoTClient 39:e98d5df6dc74 1290 if (instance->state != AMQP_MESSENGER_STATE_STOPPED)
AzureIoTClient 39:e98d5df6dc74 1291 {
AzureIoTClient 39:e98d5df6dc74 1292 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 1293 LogError("amqp_messenger_start failed (current state is %d; expected AMQP_MESSENGER_STATE_STOPPED)", instance->state);
AzureIoTClient 39:e98d5df6dc74 1294 }
AzureIoTClient 39:e98d5df6dc74 1295 else
AzureIoTClient 39:e98d5df6dc74 1296 {
AzureIoTClient 39:e98d5df6dc74 1297 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_053: [`session_handle` shall be saved on `instance->session_handle`]
AzureIoTClient 39:e98d5df6dc74 1298 instance->session_handle = session_handle;
AzureIoTClient 39:e98d5df6dc74 1299
AzureIoTClient 39:e98d5df6dc74 1300 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_054: [If no failures occurr, `instance->state` shall be set to AMQP_MESSENGER_STATE_STARTING, and `instance->on_state_changed_callback` invoked if provided]
AzureIoTClient 39:e98d5df6dc74 1301 update_messenger_state(instance, AMQP_MESSENGER_STATE_STARTING);
AzureIoTClient 39:e98d5df6dc74 1302
AzureIoTClient 39:e98d5df6dc74 1303 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_055: [If no failures occurr, amqp_messenger_start() shall return 0]
AzureIoTClient 39:e98d5df6dc74 1304 result = RESULT_OK;
AzureIoTClient 39:e98d5df6dc74 1305 }
AzureIoTClient 39:e98d5df6dc74 1306 }
AzureIoTClient 39:e98d5df6dc74 1307
AzureIoTClient 39:e98d5df6dc74 1308 return result;
AzureIoTClient 39:e98d5df6dc74 1309 }
AzureIoTClient 39:e98d5df6dc74 1310
AzureIoTClient 39:e98d5df6dc74 1311 int amqp_messenger_stop(AMQP_MESSENGER_HANDLE messenger_handle)
AzureIoTClient 39:e98d5df6dc74 1312 {
AzureIoTClient 39:e98d5df6dc74 1313 int result;
AzureIoTClient 39:e98d5df6dc74 1314
AzureIoTClient 39:e98d5df6dc74 1315 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_056: [If `messenger_handle` is NULL, amqp_messenger_stop() shall fail and return non-zero value]
AzureIoTClient 39:e98d5df6dc74 1316 if (messenger_handle == NULL)
AzureIoTClient 39:e98d5df6dc74 1317 {
AzureIoTClient 39:e98d5df6dc74 1318 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 1319 LogError("Invalid argument (messenger_handle is NULL)");
AzureIoTClient 39:e98d5df6dc74 1320 }
AzureIoTClient 39:e98d5df6dc74 1321 else
AzureIoTClient 39:e98d5df6dc74 1322 {
AzureIoTClient 39:e98d5df6dc74 1323 AMQP_MESSENGER_INSTANCE* instance = (AMQP_MESSENGER_INSTANCE*)messenger_handle;
AzureIoTClient 39:e98d5df6dc74 1324
AzureIoTClient 39:e98d5df6dc74 1325 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_057: [If `instance->state` is AMQP_MESSENGER_STATE_STOPPED, amqp_messenger_stop() shall fail and return non-zero value]
AzureIoTClient 39:e98d5df6dc74 1326 if (instance->state == AMQP_MESSENGER_STATE_STOPPED)
AzureIoTClient 39:e98d5df6dc74 1327 {
AzureIoTClient 39:e98d5df6dc74 1328 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 1329 LogError("amqp_messenger_stop failed (messenger is already stopped)");
AzureIoTClient 39:e98d5df6dc74 1330 }
AzureIoTClient 39:e98d5df6dc74 1331 else
AzureIoTClient 39:e98d5df6dc74 1332 {
AzureIoTClient 39:e98d5df6dc74 1333 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_058: [`instance->state` shall be set to AMQP_MESSENGER_STATE_STOPPING, and `instance->on_state_changed_callback` invoked if provided]
AzureIoTClient 39:e98d5df6dc74 1334 update_messenger_state(instance, AMQP_MESSENGER_STATE_STOPPING);
AzureIoTClient 39:e98d5df6dc74 1335
AzureIoTClient 39:e98d5df6dc74 1336 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_059: [`instance->message_sender` and `instance->message_receiver` shall be destroyed along with all its links]
AzureIoTClient 39:e98d5df6dc74 1337 destroy_message_sender(instance);
AzureIoTClient 39:e98d5df6dc74 1338 destroy_message_receiver(instance);
AzureIoTClient 39:e98d5df6dc74 1339
AzureIoTClient 39:e98d5df6dc74 1340 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_060: [`instance->send_queue` items shall be rolled back using message_queue_move_all_back_to_pending()]
AzureIoTClient 39:e98d5df6dc74 1341 if (message_queue_move_all_back_to_pending(instance->send_queue) != RESULT_OK)
AzureIoTClient 39:e98d5df6dc74 1342 {
AzureIoTClient 39:e98d5df6dc74 1343 LogError("Messenger failed to move events in progress back to wait_to_send list");
AzureIoTClient 39:e98d5df6dc74 1344
AzureIoTClient 39:e98d5df6dc74 1345 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_061: [If message_queue_move_all_back_to_pending() fails, amqp_messenger_stop() shall change the messenger state to AMQP_MESSENGER_STATE_ERROR and return a non-zero value]
AzureIoTClient 39:e98d5df6dc74 1346 update_messenger_state(instance, AMQP_MESSENGER_STATE_ERROR);
AzureIoTClient 39:e98d5df6dc74 1347 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 1348 }
AzureIoTClient 39:e98d5df6dc74 1349 else
AzureIoTClient 39:e98d5df6dc74 1350 {
AzureIoTClient 39:e98d5df6dc74 1351 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_062: [`instance->state` shall be set to AMQP_MESSENGER_STATE_STOPPED, and `instance->on_state_changed_callback` invoked if provided]
AzureIoTClient 39:e98d5df6dc74 1352 update_messenger_state(instance, AMQP_MESSENGER_STATE_STOPPED);
AzureIoTClient 39:e98d5df6dc74 1353 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_063: [If no failures occurr, amqp_messenger_stop() shall return 0]
AzureIoTClient 39:e98d5df6dc74 1354 result = RESULT_OK;
AzureIoTClient 39:e98d5df6dc74 1355 }
AzureIoTClient 39:e98d5df6dc74 1356 }
AzureIoTClient 39:e98d5df6dc74 1357 }
AzureIoTClient 39:e98d5df6dc74 1358
AzureIoTClient 39:e98d5df6dc74 1359 return result;
AzureIoTClient 39:e98d5df6dc74 1360 }
AzureIoTClient 39:e98d5df6dc74 1361
AzureIoTClient 39:e98d5df6dc74 1362 // @brief
AzureIoTClient 39:e98d5df6dc74 1363 // Sets the messenger module state based on the state changes from messagesender and messagereceiver
AzureIoTClient 39:e98d5df6dc74 1364 static void process_state_changes(AMQP_MESSENGER_INSTANCE* instance)
AzureIoTClient 39:e98d5df6dc74 1365 {
AzureIoTClient 39:e98d5df6dc74 1366 // Note: messagesender and messagereceiver are still not created or already destroyed
AzureIoTClient 39:e98d5df6dc74 1367 // when state is AMQP_MESSENGER_STATE_STOPPED, so no checking is needed there.
AzureIoTClient 39:e98d5df6dc74 1368
AzureIoTClient 39:e98d5df6dc74 1369 if (instance->state == AMQP_MESSENGER_STATE_STARTED)
AzureIoTClient 39:e98d5df6dc74 1370 {
AzureIoTClient 39:e98d5df6dc74 1371 if (instance->message_sender_current_state != MESSAGE_SENDER_STATE_OPEN)
AzureIoTClient 39:e98d5df6dc74 1372 {
AzureIoTClient 39:e98d5df6dc74 1373 LogError("messagesender reported unexpected state %d while messenger was started", instance->message_sender_current_state);
AzureIoTClient 39:e98d5df6dc74 1374 update_messenger_state(instance, AMQP_MESSENGER_STATE_ERROR);
AzureIoTClient 39:e98d5df6dc74 1375 }
AzureIoTClient 39:e98d5df6dc74 1376 else if (instance->message_receiver != NULL && instance->message_receiver_current_state != MESSAGE_RECEIVER_STATE_OPEN)
AzureIoTClient 39:e98d5df6dc74 1377 {
AzureIoTClient 39:e98d5df6dc74 1378 if (instance->message_receiver_current_state == MESSAGE_RECEIVER_STATE_OPENING)
AzureIoTClient 39:e98d5df6dc74 1379 {
AzureIoTClient 39:e98d5df6dc74 1380 bool is_timed_out;
AzureIoTClient 39:e98d5df6dc74 1381 if (is_timeout_reached(instance->last_message_receiver_state_change_time, MAX_MESSAGE_RECEIVER_STATE_CHANGE_TIMEOUT_SECS, &is_timed_out) != RESULT_OK)
AzureIoTClient 39:e98d5df6dc74 1382 {
AzureIoTClient 39:e98d5df6dc74 1383 LogError("messenger got an error (failed to verify messagereceiver start timeout)");
AzureIoTClient 39:e98d5df6dc74 1384 update_messenger_state(instance, AMQP_MESSENGER_STATE_ERROR);
AzureIoTClient 39:e98d5df6dc74 1385 }
AzureIoTClient 39:e98d5df6dc74 1386 else if (is_timed_out)
AzureIoTClient 39:e98d5df6dc74 1387 {
AzureIoTClient 39:e98d5df6dc74 1388 LogError("messenger got an error (messagereceiver failed to start within expected timeout (%d secs))", MAX_MESSAGE_RECEIVER_STATE_CHANGE_TIMEOUT_SECS);
AzureIoTClient 39:e98d5df6dc74 1389 update_messenger_state(instance, AMQP_MESSENGER_STATE_ERROR);
AzureIoTClient 39:e98d5df6dc74 1390 }
AzureIoTClient 39:e98d5df6dc74 1391 }
AzureIoTClient 39:e98d5df6dc74 1392 else if (instance->message_receiver_current_state == MESSAGE_RECEIVER_STATE_ERROR ||
AzureIoTClient 39:e98d5df6dc74 1393 instance->message_receiver_current_state == MESSAGE_RECEIVER_STATE_IDLE)
AzureIoTClient 39:e98d5df6dc74 1394 {
AzureIoTClient 39:e98d5df6dc74 1395 LogError("messagereceiver reported unexpected state %d while messenger is starting", instance->message_receiver_current_state);
AzureIoTClient 39:e98d5df6dc74 1396 update_messenger_state(instance, AMQP_MESSENGER_STATE_ERROR);
AzureIoTClient 39:e98d5df6dc74 1397 }
AzureIoTClient 39:e98d5df6dc74 1398 }
AzureIoTClient 39:e98d5df6dc74 1399 }
AzureIoTClient 39:e98d5df6dc74 1400 else
AzureIoTClient 39:e98d5df6dc74 1401 {
AzureIoTClient 39:e98d5df6dc74 1402 if (instance->state == AMQP_MESSENGER_STATE_STARTING)
AzureIoTClient 39:e98d5df6dc74 1403 {
AzureIoTClient 39:e98d5df6dc74 1404 if (instance->message_sender_current_state == MESSAGE_SENDER_STATE_OPEN)
AzureIoTClient 39:e98d5df6dc74 1405 {
AzureIoTClient 39:e98d5df6dc74 1406 update_messenger_state(instance, AMQP_MESSENGER_STATE_STARTED);
AzureIoTClient 39:e98d5df6dc74 1407 }
AzureIoTClient 39:e98d5df6dc74 1408 else if (instance->message_sender_current_state == MESSAGE_SENDER_STATE_OPENING)
AzureIoTClient 39:e98d5df6dc74 1409 {
AzureIoTClient 39:e98d5df6dc74 1410 bool is_timed_out;
AzureIoTClient 39:e98d5df6dc74 1411 if (is_timeout_reached(instance->last_message_sender_state_change_time, MAX_MESSAGE_SENDER_STATE_CHANGE_TIMEOUT_SECS, &is_timed_out) != RESULT_OK)
AzureIoTClient 39:e98d5df6dc74 1412 {
AzureIoTClient 39:e98d5df6dc74 1413 LogError("messenger failed to start (failed to verify messagesender start timeout)");
AzureIoTClient 39:e98d5df6dc74 1414 update_messenger_state(instance, AMQP_MESSENGER_STATE_ERROR);
AzureIoTClient 39:e98d5df6dc74 1415 }
AzureIoTClient 39:e98d5df6dc74 1416 else if (is_timed_out)
AzureIoTClient 39:e98d5df6dc74 1417 {
AzureIoTClient 39:e98d5df6dc74 1418 LogError("messenger failed to start (messagesender failed to start within expected timeout (%d secs))", MAX_MESSAGE_SENDER_STATE_CHANGE_TIMEOUT_SECS);
AzureIoTClient 39:e98d5df6dc74 1419 update_messenger_state(instance, AMQP_MESSENGER_STATE_ERROR);
AzureIoTClient 39:e98d5df6dc74 1420 }
AzureIoTClient 39:e98d5df6dc74 1421 }
AzureIoTClient 39:e98d5df6dc74 1422 // For this module, the only valid scenario where messagesender state is IDLE is if
AzureIoTClient 39:e98d5df6dc74 1423 // the messagesender hasn't been created yet or already destroyed.
AzureIoTClient 39:e98d5df6dc74 1424 else if ((instance->message_sender_current_state == MESSAGE_SENDER_STATE_ERROR) ||
AzureIoTClient 39:e98d5df6dc74 1425 (instance->message_sender_current_state == MESSAGE_SENDER_STATE_CLOSING) ||
AzureIoTClient 39:e98d5df6dc74 1426 (instance->message_sender_current_state == MESSAGE_SENDER_STATE_IDLE && instance->message_sender != NULL))
AzureIoTClient 39:e98d5df6dc74 1427 {
AzureIoTClient 39:e98d5df6dc74 1428 LogError("messagesender reported unexpected state %d while messenger is starting", instance->message_sender_current_state);
AzureIoTClient 39:e98d5df6dc74 1429 update_messenger_state(instance, AMQP_MESSENGER_STATE_ERROR);
AzureIoTClient 39:e98d5df6dc74 1430 }
AzureIoTClient 39:e98d5df6dc74 1431 }
AzureIoTClient 39:e98d5df6dc74 1432 // message sender and receiver are stopped/destroyed synchronously, so no need for state control.
AzureIoTClient 39:e98d5df6dc74 1433 }
AzureIoTClient 39:e98d5df6dc74 1434 }
AzureIoTClient 39:e98d5df6dc74 1435
AzureIoTClient 39:e98d5df6dc74 1436 static void manage_amqp_messengers(AMQP_MESSENGER_INSTANCE* msgr)
AzureIoTClient 39:e98d5df6dc74 1437 {
AzureIoTClient 39:e98d5df6dc74 1438 if (msgr->state == AMQP_MESSENGER_STATE_STARTING)
AzureIoTClient 39:e98d5df6dc74 1439 {
AzureIoTClient 39:e98d5df6dc74 1440 if (msgr->message_sender == NULL)
AzureIoTClient 39:e98d5df6dc74 1441 {
AzureIoTClient 39:e98d5df6dc74 1442 if (create_message_sender(msgr) != RESULT_OK)
AzureIoTClient 39:e98d5df6dc74 1443 {
AzureIoTClient 39:e98d5df6dc74 1444 update_messenger_state(msgr, AMQP_MESSENGER_STATE_ERROR);
AzureIoTClient 39:e98d5df6dc74 1445 }
AzureIoTClient 39:e98d5df6dc74 1446 }
AzureIoTClient 39:e98d5df6dc74 1447 }
AzureIoTClient 39:e98d5df6dc74 1448 else if (msgr->state == AMQP_MESSENGER_STATE_STARTED)
AzureIoTClient 39:e98d5df6dc74 1449 {
AzureIoTClient 39:e98d5df6dc74 1450 if (msgr->receive_messages == true &&
AzureIoTClient 39:e98d5df6dc74 1451 msgr->message_receiver == NULL &&
AzureIoTClient 39:e98d5df6dc74 1452 create_message_receiver(msgr) != RESULT_OK)
AzureIoTClient 39:e98d5df6dc74 1453 {
AzureIoTClient 39:e98d5df6dc74 1454 LogError("amqp_messenger_do_work warning (failed creating the message receiver [%s])", msgr->config->device_id);
AzureIoTClient 39:e98d5df6dc74 1455 }
AzureIoTClient 39:e98d5df6dc74 1456 else if (msgr->receive_messages == false && msgr->message_receiver != NULL)
AzureIoTClient 39:e98d5df6dc74 1457 {
AzureIoTClient 39:e98d5df6dc74 1458 destroy_message_receiver(msgr);
AzureIoTClient 39:e98d5df6dc74 1459 }
AzureIoTClient 39:e98d5df6dc74 1460 }
AzureIoTClient 39:e98d5df6dc74 1461 }
AzureIoTClient 39:e98d5df6dc74 1462
AzureIoTClient 39:e98d5df6dc74 1463 static void handle_errors_and_timeouts(AMQP_MESSENGER_INSTANCE* msgr)
AzureIoTClient 39:e98d5df6dc74 1464 {
AzureIoTClient 39:e98d5df6dc74 1465 if (msgr->send_error_count >= msgr->max_send_error_count)
AzureIoTClient 39:e98d5df6dc74 1466 {
AzureIoTClient 39:e98d5df6dc74 1467 LogError("Reached max number of consecutive send failures (%d, %d)", msgr->config->device_id, msgr->max_send_error_count);
AzureIoTClient 39:e98d5df6dc74 1468 update_messenger_state(msgr, AMQP_MESSENGER_STATE_ERROR);
AzureIoTClient 39:e98d5df6dc74 1469 }
AzureIoTClient 39:e98d5df6dc74 1470 }
AzureIoTClient 39:e98d5df6dc74 1471
AzureIoTClient 39:e98d5df6dc74 1472 void amqp_messenger_do_work(AMQP_MESSENGER_HANDLE messenger_handle)
AzureIoTClient 39:e98d5df6dc74 1473 {
AzureIoTClient 39:e98d5df6dc74 1474 if (messenger_handle == NULL)
AzureIoTClient 39:e98d5df6dc74 1475 {
AzureIoTClient 39:e98d5df6dc74 1476 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_064: [If `messenger_handle` is NULL, amqp_messenger_do_work() shall fail and return]
AzureIoTClient 39:e98d5df6dc74 1477 LogError("Invalid argument (messenger_handle is NULL)");
AzureIoTClient 39:e98d5df6dc74 1478 }
AzureIoTClient 39:e98d5df6dc74 1479 else
AzureIoTClient 39:e98d5df6dc74 1480 {
AzureIoTClient 39:e98d5df6dc74 1481 AMQP_MESSENGER_INSTANCE* msgr = (AMQP_MESSENGER_INSTANCE*)messenger_handle;
AzureIoTClient 39:e98d5df6dc74 1482
AzureIoTClient 39:e98d5df6dc74 1483 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_065: [amqp_messenger_do_work() shall update the current state according to the states of message sender and receiver]
AzureIoTClient 39:e98d5df6dc74 1484 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_068: [If the message sender state changes to MESSAGE_SENDER_STATE_OPEN, amqp_messenger_do_work() shall set the state to AMQP_MESSENGER_STATE_STARTED]
AzureIoTClient 39:e98d5df6dc74 1485 process_state_changes(msgr);
AzureIoTClient 39:e98d5df6dc74 1486
AzureIoTClient 39:e98d5df6dc74 1487 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_066: [If the current state is AMQP_MESSENGER_STARTING, amqp_messenger_do_work() shall create and start `instance->message_sender`]
AzureIoTClient 39:e98d5df6dc74 1488 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_067: [If the `instance->message_sender` fails to be created/started, amqp_messenger_do_work() shall set the state to AMQP_MESSENGER_STATE_ERROR]
AzureIoTClient 39:e98d5df6dc74 1489 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_069: [If the `instance->receive_messages` is true, amqp_messenger_do_work() shall create and start `instance->message_receiver` if not done before]
AzureIoTClient 39:e98d5df6dc74 1490 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_070: [If the `instance->message_receiver` fails to be created/started, amqp_messenger_do_work() shall set the state to AMQP_MESSENGER_STATE_ERROR]
AzureIoTClient 39:e98d5df6dc74 1491 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_071: [If the `instance->receive_messages` is false, amqp_messenger_do_work() shall stop and destroy `instance->message_receiver` if not done before]
AzureIoTClient 39:e98d5df6dc74 1492 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_072: [If the `instance->message_receiver` fails to be stopped/destroyed, amqp_messenger_do_work() shall set the state to AMQP_MESSENGER_STATE_ERROR]
AzureIoTClient 39:e98d5df6dc74 1493 manage_amqp_messengers(msgr);
AzureIoTClient 39:e98d5df6dc74 1494
AzureIoTClient 39:e98d5df6dc74 1495 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_073: [amqp_messenger_do_work() shall invoke message_queue_do_work() on `instance->send_queue`]
AzureIoTClient 39:e98d5df6dc74 1496 if (msgr->state == AMQP_MESSENGER_STATE_STARTED)
AzureIoTClient 39:e98d5df6dc74 1497 {
AzureIoTClient 39:e98d5df6dc74 1498 message_queue_do_work(msgr->send_queue);
AzureIoTClient 39:e98d5df6dc74 1499 }
AzureIoTClient 39:e98d5df6dc74 1500
AzureIoTClient 39:e98d5df6dc74 1501 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_074: [If `instance->send_error_count` DEFAULT_MAX_SEND_ERROR_COUNT (10), amqp_messenger_do_work() shall change the state to AMQP_MESSENGER_STATE_ERROR]
AzureIoTClient 39:e98d5df6dc74 1502 handle_errors_and_timeouts(msgr);
AzureIoTClient 39:e98d5df6dc74 1503 }
AzureIoTClient 39:e98d5df6dc74 1504 }
AzureIoTClient 39:e98d5df6dc74 1505
AzureIoTClient 39:e98d5df6dc74 1506 void amqp_messenger_destroy(AMQP_MESSENGER_HANDLE messenger_handle)
AzureIoTClient 39:e98d5df6dc74 1507 {
AzureIoTClient 39:e98d5df6dc74 1508 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_123: [If `messenger_handle` is NULL, amqp_messenger_destroy() shall fail and return]
AzureIoTClient 39:e98d5df6dc74 1509 if (messenger_handle == NULL)
AzureIoTClient 39:e98d5df6dc74 1510 {
AzureIoTClient 39:e98d5df6dc74 1511 LogError("invalid argument (messenger_handle is NULL)");
AzureIoTClient 39:e98d5df6dc74 1512 }
AzureIoTClient 39:e98d5df6dc74 1513 else
AzureIoTClient 39:e98d5df6dc74 1514 {
AzureIoTClient 39:e98d5df6dc74 1515 AMQP_MESSENGER_INSTANCE* instance = (AMQP_MESSENGER_INSTANCE*)messenger_handle;
AzureIoTClient 39:e98d5df6dc74 1516
AzureIoTClient 39:e98d5df6dc74 1517 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_124: [If `instance->state` is not AMQP_MESSENGER_STATE_STOPPED, amqp_messenger_destroy() shall invoke amqp_messenger_stop()]
AzureIoTClient 39:e98d5df6dc74 1518 if (instance->state != AMQP_MESSENGER_STATE_STOPPED)
AzureIoTClient 39:e98d5df6dc74 1519 {
AzureIoTClient 39:e98d5df6dc74 1520 (void)amqp_messenger_stop(messenger_handle);
AzureIoTClient 39:e98d5df6dc74 1521 }
AzureIoTClient 39:e98d5df6dc74 1522
AzureIoTClient 39:e98d5df6dc74 1523 if (instance->send_queue != NULL)
AzureIoTClient 39:e98d5df6dc74 1524 {
AzureIoTClient 39:e98d5df6dc74 1525 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_125: [message_queue_destroy() shall be invoked for `instance->send_queue`]
AzureIoTClient 39:e98d5df6dc74 1526 message_queue_destroy(instance->send_queue);
AzureIoTClient 39:e98d5df6dc74 1527 }
AzureIoTClient 39:e98d5df6dc74 1528
AzureIoTClient 39:e98d5df6dc74 1529 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_126: [amqp_messenger_destroy() shall release all the memory allocated for `instance`]
AzureIoTClient 39:e98d5df6dc74 1530 destroy_configuration(instance->config);
AzureIoTClient 39:e98d5df6dc74 1531
AzureIoTClient 39:e98d5df6dc74 1532 free((void*)instance);
AzureIoTClient 39:e98d5df6dc74 1533 }
AzureIoTClient 39:e98d5df6dc74 1534 }
AzureIoTClient 39:e98d5df6dc74 1535
AzureIoTClient 39:e98d5df6dc74 1536 AMQP_MESSENGER_HANDLE amqp_messenger_create(const AMQP_MESSENGER_CONFIG* messenger_config)
AzureIoTClient 39:e98d5df6dc74 1537 {
AzureIoTClient 39:e98d5df6dc74 1538 AMQP_MESSENGER_HANDLE handle;
AzureIoTClient 39:e98d5df6dc74 1539
AzureIoTClient 39:e98d5df6dc74 1540 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_001: [If `messenger_config` is NULL, amqp_messenger_create() shall return NULL]
AzureIoTClient 39:e98d5df6dc74 1541 if (!is_valid_configuration(messenger_config))
AzureIoTClient 39:e98d5df6dc74 1542 {
AzureIoTClient 39:e98d5df6dc74 1543 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_002: [If `messenger_config`'s `device_id`, `iothub_host_fqdn`, `receive_link.source_suffix` or `send_link.target_suffix` are NULL, amqp_messenger_create() shall return NULL]
AzureIoTClient 39:e98d5df6dc74 1544 handle = NULL;
AzureIoTClient 39:e98d5df6dc74 1545 }
AzureIoTClient 39:e98d5df6dc74 1546 else
AzureIoTClient 39:e98d5df6dc74 1547 {
AzureIoTClient 39:e98d5df6dc74 1548 AMQP_MESSENGER_INSTANCE* instance;
AzureIoTClient 39:e98d5df6dc74 1549
AzureIoTClient 39:e98d5df6dc74 1550 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_003: [amqp_messenger_create() shall allocate memory for the messenger instance structure (aka `instance`)]
AzureIoTClient 39:e98d5df6dc74 1551 if ((instance = (AMQP_MESSENGER_INSTANCE*)malloc(sizeof(AMQP_MESSENGER_INSTANCE))) == NULL)
AzureIoTClient 39:e98d5df6dc74 1552 {
AzureIoTClient 39:e98d5df6dc74 1553 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_004: [If malloc() fails, amqp_messenger_create() shall fail and return NULL]
AzureIoTClient 39:e98d5df6dc74 1554 LogError("Failed allocating AMQP_MESSENGER_INSTANCE");
AzureIoTClient 39:e98d5df6dc74 1555 handle = NULL;
AzureIoTClient 39:e98d5df6dc74 1556 }
AzureIoTClient 39:e98d5df6dc74 1557 else
AzureIoTClient 39:e98d5df6dc74 1558 {
AzureIoTClient 39:e98d5df6dc74 1559 memset(instance, 0, sizeof(AMQP_MESSENGER_INSTANCE));
AzureIoTClient 39:e98d5df6dc74 1560
AzureIoTClient 39:e98d5df6dc74 1561 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_005: [amqp_messenger_create() shall save a copy of `messenger_config` into `instance`]
AzureIoTClient 39:e98d5df6dc74 1562 if ((instance->config = clone_configuration(messenger_config)) == NULL)
AzureIoTClient 39:e98d5df6dc74 1563 {
AzureIoTClient 39:e98d5df6dc74 1564 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_006: [If the copy fails, amqp_messenger_create() shall fail and return NULL]
AzureIoTClient 39:e98d5df6dc74 1565 LogError("Failed copying AMQP messenger configuration");
AzureIoTClient 39:e98d5df6dc74 1566 handle = NULL;
AzureIoTClient 39:e98d5df6dc74 1567 }
AzureIoTClient 39:e98d5df6dc74 1568 else
AzureIoTClient 39:e98d5df6dc74 1569 {
AzureIoTClient 39:e98d5df6dc74 1570 MESSAGE_QUEUE_CONFIG mq_config;
AzureIoTClient 39:e98d5df6dc74 1571 mq_config.max_retry_count = DEFAULT_EVENT_SEND_RETRY_LIMIT;
AzureIoTClient 39:e98d5df6dc74 1572 mq_config.max_message_enqueued_time_secs = DEFAULT_EVENT_SEND_TIMEOUT_SECS;
AzureIoTClient 39:e98d5df6dc74 1573 mq_config.max_message_processing_time_secs = 0;
AzureIoTClient 39:e98d5df6dc74 1574 mq_config.on_process_message_callback = on_process_message_callback;
AzureIoTClient 39:e98d5df6dc74 1575
AzureIoTClient 39:e98d5df6dc74 1576 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_007: [`instance->send_queue` shall be set using message_queue_create(), passing `on_process_message_callback`]
AzureIoTClient 39:e98d5df6dc74 1577 if ((instance->send_queue = message_queue_create(&mq_config)) == NULL)
AzureIoTClient 39:e98d5df6dc74 1578 {
AzureIoTClient 39:e98d5df6dc74 1579 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_008: [If message_queue_create() fails, amqp_messenger_create() shall fail and return NULL]
AzureIoTClient 39:e98d5df6dc74 1580 LogError("Failed creating message queue");
AzureIoTClient 39:e98d5df6dc74 1581 handle = NULL;
AzureIoTClient 39:e98d5df6dc74 1582 }
AzureIoTClient 39:e98d5df6dc74 1583 else
AzureIoTClient 39:e98d5df6dc74 1584 {
AzureIoTClient 39:e98d5df6dc74 1585 instance->state = AMQP_MESSENGER_STATE_STOPPED;
AzureIoTClient 39:e98d5df6dc74 1586 instance->message_sender_current_state = MESSAGE_SENDER_STATE_IDLE;
AzureIoTClient 39:e98d5df6dc74 1587 instance->message_sender_previous_state = MESSAGE_SENDER_STATE_IDLE;
AzureIoTClient 39:e98d5df6dc74 1588 instance->message_receiver_current_state = MESSAGE_RECEIVER_STATE_IDLE;
AzureIoTClient 39:e98d5df6dc74 1589 instance->message_receiver_previous_state = MESSAGE_RECEIVER_STATE_IDLE;
AzureIoTClient 39:e98d5df6dc74 1590 instance->last_message_sender_state_change_time = INDEFINITE_TIME;
AzureIoTClient 39:e98d5df6dc74 1591 instance->last_message_receiver_state_change_time = INDEFINITE_TIME;
AzureIoTClient 39:e98d5df6dc74 1592 instance->max_send_error_count = DEFAULT_MAX_SEND_ERROR_COUNT;
AzureIoTClient 39:e98d5df6dc74 1593 instance->receive_messages = false;
AzureIoTClient 39:e98d5df6dc74 1594
AzureIoTClient 39:e98d5df6dc74 1595 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_009: [If no failures occurr, amqp_messenger_create() shall return a handle to `instance`]
AzureIoTClient 39:e98d5df6dc74 1596 handle = (AMQP_MESSENGER_HANDLE)instance;
AzureIoTClient 39:e98d5df6dc74 1597 }
AzureIoTClient 39:e98d5df6dc74 1598 }
AzureIoTClient 39:e98d5df6dc74 1599 }
AzureIoTClient 39:e98d5df6dc74 1600
AzureIoTClient 39:e98d5df6dc74 1601 if (handle == NULL)
AzureIoTClient 39:e98d5df6dc74 1602 {
AzureIoTClient 39:e98d5df6dc74 1603 amqp_messenger_destroy((AMQP_MESSENGER_HANDLE)instance);
AzureIoTClient 39:e98d5df6dc74 1604 }
AzureIoTClient 39:e98d5df6dc74 1605 }
AzureIoTClient 39:e98d5df6dc74 1606
AzureIoTClient 39:e98d5df6dc74 1607 return handle;
AzureIoTClient 39:e98d5df6dc74 1608 }
AzureIoTClient 39:e98d5df6dc74 1609
AzureIoTClient 39:e98d5df6dc74 1610 int amqp_messenger_set_option(AMQP_MESSENGER_HANDLE messenger_handle, const char* name, void* value)
AzureIoTClient 39:e98d5df6dc74 1611 {
AzureIoTClient 39:e98d5df6dc74 1612 int result;
AzureIoTClient 39:e98d5df6dc74 1613
AzureIoTClient 39:e98d5df6dc74 1614 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_127: [If `messenger_handle` or `name` or `value` is NULL, amqp_messenger_set_option shall fail and return a non-zero value]
AzureIoTClient 39:e98d5df6dc74 1615 if (messenger_handle == NULL || name == NULL || value == NULL)
AzureIoTClient 39:e98d5df6dc74 1616 {
AzureIoTClient 39:e98d5df6dc74 1617 LogError("Invalid argument (messenger_handle=%p, name=%p, value=%p)",
AzureIoTClient 39:e98d5df6dc74 1618 messenger_handle, name, value);
AzureIoTClient 39:e98d5df6dc74 1619 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 1620 }
AzureIoTClient 39:e98d5df6dc74 1621 else
AzureIoTClient 39:e98d5df6dc74 1622 {
AzureIoTClient 39:e98d5df6dc74 1623 AMQP_MESSENGER_INSTANCE* instance = (AMQP_MESSENGER_INSTANCE*)messenger_handle;
AzureIoTClient 39:e98d5df6dc74 1624
AzureIoTClient 51:269e65571b39 1625 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_128: [If name matches AMQP_MESSENGER_OPTION_EVENT_SEND_TIMEOUT_SECS, `value` shall be set on `instance->send_queue` using message_queue_set_max_message_enqueued_time_secs()]
AzureIoTClient 51:269e65571b39 1626 if (strcmp(AMQP_MESSENGER_OPTION_EVENT_SEND_TIMEOUT_SECS, name) == 0)
AzureIoTClient 39:e98d5df6dc74 1627 {
AzureIoTClient 39:e98d5df6dc74 1628 if (message_queue_set_max_message_enqueued_time_secs(instance->send_queue, *(size_t*)value) != 0)
AzureIoTClient 39:e98d5df6dc74 1629 {
AzureIoTClient 39:e98d5df6dc74 1630 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_129: [If message_queue_set_max_message_enqueued_time_secs() fails, amqp_messenger_set_option() shall fail and return a non-zero value]
AzureIoTClient 51:269e65571b39 1631 LogError("Failed setting option %s", AMQP_MESSENGER_OPTION_EVENT_SEND_TIMEOUT_SECS);
AzureIoTClient 39:e98d5df6dc74 1632 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 1633 }
AzureIoTClient 39:e98d5df6dc74 1634 else
AzureIoTClient 39:e98d5df6dc74 1635 {
AzureIoTClient 39:e98d5df6dc74 1636 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_131: [If no errors occur, amqp_messenger_set_option shall return 0]
AzureIoTClient 39:e98d5df6dc74 1637 result = RESULT_OK;
AzureIoTClient 39:e98d5df6dc74 1638 }
AzureIoTClient 39:e98d5df6dc74 1639 }
AzureIoTClient 39:e98d5df6dc74 1640 else
AzureIoTClient 39:e98d5df6dc74 1641 {
AzureIoTClient 39:e98d5df6dc74 1642 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_130: [If `name` does not match any supported option, amqp_messenger_set_option() shall fail and return a non-zero value]
AzureIoTClient 39:e98d5df6dc74 1643 LogError("Invalid argument (option '%s' is not valid)", name);
AzureIoTClient 39:e98d5df6dc74 1644 result = __FAILURE__;
AzureIoTClient 39:e98d5df6dc74 1645 }
AzureIoTClient 39:e98d5df6dc74 1646 }
AzureIoTClient 39:e98d5df6dc74 1647
AzureIoTClient 39:e98d5df6dc74 1648 return result;
AzureIoTClient 39:e98d5df6dc74 1649 }
AzureIoTClient 39:e98d5df6dc74 1650
AzureIoTClient 39:e98d5df6dc74 1651 OPTIONHANDLER_HANDLE amqp_messenger_retrieve_options(AMQP_MESSENGER_HANDLE messenger_handle)
AzureIoTClient 39:e98d5df6dc74 1652 {
AzureIoTClient 39:e98d5df6dc74 1653 OPTIONHANDLER_HANDLE result;
AzureIoTClient 39:e98d5df6dc74 1654
AzureIoTClient 39:e98d5df6dc74 1655 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_132: [If `messenger_handle` is NULL, amqp_messenger_retrieve_options shall fail and return NULL]
AzureIoTClient 39:e98d5df6dc74 1656 if (messenger_handle == NULL)
AzureIoTClient 39:e98d5df6dc74 1657 {
AzureIoTClient 39:e98d5df6dc74 1658 LogError("Invalid argument (messenger_handle is NULL)");
AzureIoTClient 39:e98d5df6dc74 1659 result = NULL;
AzureIoTClient 39:e98d5df6dc74 1660 }
AzureIoTClient 39:e98d5df6dc74 1661 else
AzureIoTClient 39:e98d5df6dc74 1662 {
AzureIoTClient 39:e98d5df6dc74 1663 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_133: [An OPTIONHANDLER_HANDLE instance shall be created using OptionHandler_Create]
AzureIoTClient 39:e98d5df6dc74 1664 result = OptionHandler_Create(amqp_messenger_clone_option, amqp_messenger_destroy_option, (pfSetOption)amqp_messenger_set_option);
AzureIoTClient 39:e98d5df6dc74 1665
AzureIoTClient 39:e98d5df6dc74 1666 if (result == NULL)
AzureIoTClient 39:e98d5df6dc74 1667 {
AzureIoTClient 39:e98d5df6dc74 1668 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_134: [If an OPTIONHANDLER_HANDLE instance fails to be created, amqp_messenger_retrieve_options shall fail and return NULL]
AzureIoTClient 39:e98d5df6dc74 1669 LogError("Failed to retrieve options from messenger instance (OptionHandler_Create failed)");
AzureIoTClient 39:e98d5df6dc74 1670 }
AzureIoTClient 39:e98d5df6dc74 1671 else
AzureIoTClient 39:e98d5df6dc74 1672 {
AzureIoTClient 39:e98d5df6dc74 1673 AMQP_MESSENGER_INSTANCE* instance = (AMQP_MESSENGER_INSTANCE*)messenger_handle;
AzureIoTClient 39:e98d5df6dc74 1674 OPTIONHANDLER_HANDLE mq_options;
AzureIoTClient 39:e98d5df6dc74 1675
AzureIoTClient 39:e98d5df6dc74 1676 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_135: [`instance->send_queue` options shall be retrieved using message_queue_retrieve_options()]
AzureIoTClient 39:e98d5df6dc74 1677 if ((mq_options = message_queue_retrieve_options(instance->send_queue)) == NULL)
AzureIoTClient 39:e98d5df6dc74 1678 {
AzureIoTClient 39:e98d5df6dc74 1679 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_136: [If message_queue_retrieve_options() fails, amqp_messenger_retrieve_options shall fail and return NULL]
AzureIoTClient 39:e98d5df6dc74 1680 LogError("failed to retrieve options from send queue)");
AzureIoTClient 39:e98d5df6dc74 1681 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_139: [If amqp_messenger_retrieve_options fails, any allocated memory shall be freed]
AzureIoTClient 39:e98d5df6dc74 1682 OptionHandler_Destroy(result);
AzureIoTClient 39:e98d5df6dc74 1683 result = NULL;
AzureIoTClient 39:e98d5df6dc74 1684 }
AzureIoTClient 39:e98d5df6dc74 1685 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_137: [Each option of `instance` shall be added to the OPTIONHANDLER_HANDLE instance using OptionHandler_AddOption]
AzureIoTClient 39:e98d5df6dc74 1686 else if (OptionHandler_AddOption(result, MESSENGER_SAVED_MQ_OPTIONS, (void*)mq_options) != OPTIONHANDLER_OK)
AzureIoTClient 39:e98d5df6dc74 1687 {
AzureIoTClient 39:e98d5df6dc74 1688 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_138: [If OptionHandler_AddOption fails, amqp_messenger_retrieve_options shall fail and return NULL]
AzureIoTClient 39:e98d5df6dc74 1689 LogError("failed adding option '%s'", MESSENGER_SAVED_MQ_OPTIONS);
AzureIoTClient 39:e98d5df6dc74 1690 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_139: [If amqp_messenger_retrieve_options fails, any allocated memory shall be freed]
AzureIoTClient 39:e98d5df6dc74 1691 OptionHandler_Destroy(mq_options);
AzureIoTClient 39:e98d5df6dc74 1692 OptionHandler_Destroy(result);
AzureIoTClient 39:e98d5df6dc74 1693 result = NULL;
AzureIoTClient 39:e98d5df6dc74 1694 }
AzureIoTClient 39:e98d5df6dc74 1695 }
AzureIoTClient 39:e98d5df6dc74 1696 }
AzureIoTClient 39:e98d5df6dc74 1697
AzureIoTClient 39:e98d5df6dc74 1698 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_140: [If no failures occur, amqp_messenger_retrieve_options shall return the OPTIONHANDLER_HANDLE instance]
AzureIoTClient 39:e98d5df6dc74 1699 return result;
AzureIoTClient 39:e98d5df6dc74 1700 }
AzureIoTClient 39:e98d5df6dc74 1701
AzureIoTClient 39:e98d5df6dc74 1702 void amqp_messenger_destroy_disposition_info(AMQP_MESSENGER_MESSAGE_DISPOSITION_INFO* disposition_info)
AzureIoTClient 39:e98d5df6dc74 1703 {
AzureIoTClient 39:e98d5df6dc74 1704 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_132: [If `disposition_info` is NULL, amqp_messenger_destroy_disposition_info shall return immediately]
AzureIoTClient 39:e98d5df6dc74 1705 if (disposition_info == NULL)
AzureIoTClient 39:e98d5df6dc74 1706 {
AzureIoTClient 39:e98d5df6dc74 1707 LogError("Invalid argument (disposition_info is NULL)");
AzureIoTClient 39:e98d5df6dc74 1708 }
AzureIoTClient 39:e98d5df6dc74 1709 else
AzureIoTClient 39:e98d5df6dc74 1710 {
AzureIoTClient 39:e98d5df6dc74 1711 // Codes_SRS_IOTHUBTRANSPORT_AMQP_MESSENGER_09_132: [All memory allocated for `disposition_info` shall be released]
AzureIoTClient 39:e98d5df6dc74 1712 destroy_message_disposition_info(disposition_info);
AzureIoTClient 39:e98d5df6dc74 1713 }
AzureIoTClient 39:e98d5df6dc74 1714 }