How ratanachh/dapperx works
DapperX is a compile-time source-generator-powered .NET data-access framework: developers declare mapped entities and repository interfaces, then use generated repositories for database operations. The generator models mappings and emits SQL-backed repository code; runtime query and execution layers handle requests against one of four providers. The README documents additional batch/graph, relationship, lifecycle, tenancy, auditing, and query-language capabilities; their internal wiring is not fully shown in the sampled source, so those links are marked unverified where appropriate.
Main entry points: EntityModel.cs Entity metadata · DbExecutor.cs Database executor · RepositoryEmitter.cs Repository emission · DapperXRepositoryBase.cs Repository runtime
Components 20
Declarations and metadata
- Entity declarations
src/DapperX/Core/Attributes/Entity/EntityAttribute.cs - Repository contract
src/DapperX/Core/Attributes/Query/RepositoryAttribute.cs
Compile-time generation
- Entity metadata
src/DapperX.Generator/Models/EntityModel.cs - Source generator
src/DapperX.Generator/DapperXSourceGenerator.cs - Repository emission
src/DapperX.Generator/Emitters/RepositoryEmitter.cs - SQL generation
src/DapperX.Generator/Builders/SqlBuilder.cs - Derived queries
src/DapperX.Generator/Generators/DerivedQueryGenerator.cs - CPQL queries
src/DapperX.Generator/Generators/CpqlGenerator.cs - Mapping and policies
src/DapperX.Generator/Generators - Batch and graph ops
src/DapperX.Generator/Generators/GraphGenerator.cs
Repository runtime
- Generated repository
src/DapperX.Generator/Emitters/RepositoryEmission.cs - Repository runtime
src/DapperX/Runtime/Repositories/DapperXRepositoryBase.cs - Fluent query API
src/DapperX/Runtime/Query/RepositoryQuery.cs - Query execution
src/DapperX/Runtime/Query/QueryExecutor.cs - Database executor
src/DapperX/Runtime/Execution/DbExecutor.cs - SQL logging
src/DapperX/Runtime/Logging/SqlExecutionLogger.cs
Database providers
- Provider selection
src/DapperX/Provider/Common/DatabaseProviderFactory.cs - Provider dialects
src/DapperX/Provider
Other components
- Application developer
- Relational database
Connections 24
- Application developer → Entity declarations: declares mappings
README.md - Application developer → Repository contract: declares repository
README.md - Entity declarations → Source generator: triggers generation
- Repository contract → Source generator: triggers generation
- Source generator → Entity metadata: builds metadata
- Entity metadata → Repository emission: informs emission
src/DapperX.Generator/Emitters/RepositoryEmitter.cs - Repository emission → SQL generation: builds SQL
src/DapperX.Generator/Emitters/RepositoryEmitter.cs - Repository emission → Generated repository: emits repository
src/DapperX.Generator/Emitters/RepositoryEmitter.cs - Entity metadata → Derived queries: supports parsing
src/DapperX.Generator/Generators/DerivedQueryGenerator.cs - Derived queries → SQL generation: uses SQL builder
src/DapperX.Generator/Generators/DerivedQueryGenerator.cs - Entity metadata → CPQL queries: provides entity context
- Entity metadata → Mapping and policies: configures capabilities
src/DapperX.Generator/Generators/DerivedQueryGenerator.cs - Entity metadata → Batch and graph ops: configures graph operations
- Generated repository → Repository runtime: extends runtime
src/DapperX.Generator/Emitters/RepositoryEmitter.cs - Repository runtime → Database executor: executes SQL
src/DapperX/Runtime/Repositories/DapperXRepositoryBase.cs - Repository runtime → Fluent query API: creates query API
- Fluent query API → Query execution: executes query
src/DapperX/Runtime/Query/RepositoryQuery.cs - Fluent query API → Database executor: executes commands
src/DapperX/Runtime/Query/RepositoryQuery.cs - Query execution → Database executor: runs SQL
- Database executor → SQL logging: logs statements
src/DapperX/Runtime/Execution/DbExecutor.cs - Provider selection → Provider dialects: selects provider
src/DapperX/Provider/Common/DatabaseProviderFactory.cs - Database executor → Relational database: executes commands
src/DapperX/Runtime/Execution/DbExecutor.cs - Application developer → Generated repository: uses generated API
README.md - Provider dialects → Relational database: accesses database