Index

An alphabetical map of key concepts to the documents that cover them. For a topic-grouped listing of every document, see the Table of Contents; to get started, see the Quickstart.

A

• Address validation (QUIC retry tokens) — TRIP over Cloudflare quiche
• Aggregates — PDO, rootId / rootClassId Columns
• AI agents / coding agents (MCP, batch modes, skills) — AI Agent Tooling Support, MCP Maven Plugin, Wizard Maven Plugin
• Application bootstrap / lifecycle — Application Bootstrap, Multi-Tier Cascade
• Annotation analysis (@Analyze, META-INF generation) — Service and Configuration API, Build Support, Tentackle Maven Plugin
• Annotation processors (compile-time validation) — Annotation Processors
• Archetype (project scaffolding) — Tentackle Project Archetype, Quickstart
• AtlantaFX theme — tentackle-fx-atlanta
• Authentication (login, credentials, providers) — Authentication
• AuthenticationProvider / AuthenticationManager — Authentication
• Auto-completion (text field suggestions) — Auto-Completion, tentackle-fx
• Auto-update — Tentackle Update, FX RDC Update
• Autologin (desktop clients) — Backend Properties

B

• Backend identity (Db#getBackendIdentity, identity, several databases in one JVM) — Tentackle Database, Backend Properties
• Backend properties (backend.properties, connection/server/client keys) — Backend Properties, Tentackle Session
• Background execution (Rdc.bg, session pool) — Background Execution, tentackle-fx-rdc
• Batch mode (headless wizard goals: pdo, browse, script) — AI Agent Tooling Support, Wizard Maven Plugin
• Batching (JDBC statement batching, batchsize) — SQL Statement Batching, Tentackle Database
• Binding (models to views) — Binding, tentackle-fx
• BOM (Bill of Materials) — Tentackle BOM
• Bulk updates and deletes (PdoUpdateBy, PdoDeleteBy) — Persistence Wurblets
• BundleMonkey (translation editor) — BundleMonkey
• Bundles (resource) — Resource Bundles and Internationalization, Tentackle I18N, BundleMonkey

C

• Cache / caching — PDO Caching, Multi-Tier Cascade
• Cache preloading (@PreloadCache) — PDO Caching, Application Bootstrap
• Canonical construction (@CanonicalConstructor, builders) — Reflection, TRIP
• Class variables (per-class persistence metadata) — Tentackle Persistence, Persistence Wurblets
• ClassMapper / class mapping — Reflection, Service and Configuration API
• CockroachDB (backend peculiarities, selection by name) — The CockroachDB Backend
• Collections (tracked, copy-on-write, immutable) — Miscellaneous, Immutable
• Column defaults (database) — Model Definition, The Oracle Backend (defaults stored as source text)
• Code generation — Wurblets, Persistence Wurblets, Model Definition, The Wurblet API, The Persistence Wurblet API
• Common module (foundation) — Tentackle Common
• CompoundValue (constants, references, scripts in annotations) — CompoundValue, Validation, Tentackle Scripting
• Connection migration (QUIC, stalled paths) — TRIP over Cloudflare quiche, TRIP over QUIC
• Context menus (PDO tree and table items, @PdoTreeContextMenuItemService) — tentackle-fx-rdc
• Core module (runtime foundation) — Tentackle Core
• Correctness guarantees — Correctness First
• Cryptor / encryption of secrets — Cryptor and EncryptedProperties
• Credentials (password, token, custom) — Authentication
• Cursors (streaming large result sets) — Cursors, PdoSelectList / PdoSelectUnique
• Combo / choice boxes (prefix selection, deselect, short/long text) — tentackle-fx, tentackle-fx-rdc
• CRUD and search dialogs (PdoCrud, PdoSearch, PdoEvent, dialog caching) — tentackle-fx-rdc

D

• Database backend — Tentackle SQL, Tentackle Database, The PostgreSQL Backend, The Oracle Backend, The MySQL and MariaDB Backends, The SAP HANA Backend, The Firebird Backend, The CockroachDB Backend, The H2 Backend, The DB2 Backend
• Daemon / supervisor (background threads) — Tasks and Daemons
• DataTypes (application-specific) — Embedded vs. DataType, Binding, Freezable
• Date/time parsing (smart syntax, shortcuts) — Miscellaneous
• Date/time input (reference date @, sliding year window) — tentackle-fx
• Deserialization hardening (allowlisting, untrusted data) — TRIP
• DB2 (backend peculiarities) — The DB2 Backend
• DDL generation — SQL Maven Plugin, Model Definition
• Deduplication (wire format) — TRIP
• Deferred constraint checking (deferred, deferrable) — Model Definition, Transactions
• Dictionary (type compression) — TRIP
• Domain delegate (AbstractDomainObject, AbstractDomainOperation) — Tentackle Domain, PDO
• Domain key (business identity, findByUniqueDomainKey) — Domain Keys
• Domain logic layer — Tentackle Domain, PDO
• DomainDelegateLinker (linking a domain delegate to its proxy) — Tentackle Domain
• DomainContext / DomainContextProvider — The DomainContextProvider, PDO
• DSL (typed SQL projection queries) — The Query DSL
• DTO (Data Transfer Object) generation — The DTO Wurblet and @RecordDTO, Wurblets
• Dark mode / themes (ThemeUtilities) — tentackle-fx, tentackle-fx-atlanta
• Diagnostics (nested selects, statement and TRIP statistics, statement limits) — Tentackle Database

E

• Eager relations — Eager Relations, Model Definition
• Editable tables / edit handlers (TableEditHandler, navigation, adding rows) — Tables and Trees
• Effective class (getClass() vs instanceof on a PDO proxy) — Reflection
• Embedded entities — Embedded vs. DataType, Model Definition
• Entity aliases (entityAliases) — Model Definition, Tentackle Model
• Error display (marking controls, error/info popups) — InteractiveError, tentackle-fx
• Error handling / exception model — Exceptions and Error Handling, Correctness First
• ExceptionHelper (searching and handling exception chains) — Exceptions and Error Handling
• Exceptions (hierarchy, TentackleRuntimeException, PersistenceException) — Exceptions and Error Handling
• Exceptions across tiers (remoting a Throwable) — Exceptions and Error Handling, TRIP
• Expandable text areas (one-liner expanding to a multi-line editor) — tentackle-fx
• Environment variables (overriding properties) — Miscellaneous

F

• FFM API (native bindings) — TRIP over Cloudflare quiche, OS Credential Stores
• Fetch size / FetchList (fetching cursor rows in blocks) — Cursors
• Filtering (column autofilter in table headers) — Tables and Trees
• Firebird (backend peculiarities) — The Firebird Backend
• Formatting (localized patterns) — Miscellaneous, Resource Bundles
• Freezable value types — Freezable
• FX / JavaFX — tentackle-fx, tentackle-fx-rdc, tentackle-fx-atlanta

G

• Global transactions (JTA/XA, two-phase commit) — Global Transactions — JTA and XA, Transactions and Transparent Retry
• Google sign-in / OAuth client — Single Sign-On with Google
• GraphicProvider (icons/images by symbolic name, realms) — GraphicProvider, tentackle-fx
• GuiProvider (per-entity GUI services, default editor/finder) — GuiProvider, tentackle-fx-rdc

H

• H2 (backend peculiarities, test database) — The H2 Backend, tentackle-test-pdo
• History (origins, milestones, the move to GitHub) — The History of Tentackle
• Host name verification (hostcheck, TLS) — TRIP, TRIP over Cloudflare quiche, TRIP over QUIC

I

• I18NText (multilingual values, translation editor) — Resource Bundles and Internationalization, tentackle-fx
• i18n / Internationalization — Resource Bundles and Internationalization, Tentackle I18N, I18N Maven Plugin, BundleMonkey
• Icons / images (symbolic names, icon packs, realms) — GraphicProvider, tentackle-fx-atlanta
• Id sources (technical object ids) — Tentackle Database, Number Sources (for business numbers)
• Immutability — Immutable
• I/O streams (compression, encryption, packet framing) — I/O and Networking
• Indexes (database) — Model Definition, The PostgreSQL Backend (GIN indexes on JSONB, unmodeled index methods), The Oracle Backend (filtered indexes on Oracle), The MySQL and MariaDB Backends (index key limits), The Firebird Backend (sort order per index)
• Inheritance mapping — Model Definition
• Input alerts (sound / visual feedback on rejected input) — tentackle-fx
• Integrity modes — Model Definition
• InteractiveError (validation results → marked controls) — InteractiveError, Validation
• Interceptors — Interceptors
• Interrupts (InterruptedRuntimeException) — Exceptions and Error Handling
• Idle transactions (transaction supervisor, txIdleTimeout) — Tentackle Database, Backend Properties

J

• JPMS / Jigsaw (modules, automatic modules) — Tentackle Modules, Quickstart
• JPMS: exporting new packages (wizard profiles, first operation) — Quickstart, Wizard Maven Plugin
• Jlink / Jpackage images — Jlink/Jpackage Maven Plugin, Quickstart
• Joins (Join, JoinedSelect, JoinState) — Tentackle Persistence, Eager Relations, The Persistence Wurblet API
• JTA / XA (jta backend property, XaConnectionManager, XaMpxConnectionManager) — Global Transactions — JTA and XA, Tentackle Database
• JWT / ID token verification — Single Sign-On with Google
• JWT / tokens on the client (storage) — Keyring, Single Sign-On with Google
• JSON / JSONB (model type ↔ database column type) — The PostgreSQL Backend, The MySQL and MariaDB Backends, Tentackle SQL

K

• Keep-alive (sessions, SessionKeepAliveDaemon) — Tentackle Session, Tentackle Session — Session utilities
• Keychain (macOS), Credential Manager (Windows), Secret Service (Linux) — OS Credential Stores
• Keyring (secrets on the client) — Keyring, OS Credential Stores, Single Sign-On with Google
• Keyboard handling (ENTER navigation, Ctrl-Z/Ctrl-Y, F1) — tentackle-fx, tentackle-fx-rdc (F2/F3)

L

• Location transparency (and its limits) — Location Transparency vs. REST, RMI and Spring Remoting, Multi-Tier Cascade, Tentackle Session, PDO
• Locking (optimistic serial, token locks) — Locking
• LockManager (token lock cleanup on logout, crash and restart) — Locking, Tentackle Persistence
• Loggable (how much of an exception to log) — Exceptions and Error Handling, Tentackle Logging
• Logging — Tentackle Logging, SLF4J Provider, Log4J 2 Provider
• Login view (backend selection, failed logins, custom login view) — tentackle-fx-rdc, Authentication

M

• MasterSerialEvent (server-to-client events) — Modification Tracking, Tentackle Session
• Maven plugins — Tentackle Maven Plugin, Maven Support, Build Support
• MCP server (coding agents, model introspection) — MCP Maven Plugin, AI Agent Tooling Support
• Migration (RMI → TRIP) — Migrate from RMI to TRIP
• Mixins (multiple-inheritance emulation) — Reflection, PDO
• Mock delegates (database-less unit tests) — Tentackle PDO Mocks, tentackle-test-pdo
• Model defaults (modelDefaults, nodefaults) — Model Definition, Tentackle Model
• Model definition (DSL) — Model Definition, Tentackle Model, MCP Maven Plugin
• Model documentation (browsable HTML/Markdown pages, tentackle-sql:document) — SQL Maven Plugin
• Modification log serialization (TripModificationLogSerializer, RESET, epochs) — Tentackle Database, Tentackle Persistence
• Modification table generation (reinitialization detection) — Modification Tracking
• Modification tracking — Modification Tracking, Tentackle Session
• ModuleHook — Service and Configuration API, Resource Bundles
• ModuleLayer (isolated dependency versions) — Isolated Module Layers, jlinkpackage.md
• Module ordering / service precedence (@ModuleOrdinal, @ClasspathFirst) — Service and Configuration API
• Modules — Tentackle Modules
• Multi-tier deployment — Multi-Tier Cascade
• MySQL / MariaDB (backend peculiarities) — The MySQL and MariaDB Backends

N

• Naming rules (derived class names, NamingRules) — Naming Rules
• NoBundle (bundle look-alikes, excluded from tentackle-check:bundles) — Resource Bundles and Internationalization, Checker Maven Plugin
• N:M relations — Model Definition
• Normtext (phonetically normalized search, NormText) — Tentackle Persistence, Model Definition
• Number pools / ranges — Number Sources, Tentackle Persistence
• Number sources (unique business numbers) — Number Sources
• Notes and notifications (non-blocking dialogs, NotificationBuilder) — tentackle-fx

O

• Object identity (equals/hashCode/compareTo, id-based, transient trap, why relations are lists not sets) — PDO
• Operations (behavior without an entity) — Operation
• Optimistic locking (serial column, lost updates) — Locking, Correctness First
• Optional query conditions (QBF-style finders) — Query Methods
• Oracle (backend peculiarities) — The Oracle Backend
• ORM comparison — PDOs vs. Traditional ORMs
• OAuth2 / OIDC login — Authentication, Single Sign-On with Google
• OSGi bundles (building, activators, RESOURCE-INDEX.LIST) — OSGi Bundles, Service and Configuration API
• Online help (F1, help URLs) — tentackle-fx

P

• PDO (Persistent Domain Objects) — PDO, PDOs vs. ORMs
• PDO Browser (generating test-fixture code) — Wizard Maven Plugin, tentackle-test-pdo, AI Agent Tooling Support
• Parallel builds (mvn -T, thread-safe plugins and wurblets) — Tentackle Maven Support, Wurblets, The Wurblet API
• Password input (char[], FxPasswordField) — tentackle-fx
• Passwords / credentials (storage, encryption) — Cryptor and EncryptedProperties, Authentication, Tentackle Session
• PKCE (authorization code flow with proof key) — Single Sign-On with Google
• Permissions / grantees — Security
• Persistence layer — Tentackle Persistence
• Pooling (resources, sessions) — Miscellaneous, Tentackle Session
• PostgreSQL (backend peculiarities, JSON/JSONB) — The PostgreSQL Backend
• Printing (tables, tree tables) — tentackle-fx-rdc
• Projection queries (plain data instead of PDOs) — The Query DSL, Tentackle Database
• Properties (loading, change events) — Miscellaneous
• Preferences (database-backed settings) — Preferences
• Preferenzr (preferences editor) — Preferences
• Preloading PDO caches (@PreloadCache) — PDO Caching, Application Bootstrap
• Preloading remote delegates (@PreloadRemoteDelegate) — Tentackle Database, TRIP
• Pre-/post-commit methods (@PreCommit, @PostCommit) — Interceptors, Transactions
• PDO-bound components (F2/F3, drag and drop, self-loading combo boxes) — tentackle-fx-rdc
• Placeholders in property values (@{name?default}, ${…}) — Backend Properties, Tentackle Common

Q

• Query DSL (typed SELECTs, aggregates, joins) — The Query DSL
• QUIC transport — TRIP over QUIC, TRIP over Cloudflare quiche, TRIP
• Quickstart — Quickstart

R

• Referential integrity (isReferenced, PdoIsReferencing) — Persistence Wurblets, Model Definition
• Reflection (proxies, class mapping, helpers) — Reflection, Interceptors
• Relations (object, list, reversed, N:M) — Model Definition, PdoSelectList / PdoSelectUnique, Eager Relations
• Reconnection (dead resources, policies) — I/O and Networking, Tentackle Database
• @RecordDTO (generating DTOs from records) — The DTO Wurblet and @RecordDTO
• Remote delegates (naming, lookup, preloading) — Naming Rules, Multi-Tier Cascade, Tentackle Database
• Remoting — TRIP, QUIC, QUIC on quiche, vs. REST, RMI and Spring Remoting
• REST (why not between your own tiers, and where it does belong) — Location Transparency vs. REST, RMI and Spring Remoting, Tentackle Web
• RMI (comparison and migration) — Location Transparency vs. REST, RMI and Spring Remoting, Migrate from RMI to TRIP, TRIP
• Retry (transparent transaction retry, backoff policies) — Transactions and Transparent Retry, Locking
• Reverse engineering (existing database → model source, reveng goal) — SQL Maven Plugin, AI Agent Tooling Support
• rootId / rootClassId — rootId / rootClassId Columns, Model Definition

S

• SAP HANA (backend peculiarities) — The SAP HANA Backend
• Scripting — Tentackle Scripting, CompoundValue, Groovy, JRuby, JSR-223
• Secrets in configuration (~-encrypted properties) — Cryptor and EncryptedProperties
• Secrets on the client (SSO tokens, passwords) — Keyring
• Schema mapping (mapSchema / mapSchemas) — Table Names, SQL Maven Plugin, The Oracle Backend, The Firebird Backend
• Schema migration (tentackle-sql:migrate, migration hints) — SQL Maven Plugin, AI Agent Tooling Support
• Security model — Security, Tentackle Persistence
• Security rules editor (SecurityRulesView, SecurityDialogFactory) — tentackle-fx-rdc
• Server application (ServerApplication, AbstractServerApplication) — Tentackle Persistence, Application Bootstrap, Multi-Tier Cascade
• Select methods (generated queries) — PdoSelectList / PdoSelectUnique
• Streaming results / batch processing — Cursors, SQL Statement Batching
• Serialization (wire format) — TRIP
• ServiceFinder / SPI — Service and Configuration API
• Services (@Service, @ServiceName, @MappedService) — Service and Configuration API, Reflection
• Session — Tentackle Session
• Session pool — Tentackle Session, Background Execution
• SessionPooledExecutor (parallel background work on pooled sessions) — Tentackle Session
• SessionUtilities (class/table/class-id lookup, keep-alive daemon, exception hooks) — Tentackle Session, Exceptions and Error Handling
• Single sign-on (SSO) — Authentication, Single Sign-On with Google
• Singular / plural names (@Singular, @Plural, PDO bundle keys) — Wizard Maven Plugin, MyApp Walkthrough
• SessionTaskDispatcher (session-aware background tasks) — Tasks and Daemons, Background Execution
• Snapshots and copies — Snapshots and Copies
• Spreadsheet / XLS / Excel export — tentackle-fx-rdc-poi, Tables and Trees, tentackle-fx-rdc
• Spring Remoting (comparison) — Location Transparency vs. REST, RMI and Spring Remoting
• SQL generation — SQL Maven Plugin, Tentackle SQL
• SQL script execution (tentackle-sql:run) — SQL Maven Plugin, AI Agent Tooling Support
• Startup / shutdown sequence — Application Bootstrap
• Stateless domain logic (warning) — Annotation Processors, Tentackle Domain
• Statement history limit (per transaction, statementHistoryLimit) — Tentackle Database, Transactions
• Session administration (list, log out, kill client sessions) — tentackle-fx-rdc, Tentackle Persistence

T

• Technical & scientific applications — Why Tentackle Fits Technical and Scientific Applications
• Temporary exceptions (the retry classifier) — Exceptions and Error Handling, Transactions and Transparent Retry
• Tables / tree-tables (configuration, cell types, layouts) — Tables and Trees, tentackle-fx-rdc
• Table aliases (alias, automatic generation) — Tentackle Model, Model Definition
• Table names (@TableName, schemas, prefixes) — Table Names, Model Definition
• Table popup (column chooser, CSV/XML export, table preferences) — tentackle-fx-rdc
• Tasks / task dispatcher (background execution) — Tasks and Daemons
• Testing (TestNG support) — tentackle-test-pdo, tentackle-test-fx-rdc, Tentackle PDO Mocks
• Tiers (nested servers/clients) — Multi-Tier Cascade
• Token locks — Locking
• Tokens (bearer, refresh, expiry) — Authentication
• Transactional outbox (instead of XA) — Global Transactions — JTA and XA, Modification Tracking
• Transactions (@Transaction, isolation, retry) — Transactions and Transparent Retry, Tentackle Session, PDOs vs. ORMs, Global Transactions — JTA and XA
• Transports (pluggable) — TRIP, QUIC, QUIC on quiche
• Two-phase commit (XA) — Global Transactions — JTA and XA
• TripFilter (skipping components, PDOs without components) — TRIP
• TRIP (remote invocation protocol) — TRIP, QUIC, QUIC on quiche, Migrate from RMI to TRIP
• TCP transport parameters (connection pool, backlog, compression) — TRIP
• Testing across JVMs (ServerProcessWrapper) — tentackle-test-pdo

U

• Unexpected (deviations from mainstream Java frameworks) — What a Seasoned Java Developer Would Not Expect
• Unique domain key (UDK) — Domain Keys
• Update (self-update service) — Tentackle Update, FX RDC Update
• UserResolver (principal → user entity) — Authentication, Single Sign-On with Google

V

• Validation — Validation, CompoundValue, Check Maven Plugin, InteractiveError (showing results in the UI)
• Version negotiation (QUIC) — TRIP over Cloudflare quiche
• Version numbering (Java LTS prefix, release lines) — The History of Tentackle
• View-modified tracking (dirty forms, Ctrl-Z) — tentackle-fx

W

• Walkthrough (generated application) — MyApp Walkthrough
• When to use Tentackle (and when not to) — Location Transparency vs. REST, RMI and Spring Remoting, Technical & Scientific Applications, What a Seasoned Java Developer Would Not Expect
• Web integration — Tentackle Web
• Wizard (PDO/operation generator) — Wizard Maven Plugin, AI Agent Tooling Support (headless batch modes)
• Wizard: what is left to do after generating a PDO (bundles, GuiProvider) — Wizard Maven Plugin, GuiProvider
• Wurblet API (ModelWurblet, WurbletArgument, JoinPath) — The Wurblet API, The Persistence Wurblet API (DbModelWurblet, the clause generators)
• Wurblet arguments (the query mini-language) — The Wurblet API, PdoSelectList / PdoSelectUnique
• Wurblets / Wurbelizer — Wurblets, Persistence Wurblets, Model Definition, The Wurblet API