Repository navigation
Blueprint 1.1.0 introduces a class-based entity model, explicit DB/RAM selection, and improved documentation.
- Class-based entities: BlueprintEntity is now an abstract class instead of an interface. Entities inherit from BlueprintEntityDB for SQL reads or BlueprintEntityRAM for reads from synchronized RAM.
- Removed [RAMCached]: Caching is now selected by inheriting from BlueprintEntityRAM. RAM entities continue to persist their data in SQL.
- Updated namespaces: Entities and the shared Entity API moved to Blueprint.Entities. Blueprint annotations moved to Blueprint.Entities.Annotations.
- Independent AutoInclude sources: Outside transactions, each included entity reads through its own DB or RAM executor, including nested relationships. DB entities are no longer automatically cached because another entity includes them.
- Reorganized query execution: A shared QueryExecutor base supports QueryExecutor_Database and QueryExecutor_RAM. RAM counting and paging logic is consolidated in the RAM executor.
- Expanded documentation: The wiki now includes linked API indexes, descriptions, and examples for Queries and CRUD, Data Annotations, and Transactions, along with migration guidance.
This release includes breaking changes. When upgrading from 1.0.x:
- Convert entity interfaces into classes inheriting from BlueprintEntityDB or BlueprintEntityRAM.
- Remove [RAMCached] and select the appropriate base class.
- Update imports from Blueprint.Database.Entities to Blueprint.Entities, and from Blueprint.Database.Entities.Annotations to Blueprint.Entities.Annotations.
- Adapt property declarations and rebuild all consuming applications. Abstract properties are supported; implemented multilingual properties require overridable accessors.
The shared LINQ and CRUD API remains available. Preserving existing entity mappings avoids the need to rename tables or columns. Transactions continue to execute in SQL, including reads of RAM entities and their AutoInclude relationships.