Add new API for subscribing event.

Subscribes event of dynamicboxes which are categorized by given category.
Unsubscribes event of dynamicboxes which are categorized by given category.

[model] Redwood,Kiran,B3(Wearable)
[binary_type] AP
[customer] Docomo/Orange/ATT/Open
[issue#] N/A
[problem]
[cause]
[solution]
[team] HomeTF
[request]
[horizontal_expansion]

Change-Id: Id3e258f611d0b8428509a279e6273aafd808e164

diff --git a/dynamicbox_viewer/include/dynamicbox.h b/dynamicbox_viewer/include/dynamicbox.h
index 703a7607662324ff58276206a84a509dc1448e85..01ab06af601700ea362da9f7b3931ea7a5b9ed1e 100644 (file)
--- a/dynamicbox_viewer/include/dynamicbox.h
+++ b/dynamicbox_viewer/include/dynamicbox.h
@@ -1280,7 +1280,7 @@ extern void *dynamicbox_data(dynamicbox_h handler);
  * @retval #DBOX_STATUS_ERROR_NONE Successfully requested
  * @see dynamicbox_unsubscribe_group()
  */
-extern int dynamicbox_subscribe_group(const char *cluster, const char *category);
+extern int dynamicbox_subscribe_group(const char *cluster, const char *sub_cluster);
 
 /**
  * @internal
@@ -1295,7 +1295,38 @@ extern int dynamicbox_subscribe_group(const char *cluster, const char *category)
  * @retval #DBOX_STATUS_ERROR_NONE Successfully requested
  * @see dynamicbox_subscribe_group()
  */
-extern int dynamicbox_unsubscribe_group(const char *cluster, const char *category);
+extern int dynamicbox_unsubscribe_group(const char *cluster, const char *sub_cluster);
+
+/**
+ * @internal
+ * @brief Subscribe events of dynamicboxes which is categorized by given "category" string.
+ *        "category" is written in the XML file of each dynamicbox manifest file.
+ *        After subscribe the category, the master will send created event for all created dynamicboxes,
+ *        Also it will notify client when a new dynamicbox is created.
+ * @since_tizen 2.4
+ * @param[in] category Category name
+ * @privlevel platform
+ * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.viewer
+ * @return int
+ * @retval #DBOX_STATUS_ERROR_FAULT Unrecoverable error occurred
+ * @retval #DBOX_STATUS_ERROR_NONE Successfully requested
+ * @see dynamicbox_unsubscribe_category()
+ */
+extern int dynamicbox_subscribe_category(const char *category);
+
+/**
+ * @internal
+ * @brief Unsubscribe events of dynamicboxes.
+ * @since_tizen 2.4
+ * @param[in] category Category name
+ * @privlevel platform
+ * @privilege %http://developer.samsung.com/tizen/privilege/dynamicbox.viewer
+ * @return int
+ * @retval #DBOX_STATUS_ERROR_FAULT Unrecoverable error occurred
+ * @retval #DBOX_STATUS_ERROR_NONE Successfully requested
+ * @see dynamicbox_subscribe_category()
+ */
+extern int dynamicbox_unsubscribe_category(const char *category);
 
 /**
  * @internal

diff --git a/dynamicbox_viewer/src/dynamicbox.c b/dynamicbox_viewer/src/dynamicbox.c
index 82db428f7b46d324b71c6673056037ebdc012906..554156311b042281c7c8d3b39f07737031386a72 100644 (file)
--- a/dynamicbox_viewer/src/dynamicbox.c
+++ b/dynamicbox_viewer/src/dynamicbox.c
@@ -3712,6 +3712,18 @@ EAPI int dynamicbox_unsubscribe_group(const char *cluster, const char *category)
        return master_rpc_request_only(NULL, packet);
 }
 
+EAPI int dynamicbox_subscribe_category(const char *category)
+{
+       /* Send subscribe_category request to the master */
+       return DBOX_STATUS_ERROR_NOT_IMPLEMENTED;
+}
+
+EAPI int dynamicbox_unsubscribe_category(const char *category)
+{
+       /* Send unsubscribe_category request to the master */
+       return DBOX_STATUS_ERROR_NOT_IMPLEMENTED;
+}
+
 EAPI int dynamicbox_refresh(dynamicbox_h handler, int force)
 {
        struct packet *packet;