Skip to content

Namastack Outbox v1.6.0

Choose a tag to compare

@github-actions github-actions released this 17 May 20:09
· 81 commits to main since this release
ef1ed20

What's New

JPA Schema Validation and DDL Compatibility Improvements (GH-288, GH-289)

This release introduces comprehensive JPA schema validation tests for all supported databases and
fixes DDL compatibility issues for OutboxRecordEntity.payload and OutboxRecordEntity.context.
These fields now use Hibernate's dialect-aware large Unicode text mapping, resolving validation
failures and mismatches with shipped DDL schemas—especially for Oracle, SQL Server, MySQL, MariaDB,
and H2. See the detailed migration and impact notes below.

Impact

Setup Impact
JDBC module No runtime migration required
JPA with ddl-auto=none No startup validation impact
JPA with ddl-auto=validate and new schema No action required
JPA with ddl-auto=validate and existing schema Migration may be required, see below

Database Notes

Database Change
Oracle No DDL change. Existing NCLOB columns now validate correctly.
PostgreSQL No DDL change. Existing TEXT columns now validate correctly.
SQL Server context should be NVARCHAR(MAX) instead of VARCHAR(MAX).
MySQL payload and context should be LONGTEXT CHARACTER SET utf8mb4.
MariaDB payload and context should be LONGTEXT CHARACTER SET utf8mb4.
H2 payload and context should be CLOB.

Migration Scripts

SQL Server

ALTER TABLE outbox_record
    ALTER COLUMN context NVARCHAR(MAX) NULL;

MySQL

ALTER TABLE outbox_record
    MODIFY COLUMN payload LONGTEXT CHARACTER
SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL,
    MODIFY COLUMN context LONGTEXT CHARACTER
SET utf8mb4 COLLATE utf8mb4_unicode_ci NULL;

MariaDB

ALTER TABLE outbox_record
    MODIFY COLUMN payload LONGTEXT CHARACTER
SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL,
    MODIFY COLUMN context LONGTEXT CHARACTER
SET utf8mb4 COLLATE utf8mb4_unicode_ci NULL;

H2

ALTER TABLE outbox_record
    ALTER COLUMN payload CLOB;
ALTER TABLE outbox_record
    ALTER COLUMN context CLOB;

What's Changed

  • GH-288 Add JPA schema validation tests for all supported databases and fix DDL compatibility
    issues by @rolandbeisel in #289
  • Bump gradle-wrapper from 9.5.0 to 9.5.1 by @dependabot[bot]
    in #291

New Contributors

  • No new contributors in this release.

🙏 Contributors

Special thanks to all contributors who made this release possible:


Full Changelog: v1.5.0...v1.6.0