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

• 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 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, 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
• ClassMapper / class mapping — Reflection, Service and Configuration API
• 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
• 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

D

• Database backend — Tentackle SQL, Tentackle Database, The Oracle Backend, The MySQL and MariaDB Backends
• Daemon / supervisor (background threads) — Tasks and Daemons
• DataTypes (application-specific) — Embedded vs. DataType, Binding, Freezable
• Date/time parsing (smart syntax, shortcuts) — Miscellaneous
• Deserialization hardening (allowlisting, untrusted data) — TRIP
• DDL generation — SQL Maven Plugin, Model Definition
• Deduplication (wire format) — TRIP
• Dictionary (type compression) — TRIP
• Domain key (business identity, findByUniqueDomainKey) — Domain Keys
• Domain logic layer — Tentackle Domain, PDO
• DomainContext / DomainContextProvider — The DomainContextProvider, PDO
• DSL (typed SQL projection queries) — The Query DSL
• DTO (Data Transfer Object) generation — The DTO Wurblet and @RecordDTO, Wurblets

E

• Eager relations — Eager Relations, Model Definition
• Effective class (getClass() vs instanceof on a PDO proxy) — Reflection
• Embedded entities — Embedded vs. DataType, Model Definition
• 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

F

• Filtering (column autofilter in table headers) — Tables and Trees
• Formatting (localized patterns) — Miscellaneous, Resource Bundles
• Freezable value types — Freezable
• FX / JavaFX — tentackle-fx, tentackle-fx-rdc, tentackle-fx-atlanta

G

• 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

I

• i18n / Internationalization — Resource Bundles, 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 Oracle Backend (filtered indexes on Oracle), The MySQL and MariaDB Backends (index key limits)
• Inheritance mapping — Model Definition
• Integrity modes — Model Definition
• InteractiveError (validation results → marked controls) — InteractiveError, Validation
• Interceptors — Interceptors
• Interrupts (InterruptedRuntimeException) — Exceptions and Error Handling

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
• JWT / ID token verification — Single Sign-On with Google

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
• Loggable (how much of an exception to log) — Exceptions and Error Handling, Tentackle Logging
• Logging — Tentackle Logging, SLF4J Provider, Log4J 2 Provider

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 definition (DSL) — Model Definition, Tentackle Model, MCP Maven Plugin
• Modification tracking — Modification Tracking, Tentackle Session
• ModuleHook — Service and Configuration API, Resource Bundles
• 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
• N:M relations — Model Definition
• Number pools / ranges — Number Sources
• Number sources (unique business numbers) — Number Sources

O

• Object identity (equals/hashCode/compareTo, id-based, transient trap, why relations are lists not sets) — PDO
• Operations (behavior without an entity) — Operation
• 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 — Service and Configuration API

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
• 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
• 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

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
• rootId / rootClassId — rootId / rootClassId Columns, Model Definition

S

• Scripting — Tentackle Scripting, CompoundValue, Groovy, JRuby, JSR-223
• Secrets in configuration (~-encrypted properties) — Cryptor and EncryptedProperties
• Schema mapping (mapSchema / mapSchemas) — Table Names, SQL Maven Plugin, The Oracle Backend
• Schema migration (tentackle-sql:migrate, migration hints) — SQL Maven Plugin, AI Agent Tooling Support
• Security model — Security
• 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
• Single sign-on (SSO) — Authentication, Single Sign-On with Google
• 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
• 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

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 names (@TableName, schemas, prefixes) — Table Names, Model Definition
• 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
• Transactions (@Transaction, isolation, retry) — Transactions and Transparent Retry, Tentackle Session, PDOs vs. ORMs
• Transports (pluggable) — TRIP, QUIC, QUIC on quiche
• TRIP (remote invocation protocol) — TRIP, QUIC, QUIC on quiche, Migrate from RMI to TRIP

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)

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)
• 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