Add some documentation

jakartaee · May 22, 2023 · ebcc1bb · ebcc1bb
1 parent 015803d
commit ebcc1bb
Show file tree

Hide file tree

Showing 2 changed files with 13 additions and 0 deletions.
diff --git a/api/src/main/java/jakarta/el/BeanELResolver.java b/api/src/main/java/jakarta/el/BeanELResolver.java
@@ -32,6 +32,12 @@
  * Defines property resolution behavior on objects using the JavaBeans component architecture.
  *
  * <p>
+ * If the {@code java.beans.*} package is available (part of the {@code java.desktop} module) the JavaBeans
+ * implementation provided by the JRE is used. If the {@code java.beans.*} package is not available, a built-in
+ * stand-alone implementation is used that just provides getter/setter support (as everything else requires classes from
+ * {@code java.beans.*}).
+ * 
+ * <p>
  * This resolver handles base objects of any type, as long as the base is not <code>null</code>. It accepts any object
  * as a property or method, and coerces it to a string.
  *

diff --git a/spec/src/main/asciidoc/ELSpec.adoc b/spec/src/main/asciidoc/ELSpec.adoc
@@ -2980,6 +2980,13 @@ This appendix is non-normative.
 
 * Update to reflect new GitHub organisation and project names.
 
+* https://github.com/jakartaee/expression-language/issues/47[#47]
+  Make the dependency on the `java.beans.*` package (and hence the
+  `java.desktop` module) optional. If the `java.beans.*` package is not
+  available, an internal implementation is used to support the `BeanELResolver`
+  that just provides getter/setter support as all other JavaBeans functionality
+  requires classes from the `java.beans.*` package.
+
 * https://github.com/jakartaee/expression-language/issues/175[#175]
   Add support for a new property, `length`, for arrays.