#include "ocstackinternal.h"
#include "ocserverrequest.h"
+#ifdef __cplusplus
+extern "C" {
+#endif // __cplusplus
+
/**
* 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.
#define OC_RESOURCE_SECURE 1
/**
+ * 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
+
+#ifdef MQ_BROKER
+ /** "/oic/ps" .*/
+ OC_MQ_BROKER_URI,
+#endif
+
+#ifdef TCP_ADAPTER
+ /** "/oic/ping" .*/
+ OC_KEEPALIVE_RESOURCE_URI,
+#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
OCEntityHandlerRequest * request, void* callbackParam);
/**
- * Get string value associated with a virtual resource type.
- */
-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);
/**
- * Returns true if the specificed resource URI aligns with a pre-existing
+ * 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,
/**
* 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,
/**
* 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.
- * The device name is received from the appliation.
- * The deviceID, spec version and data model verson are initialized by the stack.
+ * @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);
*/
void DeleteDeviceInfo();
-/**
- * Prepares a JSON string for response.
+/*
+ * Prepare payload for resource representation.
*/
-OCStackResult BuildVirtualResourceResponse(const OCResource *resourcePtr,
- OCDiscoveryPayload* payload,
- CATransportAdapter_t adapter);
+OCStackResult BuildResponseRepresentation(const OCResource *resourcePtr,
+ OCRepPayload** payload, OCDevAddr *devAddr);
/**
* A helper function that Maps an @ref OCEntityHandlerResult type to an
*/
OCStackResult EntityHandlerCodeToOCStackCode(OCEntityHandlerResult ehResult);
+#ifdef __cplusplus
+}
+#endif // __cplusplus
#endif //OC_RESOURCEHANDLER_H
-