java: Implementing ability to split actions to a series of atomic actions

In particular, sendKeys should be decomposed to a series of atomic
keyDown+keyUp actions according to the standard. Unit tests to be
written yet.

Author: barancev

Diff for: java/client/src/org/openqa/selenium/interactions/CompositeAction.java

@@ -20,6 +20,7 @@
 import com.google.common.collect.ImmutableList;
 
 import org.openqa.selenium.WebDriver;
+import org.openqa.selenium.interactions.internal.MultiAction;
 
 import java.util.ArrayList;
 import java.util.List;
@@ -60,6 +61,14 @@ public int getNumberOfActions() {
   }
 
   public List<Action> asList() {
-    return ImmutableList.copyOf(actionsList);
+    ImmutableList.Builder<Action> builder = new ImmutableList.Builder<Action>();
+    for (Action action : actionsList) {
+      if (action instanceof MultiAction) {
+        builder.addAll(((MultiAction) action).getActions());
+      } else {
+        builder.add(action);
+      }
+    }
+    return builder.build();
   }
 }

Diff for: java/client/src/org/openqa/selenium/interactions/SendKeysAction.java

@@ -17,14 +17,20 @@
 
 package org.openqa.selenium.interactions;
 
+import org.openqa.selenium.Keys;
 import org.openqa.selenium.interactions.internal.KeysRelatedAction;
+import org.openqa.selenium.interactions.internal.MultiAction;
 import org.openqa.selenium.internal.Locatable;
 
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.List;
+
 /**
  * Sending a sequence of keys to an element.
  *
  */
-public class SendKeysAction extends KeysRelatedAction implements Action {
+public class SendKeysAction extends KeysRelatedAction implements Action, MultiAction {
   private final CharSequence[] keysToSend;
 
   public SendKeysAction(Keyboard keyboard, Mouse mouse, Locatable locationProvider,
@@ -42,4 +48,16 @@ public void perform() {
 
     keyboard.sendKeys(keysToSend);
   }
+
+  public List<Action> getActions() {
+    List<Action> actions = new ArrayList<Action>();
+    for (CharSequence chars : keysToSend) {
+      for (int i = 0; i < chars.length(); i++) {
+        Keys key = Keys.getKeyFromUnicode(chars.charAt(i));
+        actions.add(new KeyDownAction(keyboard, mouse, where, key));
+        actions.add(new KeyUpAction(keyboard, mouse, where, key));
+      }
+    }
+    return actions;
+  }
 }

Diff for: java/client/src/org/openqa/selenium/interactions/internal/MultiAction.java

@@ -0,0 +1,36 @@
+// Licensed to the Software Freedom Conservancy (SFC) under one
+// or more contributor license agreements.  See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership.  The SFC licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License.  You may obtain a copy of the License at
+//
+//   http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied.  See the License for the
+// specific language governing permissions and limitations
+// under the License.
+
+
+package org.openqa.selenium.interactions.internal;
+
+import org.openqa.selenium.interactions.Action;
+
+import java.util.List;
+
+/**
+ * Represents a complex action that is a series of primitive actions listed in the standard.
+ */
+public interface MultiAction {
+
+  /**
+   * Returns the list of primitive actions that compose this complex action.
+   *
+   * @return list of primitive actions that compose this complex action.
+   */
+  List<Action> getActions();
+}