RCommon.EFCore 2.3.2-alpha.0.2

RCommon.EFCore

Entity Framework Core implementation of the RCommon persistence abstractions. Provides a fully-featured repository with LINQ queries, eager loading, change tracking, and automatic domain event integration -- all backed by EF Core's DbContext.

Features

• EFCoreRepository<TEntity> implementing IGraphRepository<T>, ILinqRepository<T>, IReadOnlyRepository<T>, and IWriteOnlyRepository<T>
• Full IQueryable<T> support for composable LINQ queries at the domain layer
• Eager loading via Include / ThenInclude mapped to EF Core's IIncludableQueryable
• Configurable change tracking (enable/disable per repository via the Tracking property)
• Paginated query results with ordering support
• Bulk delete via ExecuteDeleteAsync for expression-based batch operations
• Named data store support for multi-database scenarios through IDataStoreFactory
• RCommonDbContext base class implementing IDataStore for seamless factory resolution
• Fluent DI configuration to register DbContexts as named data stores
• Automatic entity event tracking for domain event dispatching on add, update, and delete
• Targets .NET 8, .NET 9, and .NET 10

Installation

dotnet add package RCommon.EFCore

Usage

// Configure in Program.cs or Startup
builder.Services.AddRCommon()
    .WithPersistence<EFCorePerisistenceBuilder>(ef =>
    {
        ef.AddDbContext<ApplicationDbContext>("ApplicationDb", options =>
            options.UseSqlServer(builder.Configuration.GetConnectionString("ApplicationDb")));

        ef.SetDefaultDataStore(defaults =>
            defaults.DefaultDataStoreName = "ApplicationDb");
    });

Your DbContext must inherit from RCommonDbContext:

public class ApplicationDbContext : RCommonDbContext
{
    public ApplicationDbContext(DbContextOptions<ApplicationDbContext> options)
        : base(options) { }

    public DbSet<Order> Orders => Set<Order>();
    public DbSet<Customer> Customers => Set<Customer>();
}

Then inject and use the repository abstractions:

public class OrderService
{
    private readonly IGraphRepository<Order> _orderRepo;

    public OrderService(IGraphRepository<Order> orderRepo)
    {
        _orderRepo = orderRepo;
    }

    public async Task<ICollection<Order>> GetCustomerOrdersAsync(int customerId)
    {
        _orderRepo.Include(o => o.LineItems);
        return await _orderRepo.FindAsync(o => o.CustomerId == customerId);
    }
}

Key Types

Documentation

For full documentation, visit rcommon.com.

Related Packages

• RCommon.Persistence - Core persistence abstractions (required dependency)
• RCommon.Dapper - Dapper implementation
• RCommon.Linq2Db - Linq2Db implementation

License

Licensed under the Apache License, Version 2.0.