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

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)
  - Java SE 17.0.14 Release Notes (Oracle)
  - All Java 17 Updates

PostgreSQL

New Version Supported: 16.8.1
Notable Changes:
- PostgreSQL 16.x
- PostgreSQL 15.x

Apache Tomcat

New Version Supported: 9.0.98
Notable Changes:
- Apache Tomcat 9.x
  - Apache Tomcat 9 Release Notes

Gradle

New Version Supported: 8.12.1
Notable Changes:
- Gradle 8.x
- Gradle 7.x

Warning

To update the Gradle wrapper, you must run ./gradlew wrapper --gradle-version 8.12.1. For more detailed migration guidelines, refer to the Upgrading the Gradle Wrapper

Etendo Gradle Plugin

New Version Supported: 2.0.0
Notable Changes:
- New Gradle Plugin Task
  Terminal
```
./gradlew cleanExpandCore
```
  This new task deletes directories created by the expandCore task.
- Compatibility Flag
  Terminal
```
-Pjava.version=11
```
  This new flag forces the use of Java 11 with version 25Q1.

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.
[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 to org.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 by org.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:
- 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 package org.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 by org.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:
  - 5.1.1.Final Release Notes
  - 5.1.2.Final Release Notes
[hibernate-core] 5.4.2.Final -> 5.6.15.Final
- Notable Changes:
  - 5.4.x Release Notes
  - 5.5.x Release Notes
[istack-commons-runtime] 3.0.7 -> 4.2.0
[jasperreports] 6.0.0 -> 6.17.0
- Notable Changes:
  - Releases Page – GitHub
[jasperreports-fonts] 6.0.0 -> 6.17.0
[poi] 3.10.1 -> 5.4.0
- Notable Changes:
  For older versions like 3.10.1, you can check:
  - Apache POI Release Archive (source & binaries)
  - Full changelog overview
Info

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