Skip to content
themarioga edited this page Nov 8, 2026 · 3 revisions

TIE — Integration Engine

TIE is a stateless Java library for file integrations. It brings files from an SFTP server, a local directory or a stream you provide, reads them as CSV, XLSX, XML or JSON, turns every value into a typed field through a declarative field engine, and hands each record to your code. It also does the reverse: it writes your records to a file and delivers it.

TIE stores nothing. Configuration and state (watermarks, "already processed" checks) come in as data, records go to your consumer, and a result with the new state comes out for you to keep.

Java 25 or later
Artifacts io.github.tie-integration-engine:tie-core, io.github.tie-integration-engine:tie-spring-boot-starter
License MIT
Source tie (aggregator), tie-core and tie-spring-boot-starter, as git submodules: see Repositories and Building

What it does

  • Imports: file → typed records handed to your RecordConsumer, one by one, in streaming.
  • Exports: your records → a file written in streaming and delivered at the end.
  • Delivery of an existing file to a channel (deliverFile).
  • Channels: SFTP (with host key verification), local directories, caller-provided streams.
  • Formats: CSV, XLSX, XML and JSON, read and written incrementally, with nested child records in JSON and XML.
  • Field engine: column lookup, copies, trimming, text transforms, translation tables, custom transformers, type conversion, validations, empty-value rules and default values.
  • Duplicate protection without state: watermarks, an "already processed" predicate, and moving or deleting the source after success.
  • Result reports listing rejected (and optionally applied) lines.
  • Configuration with a Java API or a JSON/YAML document with a published JSON schema.

Where to start

  1. Getting Started — add the dependency and run a first import and export.
  2. Running Imports — what happens to every file, step by step.
  3. Field Engine — how a raw value becomes a typed field.
  4. Errors and Warnings — the stable catalogs you can program against.

Pages

Clone this wiki locally