Changeset 1294 for trunk/autoquest-core-tasktrees/src/main/java/de/ugoe/cs/autoquest/tasktrees/taskequality/TaskComparisonRule.java

Timestamp:

08/14/13 17:04:42 (11 years ago)

Author:

pharms

Message:

• rework of task model to move event instance stuff to task instances
• introduction of sequence, selection, iteration and optional instances

File:

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

trunk/autoquest-core-tasktrees/src/main/java/de/ugoe/cs/autoquest/tasktrees/taskequality/TaskComparisonRule.java

@@ -16 +16 @@
 
 import de.ugoe.cs.autoquest.tasktrees.treeifc.ITask;
+import de.ugoe.cs.autoquest.tasktrees.treeifc.ITaskInstance;
 
 /**
  * <p>
- * A task comparison rule is used by the {@link TaskEqualityRuleManager} to compare tasks with
- * each other. It provides several methods to be called for a comparison.
+ * A task comparison rule is used by the {@link TaskEqualityRuleManager} to compare tasks and
+ * task instances with each other. It provides several methods to be called for a comparison.
  * </p>
  * 
@@ -90 +91 @@
     public TaskEquality compare(ITask task1, ITask task2);
 
+    /**
+     * <p>
+     * checks if the rule is applicable for comparing the two provided task instances
+     * </p>
+     * 
+     * @param instance1 the first task instance to compare
+     * @param instance2 the second task instance to compare
+     * 
+     * @return true, if the rule is applicable, false else
+     */
+    public boolean isApplicable(ITaskInstance instance1, ITaskInstance instance2);
+
+    /**
+     * <p>
+     * checks, if the provided task instances are lexically equal
+     * </p>
+     * 
+     * @param instance1 the first task instance to compare
+     * @param instance2 the second task instance to compare
+     * 
+     * @return true, if the tasks are equal, false else
+     */
+    public boolean areLexicallyEqual(ITaskInstance instance1, ITaskInstance instance2);
+
+    /**
+     * <p>
+     * checks, if the provided task instances are syntactically equal
+     * </p>
+     * 
+     * @param instance1 the first task instance to compare
+     * @param instance2 the second task instance to compare
+     * 
+     * @return true, if the tasks are equal, false else
+     */
+    public boolean areSyntacticallyEqual(ITaskInstance instance1, ITaskInstance instance2);
+
+    /**
+     * <p>
+     * checks, if the provided task instances are semantically equal
+     * </p>
+     * 
+     * @param instance1 the first task instance to compare
+     * @param instance2 the second task instance to compare
+     * 
+     * @return true, if the tasks are equal, false else
+     */
+    public boolean areSemanticallyEqual(ITaskInstance instance1, ITaskInstance instance2);
+
+    /**
+     * <p>
+     * compares two task instances with each other. The result of the method is either a task
+     * instance equality or null. If it is null, it means, that the rule is not able to correctly
+     * compare the two given task instances
+     * </p>
+     * 
+     * @param instance1 the first task instance to compare
+     * @param instance2 the second task instance to compare
+     * 
+     * @return as described
+     */
+    public TaskEquality compare(ITaskInstance instance1, ITaskInstance instance2);
+
 }