1 //******************************************************************
3 // Copyright 2014 Intel Mobile Communications GmbH All Rights Reserved.
5 //-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
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
11 // http://www.apache.org/licenses/LICENSE-2.0
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.
19 //-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
21 // Defining _POSIX_C_SOURCE macro with 200112L (or greater) as value
22 // causes header files to expose definitions
23 // corresponding to the POSIX.1-2001 base
24 // specification (excluding the XSI extension).
25 // For POSIX.1-2001 base specification,
26 // Refer http://pubs.opengroup.org/onlinepubs/009695399/
27 #define _POSIX_C_SOURCE 200112L
32 #include "iotivity_config.h"
40 #include "ocresource.h"
41 #include "ocresourcehandler.h"
42 #include "ocobserve.h"
43 #include "occollection.h"
44 #include "oic_malloc.h"
45 #include "oic_string.h"
48 #include "ocpayload.h"
49 #include "secureresourcemanager.h"
51 #include "cainterface.h"
52 #include "ocpayload.h"
53 #include "platform_features.h"
54 #include "payload_logging.h"
55 #ifdef ROUTING_GATEWAY
56 #include "routingmanager.h"
60 #include "rd_database.h"
64 #define TAG "OIC_RI_RESOURCE"
66 #define VERIFY_SUCCESS(op, successCode) { if (op != successCode) \
67 {OIC_LOG_V(FATAL, TAG, "%s failed!!", #op); goto exit;} }
69 extern OCResource *headResource;
70 static OCPlatformInfo savedPlatformInfo = {0};
71 static OCDeviceInfo savedDeviceInfo = {0};
74 * Prepares a Payload for response.
76 static OCStackResult BuildVirtualResourceResponse(const OCResource *resourcePtr,
77 OCDiscoveryPayload* payload,
80 //-----------------------------------------------------------------------------
81 // Default resource entity handler function
82 //-----------------------------------------------------------------------------
83 OCEntityHandlerResult defaultResourceEHandler(OCEntityHandlerFlag flag,
84 OCEntityHandlerRequest * request, void* callbackParam)
86 //TODO ("Implement me!!!!");
87 // TODO: remove silence unused param warnings
91 return OC_EH_OK; // Making sure that the Default EH and the Vendor EH have matching signatures
94 /* This method will retrieve the port at which the secure resource is hosted */
95 static OCStackResult GetSecurePortInfo(OCDevAddr *endpoint, uint16_t *port)
99 if (endpoint->adapter == OC_ADAPTER_IP)
101 if (endpoint->flags & OC_IP_USE_V6)
103 p = caglobals.ip.u6s.port;
105 else if (endpoint->flags & OC_IP_USE_V4)
107 p = caglobals.ip.u4s.port;
116 /* This method will retrieve the tcp port */
117 static OCStackResult GetTCPPortInfo(OCDevAddr *endpoint, uint16_t *port)
121 if (endpoint->adapter == OC_ADAPTER_IP)
123 if (endpoint->flags & OC_IP_USE_V4)
125 p = caglobals.tcp.ipv4.port;
127 else if (endpoint->flags & OC_IP_USE_V6)
129 p = caglobals.tcp.ipv6.port;
139 * Function will extract 0, 1 or 2 filters from query.
140 * More than 2 filters or unsupported filters will result in error.
141 * If both filters are of the same supported type, the 2nd one will be picked.
142 * Resource and device filters in the SAME query are NOT validated
143 * and resources will likely not clear filters.
145 static OCStackResult ExtractFiltersFromQuery(char *query, char **filterOne, char **filterTwo)
149 char *queryDup = NULL;
150 char *restOfQuery = NULL;
151 char *keyValuePair = NULL;
152 int numKeyValuePairsParsed = 0;
157 queryDup = OICStrdup(query);
158 if (NULL == queryDup)
160 OIC_LOG_V(ERROR, TAG, "Creating duplicate string failed!");
161 return OC_STACK_NO_MEMORY;
164 OIC_LOG_V(INFO, TAG, "Extracting params from %s", queryDup);
166 OCStackResult eCode = OC_STACK_INVALID_QUERY;
167 if (strnlen(queryDup, MAX_QUERY_LENGTH) >= MAX_QUERY_LENGTH)
169 OIC_LOG(ERROR, TAG, "Query exceeds maximum length.");
173 keyValuePair = strtok_r (queryDup, OC_QUERY_SEPARATOR, &restOfQuery);
177 if (numKeyValuePairsParsed >= 2)
179 OIC_LOG(ERROR, TAG, "More than 2 queries params in URI.");
183 key = strtok_r(keyValuePair, OC_KEY_VALUE_DELIMITER, &value);
189 else if (strncasecmp(key, OC_RSRVD_INTERFACE, sizeof(OC_RSRVD_INTERFACE) - 1) == 0)
191 *filterOne = value; // if
193 else if (strncasecmp(key, OC_RSRVD_RESOURCE_TYPE, sizeof(OC_RSRVD_INTERFACE) - 1) == 0)
195 *filterTwo = value; // rt
199 OIC_LOG_V(ERROR, TAG, "Unsupported query key: %s", key);
202 ++numKeyValuePairsParsed;
204 keyValuePair = strtok_r(NULL, OC_QUERY_SEPARATOR, &restOfQuery);
209 *filterOne = OICStrdup(*filterOne);
210 if (NULL == *filterOne)
212 OIC_LOG_V(ERROR, TAG, "Creating duplicate string failed!");
213 eCode = OC_STACK_NO_MEMORY;
220 *filterTwo = OICStrdup(*filterTwo);
221 if (NULL == *filterTwo)
223 OIC_LOG_V(ERROR, TAG, "Creating duplicate string failed!");
225 eCode = OC_STACK_NO_MEMORY;
231 OIC_LOG_V(INFO, TAG, "Extracted params if: %s and rt: %s.", *filterOne, *filterTwo);
241 static OCVirtualResources GetTypeOfVirtualURI(const char *uriInRequest)
243 if (strcmp(uriInRequest, OC_RSRVD_WELL_KNOWN_URI) == 0)
245 return OC_WELL_KNOWN_URI;
247 else if (strcmp(uriInRequest, OC_RSRVD_DEVICE_URI) == 0)
249 return OC_DEVICE_URI;
251 else if (strcmp(uriInRequest, OC_RSRVD_PLATFORM_URI) == 0)
253 return OC_PLATFORM_URI;
255 else if (strcmp(uriInRequest, OC_RSRVD_RESOURCE_TYPES_URI) == 0)
257 return OC_RESOURCE_TYPES_URI;
259 #ifdef ROUTING_GATEWAY
260 else if (0 == strcmp(uriInRequest, OC_RSRVD_GATEWAY_URI))
262 return OC_GATEWAY_URI;
266 else if (strcmp(uriInRequest, OC_RSRVD_PRESENCE_URI) == 0)
270 #endif //WITH_PRESENCE
273 else if (0 == strcmp(uriInRequest, OC_RSRVD_WELL_KNOWN_MQ_URI))
275 return OC_MQ_BROKER_URI;
280 else if (strcmp(uriInRequest, OC_RSRVD_KEEPALIVE_URI) == 0)
282 return OC_KEEPALIVE_RESOURCE_URI;
286 return OC_UNKNOWN_URI;
289 static OCStackResult getQueryParamsForFiltering (OCVirtualResources uri, char *query,
290 char **filterOne, char **filterTwo)
292 if(!filterOne || !filterTwo)
294 return OC_STACK_INVALID_PARAM;
301 if (uri == OC_PRESENCE)
303 //Nothing needs to be done, except for pass a OC_PRESENCE query through as OC_STACK_OK.
304 OIC_LOG(INFO, TAG, "OC_PRESENCE Request for virtual resource.");
309 OCStackResult result = OC_STACK_OK;
313 result = ExtractFiltersFromQuery(query, filterOne, filterTwo);
319 OCStackResult BuildResponseRepresentation(const OCResource *resourcePtr,
320 OCRepPayload** payload)
322 OCRepPayload *tempPayload = OCRepPayloadCreate();
326 OCRepPayloadDestroy(tempPayload);
327 return OC_STACK_INVALID_PARAM;
332 return OC_STACK_NO_MEMORY;
335 OCRepPayloadSetUri(tempPayload, resourcePtr->uri);
337 OCResourceType *resType = resourcePtr->rsrcType;
340 OCRepPayloadAddResourceType(tempPayload, resType->resourcetypename);
341 resType = resType->next;
344 OCResourceInterface *resInterface = resourcePtr->rsrcInterface;
347 OCRepPayloadAddInterface(tempPayload, resInterface->name);
348 resInterface = resInterface->next;
351 OCAttribute *resAttrib = resourcePtr->rsrcAttributes;
354 OCRepPayloadSetPropString(tempPayload, resAttrib->attrName,
355 resAttrib->attrValue);
356 resAttrib = resAttrib->next;
361 *payload = tempPayload;
365 OCRepPayloadAppend(*payload, tempPayload);
371 OCStackResult BuildVirtualResourceResponse(const OCResource *resourcePtr,
372 OCDiscoveryPayload *payload, OCDevAddr *devAddr)
374 if (!resourcePtr || !payload)
376 return OC_STACK_INVALID_PARAM;
378 uint16_t securePort = 0;
379 if (resourcePtr->resourceProperties & OC_SECURE)
381 if (GetSecurePortInfo(devAddr, &securePort) != OC_STACK_OK)
388 uint16_t tcpPort = 0;
389 if (GetTCPPortInfo(devAddr, &tcpPort) != OC_STACK_OK)
393 OCDiscoveryPayloadAddResource(payload, resourcePtr, securePort, tcpPort);
395 OCDiscoveryPayloadAddResource(payload, resourcePtr, securePort);
401 uint8_t IsCollectionResource (OCResource *resource)
408 if(resource->rsrcChildResourcesHead != NULL)
416 OCResource *FindResourceByUri(const char* resourceUri)
423 OCResource * pointer = headResource;
426 if (strcmp(resourceUri, pointer->uri) == 0)
430 pointer = pointer->next;
432 OIC_LOG_V(INFO, TAG, "Resource %s not found", resourceUri);
437 OCStackResult DetermineResourceHandling (const OCServerRequest *request,
438 ResourceHandling *handling,
439 OCResource **resource)
441 if(!request || !handling || !resource)
443 return OC_STACK_INVALID_PARAM;
446 OIC_LOG_V(INFO, TAG, "DetermineResourceHandling for %s", request->resourceUrl);
448 // Check if virtual resource
449 if (GetTypeOfVirtualURI(request->resourceUrl) != OC_UNKNOWN_URI)
451 OIC_LOG_V (INFO, TAG, "%s is virtual", request->resourceUrl);
452 *handling = OC_RESOURCE_VIRTUAL;
453 *resource = headResource;
456 if (strlen((const char*)(request->resourceUrl)) == 0)
458 // Resource URL not specified
459 *handling = OC_RESOURCE_NOT_SPECIFIED;
460 return OC_STACK_NO_RESOURCE;
464 OCResource *resourcePtr = FindResourceByUri((const char*)request->resourceUrl);
465 *resource = resourcePtr;
468 if(defaultDeviceHandler)
470 *handling = OC_RESOURCE_DEFAULT_DEVICE_ENTITYHANDLER;
474 // Resource does not exist
475 // and default device handler does not exist
476 *handling = OC_RESOURCE_NOT_SPECIFIED;
477 return OC_STACK_NO_RESOURCE;
480 if (IsCollectionResource (resourcePtr))
482 // Collection resource
483 if (resourcePtr->entityHandler != defaultResourceEHandler)
485 *handling = OC_RESOURCE_COLLECTION_WITH_ENTITYHANDLER;
490 *handling = OC_RESOURCE_COLLECTION_DEFAULT_ENTITYHANDLER;
496 // Resource not a collection
497 if (resourcePtr->entityHandler != defaultResourceEHandler)
499 *handling = OC_RESOURCE_NOT_COLLECTION_WITH_ENTITYHANDLER;
504 *handling = OC_RESOURCE_NOT_COLLECTION_DEFAULT_ENTITYHANDLER;
511 OCStackResult EntityHandlerCodeToOCStackCode(OCEntityHandlerResult ehResult)
513 OCStackResult result;
520 result = OC_STACK_OK;
523 result = OC_STACK_SLOW_RESOURCE;
526 result = OC_STACK_ERROR;
528 case OC_EH_FORBIDDEN:
529 result = OC_STACK_FORBIDDEN_REQ;
531 case OC_EH_INTERNAL_SERVER_ERROR:
532 result = OC_STACK_INTERNAL_SERVER_ERROR;
534 case OC_EH_RESOURCE_CREATED:
535 result = OC_STACK_RESOURCE_CREATED;
537 case OC_EH_RESOURCE_DELETED:
538 result = OC_STACK_RESOURCE_DELETED;
541 result = OC_STACK_RESOURCE_CHANGED;
543 case OC_EH_RESOURCE_NOT_FOUND:
544 result = OC_STACK_NO_RESOURCE;
547 result = OC_STACK_ERROR;
553 static bool resourceMatchesRTFilter(OCResource *resource, char *resourceTypeFilter)
560 // Null or empty is analogous to no filter.
561 if (resourceTypeFilter == NULL || *resourceTypeFilter == 0)
566 OCResourceType *resourceTypePtr = resource->rsrcType;
568 while (resourceTypePtr)
570 if (strcmp (resourceTypePtr->resourcetypename, resourceTypeFilter) == 0)
574 resourceTypePtr = resourceTypePtr->next;
577 OIC_LOG_V(INFO, TAG, "%s does not contain rt=%s.", resource->uri, resourceTypeFilter);
581 static bool resourceMatchesIFFilter(OCResource *resource, char *interfaceFilter)
588 // Null or empty is analogous to no filter.
589 if (interfaceFilter == NULL || *interfaceFilter == 0)
594 OCResourceInterface *interfacePtr = resource->rsrcInterface;
598 if (strcmp (interfacePtr->name, interfaceFilter) == 0 ||
599 strcmp (OC_RSRVD_INTERFACE_LL, interfaceFilter) == 0 ||
600 strcmp (OC_RSRVD_INTERFACE_DEFAULT, interfaceFilter) == 0)
604 interfacePtr = interfacePtr->next;
607 OIC_LOG_V(INFO, TAG, "%s does not contain if=%s.", resource->uri, interfaceFilter);
612 * If the filters are null, they will be assumed to NOT be present
613 * and the resource will not be matched against them.
614 * Function will return true if all non null AND non empty filters passed in find a match.
616 static bool includeThisResourceInResponse(OCResource *resource,
617 char *interfaceFilter,
618 char *resourceTypeFilter)
622 OIC_LOG(ERROR, TAG, "Invalid resource");
626 if (resource->resourceProperties & OC_EXPLICIT_DISCOVERABLE)
629 * At least one valid filter should be available to
630 * include the resource in discovery response
632 if (!(resourceTypeFilter && *resourceTypeFilter))
634 OIC_LOG_V(INFO, TAG, "%s no query string for EXPLICIT_DISCOVERABLE \
635 resource", resource->uri);
639 else if ( !(resource->resourceProperties & OC_ACTIVE) ||
640 !(resource->resourceProperties & OC_DISCOVERABLE))
642 OIC_LOG_V(INFO, TAG, "%s not ACTIVE or DISCOVERABLE", resource->uri);
646 return resourceMatchesIFFilter(resource, interfaceFilter) &&
647 resourceMatchesRTFilter(resource, resourceTypeFilter);
651 OCStackResult SendNonPersistantDiscoveryResponse(OCServerRequest *request, OCResource *resource,
652 OCPayload *discoveryPayload, OCEntityHandlerResult ehResult)
654 OCEntityHandlerResponse response = {0};
656 response.ehResult = ehResult;
657 response.payload = discoveryPayload;
658 response.persistentBufferFlag = 0;
659 response.requestHandle = (OCRequestHandle) request;
660 response.resourceHandle = (OCResourceHandle) resource;
662 return OCDoResponse(&response);
666 * Find resource at the resource directory server. This resource is not local resource but a
669 * @param resource The resource to check the matching resource URI.
670 * @param interfaceQuery The interface query parameter.
671 * @param resourceTypeQuery The resourceType query parameter.
672 * @param discPayload The payload that will be added with the resource information if found at RD.
674 * @return ::OC_STACK_OK if the resource is found else ::OC_STACK_NO_RESOURCE.
675 * In case if build is not with flag RD_SERVER, it returns ::OC_STACK_NO_RESOURCE.
677 static OCStackResult findResourceAtRD(const OCResource* resource, const char *interfaceQuery,
678 const char *resourceTypeQuery, OCDiscoveryPayload *discPayload)
681 if (strcmp(resource->uri, OC_RSRVD_RD_URI) == 0)
683 if (OC_STACK_OK == OCRDDatabaseCheckResources(interfaceQuery, resourceTypeQuery, discPayload))
690 OC_UNUSED(interfaceQuery);
691 OC_UNUSED(resourceTypeQuery);
692 OC_UNUSED(discPayload);
694 return OC_STACK_NO_RESOURCE;
698 * Creates a discovery payload and add device id information. This information is included in all
701 * @param payload payload that will have memory alllocated and device id information added.
703 * @return ::OC_STACK_OK if successful in allocating memory and adding ID information.
704 * ::OC_STACK_NO_MEMORY if failed allocating the memory.
706 static OCStackResult discoveryPayloadCreateAndAddDeviceId(OCPayload **payload)
710 OIC_LOG_V(DEBUG, TAG, "Payload is already allocated");
714 *payload = (OCPayload *) OCDiscoveryPayloadCreate();
715 VERIFY_PARAM_NON_NULL(TAG, *payload, "Failed adding device id to discovery payload.");
718 OCDiscoveryPayload *discPayload = (OCDiscoveryPayload *)*payload;
719 discPayload->sid = (char *)OICCalloc(1, UUID_STRING_SIZE);
720 VERIFY_PARAM_NON_NULL(TAG, discPayload->sid, "Failed adding device id to discovery payload.");
722 const char* uid = OCGetServerInstanceIDString();
725 memcpy(discPayload->sid, uid, UUID_STRING_SIZE);
731 OCPayloadDestroy(*payload);
732 return OC_STACK_NO_MEMORY;
736 * Add the common properties to the payload, they are only included in case of oic.if.baseline response.
738 * @param discPayload payload that will have the baseline information included.
740 * @return ::OC_STACK_OK if successful in adding all the information. ::OC_STACK_NO_MEMORY if failed
741 * allocating the memory for the baseline information.
743 static OCStackResult addDiscoveryBaselineCommonProperties(OCDiscoveryPayload *discPayload)
745 discPayload->uri = OICStrdup(OC_RSRVD_WELL_KNOWN_URI);
746 VERIFY_PARAM_NON_NULL(TAG, discPayload->uri, "Failed adding href to discovery payload.");
748 if (savedDeviceInfo.deviceName)
750 discPayload->name = OICStrdup(savedDeviceInfo.deviceName);
751 VERIFY_PARAM_NON_NULL(TAG, discPayload->name, "Failed adding name to discovery payload.");
754 discPayload->type = (OCStringLL*)OICCalloc(1, sizeof(OCStringLL));
755 VERIFY_PARAM_NON_NULL(TAG, discPayload->type, "Failed adding rt to discovery payload.");
756 discPayload->type->value = OICStrdup(OC_RSRVD_RESOURCE_TYPE_RES);
757 VERIFY_PARAM_NON_NULL(TAG, discPayload->type, "Failed adding rt value to discovery payload.");
759 OCResourcePayloadAddStringLL(&discPayload->iface, OC_RSRVD_INTERFACE_LL);
760 OCResourcePayloadAddStringLL(&discPayload->iface, OC_RSRVD_INTERFACE_DEFAULT);
761 VERIFY_PARAM_NON_NULL(TAG, discPayload->iface, "Failed adding if to discovery payload.");
766 return OC_STACK_NO_MEMORY;
769 static OCStackResult HandleVirtualResource (OCServerRequest *request, OCResource* resource)
771 if (!request || !resource)
773 return OC_STACK_INVALID_PARAM;
776 OCStackResult discoveryResult = OC_STACK_ERROR;
777 OCPayload* payload = NULL;
778 char *interfaceQuery = NULL;
779 char *resourceTypeQuery = NULL;
780 char *dataModelVersions = NULL;
782 OIC_LOG(INFO, TAG, "Entering HandleVirtualResource");
784 OCVirtualResources virtualUriInRequest = GetTypeOfVirtualURI (request->resourceUrl);
786 // Step 1: Generate the response to discovery request
787 if (virtualUriInRequest == OC_WELL_KNOWN_URI
789 || virtualUriInRequest == OC_MQ_BROKER_URI
793 if (request->method == OC_REST_PUT || request->method == OC_REST_POST ||
794 request->method == OC_REST_DELETE)
796 OIC_LOG_V(ERROR, TAG, "Resource : %s not permitted for method: %d",
797 request->resourceUrl, request->method);
798 discoveryResult = OC_STACK_UNAUTHORIZED_REQ;
802 discoveryResult = getQueryParamsForFiltering (virtualUriInRequest, request->query,
803 &interfaceQuery, &resourceTypeQuery);
804 VERIFY_SUCCESS(discoveryResult, OC_STACK_OK);
805 if (!interfaceQuery && !resourceTypeQuery)
807 // If no query is sent, default interface is used i.e. oic.if.ll.
808 interfaceQuery = OICStrdup(OC_RSRVD_INTERFACE_LL);
811 bool baselineQuery = false;
812 if (interfaceQuery && 0 != strcmp(interfaceQuery, OC_RSRVD_INTERFACE_LL))
814 baselineQuery = true;
817 discoveryResult = discoveryPayloadCreateAndAddDeviceId(&payload);
818 VERIFY_PARAM_NON_NULL(TAG, payload, "Failed creating Discovery Payload.");
819 VERIFY_SUCCESS(discoveryResult, OC_STACK_OK);
821 OCDiscoveryPayload *discPayload = (OCDiscoveryPayload *)payload;
824 discoveryResult = addDiscoveryBaselineCommonProperties(discPayload);
825 VERIFY_SUCCESS(discoveryResult, OC_STACK_OK);
827 OCResourceProperty prop = OC_DISCOVERABLE;
829 prop = (OC_MQ_BROKER_URI == virtualUriInRequest) ? OC_MQ_BROKER : prop;
831 for (; resource && discoveryResult == OC_STACK_OK; resource = resource->next)
833 discoveryResult = findResourceAtRD(resource, interfaceQuery, resourceTypeQuery,
835 if (OC_STACK_NO_RESOURCE == discoveryResult)
837 if ((!baselineQuery && (resource->resourceProperties & prop)) ||
838 (baselineQuery && (includeThisResourceInResponse(resource, interfaceQuery,
839 resourceTypeQuery))))
841 if ((!baselineQuery && (resource->resourceProperties & prop)) ||
842 (baselineQuery && (includeThisResourceInResponse(resource, interfaceQuery,
843 resourceTypeQuery))))
845 discoveryResult = BuildVirtualResourceResponse(resource, discPayload,
850 discoveryResult = OC_STACK_OK;
855 if (discPayload->resources == NULL)
857 discoveryResult = OC_STACK_NO_RESOURCE;
860 else if (virtualUriInRequest == OC_DEVICE_URI)
862 if (request->method == OC_REST_PUT || request->method == OC_REST_POST ||
863 request->method == OC_REST_DELETE)
865 OIC_LOG_V(ERROR, TAG, "Resource : %s not permitted for method: %d",
866 request->resourceUrl, request->method);
867 discoveryResult = OC_STACK_UNAUTHORIZED_REQ;
871 const char* deviceId = OCGetServerInstanceIDString();
872 VERIFY_PARAM_NON_NULL(TAG, deviceId, "Failed retrieving device id.");
873 discoveryResult = OC_STACK_NO_MEMORY;
874 dataModelVersions = OCCreateString(savedDeviceInfo.dataModelVersions);
875 VERIFY_PARAM_NON_NULL(TAG, dataModelVersions, "Failed adding data model version.");
876 payload = (OCPayload*) OCDevicePayloadCreate(deviceId, savedDeviceInfo.deviceName,
877 savedDeviceInfo.types, savedDeviceInfo.specVersion, dataModelVersions);
878 VERIFY_PARAM_NON_NULL(TAG, payload, "Failed adding device payload.");
880 else if (virtualUriInRequest == OC_PLATFORM_URI)
882 if (request->method == OC_REST_PUT || request->method == OC_REST_POST ||
883 request->method == OC_REST_DELETE)
885 OIC_LOG_V(ERROR, TAG, "Resource : %s not permitted for method: %d",
886 request->resourceUrl, request->method);
887 discoveryResult = OC_STACK_UNAUTHORIZED_REQ;
891 discoveryResult = OC_STACK_NO_MEMORY;
892 payload = (OCPayload *)OCPlatformPayloadCreate(&savedPlatformInfo);
893 VERIFY_PARAM_NON_NULL(TAG, payload, "Failed adding platform payload.");
895 #ifdef ROUTING_GATEWAY
896 else if (OC_GATEWAY_URI == virtualUriInRequest)
898 // Received request for a gateway
899 OIC_LOG(INFO, TAG, "Request is for Gateway Virtual Request");
900 discoveryResult = RMHandleGatewayRequest(request, resource);
904 else if (OC_KEEPALIVE_RESOURCE_URI == virtualUriInRequest)
906 // Received request for a keepalive
907 OIC_LOG(INFO, TAG, "Request is for KeepAlive Request");
908 discoveryResult = HandleKeepAliveRequest(request, resource);
912 * Step 2: Send the discovery response
914 * Iotivity should respond to discovery requests in below manner:
915 * 1)If query filter matching fails and discovery request is multicast,
916 * it should NOT send any response.
917 * 2)If query filter matching fails and discovery request is unicast,
918 * it should send an error(RESOURCE_NOT_FOUND - 404) response.
919 * 3)If Server does not have any 'DISCOVERABLE' resources and discovery
920 * request is multicast, it should NOT send any response.
921 * 4)If Server does not have any 'DISCOVERABLE' resources and discovery
922 * request is unicast, it should send an error(RESOURCE_NOT_FOUND - 404) response.
926 if ((virtualUriInRequest == OC_PRESENCE) &&
927 (resource->resourceProperties & OC_ACTIVE))
929 // Need to send ACK when the request is CON.
930 if (request->qos == OC_HIGH_QOS)
932 CAEndpoint_t endpoint = { .adapter = CA_DEFAULT_ADAPTER };
933 CopyDevAddrToEndpoint(&request->devAddr, &endpoint);
934 SendDirectStackResponse(&endpoint, request->coapID, CA_EMPTY, CA_MSG_ACKNOWLEDGE,
935 0, NULL, NULL, 0, NULL, CA_RESPONSE_FOR_RES);
937 FindAndDeleteServerRequest(request);
939 // Presence uses observer notification api to respond via SendPresenceNotification.
940 SendPresenceNotification(resource->rsrcType, OC_PRESENCE_TRIGGER_CHANGE);
945 // Gateway uses the RMHandleGatewayRequest to respond to the request.
946 if (OC_GATEWAY_URI != virtualUriInRequest)
950 // KeepAlive uses the HandleKeepAliveRequest to respond to the request.
951 if (OC_KEEPALIVE_RESOURCE_URI != virtualUriInRequest)
954 OIC_LOG_PAYLOAD(DEBUG, payload);
955 if(discoveryResult == OC_STACK_OK)
957 SendNonPersistantDiscoveryResponse(request, resource, payload, OC_EH_OK);
959 else if(((request->devAddr.flags & OC_MULTICAST) == false) &&
960 (request->devAddr.adapter != OC_ADAPTER_RFCOMM_BTEDR) &&
961 (request->devAddr.adapter != OC_ADAPTER_GATT_BTLE))
963 OIC_LOG_V(ERROR, TAG, "Sending a (%d) error to (%d) discovery request",
964 discoveryResult, virtualUriInRequest);
965 SendNonPersistantDiscoveryResponse(request, resource, NULL,
966 (discoveryResult == OC_STACK_NO_RESOURCE) ?
967 OC_EH_RESOURCE_NOT_FOUND : OC_EH_ERROR);
971 // Ignoring the discovery request as per RFC 7252, Section #8.2
972 OIC_LOG(INFO, TAG, "Silently ignoring the request since no useful data to send.");
973 // the request should be removed.
974 // since it never remove and causes a big memory waste.
975 FindAndDeleteServerRequest(request);
983 OICFree(interfaceQuery);
986 if (resourceTypeQuery)
988 OICFree(resourceTypeQuery);
990 OCPayloadDestroy(payload);
991 if (dataModelVersions)
993 OICFree(dataModelVersions);
995 return discoveryResult;
999 HandleDefaultDeviceEntityHandler (OCServerRequest *request)
1003 return OC_STACK_INVALID_PARAM;
1006 OCStackResult result = OC_STACK_OK;
1007 OCEntityHandlerResult ehResult = OC_EH_ERROR;
1008 OCEntityHandlerRequest ehRequest = {0};
1010 OIC_LOG(INFO, TAG, "Entering HandleResourceWithDefaultDeviceEntityHandler");
1011 result = FormOCEntityHandlerRequest(&ehRequest,
1012 (OCRequestHandle) request,
1015 (OCResourceHandle) NULL, request->query,
1016 PAYLOAD_TYPE_REPRESENTATION,
1018 request->payloadSize,
1019 request->numRcvdVendorSpecificHeaderOptions,
1020 request->rcvdVendorSpecificHeaderOptions,
1021 (OCObserveAction)request->observationOption,
1024 VERIFY_SUCCESS(result, OC_STACK_OK);
1026 // At this point we know for sure that defaultDeviceHandler exists
1027 ehResult = defaultDeviceHandler(OC_REQUEST_FLAG, &ehRequest,
1028 (char*) request->resourceUrl, defaultDeviceHandlerCallbackParameter);
1029 if(ehResult == OC_EH_SLOW)
1031 OIC_LOG(INFO, TAG, "This is a slow resource");
1032 request->slowFlag = 1;
1034 else if(ehResult == OC_EH_ERROR)
1036 FindAndDeleteServerRequest(request);
1038 result = EntityHandlerCodeToOCStackCode(ehResult);
1040 OCPayloadDestroy(ehRequest.payload);
1044 static OCStackResult
1045 HandleResourceWithEntityHandler (OCServerRequest *request,
1046 OCResource *resource,
1047 uint8_t collectionResource)
1049 OC_UNUSED(collectionResource);
1051 if(!request || ! resource)
1053 return OC_STACK_INVALID_PARAM;
1056 OCStackResult result = OC_STACK_ERROR;
1057 OCEntityHandlerResult ehResult = OC_EH_ERROR;
1058 OCEntityHandlerFlag ehFlag = OC_REQUEST_FLAG;
1059 ResourceObserver *resObs = NULL;
1061 OCEntityHandlerRequest ehRequest = {0};
1063 OIC_LOG(INFO, TAG, "Entering HandleResourceWithEntityHandler");
1064 OCPayloadType type = PAYLOAD_TYPE_REPRESENTATION;
1065 // check the security resource
1066 if (request && request->resourceUrl && SRMIsSecurityResourceURI(request->resourceUrl))
1068 type = PAYLOAD_TYPE_SECURITY;
1072 result = FormOCEntityHandlerRequest(&ehRequest,
1073 (OCRequestHandle)request,
1076 (OCResourceHandle)resource,
1080 request->payloadSize,
1081 request->numRcvdVendorSpecificHeaderOptions,
1082 request->rcvdVendorSpecificHeaderOptions,
1083 (OCObserveAction)request->observationOption,
1086 VERIFY_SUCCESS(result, OC_STACK_OK);
1088 if(ehRequest.obsInfo.action == OC_OBSERVE_NO_OPTION)
1090 OIC_LOG(INFO, TAG, "No observation requested");
1091 ehFlag = OC_REQUEST_FLAG;
1093 else if(ehRequest.obsInfo.action == OC_OBSERVE_REGISTER)
1095 OIC_LOG(INFO, TAG, "Observation registration requested");
1097 ResourceObserver *obs = GetObserverUsingToken (request->requestToken,
1098 request->tokenLength);
1102 OIC_LOG (INFO, TAG, "Observer with this token already present");
1103 OIC_LOG (INFO, TAG, "Possibly re-transmitted CON OBS request");
1104 OIC_LOG (INFO, TAG, "Not adding observer. Not responding to client");
1105 OIC_LOG (INFO, TAG, "The first request for this token is already ACKED.");
1107 // server requests are usually free'd when the response is sent out
1108 // for the request in ocserverrequest.c : HandleSingleResponse()
1109 // Since we are making an early return and not responding, the server request
1110 // needs to be deleted.
1111 FindAndDeleteServerRequest (request);
1115 result = GenerateObserverId(&ehRequest.obsInfo.obsId);
1116 VERIFY_SUCCESS(result, OC_STACK_OK);
1118 result = AddObserver ((const char*)(request->resourceUrl),
1119 (const char *)(request->query),
1120 ehRequest.obsInfo.obsId, request->requestToken, request->tokenLength,
1121 resource, request->qos, request->acceptFormat,
1124 if(result == OC_STACK_OK)
1126 OIC_LOG(INFO, TAG, "Added observer successfully");
1127 request->observeResult = OC_STACK_OK;
1128 ehFlag = (OCEntityHandlerFlag)(OC_REQUEST_FLAG | OC_OBSERVE_FLAG);
1130 else if (result == OC_STACK_RESOURCE_ERROR)
1132 OIC_LOG(INFO, TAG, "The Resource is not active, discoverable or observable");
1133 request->observeResult = OC_STACK_ERROR;
1134 ehFlag = OC_REQUEST_FLAG;
1138 // The error in observeResult for the request will be used when responding to this
1139 // request by omitting the observation option/sequence number.
1140 request->observeResult = OC_STACK_ERROR;
1141 OIC_LOG(ERROR, TAG, "Observer Addition failed");
1142 ehFlag = OC_REQUEST_FLAG;
1143 FindAndDeleteServerRequest(request);
1148 else if(ehRequest.obsInfo.action == OC_OBSERVE_DEREGISTER)
1150 OIC_LOG(INFO, TAG, "Deregistering observation requested");
1152 resObs = GetObserverUsingToken (request->requestToken, request->tokenLength);
1156 // Stack does not contain this observation request
1157 // Either token is incorrect or observation list is corrupted
1158 result = OC_STACK_ERROR;
1161 ehRequest.obsInfo.obsId = resObs->observeId;
1162 ehFlag = (OCEntityHandlerFlag)(ehFlag | OC_OBSERVE_FLAG);
1164 result = DeleteObserverUsingToken (request->requestToken, request->tokenLength);
1166 if(result == OC_STACK_OK)
1168 OIC_LOG(INFO, TAG, "Removed observer successfully");
1169 request->observeResult = OC_STACK_OK;
1170 // There should be no observe option header for de-registration response.
1171 // Set as an invalid value here so we can detect it later and remove the field in response.
1172 request->observationOption = MAX_SEQUENCE_NUMBER + 1;
1176 request->observeResult = OC_STACK_ERROR;
1177 OIC_LOG(ERROR, TAG, "Observer Removal failed");
1178 FindAndDeleteServerRequest(request);
1184 result = OC_STACK_ERROR;
1188 ehResult = resource->entityHandler(ehFlag, &ehRequest, resource->entityHandlerCallbackParam);
1189 if(ehResult == OC_EH_SLOW)
1191 OIC_LOG(INFO, TAG, "This is a slow resource");
1192 request->slowFlag = 1;
1194 else if(ehResult == OC_EH_ERROR)
1196 FindAndDeleteServerRequest(request);
1198 result = EntityHandlerCodeToOCStackCode(ehResult);
1200 OCPayloadDestroy(ehRequest.payload);
1204 static OCStackResult
1205 HandleCollectionResourceDefaultEntityHandler (OCServerRequest *request,
1206 OCResource *resource)
1208 if(!request || !resource)
1210 return OC_STACK_INVALID_PARAM;
1213 OCStackResult result = OC_STACK_ERROR;
1214 OCEntityHandlerRequest ehRequest = {0};
1216 result = FormOCEntityHandlerRequest(&ehRequest,
1217 (OCRequestHandle)request,
1220 (OCResourceHandle)resource,
1222 PAYLOAD_TYPE_REPRESENTATION,
1224 request->payloadSize,
1225 request->numRcvdVendorSpecificHeaderOptions,
1226 request->rcvdVendorSpecificHeaderOptions,
1227 (OCObserveAction)request->observationOption,
1230 if(result == OC_STACK_OK)
1232 result = DefaultCollectionEntityHandler (OC_REQUEST_FLAG, &ehRequest);
1235 OCPayloadDestroy(ehRequest.payload);
1240 ProcessRequest(ResourceHandling resHandling, OCResource *resource, OCServerRequest *request)
1242 OCStackResult ret = OC_STACK_OK;
1244 switch (resHandling)
1246 case OC_RESOURCE_VIRTUAL:
1248 ret = HandleVirtualResource (request, resource);
1251 case OC_RESOURCE_DEFAULT_DEVICE_ENTITYHANDLER:
1253 ret = HandleDefaultDeviceEntityHandler(request);
1256 case OC_RESOURCE_NOT_COLLECTION_DEFAULT_ENTITYHANDLER:
1258 OIC_LOG(INFO, TAG, "OC_RESOURCE_NOT_COLLECTION_DEFAULT_ENTITYHANDLER");
1259 return OC_STACK_ERROR;
1261 case OC_RESOURCE_NOT_COLLECTION_WITH_ENTITYHANDLER:
1263 ret = HandleResourceWithEntityHandler (request, resource, 0);
1266 case OC_RESOURCE_COLLECTION_WITH_ENTITYHANDLER:
1268 ret = HandleResourceWithEntityHandler (request, resource, 1);
1271 case OC_RESOURCE_COLLECTION_DEFAULT_ENTITYHANDLER:
1273 ret = HandleCollectionResourceDefaultEntityHandler (request, resource);
1276 case OC_RESOURCE_NOT_SPECIFIED:
1278 ret = OC_STACK_NO_RESOURCE;
1283 OIC_LOG(INFO, TAG, "Invalid Resource Determination");
1284 return OC_STACK_ERROR;
1290 void DeletePlatformInfo()
1292 OIC_LOG(INFO, TAG, "Deleting platform info.");
1294 OICFree(savedPlatformInfo.platformID);
1295 savedPlatformInfo.platformID = NULL;
1297 OICFree(savedPlatformInfo.manufacturerName);
1298 savedPlatformInfo.manufacturerName = NULL;
1300 OICFree(savedPlatformInfo.manufacturerUrl);
1301 savedPlatformInfo.manufacturerUrl = NULL;
1303 OICFree(savedPlatformInfo.modelNumber);
1304 savedPlatformInfo.modelNumber = NULL;
1306 OICFree(savedPlatformInfo.dateOfManufacture);
1307 savedPlatformInfo.dateOfManufacture = NULL;
1309 OICFree(savedPlatformInfo.platformVersion);
1310 savedPlatformInfo.platformVersion = NULL;
1312 OICFree(savedPlatformInfo.operatingSystemVersion);
1313 savedPlatformInfo.operatingSystemVersion = NULL;
1315 OICFree(savedPlatformInfo.hardwareVersion);
1316 savedPlatformInfo.hardwareVersion = NULL;
1318 OICFree(savedPlatformInfo.firmwareVersion);
1319 savedPlatformInfo.firmwareVersion = NULL;
1321 OICFree(savedPlatformInfo.supportUrl);
1322 savedPlatformInfo.supportUrl = NULL;
1324 OICFree(savedPlatformInfo.systemTime);
1325 savedPlatformInfo.systemTime = NULL;
1328 static OCStackResult DeepCopyPlatFormInfo(OCPlatformInfo info)
1330 savedPlatformInfo.platformID = OICStrdup(info.platformID);
1331 savedPlatformInfo.manufacturerName = OICStrdup(info.manufacturerName);
1332 savedPlatformInfo.manufacturerUrl = OICStrdup(info.manufacturerUrl);
1333 savedPlatformInfo.modelNumber = OICStrdup(info.modelNumber);
1334 savedPlatformInfo.dateOfManufacture = OICStrdup(info.dateOfManufacture);
1335 savedPlatformInfo.platformVersion = OICStrdup(info.platformVersion);
1336 savedPlatformInfo.operatingSystemVersion = OICStrdup(info.operatingSystemVersion);
1337 savedPlatformInfo.hardwareVersion = OICStrdup(info.hardwareVersion);
1338 savedPlatformInfo.firmwareVersion = OICStrdup(info.firmwareVersion);
1339 savedPlatformInfo.supportUrl = OICStrdup(info.supportUrl);
1340 savedPlatformInfo.systemTime = OICStrdup(info.systemTime);
1342 if ((!savedPlatformInfo.platformID && info.platformID)||
1343 (!savedPlatformInfo.manufacturerName && info.manufacturerName)||
1344 (!savedPlatformInfo.manufacturerUrl && info.manufacturerUrl)||
1345 (!savedPlatformInfo.modelNumber && info.modelNumber)||
1346 (!savedPlatformInfo.dateOfManufacture && info.dateOfManufacture)||
1347 (!savedPlatformInfo.platformVersion && info.platformVersion)||
1348 (!savedPlatformInfo.operatingSystemVersion && info.operatingSystemVersion)||
1349 (!savedPlatformInfo.hardwareVersion && info.hardwareVersion)||
1350 (!savedPlatformInfo.firmwareVersion && info.firmwareVersion)||
1351 (!savedPlatformInfo.supportUrl && info.supportUrl)||
1352 (!savedPlatformInfo.systemTime && info.systemTime))
1354 DeletePlatformInfo();
1355 return OC_STACK_INVALID_PARAM;
1362 OCStackResult SavePlatformInfo(OCPlatformInfo info)
1364 DeletePlatformInfo();
1366 OCStackResult res = DeepCopyPlatFormInfo(info);
1368 if (res != OC_STACK_OK)
1370 OIC_LOG_V(ERROR, TAG, "Failed to save platform info. errno(%d)", res);
1374 OIC_LOG(INFO, TAG, "Platform info saved.");
1380 void DeleteDeviceInfo()
1382 OIC_LOG(INFO, TAG, "Deleting device info.");
1384 OICFree(savedDeviceInfo.deviceName);
1385 OCFreeOCStringLL(savedDeviceInfo.types);
1386 OICFree(savedDeviceInfo.specVersion);
1387 OCFreeOCStringLL(savedDeviceInfo.dataModelVersions);
1388 savedDeviceInfo.deviceName = NULL;
1389 savedDeviceInfo.specVersion = NULL;
1390 savedDeviceInfo.dataModelVersions = NULL;
1393 static OCStackResult DeepCopyDeviceInfo(OCDeviceInfo info)
1395 savedDeviceInfo.deviceName = OICStrdup(info.deviceName);
1397 if(!savedDeviceInfo.deviceName && info.deviceName)
1400 return OC_STACK_NO_MEMORY;
1405 savedDeviceInfo.types = CloneOCStringLL(info.types);
1406 OCStringLL *type = info.types;
1410 if (type && type->value && 0 == strcmp(type->value, OC_RSRVD_RESOURCE_TYPE_DEVICE))
1418 // Append the oic.wk.d at the start of rt link parameter value.
1419 OCStringLL *dest = (OCStringLL*)OICCalloc (1, sizeof (OCStringLL));
1423 return OC_STACK_NO_MEMORY;
1425 dest->value = OICStrdup (OC_RSRVD_RESOURCE_TYPE_DEVICE);
1429 return OC_STACK_NO_MEMORY;
1431 dest->next = savedDeviceInfo.types;
1432 savedDeviceInfo.types = dest;
1434 if(!savedDeviceInfo.types && info.types)
1437 return OC_STACK_NO_MEMORY;
1441 if (info.specVersion)
1443 savedDeviceInfo.specVersion = OICStrdup(info.specVersion);
1444 if(!savedDeviceInfo.specVersion && info.specVersion)
1447 return OC_STACK_NO_MEMORY;
1452 savedDeviceInfo.specVersion = OICStrdup(OC_SPEC_VERSION);
1453 if(!savedDeviceInfo.specVersion && OC_SPEC_VERSION)
1456 return OC_STACK_NO_MEMORY;
1460 if (info.dataModelVersions)
1462 savedDeviceInfo.dataModelVersions = CloneOCStringLL(info.dataModelVersions);
1463 if(!savedDeviceInfo.dataModelVersions && info.dataModelVersions)
1466 return OC_STACK_NO_MEMORY;
1471 savedDeviceInfo.dataModelVersions = (OCStringLL *)OICCalloc(1,sizeof(OCStringLL));
1472 if (!savedDeviceInfo.dataModelVersions)
1474 return OC_STACK_NO_MEMORY;
1476 savedDeviceInfo.dataModelVersions->value = OICStrdup(OC_DATA_MODEL_VERSION);
1477 if(!savedDeviceInfo.dataModelVersions->value && OC_DATA_MODEL_VERSION)
1480 return OC_STACK_NO_MEMORY;
1487 OCStackResult SaveDeviceInfo(OCDeviceInfo info)
1489 OCStackResult res = OC_STACK_OK;
1493 res = DeepCopyDeviceInfo(info);
1495 VERIFY_SUCCESS(res, OC_STACK_OK);
1497 if (OCGetServerInstanceIDString() == NULL)
1499 OIC_LOG(INFO, TAG, "Device ID generation failed");
1500 res = OC_STACK_ERROR;
1504 OIC_LOG(INFO, TAG, "Device initialized successfully.");