< prev index next >
modules/javafx.fxml/src/main/java/javafx/fxml/FXML.java
Print this page
rev 10444 : imported patch doc-8177566-trampoline
rev 10445 : [mq]: doc-v1-8177566-trampoline
*** 30,53 ****
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
/**
* Annotation that tags a field or method as accessible to markup.
* If the object being annotated is in a named module then it must
* be reflectively accessible to the {@code javafx.fxml} module.
* Otherwise, the {@link FXMLLoader} will fail with an
* {@code InaccessibleObjectException} when it attempts to modify the
* annotated element.
* An object is reflectively accessible if the module containing that
* object {@link Module#isOpen(String,Module) opens} the containing package to
* at least the
! * {@code javafx.fxml} module, either in its {@code module-info.class} or
! * by calling {@link Module#addOpens}.
! * An object is also reflectively accessible if it is declared as a public
! * member, is in a public class, and the module containing that class
! * {@link Module#isExported(String,Module) exports}
! * the containing package to at least the {@code javafx.fxml} module.
*
* @since JavaFX 2.0
*/
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.FIELD, ElementType.METHOD})
--- 30,67 ----
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
/**
* Annotation that tags a field or method as accessible to markup.
+ * <p><b>Deploying an Application as a Module</b></p>
+ * <p>
* If the object being annotated is in a named module then it must
* be reflectively accessible to the {@code javafx.fxml} module.
* Otherwise, the {@link FXMLLoader} will fail with an
* {@code InaccessibleObjectException} when it attempts to modify the
* annotated element.
* An object is reflectively accessible if the module containing that
* object {@link Module#isOpen(String,Module) opens} the containing package to
* at least the
! * {@code javafx.fxml} module.
! * </p>
! * <p>
! * For example, if the object being annotated is in the {@code com.foo}
! * package 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.fxml;
! }}</pre>
! *
! * <p>
! * Alternatively, an object is reflectively accessible if it is declared
! * as a public member, is in a public class, and the module containing that
! * class {@link Module#isExported(String) exports} the containing
! * package unconditionally.
! * </p>
*
* @since JavaFX 2.0
*/
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.FIELD, ElementType.METHOD})
< prev index next >