Skip to content

TIE 0.3.0

Choose a tag to compare

@themarioga themarioga released this 09 Nov 12:25
· 23 commits to main since this release

Four additions for reading files as the V2 integration engine did: default values delivered as text, XLSX cells read as Excel displays them, blank XLSX rows skipped, and date patterns with a locale. With the defaults, 0.3.0 behaves exactly like 0.2.0.

Added

  • defaultMode on a field with defaultValue: CONVERT (default, the 0.2.0 behaviour) or TEXT. With TEXT the resolved default skips type conversion, still goes through the field's validations, and reaches the consumer as a String whatever the field's type, so an unresolved ${…} template in a DATE field no longer rejects the line.
  • XLSX reading options:
    • skipBlankRecords, as in CSV: a row whose cells are all blank is dropped and uses no line number.
    • cellValues: FORMATTED reads numbers and dates as Excel displays them per the cell's number format (08001, 25%, 1,234.50, 15/03/2024, 12345678A); CANONICAL remains the default.
    • locale (BCP 47, default ROOT) sets the separators and names for FORMATTED: 1.234,50 with es-ES.
    • XlsxOptions has a builder.
  • Date patterns with a locale: TypeFormat.date(pattern, locale) or typeFormat: { pattern, locale }, for month and day names and AM/PM when reading and writing (31-dic-2026 with es-ES).
formatOptions:
  xlsx: { cellValues: FORMATTED, locale: es-ES, skipBlankRecords: true }
fields:
  - { name: signed, type: DATE, typeFormat: { pattern: dd-MMM-yyyy, locale: es-ES } }   # 31-dic-2026
  - { name: loaded, inInput: false, type: DATE, defaultValue: "${loadDate}", defaultMode: TEXT }

Changed

  • RecordView.get(field) is no longer always of the field's Java type: a defaultMode: TEXT field that took its default holds a String, and get(field, LocalDate.class) throws ClassCastException for it. This only affects fields that declare TEXT.
  • Canonical constructors of XlsxOptions (use XlsxOptions.builder()), TypeFormat.DateFormat and FieldDefinition have new components; record patterns on DateFormat(String pattern) no longer compile. XlsxOptions.DEFAULTS, TypeFormat.date(pattern) and the builders are unchanged.

Artifacts

Artifact
io.github.tie-integration-engine:tie-core:0.3.0 The library
io.github.tie-integration-engine:tie-spring-boot-starter:0.3.0 Optional Spring Boot 4 auto-configuration

Available on Maven Central:

<dependency>
    <groupId>io.github.tie-integration-engine</groupId>
    <artifactId>tie-core</artifactId>
    <version>0.3.0</version>
</dependency>

The jars, with their sources and javadoc, are attached below. Requires Java 25.

Documentation