Changeset 1009 for trunk/autoquest-plugin-jfc/src/main

Timestamp:

12/11/12 17:24:30 (12 years ago)

Author:

fglaser

Message:

• autoquest-plugin-jfc subproject was adapted to new naming conventions (GUI element instead of component) were appropriate

Location:

trunk/autoquest-plugin-jfc/src/main/java/de/ugoe/cs/autoquest/plugin/jfc

Files:

• JFCLogParser.java (modified) (7 diffs)
• JFCReplayIDCalculator.java (modified) (6 diffs)
• JFCSimplifiedLogParser.java (modified) (10 diffs)
• guimodel/JFCGUIElementSpec.java (modified) (2 diffs)

trunk/autoquest-plugin-jfc/src/main/java/de/ugoe/cs/autoquest/plugin/jfc/JFCLogParser.java

@@ -108 +108 @@
     /**
      * <p>
-     * internal handle to the parameters currently parsed for a component
+     * internal handle to the GUI element specification currently parsed for a GUI element
      * </p>
      */
@@ -115 +115 @@
     /**
      * <p>
-     * internal handle to the last parsed component
+     * internal handle to the last parsed GUI element
      * </p>
      */
@@ -122 +122 @@
     /**
      * <p>
-     * internal handle to the component of the previous event to be potentially reused for the
+     * internal handle to the GUI element of the previous event to be potentially reused for the
      * current
      * </p>
@@ -148 +148 @@
      * </p>
      * 
-     * @author Steffen Herbold
-     * @version 1.0
      */
     private enum ParamSource {
@@ -396 +394 @@
                 if (currentGuiElementPath.size() <= 0)
                 {
-                    // no component specification available. Try to parse the GUI element from
+                    // no GUI element specification available. Try to parse the GUI element from
                     // the toString parameter
                     currentGuiElementSpec = new JFCGUIElementSpec();
@@ -631 +629 @@
     /**
      * <p>
-     * for some events in the log file, no component specification is provided. In this case the
+     * for some events in the log file, no GUI element specification is provided. In this case the
      * GUI element on which the event is executed must be determined based on the
      * <code>toString</code> parameter of the event. This is achieved through this method. The
@@ -642 +640 @@
      *            the <code>toString</code> parameter of the event to be parsed for the GUI element
      *            
-     * @return the appropriate GUI Element
+     * @return the appropriate GUI element
      * 
      * @throws SAXException thrown if the provided value of the <code>toString</code> parameter

trunk/autoquest-plugin-jfc/src/main/java/de/ugoe/cs/autoquest/plugin/jfc/JFCReplayIDCalculator.java

@@ -77 +77 @@
    /**
     * Calculates the replayID of a JFCEvent needed for compatibility with guitar suite
-    * @param List of {@link JFCGUIElementSpec}s that represent the component path of a event target
+    * @param List of {@link JFCGUIElementSpec}s that represent the path of an event target
     * for which the replayID should be calculated. 
     * @return replayID
@@ -91 +91 @@
            String title = currentSpec.getName();
            String fuzzyTitle = getFuzzyTitle(title);
-           long windowHashCode = fuzzyTitle.hashCode();
-           windowHashCode = (windowHashCode * 2) & 0xffffffffL;
-
-           long propagatedHashCode = windowHashCode;
+           long topLevelHashCode = fuzzyTitle.hashCode();
+           topLevelHashCode = (topLevelHashCode * 2) & 0xffffffffL;
+
+           long propagatedHashCode = topLevelHashCode;
            
-           // added validator to check if generated component ids are known
+           // added validator to check if generated GUI element ids are known
            if (validator != null){
-                   if (validator.validateReplayID("w" + windowHashCode)){
-                           System.out.println("ID w" + windowHashCode + " is valid.");
+                   if (validator.validateReplayID("w" + topLevelHashCode)){
+                           System.out.println("ID w" + topLevelHashCode + " is valid.");
                    }
                    else{
-                           System.err.println(currentSpec + " describes an unknown component.");
-                           System.err.println("ID w" + windowHashCode + " is unknown." );
+                           System.err.println(currentSpec + " describes an unknown GUI element.");
+                           System.err.println("ID w" + topLevelHashCode + " is unknown." );
                            System.err.println();
                    }
@@ -114 +114 @@
            else{
                    currentSpec = null;
-                   // there are no subcomponents, so we use windowHashCode as hashCode
-                   hashCode = windowHashCode;
+                   // there are no children of current GUI element, so we use topLevelHashCode as hashCode
+                   hashCode = topLevelHashCode;
            }
 
-           // walk through component path and calculate hashcode
+           // walk through GUI element path and calculate hashcode
            while(currentSpec != null){
                    long localHashCode = getLocalHashCode(currentSpec);
@@ -124 +124 @@
                    hashCode = (hashCode * 2) & 0xffffffffL;
                    
-                   // added validator to check if generated component ids are known
+                   // added validator to check if generated GUI element ids are known
                    if (validator != null){
                            if (validator.validateReplayID("w" + hashCode)){
                                    System.out.println("ID w" + hashCode + " is valid.");
-                                   System.out.println("==> " + currentSpec + " describes a known component.");
+                                   System.out.println("==> " + currentSpec + " describes a known GUI element.");
                            }
                            else{
                                    System.err.println("ID w" + hashCode + " is unknown." );
-                                   System.err.println("==> " + currentSpec + " describes an unknown component.");
+                                   System.err.println("==> " + currentSpec + " describes an unknown GUI element.");
                                    System.err.println();
                            }
@@ -183 +183 @@
         
         /**
-         * Calculates the hashcode part of a component.
+         * Calculates the hashcode part of a GUI element.
          * @param spec The {@link JFCGUIElementSpec} for which the hashcode should be calculated.
          * @return the local hashcode
@@ -238 +238 @@
         
         /**
-         * Guitar has a special way to deal with window titles when
-         * calculating unique widget IDs. This method mimics Guitar's
+         * Guitar has a special way to deal with top level GUI elements (window) 
+         * titles when calculating unique widget IDs. This method mimics Guitar's
          * behavior (compare guitar source code: edu.umd.cs.guitar.
          * model.JFCDefaultIDGeneratorSimple).

trunk/autoquest-plugin-jfc/src/main/java/de/ugoe/cs/autoquest/plugin/jfc/JFCSimplifiedLogParser.java

@@ -42 +42 @@
 import de.ugoe.cs.autoquest.keyboardmaps.VirtualKey;
 import de.ugoe.cs.autoquest.plugin.jfc.eventcore.JFCEventId;
-import de.ugoe.cs.autoquest.plugin.jfc.guimodel.JFCComponentTree;
 import de.ugoe.cs.autoquest.plugin.jfc.guimodel.JFCGUIElement;
 import de.ugoe.cs.autoquest.plugin.jfc.guimodel.JFCGUIElementSpec;
@@ -76 +75 @@
      * 
      * <p>
-     * Internal handle to the hashcode of the component, that is currently parsed.
-     * </p>
-     */
-    private Long currentComponentHash;
+     * Internal handle to the hashcode of the GUI element, that is currently parsed.
+     * </p>
+     */
+    private Long currentGUIElementHash;
     
     /**
      * 
      * <p>
-     * Internal handle to the hashcode of the parent of the component, that is currently parsed. 
+     * Internal handle to the hashcode of the parent of the GUI element, that is currently parsed. 
      * </p>
      */
@@ -118 +117 @@
     /**
      * <p>
-     * internal handle to the parameters currently parsed for a component
+     * internal handle to the specification currently parsed for a GUI element
      * </p>
      */
@@ -125 +124 @@
     /**
      * <p>
-     * internal handle to the parsed gui structure, stored in a JFCComponentTree
+     * internal handle to the parsed GUI structure, stored in a GUIElementTree
      * </p>
      */
@@ -132 +131 @@
     /**
      * <p>
-     * internal handle to the component of the previous event to be potentially reused for the
+     * internal handle to the GUI element of the previous event to be potentially reused for the
      * current
      * </p>
@@ -288 +287 @@
     /**
      * <p>
-     * Returns the gui model that is obtained from parsing log files.
+     * Returns the GUI model that is obtained from parsing log files.
      * </p>
      * 
@@ -319 +318 @@
         }
         else if (qName.equals("component")) {
-                currentComponentHash = Long.parseLong(atts.getValue("hash"), 16);
+                currentGUIElementHash = Long.parseLong(atts.getValue("hash"), 16);
                 currentGuiElementSpec = new JFCGUIElementSpec();
-                currentGuiElementSpec.setElementHash((int) currentComponentHash.longValue());
+                currentGuiElementSpec.setElementHash((int) currentGUIElementHash.longValue());
         }
         else if (qName.equals("event")) {
@@ -347 +346 @@
                         }
                 currentEventParameters.put(atts.getValue("name"), atts.getValue("value"));
-            } else if(currentComponentHash != null){
+            } else if(currentGUIElementHash != null){
                 if ("title".equals(atts.getValue("name"))) {
                                 currentGuiElementSpec.setName(atts.getValue("value"));
@@ -390 +389 @@
                 currentGuiElementSpec.setTypeHierarchy(currentTypeHierarchy);
         }
-        else if (qName.equals("component") && currentComponentHash != null) {
-                currentGUIElementTree.add(currentComponentHash, currentParentHash, currentGuiElementSpec);
+        else if (qName.equals("component") && currentGUIElementHash != null) {
+                currentGUIElementTree.add(currentGUIElementHash, currentParentHash, currentGuiElementSpec);
                 // do something with the ancestor list here
                 
-                currentComponentHash = null;
+                currentGUIElementHash = null;
                 currentParentHash = null;
                 currentTypeHierarchy = null;
@@ -609 +608 @@
     /**
      * <p>
-     * for some events in the log file, no component specification is provided. In this case the
+     * for some events in the log file, no GUI element specification is provided. In this case the
      * GUI element on which the event is executed must be determined based on the
      * <code>toString</code> parameter of the event. This is achieved through this method. The

trunk/autoquest-plugin-jfc/src/main/java/de/ugoe/cs/autoquest/plugin/jfc/guimodel/JFCGUIElementSpec.java

@@ -77 +77 @@
     /**
      * <p>
-     * Hash code of the window element. Used as unique identifier during its existence.
+     * Hash code of the GUI element. Used as unique identifier during its existence.
      * </p>
      */
@@ -84 +84 @@
     /**
      * <p>
-     * Previous hashes of the window as the window may have been destroyed and recreated.
+     * Previous hashes of the GUI element as the GUI element may have been destroyed and recreated.
      * </p>
      */