modules/javafx.base/src/main/java/javafx/beans/binding/Bindings.java

rev 10445 : [mq]: doc-v1-8177566-trampoline

@@ -95,10 +95,35 @@
  * Also if you watched closely, you might have noticed that the return type of
  * the Fluent API is different in the examples above. In a lot of cases the
  * Fluent API allows to be more specific about the returned type (see
  * {@link javafx.beans.binding.NumberExpression} for more details about implicit
  * casting.
+ * </p>
+ * <p><a id="DeployAppAsModule"></a><b>Deploying an Application as a Module</b></p>
+ * <p>
+ * If any class used in a select-binding (see the various {@code select*}
+ * methods) is in a named module, then it must be reflectively accessible to the
+ * {@code javafx.base} module.
+ * A class is reflectively accessible if the module
+ * {@link Module#isOpen(String,Module) opens} the containing package to at
+ * least the {@code javafx.base} module.
+ * </p>
+ * <p>
+ * For example, if {@code com.foo.MyClass} is in the {@code foo.app} module,
+ * the {@code module-info.java} might
+ * look like this:
+ * </p>
+ *
+<pre>{@code module foo.app {
+    opens com.foo to javafx.base;
+}}</pre>
+ *
+ * <p>
+ * Alternatively, a class is reflectively accessible if the module
+ * {@link Module#isExported(String) exports} the containing package
+ * unconditionally.
+ * </p>
  *
  * @see Binding
  * @see NumberBinding
  *
  *

@@ -403,16 +428,13 @@
      * be reached (due to {@code b} not having a {@code c} property,
      * {@code b} being {@code null}, or {@code c} not being the right type etc.).
      * <p>
      * All classes and properties used in a select-binding have to be
      * declared public.
-     * Additionally, if any class is in a named module, then the module
-     * must {@link Module#isOpen(String,Module) open}
-     * the containing package for that class to at least the
-     * {@code javafx.base} module
-     * (or {@link Module#isExported(String) export} the containing package
-     * unconditionally).
+     * Additionally, if any class is in a named module, then it must be
+     * reflectively accessible to the {@code javafx.base} module (see
+     * <a href="#DeployAppAsModule">Deploying an Application as a Module</a>).
      * </p>
      * <p>
      * Note: since 8.0, JavaBeans properties are supported and might be in the chain.
      * </p>
      *

@@ -433,16 +455,13 @@
      * be reached (due to {@code b} not having a {@code c} property,
      * {@code b} being {@code null}, or {@code c} not being a {@code Number} etc.).
      * <p>
      * All classes and properties used in a select-binding have to be
      * declared public.
-     * Additionally, if any class is in a named module, then the module
-     * must {@link Module#isOpen(String,Module) open}
-     * the containing package for that class to at least the
-     * {@code javafx.base} module
-     * (or {@link Module#isExported(String) export} the containing package
-     * unconditionally).
+     * Additionally, if any class is in a named module, then it must be
+     * reflectively accessible to the {@code javafx.base} module (see
+     * <a href="#DeployAppAsModule">Deploying an Application as a Module</a>).
      * </p>
      * <p>
      * Note: since 8.0, JavaBeans properties are supported and might be in the chain.
      * </p>
      *

@@ -462,16 +481,13 @@
      * be reached (due to {@code b} not having a {@code c} property,
      * {@code b} being {@code null}, or {@code c} not being a {@code Number} etc.).
      * <p>
      * All classes and properties used in a select-binding have to be
      * declared public.
-     * Additionally, if any class is in a named module, then the module
-     * must {@link Module#isOpen(String,Module) open}
-     * the containing package for that class to at least the
-     * {@code javafx.base} module
-     * (or {@link Module#isExported(String) export} the containing package
-     * unconditionally).
+     * Additionally, if any class is in a named module, then it must be
+     * reflectively accessible to the {@code javafx.base} module (see
+     * <a href="#DeployAppAsModule">Deploying an Application as a Module</a>).
      * </p>
      * <p>
      * Note: since 8.0, JavaBeans properties are supported and might be in the chain.
      * </p>
      *

@@ -491,16 +507,13 @@
      * be reached (due to {@code b} not having a {@code c} property,
      * {@code b} being {@code null}, or {@code c} not being a {@code Number} etc.).
      * <p>
      * All classes and properties used in a select-binding have to be
      * declared public.
-     * Additionally, if any class is in a named module, then the module
-     * must {@link Module#isOpen(String,Module) open}
-     * the containing package for that class to at least the
-     * {@code javafx.base} module
-     * (or {@link Module#isExported(String) export} the containing package
-     * unconditionally).
+     * Additionally, if any class is in a named module, then it must be
+     * reflectively accessible to the {@code javafx.base} module (see
+     * <a href="#DeployAppAsModule">Deploying an Application as a Module</a>).
      * </p>
      * <p>
      * Note: since 8.0, JavaBeans properties are supported and might be in the chain.
      * </p>
      *

@@ -520,16 +533,13 @@
      * be reached (due to {@code b} not having a {@code c} property,
      * {@code b} being {@code null}, or {@code c} not being a {@code Number} etc.).
      * <p>
      * All classes and properties used in a select-binding have to be
      * declared public.
-     * Additionally, if any class is in a named module, then the module
-     * must {@link Module#isOpen(String,Module) open}
-     * the containing package for that class to at least the
-     * {@code javafx.base} module
-     * (or {@link Module#isExported(String) export} the containing package
-     * unconditionally).
+     * Additionally, if any class is in a named module, then it must be
+     * reflectively accessible to the {@code javafx.base} module (see
+     * <a href="#DeployAppAsModule">Deploying an Application as a Module</a>).
      * </p>
      * <p>
      * Note: since 8.0, JavaBeans properties are supported and might be in the chain.
      * </p>
      *

@@ -549,16 +559,13 @@
      * be reached (due to {@code b} not having a {@code c} property,
      * {@code b} being {@code null}, or {@code c} not being a {@code boolean} etc.).
      * <p>
      * All classes and properties used in a select-binding have to be
      * declared public.
-     * Additionally, if any class is in a named module, then the module
-     * must {@link Module#isOpen(String,Module) open}
-     * the containing package for that class to at least the
-     * {@code javafx.base} module
-     * (or {@link Module#isExported(String) export} the containing package
-     * unconditionally).
+     * Additionally, if any class is in a named module, then it must be
+     * reflectively accessible to the {@code javafx.base} module (see
+     * <a href="#DeployAppAsModule">Deploying an Application as a Module</a>).
      * </p>
      * <p>
      * Note: since 8.0, JavaBeans properties are supported and might be in the chain.
      * </p>
      *

@@ -578,16 +585,13 @@
      * be reached (due to {@code b} not having a {@code c} property,
      * {@code b} being {@code null}, or {@code c} not being a {@code String} etc.).
      * <p>
      * All classes and properties used in a select-binding have to be
      * declared public.
-     * Additionally, if any class is in a named module, then the module
-     * must {@link Module#isOpen(String,Module) open}
-     * the containing package for that class to at least the
-     * {@code javafx.base} module
-     * (or {@link Module#isExported(String) export} the containing package
-     * unconditionally).
+     * Additionally, if any class is in a named module, then it must be
+     * reflectively accessible to the {@code javafx.base} module (see
+     * <a href="#DeployAppAsModule">Deploying an Application as a Module</a>).
      * </p>
      * <p>
      * Note: since 8.0, JavaBeans properties are supported and might be in the chain.
      * </p>
      *

@@ -607,16 +611,13 @@
      * be reached (due to {@code b} not having a {@code c} property,
      * {@code b} being {@code null}, or {@code c} not being the right type etc.).
      * <p>
      * All classes and properties used in a select-binding have to be
      * declared public.
-     * Additionally, if any class is in a named module, then the module
-     * must {@link Module#isOpen(String,Module) open}
-     * the containing package for that class to at least the
-     * {@code javafx.base} module
-     * (or {@link Module#isExported(String) export} the containing package
-     * unconditionally).
+     * Additionally, if any class is in a named module, then it must be
+     * reflectively accessible to the {@code javafx.base} module (see
+     * <a href="#DeployAppAsModule">Deploying an Application as a Module</a>).
      * </p>
      *
      * <p>
      * If root has JavaFX properties, this call is equivalent to {@link #select(javafx.beans.value.ObservableValue, java.lang.String[])},
      * with the {@code root} and {@code step[0]} being substituted with the relevant property object.

@@ -641,16 +642,13 @@
      * be reached (due to {@code b} not having a {@code c} property,
      * {@code b} being {@code null}, or {@code c} not being a {@code Number} etc.).
      * <p>
      * All classes and properties used in a select-binding have to be
      * declared public.
-     * Additionally, if any class is in a named module, then the module
-     * must {@link Module#isOpen(String,Module) open}
-     * the containing package for that class to at least the
-     * {@code javafx.base} module
-     * (or {@link Module#isExported(String) export} the containing package
-     * unconditionally).
+     * Additionally, if any class is in a named module, then it must be
+     * reflectively accessible to the {@code javafx.base} module (see
+     * <a href="#DeployAppAsModule">Deploying an Application as a Module</a>).
      * </p>
      *
      * <p>
      * If root has JavaFX properties, this call is equivalent to {@link #selectDouble(javafx.beans.value.ObservableValue, java.lang.String[])},
      * with the {@code root} and {@code step[0]} being substituted with the relevant property object.

@@ -674,16 +672,13 @@
      * be reached (due to {@code b} not having a {@code c} property,
      * {@code b} being {@code null}, or {@code c} not being a {@code Number} etc.).
      * <p>
      * All classes and properties used in a select-binding have to be
      * declared public.
-     * Additionally, if any class is in a named module, then the module
-     * must {@link Module#isOpen(String,Module) open}
-     * the containing package for that class to at least the
-     * {@code javafx.base} module
-     * (or {@link Module#isExported(String) export} the containing package
-     * unconditionally).
+     * Additionally, if any class is in a named module, then it must be
+     * reflectively accessible to the {@code javafx.base} module (see
+     * <a href="#DeployAppAsModule">Deploying an Application as a Module</a>).
      * </p>
      *
      * <p>
      * If root has JavaFX properties, this call is equivalent to {@link #selectFloat(javafx.beans.value.ObservableValue, java.lang.String[])},
      * with the {@code root} and {@code step[0]} being substituted with the relevant property object.

@@ -707,16 +702,13 @@
      * be reached (due to {@code b} not having a {@code c} property,
      * {@code b} being {@code null}, or {@code c} not being a {@code Number} etc.).
      * <p>
      * All classes and properties used in a select-binding have to be
      * declared public.
-     * Additionally, if any class is in a named module, then the module
-     * must {@link Module#isOpen(String,Module) open}
-     * the containing package for that class to at least the
-     * {@code javafx.base} module
-     * (or {@link Module#isExported(String) export} the containing package
-     * unconditionally).
+     * Additionally, if any class is in a named module, then it must be
+     * reflectively accessible to the {@code javafx.base} module (see
+     * <a href="#DeployAppAsModule">Deploying an Application as a Module</a>).
      * </p>
      *
      * <p>
      * If root has JavaFX properties, this call is equivalent to {@link #selectInteger(javafx.beans.value.ObservableValue, java.lang.String[])},
      * with the {@code root} and {@code step[0]} being substituted with the relevant property object.

@@ -740,16 +732,13 @@
      * be reached (due to {@code b} not having a {@code c} property,
      * {@code b} being {@code null}, or {@code c} not being a {@code Number} etc.).
      * <p>
      * All classes and properties used in a select-binding have to be
      * declared public.
-     * Additionally, if any class is in a named module, then the module
-     * must {@link Module#isOpen(String,Module) open}
-     * the containing package for that class to at least the
-     * {@code javafx.base} module
-     * (or {@link Module#isExported(String) export} the containing package
-     * unconditionally).
+     * Additionally, if any class is in a named module, then it must be
+     * reflectively accessible to the {@code javafx.base} module (see
+     * <a href="#DeployAppAsModule">Deploying an Application as a Module</a>).
      * </p>
      *
      * <p>
      * If root has JavaFX properties, this call is equivalent to {@link #selectLong(javafx.beans.value.ObservableValue, java.lang.String[])},
      * with the {@code root} and {@code step[0]} being substituted with the relevant property object.

@@ -773,16 +762,13 @@
      * be reached (due to {@code b} not having a {@code c} property,
      * {@code b} being {@code null}, or {@code c} not being a {@code boolean} etc.).
      * <p>
      * All classes and properties used in a select-binding have to be
      * declared public.
-     * Additionally, if any class is in a named module, then the module
-     * must {@link Module#isOpen(String,Module) open}
-     * the containing package for that class to at least the
-     * {@code javafx.base} module
-     * (or {@link Module#isExported(String) export} the containing package
-     * unconditionally).
+     * Additionally, if any class is in a named module, then it must be
+     * reflectively accessible to the {@code javafx.base} module (see
+     * <a href="#DeployAppAsModule">Deploying an Application as a Module</a>).
      * </p>
      *
      * <p>
      * If root has JavaFX properties, this call is equivalent to {@link #selectBoolean(javafx.beans.value.ObservableValue, java.lang.String[])},
      * with the {@code root} and {@code step[0]} being substituted with the relevant property object.

@@ -806,16 +792,13 @@
      * be reached (due to {@code b} not having a {@code c} property,
      * {@code b} being {@code null}, or {@code c} not being a {@code String} etc.).
      * <p>
      * All classes and properties used in a select-binding have to be
      * declared public.
-     * Additionally, if any class is in a named module, then the module
-     * must {@link Module#isOpen(String,Module) open}
-     * the containing package for that class to at least the
-     * {@code javafx.base} module
-     * (or {@link Module#isExported(String) export} the containing package
-     * unconditionally).
+     * Additionally, if any class is in a named module, then it must be
+     * reflectively accessible to the {@code javafx.base} module (see
+     * <a href="#DeployAppAsModule">Deploying an Application as a Module</a>).
      * </p>
      *
      * <p>
      * If root has JavaFX properties, this call is equivalent to {@link #selectString(javafx.beans.value.ObservableValue, java.lang.String[])},
      * with the {@code root} and {@code step[0]} being substituted with the relevant property object.