#include "ocstackinternal.h"
#include "ocserverrequest.h"
-#define OC_RSRVD_OC "oc"
-#define OC_RSRVD_PAYLOAD "payload"
-#define OC_RSRVD_HREF "href"
-#define OC_RSRVD_RESOURCE_TYPE "rt"
-#define OC_RSRVD_RESOURCE_TYPE_PRESENCE "core.presence"
-#define OC_RSRVD_INTERFACE "if"
-#define OC_RSRVD_INTERFACE_DEFAULT "oc.mi.def"
-#define OC_RSRVD_INTERFACE_LL "oc.mi.ll"
-#define OC_RSRVD_INTERFACE_BATCH "oc.mi.b"
-#define OC_RSRVD_OBSERVABLE "obs"
-#define OC_RSRVD_SECURE "sec"
-#define OC_RSRVD_HOSTING_PORT "port"
-
-#define OC_JSON_PREFIX "{\"oc\":["
+/**
+ * Common JSON string components used by the stack to build JSON strings.
+ * These details are exposed in ocstackconfig.h file in the form of documentation.
+ * Remember to update the documentation there if these are changed.
+ */
+#define OC_JSON_PREFIX "{\"oic\":["
#define OC_JSON_PREFIX_LEN (sizeof(OC_JSON_PREFIX) - 1)
#define OC_JSON_SUFFIX "]}"
#define OC_JSON_SUFFIX_LEN (sizeof(OC_JSON_SUFFIX) - 1)
#define OC_JSON_SEPARATOR ','
+#define OC_JSON_SEPARATOR_STR ","
+#define OC_KEY_VALUE_DELIMITER "="
+/**
+ * Static values for various JSON attributes.
+ */
#define OC_RESOURCE_OBSERVABLE 1
#define OC_RESOURCE_SECURE 1
-typedef enum {
+/**
+ * OIC Virtual resources supported by every OIC device.
+ */
+typedef enum
+{
+ /** unknown URI.*/
+ OC_UNKNOWN_URI =0,
+
+ /** "/oic/res".*/
+ OC_WELL_KNOWN_URI,
+
+ /** "/oic/d" .*/
+ OC_DEVICE_URI,
+
+ /** "/oic/p" .*/
+ OC_PLATFORM_URI,
+
+ /** "/oic/res/d/type" .*/
+ OC_RESOURCE_TYPES_URI,
+#ifdef ROUTING_GATEWAY
+ /** "/oic/gateway" .*/
+ OC_GATEWAY_URI,
+#endif
+ #ifdef WITH_PRESENCE
+ /** "/oic/ad" .*/
+ OC_PRESENCE,
+ #endif
+
+ /** Max items in the list */
+ OC_MAX_VIRTUAL_RESOURCES //<s Max items in the list
+} OCVirtualResources;
+
+/**
+ * The type of query a request/response message is.
+ */
+typedef enum
+{
STACK_RES_DISCOVERY_NOFILTER = 0,
STACK_RES_DISCOVERY_IF_FILTER,
- STACK_RES_DISCOVERY_RT_FILTER
+ STACK_RES_DISCOVERY_RT_FILTER,
+ STACK_DEVICE_DISCOVERY_DI_FILTER,
+ STACK_DEVICE_DISCOVERY_DN_FILTER
} StackQueryTypes;
-typedef enum {
+/**
+ * The type of handling required to handle a request.
+ */
+typedef enum
+{
OC_RESOURCE_VIRTUAL = 0,
OC_RESOURCE_NOT_COLLECTION_WITH_ENTITYHANDLER,
OC_RESOURCE_NOT_COLLECTION_DEFAULT_ENTITYHANDLER,
OC_RESOURCE_NOT_SPECIFIED
} ResourceHandling;
+/**
+ * Default entity handler (ie. callback) to be used for resources with
+ * no entity handler.
+ */
OCEntityHandlerResult defaultResourceEHandler(OCEntityHandlerFlag flag,
- OCEntityHandlerRequest * request);
+ OCEntityHandlerRequest * request, void* callbackParam);
-const char * GetVirtualResourceUri( OCVirtualResources resource);
+/**
+ * Find and retrieve pointer to a resource associated with a specific resource
+ * URI.
+ * @return pointer to found resource
+ */
OCResource *FindResourceByUri(const char* resourceUri);
-uint8_t IsVirtualResource(const char* resourceUri);
-OCStackResult DetermineResourceHandling (OCServerRequest *request,
+/**
+ * This function checks whether the specified resource URI aligns with a pre-existing
+ * virtual resource; returns false otherwise.
+ * @return true or false.
+ */
+bool IsVirtualResource(const char* resourceUri);
+
+/**
+ * Parameter @ref handling returns by-reference the type of resource handling
+ * required by the internal stack based on the specified @ref request.
+ * @return ::OC_STACK_OK for Success, otherwise some error value
+ */
+OCStackResult DetermineResourceHandling (const OCServerRequest *request,
ResourceHandling *handling,
OCResource **resource);
-OCStackResult
-ProcessRequest(ResourceHandling resHandling, OCResource *resource, OCServerRequest *request);
+/**
+ * Processes the specified @ref request based on the type of resource handling
+ * @ref resHandling.
+ * @return ::OC_STACK_OK for Success, otherwise some error value.
+ */
+OCStackResult ProcessRequest(ResourceHandling resHandling,
+ OCResource *resource,
+ OCServerRequest *request);
-OCStackResult
-BuildVirtualResourceResponse(OCResource *resourcePtr, uint8_t filterOn,
- char *filterValue, char * out, uint16_t *remaining);
+/**
+ * Internal API used to save all of the platform's information for use in platform
+ * discovery requests.
+ * @return ::OC_STACK_OK for Success, otherwise some error value.
+ */
+OCStackResult SavePlatformInfo(OCPlatformInfo info);
+/**
+ * Internal API used to save all of the device's information for use in platform
+ * discovery requests.
+ * @param info Device name is received from the application.
+ * DeviceID, spec version and data model version are initialized by the stack.
+ * @return ::OC_STACK_OK for Success, otherwise some error value.
+ */
+OCStackResult SaveDeviceInfo(OCDeviceInfo info);
+
+/**
+ * Internal API used to clear the platform information.
+ */
+void DeletePlatformInfo();
+
+/**
+ * Internal API used to clear the device information.
+ */
+void DeleteDeviceInfo();
+
+/*
+ * Prepare payload for resource representation.
+ */
+OCStackResult BuildResponseRepresentation(const OCResource *resourcePtr,
+ OCRepPayload** payload);
+
+/**
+ * Prepares a Payload for response.
+ */
+OCStackResult BuildVirtualResourceResponse(const OCResource *resourcePtr,
+ OCDiscoveryPayload* payload,
+ OCDevAddr *endpoint);
+
+/**
+ * A helper function that Maps an @ref OCEntityHandlerResult type to an
+ * @ref OCStackResult type.
+ */
OCStackResult EntityHandlerCodeToOCStackCode(OCEntityHandlerResult ehResult);
#endif //OC_RESOURCEHANDLER_H
+