Update snapshot(2018-01-04)
[platform/upstream/iotivity.git] / resource / csdk / stack / src / ocserverrequest.c
1 //******************************************************************
2 //
3 // Copyright 2014 Intel Mobile Communications GmbH All Rights Reserved.
4 //
5 //-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
6 //
7 // Licensed under the Apache License, Version 2.0 (the "License");
8 // you may not use this file except in compliance with the License.
9 // You may obtain a copy of the License at
10 //
11 //      http://www.apache.org/licenses/LICENSE-2.0
12 //
13 // Unless required by applicable law or agreed to in writing, software
14 // distributed under the License is distributed on an "AS IS" BASIS,
15 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16 // See the License for the specific language governing permissions and
17 // limitations under the License.
18 //
19 //-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
20 #include <string.h>
21
22 #include "ocstack.h"
23 #include "ocserverrequest.h"
24 #include "ocresourcehandler.h"
25 #include "ocobserve.h"
26 #include "oic_malloc.h"
27 #include "oic_string.h"
28 #include "ocpayload.h"
29 #include "ocpayloadcbor.h"
30 #include "logger.h"
31
32 #if defined (ROUTING_GATEWAY) || defined (ROUTING_EP)
33 #include "routingutility.h"
34 #endif
35
36 #include "cacommon.h"
37 #include "cainterface.h"
38
39 #include <coap/utlist.h>
40 #include <coap/pdu.h>
41
42 // Module Name
43 #define VERIFY_NON_NULL(arg) { if (!arg) {OIC_LOG(FATAL, TAG, #arg " is NULL"); goto exit;} }
44
45 #define TAG  "OIC_RI_SERVERREQUEST"
46
47 static struct OCServerRequest * serverRequestList = NULL;
48 static struct OCServerResponse * serverResponseList = NULL;
49
50 //-------------------------------------------------------------------------------------------------
51 // Local functions
52 //-------------------------------------------------------------------------------------------------
53
54 /**
55  * Add a server response to the server response list
56  *
57  * @param response initialized server response that is created by this function
58  * @param requestHandle - handle of the response
59  *
60  * @return
61  *     OCStackResult
62  */
63 static OCStackResult AddServerResponse (OCServerResponse ** response, OCRequestHandle requestHandle)
64 {
65     if (!response)
66     {
67         return OC_STACK_INVALID_PARAM;
68     }
69
70     OCServerResponse * serverResponse = NULL;
71
72     serverResponse = (OCServerResponse *) OICCalloc(1, sizeof(OCServerResponse));
73     VERIFY_NON_NULL(serverResponse);
74
75     serverResponse->payload = NULL;
76
77     serverResponse->requestHandle = requestHandle;
78
79     *response = serverResponse;
80     OIC_LOG(INFO, TAG, "Server Response Added!!");
81     LL_APPEND (serverResponseList, serverResponse);
82     return OC_STACK_OK;
83
84 exit:
85     if (serverResponse)
86     {
87         OICFree(serverResponse);
88         serverResponse = NULL;
89     }
90     *response = NULL;
91     return OC_STACK_NO_MEMORY;
92 }
93
94 /**
95  * Delete a server request from the server request list
96  *
97  * @param serverRequest - server request to delete
98  */
99 static void DeleteServerRequest(OCServerRequest * serverRequest)
100 {
101     if(serverRequest)
102     {
103         LL_DELETE(serverRequestList, serverRequest);
104         OICFree(serverRequest->requestToken);
105         OICFree(serverRequest->rcvdVendorSpecificHeaderOptions);
106         OICFree(serverRequest);
107         serverRequest = NULL;
108         OIC_LOG(INFO, TAG, "Server Request Removed!!");
109     }
110 }
111
112 /**
113  * Delete a server response from the server response list
114  *
115  * @param serverResponse - server response to delete
116  */
117 static void DeleteServerResponse(OCServerResponse * serverResponse)
118 {
119     if(serverResponse)
120     {
121         LL_DELETE(serverResponseList, serverResponse);
122         OCPayloadDestroy(serverResponse->payload);
123         OICFree(serverResponse);
124         OIC_LOG(INFO, TAG, "Server Response Removed!!");
125     }
126 }
127
128 /**
129  * Find a server response and delete it from the server response list
130  *
131  * @param serverResponse - server response to find and delete
132  */
133 static void FindAndDeleteServerResponse(OCServerResponse * serverResponse)
134 {
135     OCServerResponse* tmp;
136     if(serverResponse)
137     {
138         LL_FOREACH(serverResponseList, tmp)
139         {
140             if (serverResponse == tmp)
141             {
142                 DeleteServerResponse(tmp);
143                 return;
144             }
145         }
146     }
147 }
148
149 /**
150  * Ensure no accept header option is included when sending responses and add routing info to
151  * outgoing response.
152  *
153  * @param object CA remote endpoint.
154  * @param requestInfo CA request info.
155  *
156  * @return ::OC_STACK_OK on success, some other value upon failure.
157  */
158 static OCStackResult OCSendResponse(const CAEndpoint_t *object, CAResponseInfo_t *responseInfo)
159 {
160 #if defined (ROUTING_GATEWAY) || defined (ROUTING_EP)
161     // Add route info in RM option.
162     OCStackResult rmResult = RMAddInfo(object->routeData, responseInfo, false, NULL);
163     if(OC_STACK_OK != rmResult)
164     {
165         OIC_LOG(ERROR, TAG, "Add option failed");
166         return rmResult;
167     }
168 #endif
169
170     // Do not include the accept header option
171     responseInfo->info.acceptFormat = CA_FORMAT_UNDEFINED;
172     CAResult_t result = CASendResponse(object, responseInfo);
173     if(CA_STATUS_OK != result)
174     {
175         OIC_LOG_V(ERROR, TAG, "CASendResponse failed with CA error %u", result);
176         return CAResultToOCResult(result);
177     }
178     return OC_STACK_OK;
179 }
180
181 //-------------------------------------------------------------------------------------------------
182 // Internal APIs
183 //-------------------------------------------------------------------------------------------------
184
185 /**
186  * Get a server request from the server request list using the specified token.
187  *
188  * @param token - token of server request
189  * @param tokenLength - length of token
190  *
191  * @return
192  *     OCServerRequest*
193  */
194 OCServerRequest * GetServerRequestUsingToken (const CAToken_t token, uint8_t tokenLength)
195 {
196     if(!token)
197     {
198         OIC_LOG(ERROR, TAG, "Invalid Parameter Token");
199         return NULL;
200     }
201
202     OCServerRequest * out = NULL;
203     OIC_LOG(INFO, TAG,"Get server request with token");
204     OIC_LOG_BUFFER(INFO, TAG, (const uint8_t *)token, tokenLength);
205
206     OIC_LOG(INFO, TAG, "Found token");
207     LL_FOREACH (serverRequestList, out)
208     {
209         if(out)
210         {
211             OIC_LOG_BUFFER(INFO, TAG, (const uint8_t *)out->requestToken, out->tokenLength);
212             if((tokenLength == out->tokenLength) &&
213                 memcmp(out->requestToken, token, tokenLength) == 0)
214             {
215                 return out;
216             }
217         }
218     }
219     OIC_LOG(INFO, TAG, "Server Request not found!!");
220     return NULL;
221 }
222
223 /**
224  * Get a server request from the server request list using the specified handle
225  *
226  * @param handle - handle of server request
227  * @return
228  *     OCServerRequest*
229  */
230 OCServerRequest * GetServerRequestUsingHandle (const OCRequestHandle handle)
231 {
232     OCServerRequest * out = NULL;
233     LL_FOREACH (serverRequestList, out)
234     {
235         if(out->requestId == handle)
236         {
237             return out;
238         }
239     }
240     OIC_LOG(ERROR, TAG, "Server Request not found!!");
241     return NULL;
242 }
243
244 /**
245  * Get a server response from the server response list using the specified handle
246  *
247  * @param handle - handle of server response
248  *
249  * @return
250  *     OCServerResponse*
251  */
252 OCServerResponse * GetServerResponseUsingHandle (const OCRequestHandle handle)
253 {
254     OCServerResponse * out = NULL;
255     LL_FOREACH (serverResponseList, out)
256     {
257         if(out->requestHandle == handle)
258         {
259             return out;
260         }
261     }
262     OIC_LOG(INFO, TAG, "Server Response not found!!");
263     return NULL;
264 }
265
266 OCStackResult AddServerRequest (OCServerRequest ** request, uint16_t coapID,
267         uint8_t delayedResNeeded, uint8_t notificationFlag, OCMethod method,
268         uint8_t numRcvdVendorSpecificHeaderOptions, uint32_t observationOption,
269         OCQualityOfService qos, char * query,
270         OCHeaderOption * rcvdVendorSpecificHeaderOptions,
271         uint8_t * payload, CAToken_t requestToken, uint8_t tokenLength,
272         char * resourceUrl, size_t reqTotalSize, OCPayloadFormat acceptFormat,
273         const OCDevAddr *devAddr)
274 {
275     if (!request)
276     {
277         return OC_STACK_INVALID_PARAM;
278     }
279
280     OCServerRequest * serverRequest = NULL;
281
282     OIC_LOG_V(INFO, TAG, "addserverrequest entry!! [%s:%u]", devAddr->addr, devAddr->port);
283
284     serverRequest = (OCServerRequest *) OICCalloc(1, sizeof(OCServerRequest) +
285         (reqTotalSize ? reqTotalSize : 1) - 1);
286     VERIFY_NON_NULL(devAddr);
287     VERIFY_NON_NULL(serverRequest);
288
289     serverRequest->coapID = coapID;
290     serverRequest->delayedResNeeded = delayedResNeeded;
291     serverRequest->notificationFlag = notificationFlag;
292
293     serverRequest->method = method;
294     serverRequest->numRcvdVendorSpecificHeaderOptions = numRcvdVendorSpecificHeaderOptions;
295     serverRequest->observationOption = observationOption;
296     serverRequest->observeResult = OC_STACK_ERROR;
297     serverRequest->qos = qos;
298     serverRequest->acceptFormat = acceptFormat;
299     serverRequest->ehResponseHandler = HandleSingleResponse;
300     serverRequest->numResponses = 1;
301     serverRequest->requestId = OCGetRandom();
302
303     if(query)
304     {
305         OICStrcpy(serverRequest->query, sizeof(serverRequest->query), query);
306     }
307
308     if(rcvdVendorSpecificHeaderOptions)
309     {
310         serverRequest->rcvdVendorSpecificHeaderOptions =
311                     (OCHeaderOption *) OICCalloc(numRcvdVendorSpecificHeaderOptions, sizeof(OCHeaderOption));
312         VERIFY_NON_NULL(serverRequest->rcvdVendorSpecificHeaderOptions);
313
314         memcpy(serverRequest->rcvdVendorSpecificHeaderOptions, rcvdVendorSpecificHeaderOptions,
315             numRcvdVendorSpecificHeaderOptions * sizeof(OCHeaderOption));
316     }
317     if(payload && reqTotalSize)
318     {
319         // destination is at least 1 greater than the source, so a NULL always exists in the
320         // last character
321         memcpy(serverRequest->payload, payload, reqTotalSize);
322         serverRequest->payloadSize = reqTotalSize;
323     }
324
325     serverRequest->requestComplete = 0;
326     if(requestToken)
327     {
328          // If tokenLength is zero, the return value depends on the
329          // particular library implementation (it may or may not be a null pointer).
330         if (tokenLength)
331         {
332             serverRequest->requestToken = (CAToken_t) OICMalloc(tokenLength);
333             VERIFY_NON_NULL(serverRequest->requestToken);
334             memcpy(serverRequest->requestToken, requestToken, tokenLength);
335         }
336     }
337     serverRequest->tokenLength = tokenLength;
338
339     if(resourceUrl)
340     {
341         OICStrcpy(serverRequest->resourceUrl, sizeof(serverRequest->resourceUrl),
342             resourceUrl);
343     }
344
345     serverRequest->devAddr = *devAddr;
346
347     *request = serverRequest;
348     OIC_LOG(INFO, TAG, "Server Request Added!!");
349     LL_APPEND (serverRequestList, serverRequest);
350     return OC_STACK_OK;
351
352 exit:
353     if (serverRequest)
354     {
355         OICFree(serverRequest->requestToken);
356         OICFree(serverRequest->rcvdVendorSpecificHeaderOptions);
357         OICFree(serverRequest);
358         serverRequest = NULL;
359     }
360     *request = NULL;
361     return OC_STACK_NO_MEMORY;
362 }
363
364 OCStackResult FormOCEntityHandlerRequest(
365         OCEntityHandlerRequest * entityHandlerRequest,
366         OCRequestHandle request,
367         OCMethod method,
368         OCDevAddr *endpoint,
369         OCResourceHandle resource,
370         char * queryBuf,
371         OCPayloadType payloadType,
372         uint8_t * payload,
373         size_t payloadSize,
374         uint8_t numVendorOptions,
375         OCHeaderOption * vendorOptions,
376         OCObserveAction observeAction,
377         OCObservationId observeID,
378         uint16_t messageID)
379 {
380     if (entityHandlerRequest)
381     {
382         entityHandlerRequest->resource = (OCResourceHandle) resource;
383         entityHandlerRequest->requestHandle = request;
384         entityHandlerRequest->method = method;
385         entityHandlerRequest->devAddr = *endpoint;
386         entityHandlerRequest->query = queryBuf;
387         entityHandlerRequest->obsInfo.action = observeAction;
388         entityHandlerRequest->obsInfo.obsId = observeID;
389         entityHandlerRequest->messageID = messageID;
390
391         if(payload && payloadSize)
392         {
393             if(OCParsePayload(&entityHandlerRequest->payload, payloadType,
394                         payload, payloadSize) != OC_STACK_OK)
395             {
396                 return OC_STACK_ERROR;
397             }
398         }
399         else
400         {
401             entityHandlerRequest->payload = NULL;
402         }
403
404         entityHandlerRequest->numRcvdVendorSpecificHeaderOptions = numVendorOptions;
405         entityHandlerRequest->rcvdVendorSpecificHeaderOptions = vendorOptions;
406
407         return OC_STACK_OK;
408     }
409
410     return OC_STACK_INVALID_PARAM;
411 }
412
413 /**
414  * Find a server request in the server request list and delete
415  *
416  * @param serverRequest - server request to find and delete
417  */
418 void FindAndDeleteServerRequest(OCServerRequest * serverRequest)
419 {
420     OCServerRequest* tmp;
421     if(serverRequest)
422     {
423         LL_FOREACH(serverRequestList, tmp)
424         {
425             if (serverRequest == tmp)
426             {
427                 DeleteServerRequest(tmp);
428                 return;
429             }
430         }
431     }
432 }
433
434 CAResponseResult_t ConvertEHResultToCAResult (OCEntityHandlerResult result, OCMethod method)
435 {
436     CAResponseResult_t caResult = CA_BAD_REQ;
437
438     switch (result)
439     {
440         // Successful Client Request
441         case OC_EH_RESOURCE_CREATED: // 2.01
442             if (method == OC_REST_POST || method == OC_REST_PUT)
443             {
444                 caResult = CA_CREATED;
445             }
446             break;
447         case OC_EH_RESOURCE_DELETED: // 2.02
448             if (method == OC_REST_POST || method == OC_REST_DELETE)
449             {
450                 caResult = CA_DELETED;
451             }
452             break;
453         case OC_EH_SLOW: // 2.05
454             caResult = CA_CONTENT;
455             break;
456         case OC_EH_OK:
457         case OC_EH_CHANGED: // 2.04
458         case OC_EH_CONTENT: // 2.05
459             if (method == OC_REST_POST || method == OC_REST_PUT)
460             {
461                 caResult = CA_CHANGED;
462             }
463             else if (method == OC_REST_GET)
464             {
465                 caResult = CA_CONTENT;
466             }
467             break;
468         case OC_EH_VALID: // 2.03
469             caResult = CA_VALID;
470             break;
471         // Unsuccessful Client Request
472         case OC_EH_UNAUTHORIZED_REQ: // 4.01
473             caResult = CA_UNAUTHORIZED_REQ;
474             break;
475         case OC_EH_BAD_OPT: // 4.02
476             caResult = CA_BAD_OPT;
477             break;
478         case OC_EH_FORBIDDEN: // 4.03
479             caResult = CA_FORBIDDEN_REQ;
480             break;
481         case OC_EH_RESOURCE_NOT_FOUND: // 4.04
482             caResult = CA_NOT_FOUND;
483             break;
484         case OC_EH_METHOD_NOT_ALLOWED: // 4.05
485             caResult = CA_METHOD_NOT_ALLOWED;
486             break;
487         case OC_EH_NOT_ACCEPTABLE: // 4.06
488             caResult = CA_NOT_ACCEPTABLE;
489             break;
490         case OC_EH_INTERNAL_SERVER_ERROR: // 5.00
491             caResult = CA_INTERNAL_SERVER_ERROR;
492             break;
493         case OC_EH_NOT_IMPLEMENTED: // 5.01
494             caResult = CA_NOT_IMPLEMENTED;
495             break;
496         case OC_EH_BAD_GATEWAY: // 5.02
497             caResult = CA_BAD_GATEWAY;
498             break;
499         case OC_EH_SERVICE_UNAVAILABLE: // 5.03
500             caResult = CA_SERVICE_UNAVAILABLE;
501             break;
502         case OC_EH_RETRANSMIT_TIMEOUT: // 5.04
503             caResult = CA_RETRANSMIT_TIMEOUT;
504             break;
505         case OC_EH_PROXY_NOT_SUPPORTED: // 5.05
506             caResult = CA_PROXY_NOT_SUPPORTED;
507             break;
508         default:
509             caResult = CA_BAD_REQ;
510             break;
511     }
512     return caResult;
513 }
514
515
516 /**
517  * Handler function for sending a response from a single resource
518  *
519  * @param ehResponse - pointer to the response from the resource
520  *
521  * @return
522  *     OCStackResult
523  */
524 OCStackResult HandleSingleResponse(OCEntityHandlerResponse * ehResponse)
525 {
526     OCStackResult result = OC_STACK_ERROR;
527     CAEndpoint_t responseEndpoint = {.adapter = CA_DEFAULT_ADAPTER};
528     CAResponseInfo_t responseInfo = {.result = CA_EMPTY};
529     CAHeaderOption_t* optionsPointer = NULL;
530
531     if(!ehResponse || !ehResponse->requestHandle)
532     {
533         OIC_LOG(ERROR, TAG, "ehResponse/requestHandle is NULL");
534         return OC_STACK_ERROR;
535     }
536
537     OCServerRequest *serverRequest = GetServerRequestUsingHandle(ehResponse->requestHandle);
538     if (NULL == serverRequest)
539     {
540         OIC_LOG(ERROR, TAG, "No serverRequest matching with ehResponse");
541         return OC_STACK_ERROR;
542     }
543
544     CopyDevAddrToEndpoint(&serverRequest->devAddr, &responseEndpoint);
545
546     responseInfo.info.messageId = serverRequest->coapID;
547     responseInfo.info.resourceUri = serverRequest->resourceUrl;
548     responseInfo.result = ConvertEHResultToCAResult(ehResponse->ehResult, serverRequest->method);
549     responseInfo.info.dataType = CA_RESPONSE_DATA;
550
551     if(serverRequest->notificationFlag && serverRequest->qos == OC_HIGH_QOS)
552     {
553         responseInfo.info.type = CA_MSG_CONFIRM;
554     }
555     else if(serverRequest->notificationFlag && serverRequest->qos != OC_HIGH_QOS)
556     {
557         responseInfo.info.type = CA_MSG_NONCONFIRM;
558     }
559     else if(!serverRequest->notificationFlag && !serverRequest->slowFlag &&
560             serverRequest->qos == OC_HIGH_QOS)
561     {
562         responseInfo.info.type = CA_MSG_ACKNOWLEDGE;
563     }
564     else if(!serverRequest->notificationFlag && serverRequest->slowFlag &&
565             serverRequest->qos == OC_HIGH_QOS)
566     {
567         // To assign new messageId in CA.
568         responseInfo.info.messageId = 0;
569         responseInfo.info.type = CA_MSG_CONFIRM;
570     }
571     else if(!serverRequest->notificationFlag)
572     {
573         responseInfo.info.type = CA_MSG_NONCONFIRM;
574     }
575     else
576     {
577         OIC_LOG(ERROR, TAG, "default responseInfo type is NON");
578         responseInfo.info.type = CA_MSG_NONCONFIRM;
579     }
580
581     char rspToken[CA_MAX_TOKEN_LEN + 1] = {0};
582     responseInfo.info.messageId = serverRequest->coapID;
583     responseInfo.info.token = (CAToken_t)rspToken;
584
585     memcpy(responseInfo.info.token, serverRequest->requestToken, serverRequest->tokenLength);
586     responseInfo.info.tokenLength = serverRequest->tokenLength;
587
588     if((serverRequest->observeResult == OC_STACK_OK)&&
589        (serverRequest->observationOption != MAX_SEQUENCE_NUMBER + 1))
590     {
591         responseInfo.info.numOptions = ehResponse->numSendVendorSpecificHeaderOptions + 1;
592     }
593     else
594     {
595         responseInfo.info.numOptions = ehResponse->numSendVendorSpecificHeaderOptions;
596     }
597
598     if(responseInfo.info.numOptions > 0)
599     {
600         responseInfo.info.options = (CAHeaderOption_t *)
601                                       OICCalloc(responseInfo.info.numOptions,
602                                               sizeof(CAHeaderOption_t));
603
604         if(!responseInfo.info.options)
605         {
606             OIC_LOG(FATAL, TAG, "Memory alloc for options failed");
607             return OC_STACK_NO_MEMORY;
608         }
609
610         optionsPointer = responseInfo.info.options;
611
612         // TODO: This exposes CoAP specific details.  At some point, this should be
613         // re-factored and handled in the CA layer.
614         if(serverRequest->observeResult == OC_STACK_OK)
615         {
616             responseInfo.info.options[0].protocolID = CA_COAP_ID;
617             responseInfo.info.options[0].optionID = COAP_OPTION_OBSERVE;
618             responseInfo.info.options[0].optionLength = sizeof(uint32_t);
619             uint8_t* observationData = (uint8_t*)responseInfo.info.options[0].optionData;
620             uint32_t observationOption= serverRequest->observationOption;
621
622             for (size_t i=sizeof(uint32_t); i; --i)
623             {
624                 observationData[i-1] = observationOption & 0xFF;
625                 observationOption >>=8;
626             }
627
628             // Point to the next header option before copying vender specific header options
629             optionsPointer += 1;
630         }
631
632         if (ehResponse->numSendVendorSpecificHeaderOptions)
633         {
634             memcpy(optionsPointer, ehResponse->sendVendorSpecificHeaderOptions,
635                             sizeof(OCHeaderOption) *
636                             ehResponse->numSendVendorSpecificHeaderOptions);
637         }
638     }
639     else
640     {
641         responseInfo.info.options = NULL;
642     }
643
644     responseInfo.isMulticast = false;
645     responseInfo.info.payload = NULL;
646     responseInfo.info.payloadSize = 0;
647     responseInfo.info.payloadFormat = CA_FORMAT_UNDEFINED;
648
649     // Put the JSON prefix and suffix around the payload
650     if(ehResponse->payload)
651     {
652 #ifdef WITH_PRESENCE
653         if (ehResponse->payload->type == PAYLOAD_TYPE_PRESENCE)
654         {
655             responseInfo.isMulticast = true;
656         }
657         else
658 #endif
659         {
660             responseInfo.isMulticast = false;
661         }
662
663         switch(serverRequest->acceptFormat)
664         {
665             case OC_FORMAT_UNDEFINED:
666                 // No preference set by the client, so default to CBOR then
667             case OC_FORMAT_CBOR:
668                 if((result = OCConvertPayload(ehResponse->payload, &responseInfo.info.payload,
669                                 &responseInfo.info.payloadSize))
670                         != OC_STACK_OK)
671                 {
672                     OIC_LOG(ERROR, TAG, "Error converting payload");
673                     OICFree(responseInfo.info.options);
674                     return result;
675                 }
676                 // Add CONTENT_FORMAT OPT if payload exist
677                 if (responseInfo.info.payloadSize > 0)
678                 {
679                     responseInfo.info.payloadFormat = CA_FORMAT_APPLICATION_CBOR;
680                 }
681                 break;
682             default:
683                 responseInfo.result = CA_NOT_ACCEPTABLE;
684         }
685     }
686
687 #ifdef WITH_PRESENCE
688     CATransportAdapter_t CAConnTypes[] = {
689                             CA_ADAPTER_IP,
690                             CA_ADAPTER_GATT_BTLE,
691                             CA_ADAPTER_RFCOMM_BTEDR,
692                             CA_ADAPTER_NFC
693 #ifdef RA_ADAPTER
694                             , CA_ADAPTER_REMOTE_ACCESS
695 #endif
696                             , CA_ADAPTER_TCP
697                         };
698
699     size_t size = sizeof(CAConnTypes)/ sizeof(CATransportAdapter_t);
700
701     CATransportAdapter_t adapter = responseEndpoint.adapter;
702     // Default adapter, try to send response out on all adapters.
703     if (adapter == CA_DEFAULT_ADAPTER)
704     {
705         adapter =
706             (CATransportAdapter_t)(
707                 CA_ADAPTER_IP           |
708                 CA_ADAPTER_GATT_BTLE    |
709                 CA_ADAPTER_RFCOMM_BTEDR |
710                 CA_ADAPTER_NFC
711 #ifdef RA_ADAP
712                 | CA_ADAPTER_REMOTE_ACCESS
713 #endif
714                 | CA_ADAPTER_TCP
715             );
716     }
717
718     result = OC_STACK_OK;
719     OCStackResult tempResult = OC_STACK_OK;
720
721     for(size_t i = 0; i < size; i++ )
722     {
723         responseEndpoint.adapter = (CATransportAdapter_t)(adapter & CAConnTypes[i]);
724         if(responseEndpoint.adapter)
725         {
726             //The result is set to OC_STACK_OK only if OCSendResponse succeeds in sending the
727             //response on all the n/w interfaces else it is set to OC_STACK_ERROR
728             tempResult = OCSendResponse(&responseEndpoint, &responseInfo);
729         }
730         if(OC_STACK_OK != tempResult)
731         {
732             result = tempResult;
733         }
734     }
735 #else
736
737     OIC_LOG(INFO, TAG, "Calling OCSendResponse with:");
738     OIC_LOG_V(INFO, TAG, "\tEndpoint address: %s", responseEndpoint.addr);
739     OIC_LOG_V(INFO, TAG, "\tEndpoint adapter: %s", responseEndpoint.adapter);
740     OIC_LOG_V(INFO, TAG, "\tResponse result : %s", responseInfo.result);
741     OIC_LOG_V(INFO, TAG, "\tResponse for uri: %s", responseInfo.info.resourceUri);
742
743     result = OCSendResponse(&responseEndpoint, &responseInfo);
744 #endif
745
746     OICFree(responseInfo.info.payload);
747     OICFree(responseInfo.info.options);
748     //Delete the request
749     FindAndDeleteServerRequest(serverRequest);
750     return result;
751 }
752
753 /**
754  * Handler function for sending a response from multiple resources, such as a collection.
755  * Aggregates responses from multiple resource until all responses are received then sends the
756  * concatenated response
757  *
758  * TODO: Need to add a timeout in case a (remote?) resource does not respond
759  *
760  * @param ehResponse - pointer to the response from the resource
761  *
762  * @return
763  *     OCStackResult
764  */
765 OCStackResult HandleAggregateResponse(OCEntityHandlerResponse * ehResponse)
766 {
767     if(!ehResponse || !ehResponse->payload)
768     {
769         OIC_LOG(ERROR, TAG, "HandleAggregateResponse invalid parameters");
770         return OC_STACK_INVALID_PARAM;
771     }
772
773     OIC_LOG(INFO, TAG, "Inside HandleAggregateResponse");
774
775     OCServerRequest *serverRequest = GetServerRequestUsingHandle(ehResponse->requestHandle);
776     OCServerResponse *serverResponse = GetServerResponseUsingHandle(ehResponse->requestHandle);
777
778     OCStackResult stackRet = OC_STACK_ERROR;
779     if(serverRequest)
780     {
781         if(!serverResponse)
782         {
783             OIC_LOG(INFO, TAG, "This is the first response fragment");
784             stackRet = AddServerResponse(&serverResponse, ehResponse->requestHandle);
785             if (OC_STACK_OK != stackRet)
786             {
787                 OIC_LOG(ERROR, TAG, "Error adding server response");
788                 return stackRet;
789             }
790             VERIFY_NON_NULL(serverResponse);
791         }
792
793         if(ehResponse->payload->type != PAYLOAD_TYPE_REPRESENTATION)
794         {
795             stackRet = OC_STACK_ERROR;
796             OIC_LOG(ERROR, TAG, "Error adding payload, as it was the incorrect type");
797             goto exit;
798         }
799
800         OCRepPayload *newPayload = OCRepPayloadBatchClone((OCRepPayload *)ehResponse->payload);
801
802         if(!serverResponse->payload)
803         {
804             serverResponse->payload = (OCPayload *)newPayload;
805         }
806         else
807         {
808             OCRepPayloadAppend((OCRepPayload*)serverResponse->payload,
809                     (OCRepPayload*)newPayload);
810         }
811
812         (serverRequest->numResponses)--;
813
814         if(serverRequest->numResponses == 0)
815         {
816             OIC_LOG(INFO, TAG, "This is the last response fragment");
817             ehResponse->payload = serverResponse->payload;
818             ehResponse->ehResult = OC_EH_OK;
819             stackRet = HandleSingleResponse(ehResponse);
820             //Delete the request and response
821             FindAndDeleteServerRequest(serverRequest);
822             FindAndDeleteServerResponse(serverResponse);
823         }
824         else
825         {
826             OIC_LOG(INFO, TAG, "More response fragments to come");
827             stackRet = OC_STACK_OK;
828         }
829     }
830 exit:
831
832     return stackRet;
833 }