Changeset 1423 for trunk/autoquest-core-tasktrees/src/main/java/de/ugoe/cs/autoquest/tasktrees/treeifc/ITaskInfo.java

Timestamp:

02/28/14 15:09:12 (10 years ago)

Author:

pharms

Message:

• added possibility to calculate metrics for tasks and added the first metrics

File:

• trunk/autoquest-core-tasktrees/src/main/java/de/ugoe/cs/autoquest/tasktrees/treeifc/ITaskInfo.java (modified) (2 diffs)

trunk/autoquest-core-tasktrees/src/main/java/de/ugoe/cs/autoquest/tasktrees/treeifc/ITaskInfo.java

@@ -19 +19 @@
 /**
  * <p>
- * yet more or less unused, this class will in the future provide extended information about a
- * specific task, such as statistics about task occurrences, etc.
+ * Provides extended information about a specific task, such as statistics about task occurrences,
+ * etc. It contains measures for different metrics determined for a task.
  * </p>
  * 
@@ -38 +38 @@
     /**
      * <p>
-     * returns the number of times a task occurred
+     * returns all available measures
      * </p>
      * 
      * @return as described
      */
-    public int getCount();
+    public IMeasure[] getMeasures();
+
+    /**
+     * <p>
+     * returns the value of the measure identified through the given metric
+     * </p>
+     *
+     * @param metric the metric for which the value is to be returned
+     * 
+     * @return as described
+     */
+    public int getMeasureValue(TaskMetric metric);
+
+    /**
+     * <p>
+     * returns the value of the measure identified through the given metric if the task is
+     * observed in the given context, i.e. parent task. The result is Integer.MIN_VALUE if there
+     * is no value for this measure in a context.
+     * </p>
+     *
+     * @param metric  the metric for which the value is to be returned
+     * @param context the context for which the measure value is to be returned
+     * 
+     * @return as described
+     */
+    public int getMeasureValue(TaskMetric metric, ITask context);
+
+    /**
+     * <p>
+     * represents a measure for a specific metric
+     * </p>
+     * 
+     * @author Patrick Harms
+     */
+    public interface IMeasure {
+        
+        /**
+         * <p>
+         * returns the metric of the measure
+         * </p>
+         * 
+         * @return as described
+         */
+        public TaskMetric getMetric();
+        
+        /**
+         * <p>
+         * returns the value of the measure
+         * </p>
+         * 
+         * @return as described
+         */
+        public int getValue();
+        
+        /**
+         * <p>
+         * returns the value of the measure if the task was observed in a specific context, i.e.
+         * parent task
+         * </p>
+         * 
+         * @return as described
+         */
+        public int getValue(ITask context);
+        
+    }
 
 }