API Change Documentation
March 2025
Overview
Provide a brief overview of the purpose of this release, including high-level objectives, key improvements, and the rationale behind major changes.
API Changes
Etendo Software Stack
-
[Ubuntu Live Server amd64]
- New Version Supported:
22.04.5
- New Version Supported:
-
[Java SE]
- New Version Supported:
17.0.14
-
Notable Changes:
-
Java SE 12.x
-
Java SE 13.x
-
Java SE 14.x
-
Java SE 15.x
-
Java SE 16.x
-
Java SE 17 (LTS)
-
- New Version Supported:
-
[PostgreSQL]
- New Version Supported:
16.8.1
-
Notable Changes:
-
PostgreSQL 16.x
-
PostgreSQL 15.x
- PostgreSQL 15.10 Release Notes
- PostgreSQL 15.9 Release Notes
- PostgreSQL 15.8 Release Notes
- PostgreSQL 15.7 Release Notes
- PostgreSQL 15.6 Release Notes
- PostgreSQL 15.5 Release Notes
- PostgreSQL 15.4 Release Notes
- PostgreSQL 15.3 Release Notes
- PostgreSQL 15.2 Release Notes
- PostgreSQL 15.1 Release Notes
- PostgreSQL 15.0 Release Notes
-
- New Version Supported:
-
[Apache Tomcat]
- New Version Supported:
9.0.98
- Notable Changes:
- Apache Tomcat 9.x
- New Version Supported:
-
[Gradle]
- New Version Supported:
8.12.1
-
Notable Changes:
-
Gradle 8.x
- Gradle 8.12.1 Release Notes
- Gradle 8.12 Release Notes
- Gradle 8.11 Release Notes
- Gradle 8.10 Release Notes
- Gradle 8.9 Release Notes
- Gradle 8.8 Release Notes
- Gradle 8.7 Release Notes
- Gradle 8.6 Release Notes
- Gradle 8.5 Release Notes
- Gradle 8.4 Release Notes
- Gradle 8.3 Release Notes
- Gradle 8.2 Release Notes
- Gradle 8.1 Release Notes
- Gradle 8.0 Release Notes
-
Gradle 7.x
-
- New Version Supported:
Third-Party Library Updates
List and describe the key external libraries that have been upgraded in this release, along with the versions and any relevant breaking changes in those libraries.
-
[dbsourcemanager] 1.0.3 -> 1.0.4
- Notable Changes:
- Renamed jar file to dbsourcemanager-1.0.4.jar.
- Changes to use new version of Apache Commons Lang 3 library.
- Changes to use new version of Apache Commons Collections 4 library.
- Changes in deprecated or removed features used in Java 17.
- Added support for PostgreSQL 16.
- Notable Changes:
-
[commons-beanutils] 1.8.3 -> 1.9.4
-
[commons-codec] 1.11 -> 1.17.1
-
[commons-collections] 3.2.2 -> 4.4
-
Notable Changes:
-
API Changes - Migration from Apache Commons Collections 3.2.2 to 4.4
Starting with version 25Q1 of Etendo, Apache Commons Collections has been upgraded from version 3.2.2 to 4.4. This upgrade includes a change in the package structure: all references previously pointing to
org.apache.commons.collections
must now be updated toorg.apache.commons.collections4
. -
Migration Instructions
Developers should update all import statements and internal references to reflect the new package structure. The previous package
org.apache.commons.collections
has been replaced byorg.apache.commons.collections4
in the new version. Please verify that the updated classes and methods are compatible with your existing code, as some methods may have been deprecated, renamed, or modified in behavior.// Before (Apache Commons Collections 3.2.2) import org.apache.commons.collections.CollectionUtils; // After (Apache Commons Collections 4.4) import org.apache.commons.collections4.CollectionUtils;
For more detailed migration guidelines, please refer to the Apache Commons Collections 4.4 documentation.
-
-
[commons-digester] 1.8.1 -> 2.1
-
[commons-fileupload] 1.4 -> 1.5
-
[commons-io] 2.4 -> 2.16.1
-
[commons-lang] 2.6 -> 3.17.0
-
Notable Changes:
- Commons Lang 3.0 Release Notes
- Commons Lang 3.1 Release Notes
- Commons Lang 3.2 Release Notes
- Commons Lang 3.3 Release Notes
- Commons Lang 3.4 Release Notes
- Commons Lang 3.5 Release Notes
- Commons Lang 3.6 Release Notes
- Commons Lang 3.7 Release Notes
- Commons Lang 3.8 Release Notes
- Commons Lang 3.8.1 Release Notes
- Commons Lang 3.9 Release Notes
- Commons Lang 3.10 Release Notes
- Commons Lang 3.11 Release Notes
- Commons Lang 3.12.0 Release Notes
- Commons Lang 3.13.0 Release Notes
-
API Changes - Migration from Apache Commons Lang 2.6 to 3.17
Starting with version 25Q1 of Etendo, Apache Commons Lang has been upgraded from version 2.6 to 3.17. As part of this upgrade, the package structure has changed. All classes previously imported from
org.apache.commons.lang.*
must now be updated to use the new packageorg.apache.commons.lang3.*
. -
Migration Instructions
Developers should update their import statements to reflect the new package structure. The previous package
org.apache.commons.lang
has been replaced byorg.apache.commons.lang3
in the new version. Please verify that the updated classes and methods are compatible with your existing code, as some methods may have been deprecated, renamed, or modified in behavior.// Before (Apache Commons Lang 2.6) import org.apache.commons.lang.StringUtils; // After (Apache Commons Lang 3.17) import org.apache.commons.lang3.StringUtils;
For more detailed migration guidelines, refer to the Apache Commons Lang 3 migration notes.
-
Deprecated Library
Although the previous version of the library is maintained for backward compatibility, it will be removed in future releases. It is strongly recommended to migrate to Apache Commons Lang 3.17 to ensure long-term support and compatibility.
-
-
[hibernate-commons-annotations] 5.1.0.Final -> 5.1.2.Final
- Notable Changes:
-
[hibernate-core] 5.4.2.Final -> 5.6.15.Final
- Notable Changes:
-
[istack-commons-runtime] 3.0.7 -> 4.2.0
-
[jasperreports] 6.0.0 -> 6.17.0
- Notable Changes:
-
[jasperreports-fonts] 6.0.0 -> 6.17.0
-
[poi] 3.10.1 -> 5.4.0
-
Notable Changes:
- Apache POI 5.4.0 (2025-01-08)
- Apache POI 5.3.0 (2024-07-02)
- Apache POI 5.2.5 (2023-11-25)
- Apache POI 5.2.4 (2023-09-28)
- Apache POI 5.2.3 (2023-05-22)
- Apache POI 5.2.2 (2023-01-19)
- Apache POI 5.2.1 (2022-09-09)
- Apache POI 5.2.0 (2022-01-14)
- Apache POI 5.1.0 (2021-08-07)
- Apache POI 5.0.0 (2021-02-08)
- Apache POI 4.1.2 (2019-12-16)
- Apache POI 4.1.1 (2019-07-20)
- Apache POI 4.1.0 (2019-04-22)
- Apache POI 4.0.1 (2018-11-24)
- Apache POI 4.0.0 (2018-09-07)
For older versions like 3.10.1, you can check: - Apache POI Release Archive (source & binaries) - Full changelog overview
Note
Refer to each library’s release notes for more detailed information on changes and how they might affect your system.
-
New Libraries
-
[commons-text]
- Version: 1.10.0
- Documentation
-
[commons-math3]
- Version: 3.6.1
- Documentation
-
[castor-core]
- Version: 1.4.1
- Documentation
-
[castor-xml]
- Version: 1.4.1
- Documentation
-
[itext]
- Version: 2.1.7.js8
- Documentation
Removed Libraries
-
[itext-pdfa]
- Version: 5.5.0
-
[itextpdf]
- Version: 5.5.0
-
[jcommon]
- Version: 1.0.15
-
[jxl]
- Version: 2.6.10