Merge pull request #663 from mykola-mokhnach/clear_touch

Clear existing actions/parameters after perform is invoked

Author: TikhomirovSergey

src/main/java/io/appium/java_client/MultiTouchAction.java

@@ -85,4 +85,14 @@ protected ImmutableMap<String, ImmutableList<Object>> getParameters() {
         });
         return ImmutableMap.of("actions", listOfActionChains.build());
     }
+
+    /**
+     * Clears all the existing touch actions and resets the instance to the initial state.
+     *
+     * @return this MultiTouchAction, for possible segmented-touches.
+     */
+    protected MultiTouchAction clearActions() {
+        actions = ImmutableList.builder();
+        return this;
+    }
 }

src/main/java/io/appium/java_client/PerformsTouchActions.java

@@ -29,6 +29,8 @@ public interface PerformsTouchActions extends ExecutesMethod {
      * https://dvcs.w3.org/hg/webdriver/raw-file/default/webdriver-spec.html
      * It's more convenient to call the perform() method of the TouchAction
      * object itself.
+     * All the existing touch action parameters will be wiped out after this method
+     * is called.
      *
      * @param touchAction A TouchAction object, which contains a list of individual
      *                    touch actions to perform
@@ -37,7 +39,7 @@ public interface PerformsTouchActions extends ExecutesMethod {
     default TouchAction performTouchAction(TouchAction touchAction) {
         ImmutableMap<String, ImmutableList<Object>> parameters = touchAction.getParameters();
         execute(PERFORM_TOUCH_ACTION, parameters);
-        return touchAction;
+        return touchAction.clearParameters();
     }
 
     /**
@@ -46,11 +48,14 @@ default TouchAction performTouchAction(TouchAction touchAction) {
      * https://dvcs.w3.org/hg/webdriver/raw-file/default/webdriver-spec.html
      * It's more convenient to call the perform() method of the MultiTouchAction
      * object.
+     * All the existing multi touch actions will be wiped out after this method
+     * is called.
      *
      * @param multiAction the MultiTouchAction object to perform.
      */
     default void performMultiTouchAction(MultiTouchAction multiAction) {
         ImmutableMap<String, ImmutableList<Object>> parameters = multiAction.getParameters();
         execute(PERFORM_MULTI_TOUCH, parameters);
+        multiAction.clearActions();
     }
 }

src/main/java/io/appium/java_client/TouchAction.java

@@ -340,8 +340,14 @@ protected ImmutableMap<String, ImmutableList<Object>> getParameters() {
         return ImmutableMap.of("actions", parameters.build());
     }
 
-    protected void clearParameters() {
+    /**
+     * Clears all the existing action parameters and resets the instance to the initial state.
+     *
+     * @return this TouchAction, for possible segmented-touches.
+     */
+    protected TouchAction clearParameters() {
         parameterBuilder = ImmutableList.builder();
+        return this;
     }
 
     /**