Skip to content

CHANGELOG.md

Latest commit

 

History

History
188 lines (152 loc) · 9.12 KB

CHANGELOG.md

File metadata and controls

188 lines (152 loc) · 9.12 KB
Raw

Changelog

Unreleased

Security and compatibility

  • Replaced the vulnerable Commons Lang 2.6 / Velocity 1.7 integration with Apache Velocity Engine 2.4.1, Commons Lang 3.20.0, and SLF4J API 1.7.36. The optional Velocity driver now requires the maintained dependency set.
  • Updated the optional Spring driver from the unsupported 5.3.39 line through Spring Framework 6.2.12 to the OSS-supported Spring Framework 7.0.9. This addresses the later 6.2.x DataBinder and SpEL advisories while retaining Java 17 compatibility. See the issue #58 security disposition. The standalone source runtime set includes Spring's required Micrometer Observation/Common APIs and JSpecify annotations.
  • Release CI now builds and tests Maven and Ant paths on JDK 17 and JDK 25. Both paths compile Scriptella with a Java 17 class-file baseline.
  • PostgreSQL and MariaDB are the tested first-class database targets for the 1.5 candidate, using the recorded release-validation matrix. MySQL has one targeted validation lane using MySQL Server 8.4.11 and Connector/J 26.7.0; it is intentionally not a broad MySQL compatibility matrix.

1.4 — 2026-08-14

Scriptella 1.4 is a maintenance and modernization release focused on making the project easier to build, run, and maintain on current Java platforms while preserving its lightweight ETL model and existing scripting behavior.

Changed

  • Java 17 is the build and runtime baseline; Maven and Ant compile with release=17 (class-file major version 61). Scriptella 1.3 remains for Java 8.
  • JavaScript upgraded to the official Rhino 1.9.1 JSR-223 provider. The binary and examples distributions bundle rhino-engine and rhino under lib/; supported JavaScript aliases fall back to Rhino when the requested primary engine is absent.
  • Janino → 3.1.12, JavaMail → com.sun.mail:javax.mail:1.6.2, Activation → 1.1.1, Ant → 1.10.17, Commons Logging → 1.2. Commons JEXL stays on 2.0.1 for 1.4 (2.1.1 rejected: var/return become reserved words and break existing ${var} scripts).
  • Velocity → 1.7 with explicit Commons Collections 3.2.2 and Commons Lang 2.6 dependencies; the bundled velocity-dep.jar fat JAR was removed.
  • H2 → 2.4.240 as the bundled database used by tests and examples.

Removed

  • ODBC / JDBC-ODBC bridge adapter (driver="odbc", sun.jdbc.odbc.JdbcOdbcDriver) and the samples/odbc example — the JDK bridge has not existed since Java 8 and cannot work on the Java 17 baseline. Use Scriptella 1.3 only if you still depend on that adapter, or a maintained third-party JDBC driver with a normal JDBC connection / GenericDriver.
  • HSQLDB 1.8 as the bundled test/sample database, including its adapter, committed JAR, license, Maven/Ant dependencies, and provider-specific CSV sample. Database-backed tests and examples now use H2 2.4.240.

Upgrade notes

  • JDK 17 is the minimum runtime and build JDK; artifacts use Java 17 bytecode. Runtime and Maven builds were tested on Temurin 17 and 21, while release packaging uses JDK 17, Ant 1.10.17, and DTDDoc 1.1.0.
  • Keep the binary distribution layout intact when using JavaScript. Maven and embedded consumers must add org.mozilla:rhino-engine:1.9.1 to the application classpath; a script connection's classpath alone is not a JSR-223 provider installation mechanism.
  • ODBC users: there is no Scriptella odbc driver in 1.4.
  • Bundled examples that previously created HSQLDB file databases now create H2 databases. Existing HSQLDB database files are not converted automatically.

1.3 — 2026-07-17

Release 1.3 establishes a maintainable Java 8 baseline while preserving the existing Maven modules, Ant-built all-in-one JAR, and distribution archives.

Added

  • Added a shell-command driver for executing external commands as Scriptella scripts or queries (#32).
  • Added regression coverage for DTD validation of <include> inside <script> (#29). The maintained DTD was already correct, so no runtime or DTD change was required.
  • Added regression coverage confirming that JDBC ID result columns take precedence over a same-named global property (#20). The reported defect was not reproducible in the supported Java 8/HSQLDB path.

Changed

Compatibility

  • Set Java 8 as the required runtime baseline and Maven bytecode target.
  • Switched JavaScript execution from Nashorn-specific behavior to Rhino through a JSR 223 adapter, addressing JavaScript compatibility issue #2.
  • Updated project metadata and documentation to describe focused maintenance development and the supported release environment.

Build and packaging

  • Restored reproducible Maven module builds and tests with Maven 3.6 or newer.
  • Preserved the Ant 1.10.17 workflow for the all-in-one JAR and binary, source, and examples ZIP archives.
  • Made Ant test failures fail the build instead of allowing a successful exit.
  • Bundled the Rhino engine and JSR 223 adapter, with license material, so Ant builds work from a fresh checkout without requiring Maven dependency staging.
  • Removed Apache Forrest website generation from the project build while retaining Javadoc and DTD documentation generation. Full distribution builds continue to use the external DTDDoc 1.1.0 tool.
  • Updated the Maven compiler and Javadoc plugins where required for the release build; obsolete Cobertura execution was removed from the normal build path.
  • Migrated publication from the retired OSSRH service to the Sonatype Central Publisher Portal, with manual approval retained before public release.

Dependencies

  • Reconciled Maven and standalone-distribution Velocity versions at 1.6.2 and added explicit distribution license material.
  • Added Rhino 1.7.10 and rhino-js-engine 1.7.10 for JavaScript execution.
  • Aligned the examples distribution with the Maven-managed JavaMail 1.4.1 and Activation 1.1 versions and added explicit license material.
  • Kept remaining runtime and integration dependencies unchanged to limit release risk.

Website and documentation

  • Replaced the Forrest-generated public website with directly maintained HTML5 and CSS while preserving the principal public URLs and useful deep links.
  • Removed obsolete Forrest assets, generated PDF page variants, and broken-link reports from the website repository.
  • Updated the README, reference material, project status, build requirements, support links, and release wording.

Upgrade notes

  • Java 8 is the supported baseline. Release 1.3 artifacts target Java 8 bytecode; newer runtimes are not part of the 1.3 compatibility promise.
  • JavaScript ETL should explicitly select language=rhino. Scripts that depend on Nashorn-specific behavior should be tested and adjusted before upgrading.
  • The shell driver executes operating-system commands with the permissions of the Scriptella process; review command input and deployment permissions before enabling it in untrusted workflows.
  • Maven consumers continue to use the org.scriptella group ID introduced in 1.2. The module layout and artifact IDs are unchanged.
  • Building the full standalone distribution requires Ant 1.10.17 and an external DTDDoc 1.1.0 installation; normal Maven builds do not require DTDDoc.

Deferred and known limitations

  • JDK 17 compatibility is deferred to Scriptella 1.4. Java 21 compatibility is future work after JDK 17 unless later planning changes that target.
  • Broad Spring, JavaMail/Jakarta, reporting-plugin, and other dependency upgrades remain deferred.
  • Issue #20 remains deferred unless a concrete failing ETL and database/driver combination is provided.

1.2 — 2019-10-03

  • Changed published Maven coordinates to the org.scriptella group ID.
  • Updated the Janino driver to 3.1.0.

1.1 — 2012-12-28

  • Added JEXL 2.0 support.
  • Added flexible parsing and formatting rules for text and CSV drivers.
  • Added JDBC query and script batch execution support.
  • Added detection of a missing query.next() call.
  • Fixed SQL parsing of ternary expressions.

1.0 — 2010-05-05

  • Added CUBRID support and improved JDBC driver auto-detection.
  • Added the nostat command-line option.
  • Updated the HSQLDB, Velocity, Janino, and H2 dependencies.
  • Fixed class loading in EAR deployments, HTTP URL writes, lazy connection initialization, DB2 null handling, and CSV/text null expansion.

For changes before 1.0 and additional historical detail, see forrest/status.xml.