X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=service%2Fsoft-sensor-manager%2FSDK%2Fjava%2Forg%2Fiotivity%2Fservice%2Fssm%2FDataReader.java;h=26798509511f9d0470591ce003593c07a272044f;hb=935fdb9b67b6c10d007e652e9e2e028fd6ccfe09;hp=c963a253f5b8f6e567a4410040c2bee39dedbdc7;hpb=00b3660e45c56cb3db35dc2596a054f801b5591a;p=platform%2Fupstream%2Fiotivity.git

diff --git a/service/soft-sensor-manager/SDK/java/org/iotivity/service/ssm/DataReader.java b/service/soft-sensor-manager/SDK/java/org/iotivity/service/ssm/DataReader.java
index c963a25..2679850 100644
--- a/service/soft-sensor-manager/SDK/java/org/iotivity/service/ssm/DataReader.java
+++ b/service/soft-sensor-manager/SDK/java/org/iotivity/service/ssm/DataReader.java
@@ -1,28 +1,95 @@
+/******************************************************************
+ *
+ * Copyright 2015 Samsung Electronics All Rights Reserved.
+ *
+ *
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ ******************************************************************/
+/**
+ * @file    DataReader.java
+ *
+ * @brief    This file provides a class that represents context model data package's reader
+ *
+ */
+
 package org.iotivity.service.ssm;
 
 import java.util.List;
 
-public class DataReader {
-
-	private int pDataReaderInstance;
-	
-	public DataReader(int dataReaderInstance)
-	{
-		pDataReaderInstance = dataReaderInstance;
-	}
-	
-	public List<String> GetAffectedModels()
-	{
-		return CoreController.getInstance().GetAffectedModels(pDataReaderInstance);
-	}
-	
-	public int GetModelDataCount(String modelName)
-	{
-		return CoreController.getInstance().GetModelDataCount(pDataReaderInstance, modelName);
-	}
-	
-	public ModelData GetModelData(String modelName, int dataIndex)
-	{
-		return CoreController.getInstance().GetModelData(pDataReaderInstance, modelName, dataIndex);
-	}
+/**
+* @class    DataReader
+* @brief     This class represents context model data package's reader and contains
+*           API's to be used by IQueryEngineEvent listeners to handle the model data.
+*
+*/
+public class DataReader
+{
+
+        private int pDataReaderInstance;
+
+        public DataReader(int dataReaderInstance)
+        {
+            pDataReaderInstance = dataReaderInstance;
+        }
+
+        /**
+         * Get affected context models. The CQL(context query language) can specify
+         *       multiple ContextModels for retrieving data so a list of string of affected
+         *       context models is returned
+         *
+         * @return List<String> - affected ContextModel list
+         * 
+         */
+        public List<String> getAffectedModels()
+        {
+            return CoreController.getInstance().getAffectedModels(
+                       pDataReaderInstance);
+        }
+
+        /**
+         * Get affected model data count. There can be multiple data models existing
+         *       from the given condition, return the count.
+         *
+         * @param modelName 
+         *              - affected ContextModel name
+         *
+         * @return int  - affected dataId count
+         * 
+         */
+        public int getModelDataCount(String modelName) throws Exception
+        {
+            return CoreController.getInstance().getModelDataCount(
+                pDataReaderInstance, modelName);
+        }
+
+        /**
+         * Get actual Context Model data
+         *
+         * @param modelName 
+         *              - affected ContextModel name
+         *
+         * @param dataIndex 
+         *              - affected dataId index
+         *
+         * @return ModelData  - affected ContextModel data reader
+         * 
+         */
+        public ModelData getModelData(String modelName, int dataIndex)
+        throws Exception
+        {
+            return CoreController.getInstance().getModelData(pDataReaderInstance,
+            modelName, dataIndex);
+        }
 }