modules/javafx.base/src/main/java/javafx/beans/property/adapter/JavaBeanStringProperty.java

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

@@ -46,26 +46,44 @@
  * Java Bean property of type {@code String} and a JavaFX
  * {@code StringProperty}. It cannot be created directly, but a
  * {@link JavaBeanStringPropertyBuilder} has to be used.
  * <p>
  * As a minimum, the Java Bean class must implement a getter and a setter for the
- * property. If the getter of an instance of this class is called, the property of
+ * property.
+ * The class, as well as the getter and a setter methods, must be declared public.
+ * If the getter of an instance of this class is called, the property of
  * the Java Bean is returned. If the setter is called, the value will be passed
  * to the Java Bean property. If the Java Bean property is bound (i.e. it supports
  * PropertyChangeListeners), this {@code JavaBeanStringProperty} will be
  * aware of changes in the Java Bean. Otherwise it can be notified about
  * changes by calling {@link #fireValueChangedEvent()}. If the Java Bean property
  * is also constrained (i.e. it supports VetoableChangeListeners), this
  * {@code JavaBeanStringProperty} will reject changes, if it is bound to an
  * {@link javafx.beans.value.ObservableValue ObservableValue&lt;String&gt;}.
  * </p>
+ * <p><b>Deploying an Application as a Module</b></p>
  * <p>
- * The Java Bean class must be declared public. If that class is in a named
- * module, then the module must {@link Module#isOpen(String,Module) open}
- * the containing package to at least the {@code javafx.base} module
- * (or {@link Module#isExported(String) export} the containing package
- * unconditionally).
+ * If the Java Bean class 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.MyBeanClass} 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 javafx.beans.property.StringProperty
  * @see JavaBeanStringPropertyBuilder
  * @since JavaFX 2.1