Repository navigation
Home
themarioga edited this page Nov 8, 2026
·
3 revisions
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 |
-
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.
- Getting Started — add the dependency and run a first import and export.
- Running Imports — what happens to every file, step by step.
- Field Engine — how a raw value becomes a typed field.
- Errors and Warnings — the stable catalogs you can program against.
TIE is MIT-licensed · tie · tie-core · tie-spring-boot-starter · Changelog
Using TIE
How it works
Reference
Contributing