-
CSR
-
Resolution: Approved
-
P2
-
None
-
source, binary
-
low
-
-
Java API
-
JDK
Summary
The JavaFX HostServices::getWebContext method was marked as deprecated for removal in JDK 9 by JDK-8156963. We now propose to remove this method.
Problem
The HostServices::getWebContext method returns an instance of a JSObject that is used for JavaScript <--> Java communication when the application is running in a browser (otherwise it returns null) via the Java plug-in. The Java plug-in is deprecated in JDK 9 with the stated intention of removing it in a future release. Note also that Applets are deprecated as of JDK 9.
Solution
The proposed solution is to simply remove the method in question, along with the API documentation that refers to it.
Specification
diff --git a/modules/javafx.graphics/src/main/java/javafx/application/HostServices.java b/modules/javafx.graphics/src/main/java/javafx/application/HostServices.java
--- a/modules/javafx.graphics/src/main/java/javafx/application/HostServices.java
+++ b/modules/javafx.graphics/src/main/java/javafx/application/HostServices.java
@@ -27,16 +27,13 @@
/**
* This class provides HostServices for an Application. This includes
* methods to get the code base and document base for an Application,
- * show a web page in a browser, and communicate with the enclosing web page
- * using JavaScript if the Application is running in
- * a browser.
+ * and to show a web page in a browser.
+ *
* @since JavaFX 2.0
*/
public final class HostServices {
@@ -125,34 +122,4 @@
delegate.showDocument(uri);
}
- /**
- * Returns the JavaScript handle of the enclosing DOM window of the web
- * page containing this application.
- * This handle is used to access the web page by calling from Java into
- * JavaScript.
- * If the application is not embedded into a web page, this method
- * return null.
- *
- * <p>Example:</p>
- * <pre>{@code
- * JSObject jsWin = getHostServices().getWebContext();
- * if (jsWin != null) {
- * jsWin.eval("var b = document.body;" +
- * "var newdiv = document.createElement('div');" +
- * "newdiv.innerHTML = '<br>Hello from JavaScript!';" +
- * "b.appendChild(newdiv);");
- * }
- * }</pre>
- *
- * @return handle of the enclosing DOM window of the web page containing
- * this application
- *
- * @deprecated This method is deprecated as of JDK 9 because the
- * {@link java.applet.Applet Applet} API is deprecated.
- */
- @Deprecated(since="9", forRemoval=true)
- public final JSObject getWebContext() {
- ...
- }
-
}
- csr of
-
JDK-8187149 Remove deprecated HostServices::getWebContext method
- Resolved