< prev index next >

modules/javafx.fxml/src/main/java/javafx/fxml/FXML.java

Print this page
rev 10404 : 8178015: Clarify requirement for app modules to export/open packages to javafx modules
Reviewed-by:


  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package javafx.fxml;
  27 
  28 import java.lang.annotation.ElementType;
  29 import java.lang.annotation.Retention;
  30 import java.lang.annotation.RetentionPolicy;
  31 import java.lang.annotation.Target;
  32 import java.lang.module.ModuleDescriptor;
  33 
  34 /**
  35  * Annotation that tags a field or method as accessible to markup.
  36  * If the object being annotated is in a named module then it must
  37  * be reflectively accessible to the {@code javafx.fxml} module.



  38  * An object is reflectively accessible if the module containing that
  39  * object opens (see {@code Module.isOpen}) the containing package to the

  40  * {@code javafx.fxml} module, either in its {@link ModuleDescriptor}
  41  * (e.g., in its module-info.class) or by calling {@code Module.addOpens}.
  42  * An object is also reflectively accessible if it is declared as a public
  43  * member, is in a public class, and the module containing that class
  44  * exports (see {@code Module.isExported(String,Module)})
  45  * the containing package to the {@code javafx.fxml} module.
  46  * If the object is not reflectively accessible to the {@code javafx.fxml}
  47  * module, then the {@link FXMLLoader} will fail with an
  48  * {@code InaccessibleObjectException} when it attempts to modify the
  49  * annotated element.




  50  *
  51  * @since JavaFX 2.0
  52  */
  53 @Retention(RetentionPolicy.RUNTIME)
  54 @Target({ElementType.FIELD, ElementType.METHOD})
  55 public @interface FXML {
  56 }


  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package javafx.fxml;
  27 
  28 import java.lang.annotation.ElementType;
  29 import java.lang.annotation.Retention;
  30 import java.lang.annotation.RetentionPolicy;
  31 import java.lang.annotation.Target;
  32 import java.lang.module.ModuleDescriptor;
  33 
  34 /**
  35  * Annotation that tags a field or method as accessible to markup.
  36  * If the object being annotated is in a named module then it must
  37  * be reflectively accessible by the {@code javafx.fxml} module.
  38  * Otherwise, the {@link FXMLLoader} will fail with an
  39  * {@code InaccessibleObjectException} when it attempts to modify the
  40  * annotated element.
  41  * An object is reflectively accessible if the module containing that
  42  * object {@link Module#isOpen(String,Module) opens} the containing package to
  43  * at least the
  44  * {@code javafx.fxml} module, either in its {@link ModuleDescriptor}
  45  * (e.g., in its module-info.class) or by calling {@link Module#addOpens}.
  46  * An object is also reflectively accessible if it is declared as a public
  47  * member, is in a public class, and the module containing that class
  48  * {@link Module#isExported(String,Module) exports}
  49  * the containing package to at least the {@code javafx.fxml} module.
  50  * <p>
  51  * For example, if an object that is annotated with {@code @FXML}
  52  * is in the {@code com.foo} package in the {@code foo.app} module, the
  53  * module-info.java might look like this:
  54  * </p>
  55  * <pre>{@code module foo.app {
  56  *     opens com.foo to javafx.fxml;
  57  * }}</pre>
  58  *
  59  * @since JavaFX 2.0
  60  */
  61 @Retention(RetentionPolicy.RUNTIME)
  62 @Target({ElementType.FIELD, ElementType.METHOD})
  63 public @interface FXML {
  64 }
< prev index next >