How x-ream/sqli works
sqli is a Java SQL programming interface: callers build typed or map-oriented queries, repositories execute them, and results are returned as records, maps, pages, or streamed rows. Its main stages are entity mapping, query construction, SQL generation, and repository execution. Separate capabilities include dialect support, temporary/native SQL access, and optional second-level caching. The README documents these features; sampled source confirms selected parser, repository, and temporary-repository relationships, so unverified internal links are omitted or dashed.
Main entry points: Repository.java Repository engine · DefaultRepositoryX.java Repository implementation · Parser.java Entity parser · Dao.java DAO execution
Components 19
Query construction
- Query model
sqli-builder/src/main/java/io/xream/sqli/builder/Q.java - Query builders
sqli-builder/src/main/java/io/xream/sqli/builder - Update query
sqli-builder/src/main/java/io/xream/sqli/builder/Qr.java - SQL generation
sqli-builder/src/main/java/io/xream/sqli/builder/internal/SqlScript.java
Repository execution
- Typed repository API
sqli-core/src/main/java/io/xream/sqli/api/BaseRepository.java - Repository engine
sqli-core/src/main/java/io/xream/sqli/core/Repository.java - Repository implementation
sqli-repo/src/main/java/io/xream/sqli/repository/internal/DefaultRepositoryX.java - DAO execution
sqli-repo/src/main/java/io/xream/sqli/repository/dao/Dao.java
Mapping and results
- Entity parser
sqli-builder/src/main/java/io/xream/sqli/parser/Parser.java - Parsed metadata
sqli-builder/src/main/java/io/xream/sqli/parser/Parsed.java - Field mapping
sqli-builder/src/main/java/io/xream/sqli/util/ParserUtil.java - Paged results
sqli-builder/src/main/java/io/xream/sqli/page/Page.java - Row streaming
sqli-core/src/main/java/io/xream/sqli/core/RowHandler.java
Database extensions
- SQL dialects
sqli-dialect/src/main/java/io/xream/sqli/dialect - Second-level cache
sqli-core/src/main/java/io/xream/sqli/cache - Temporary repository
sqli-repo/src/main/java/io/xream/sqli/repository/internal/DefaultTemporaryRepository.java - Native repository
sqli-repo/src/main/java/io/xream/sqli/repository/internal/DefaultNativeRepository.java
Other components
- Application caller
- Database
Connections 20
- Application caller → Query builders: builds query
README.md - Query builders → Query model: builds
README.md - Application caller → Typed repository API: submits query
README.md - Typed repository API → Repository engine: exposes operations
sqli-core/src/main/java/io/xream/sqli/api/BaseRepository.java - Repository implementation → Repository engine: implements
sqli-repo/src/main/java/io/xream/sqli/repository/internal/DefaultRepositoryX.java - Repository implementation → Query model: accepts queries
sqli-repo/src/main/java/io/xream/sqli/repository/internal/DefaultRepositoryX.java - Repository implementation → Entity parser: parses entities
sqli-repo/src/main/java/io/xream/sqli/repository/internal/DefaultRepositoryX.java - Entity parser → Field mapping: extracts mappings
sqli-builder/src/main/java/io/xream/sqli/parser/Parser.java - Entity parser → Parsed metadata: stores metadata
sqli-builder/src/main/java/io/xream/sqli/parser/Parser.java - Repository engine → SQL generation: generates SQL
- Repository engine → DAO execution: delegates execution
- DAO execution → Database: executes SQL
- Repository engine → Paged results: returns pages
sqli-core/src/main/java/io/xream/sqli/core/Repository.java - Repository engine → Row streaming: streams rows
sqli-core/src/main/java/io/xream/sqli/core/Repository.java - Repository engine → Second-level cache: supports cached queries
sqli-core/src/main/java/io/xream/sqli/core/Repository.java - Repository engine → SQL dialects: uses SQL dialect
- Application caller → Update query: builds updates
README.md - Application caller → Temporary repository: uses temporary tables
README.md - Temporary repository → DAO execution: delegates queries
sqli-repo/src/main/java/io/xream/sqli/repository/internal/DefaultTemporaryRepository.java - Application caller → Native repository: uses native SQL
README.md