[java] Deprecating IME

[skip ci]
craigfowler · May 12, 2022 · 2cdda1f · 2cdda1f
1 parent 8bcf64c
commit 2cdda1f
Show file tree

Hide file tree

Showing 5 changed files with 22 additions and 7 deletions.
diff --git a/java/src/org/openqa/selenium/ImeActivationFailedException.java b/java/src/org/openqa/selenium/ImeActivationFailedException.java
@@ -19,6 +19,8 @@
 
 /**
  * Indicates that activating an IME engine has failed.
+ *
+ * @deprecated Will be removed. IME is not part of W3C WebDriver and does not work on browsers.
  */
 public class ImeActivationFailedException extends WebDriverException {
   public ImeActivationFailedException(String message) {

diff --git a/java/src/org/openqa/selenium/ImeNotAvailableException.java b/java/src/org/openqa/selenium/ImeNotAvailableException.java
@@ -20,7 +20,10 @@
 /**
  * Indicates that IME support is not available. This exception is thrown for every IME-related
  * method call if IME support is not available on the machine.
+ *
+ * @deprecated Will be removed. IME is not part of W3C WebDriver and does not work on browsers.
  */
+
 public class ImeNotAvailableException extends WebDriverException {
   public ImeNotAvailableException(String message) {
     super(message);

diff --git a/java/src/org/openqa/selenium/WebDriver.java b/java/src/org/openqa/selenium/WebDriver.java
@@ -277,6 +277,7 @@ interface Options {
 
     /**
      * @return the interface for controlling IME engines to generate complex-script input.
+     * @deprecated Will be removed. IME is not part of W3C WebDriver and does not work on browsers.
      */
     ImeHandler ime();
 
@@ -633,6 +634,7 @@ interface Navigation {
   }
 
   /**
+   * @deprecated Will be removed. IME is not part of W3C WebDriver and does not work on browsers.
    * An interface for managing input methods.
    */
   interface ImeHandler {

diff --git a/java/src/org/openqa/selenium/remote/RemoteWebDriver.java b/java/src/org/openqa/selenium/remote/RemoteWebDriver.java
@@ -17,13 +17,6 @@
 
 package org.openqa.selenium.remote;
 
-import static java.util.Collections.singleton;
-import static java.util.concurrent.TimeUnit.SECONDS;
-import static org.openqa.selenium.remote.CapabilityType.LOGGING_PREFS;
-import static org.openqa.selenium.remote.CapabilityType.PLATFORM;
-import static org.openqa.selenium.remote.CapabilityType.PLATFORM_NAME;
-import static org.openqa.selenium.remote.CapabilityType.SUPPORTS_JAVASCRIPT;
-
 import com.google.common.collect.ImmutableMap;
 import com.google.common.collect.ImmutableSet;
 
@@ -97,7 +90,13 @@
 import java.util.stream.Collectors;
 import java.util.stream.Stream;
 
+import static java.util.Collections.singleton;
+import static java.util.concurrent.TimeUnit.SECONDS;
 import static java.util.logging.Level.SEVERE;
+import static org.openqa.selenium.remote.CapabilityType.LOGGING_PREFS;
+import static org.openqa.selenium.remote.CapabilityType.PLATFORM;
+import static org.openqa.selenium.remote.CapabilityType.PLATFORM_NAME;
+import static org.openqa.selenium.remote.CapabilityType.SUPPORTS_JAVASCRIPT;
 
 @Augmentable
 public class RemoteWebDriver implements WebDriver,
@@ -837,6 +836,9 @@ public Timeouts timeouts() {
       return new RemoteTimeouts();
     }
 
+    /**
+     * @deprecated Will be removed. IME is not part of W3C WebDriver and does not work on browsers.
+     */
     @Override
     public ImeHandler ime() {
       return new RemoteInputMethodManager();
@@ -848,6 +850,9 @@ public Window window() {
       return new RemoteWindow();
     }
 
+    /**
+     * @deprecated Will be removed. IME is not part of W3C WebDriver and does not work on browsers.
+     */
     protected class RemoteInputMethodManager implements WebDriver.ImeHandler {
 
       @Override

diff --git a/java/src/org/openqa/selenium/support/events/EventFiringWebDriver.java b/java/src/org/openqa/selenium/support/events/EventFiringWebDriver.java
@@ -660,6 +660,9 @@ public Timeouts timeouts() {
       return new EventFiringTimeouts(options.timeouts());
     }
 
+    /**
+     * @deprecated Will be removed. IME is not part of W3C WebDriver and does not work on browsers.
+     */
     @Override
     public ImeHandler ime() {
       return options.ime();