[java] Deprecating IME

diemol · diemol · commit 2cdda1fa2b95 · 2022-05-12T22:39:26.000+02:00
[skip ci]
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();

Original file line number	Diff line number	Diff line change
`@@ -660,6 +660,9 @@ public Timeouts timeouts() {`
`660`	`660`	`return new EventFiringTimeouts(options.timeouts());`
`661`	`661`	`}`
`662`	`662`
	`663`	`+ /**`
	`664`	`+ * @deprecated Will be removed. IME is not part of W3C WebDriver and does not work on browsers.`
	`665`	`+ */`
`663`	`666`	`@Override`
`664`	`667`	`public ImeHandler ime() {`
`665`	`668`	`return options.ime();`