Jakarta Expression Language 5.0

Release for Jakarta EE 10

Jakarta Expression Language defines an expression language for Java applications.

While this is a major release due to the removal of a long deprecated method, the focus of the release has been on clarifying areas of the specification where ambiguity had been identified and on making a number of small enhancements to increase the usability of the API.

This release also laid the groundwork for the removal of the dependency on the java.desktop module which is planned for the next release.

New Features, Enhancements, or Additions

• The BeanELResolver has been updated to consider default method
  implementations when looking for property getters, property setters and
  methods.
• Support has been added for coercing a LambdaExpression instance to a
  functional interface method invocation.
• Support has been added for coercing arrays.
• The MethodReference class has been added to provide access to details of
  the method to which a MethodExpression resolves, including any
  annotations present on the method.
• Generics are now used throughout the API.
• The expected behaviour when matching expressions to methods based on
  parameter types has been clarified.
• The EL specification now explicitly states that specifications that
  depend on the EL specification may define further packages, in
  additional to java.lang.*, that are imported by default into the EL
  environment.

Removals, Deprecations or Backwards Incompatible Changes

• The deprecated, misspelt method MethodExpression.isParmetersProvided()
  has been removed.
• The ELResolver method getFeatureDescriptors() has been deprecated with
  removal planed for EL 6.0. This is to remove the dependency on the
  java.desktop module from the EL API.
• A default implementation that returns null has been added to the
  ELResolver method getFeatureDescriptors() since it has been deprecated
  so that custom ELResolver implementations do not need to implement the
  method.
• Explicitly document that ELResolver.getType() must return null if either
  the ELResolver or the resolved property is read-only. This changes the
  documented behaviour of the StaticFieldELResolver.

Minimum Java SE Version

Java SE 11 or higher

Details

• Jakarta Expression Language 5.0 Release Record
  • Jakarta EE Platform 10 Release Plan
• Jakarta Expression Language 5.0 Specification Document (PDF)
• Jakarta Expression Language 5.0 Specification Document (HTML)
• Jakarta Expression Language 5.0 Javadoc
• Jakarta Expression Language 5.0 TCK (sig, sha, pub)
  • For all TCK releases, see download directory
• Maven coordinates
  • jakarta.el:jakarta.el-api:jar:5.0.0

Compatible Implementations

• Eclipse Expressly 5.0.0-M2

Ballots

Plan Review

The Plan Review Specification Committee Ballot concluded successfully on 12/05/2021 (May 12th 2021) with the following results.

This ballot was conducted on the public e-mail list jakarta.ee-spec@eclipse.org. This ballot thread begins here.

Release Review

The Release Review Specification Committee Ballot concluded successfully on 09/05/2022 (May 9th 2022) with the following results.

This ballot was conducted on the public e-mail list jakarta.ee-spec@eclipse.org. This ballot thread begins here.