Changeset 1146 for trunk/autoquest-core-tasktrees/src/main/java/de/ugoe/cs/autoquest/tasktrees/temporalrelation/ITaskInstanceListScopeRule.java

Timestamp:

04/04/13 16:06:07 (11 years ago)

Author:

pharms

Message:

• complete refactoring of task tree model with a separation of task models and task instances
• appropriate adaptation of task tree generation process
• appropriate adaptation of commands and task tree visualization

File:

• trunk/autoquest-core-tasktrees/src/main/java/de/ugoe/cs/autoquest/tasktrees/temporalrelation/ITaskInstanceListScopeRule.java (moved) (moved from trunk/autoquest-core-tasktrees/src/main/java/de/ugoe/cs/autoquest/tasktrees/temporalrelation/TemporalRelationshipRule.java) (1 diff)

trunk/autoquest-core-tasktrees/src/main/java/de/ugoe/cs/autoquest/tasktrees/temporalrelation/ITaskInstanceListScopeRule.java

@@ -15 +15 @@
 package de.ugoe.cs.autoquest.tasktrees.temporalrelation;
 
-import de.ugoe.cs.autoquest.tasktrees.treeifc.ITaskTreeNode;
+import de.ugoe.cs.autoquest.tasktrees.treeifc.ITaskInstanceList;
 
 /**
  * <p>
- * a temporal relationship rule is able to detected temporal relationships between the child nodes
- * of the parent node provided to the {@link #apply(ITaskTreeNode, boolean)} method. A rule
- * creates temporal relationships between the child nodes, i.e. substructures in the task tree, if
- * it detects a temporal relationship and it can be sure that it is complete. Incomplete but
- * detected temporal relationships may occur, if there can be more children expected to be added
- * to the provided parent node. This could be the case during parsing a interaction log file of
- * a GUI.
+ * a task instance list scope rule is able to detected temporal relationships between a list of task
+ * instances provided to the {@link #apply(ITaskInstanceList)} method. A rule creates temporal
+ * relationships between the task instances, i.e. substructures in the task tree, if
+ * it detects a temporal relationship and instantiates the temporal relationships accordingly.
  * </p>
  * 
  * @author Patrick Harms
  */
-interface TemporalRelationshipRule {
+interface ITaskInstanceListScopeRule extends ITemporalRelationshipRule {
 
   /**
    * <p>
-   * applies the rule to the given parent node. The finalize parameter is used to command the rule
-   * to finish rule applications, in the case it is known that no further data will be available. 
-   * </p>
-   * <p>
-   * The returned rule application result is null, if the rule can not be applied, i.e. it does not
-   * detect a temporal relationship. It returns a rule application result with a status
-   * {@link RuleApplicationStatus#RULE_APPLICATION_FINISHED} if the rule was applied. The result
-   * contains all newly created parent nodes. It returns a rule application result with status
-   * {@link RuleApplicationStatus#RULE_APPLICATION_FEASIBLE} if the rule would be applicable if
-   * further children would be available in the parent node. This status MUST not be returned if 
-   * the finalize parameter is true. In this case the rule must be applied or not. 
+   * applies the rule to the given task instance list. The returned rule application result is null,
+   * if the rule can not be applied, i.e. it does not detect a temporal relationship. It returns a
+   * rule application result with a status {@link RuleApplicationStatus#RULE_APPLICATION_FINISHED}
+   * if the rule was applied. The result contains all newly created parent tasks and task instances.
    * </p>
    * 
-   * @param parent   the parent node with the children to apply the rule on
-   * @param finalize true, if the rule shall not expect further children to come and that it
-   *                 should therefore be applied in any case
+   * @param taskInstances the list of task instances to apply the rule on
    *                    
    * @return the rule application result as described.
    */
-  RuleApplicationResult apply(ITaskTreeNode parent,
-                              boolean       finalize);
+  RuleApplicationResult apply(ITaskInstanceList taskInstances);
   
 }