Ozcorps.Generic 9.0.0

Ozcorps.Generic

Generic repository, unit-of-work, service, and CRUD controller base classes for ASP.NET Core with Entity Framework Core. Includes support for spatial queries, Snowflake IDs, soft-delete, audit fields, and optimistic concurrency versioning.

Installation

dotnet add package Ozcorps.Generic

<PackageReference Include="Ozcorps.Generic" Version="9.0.0" />

Core Concepts

Entity Setup

1. Define your entity

using Ozcorps.Generic.Entity;

public class Product : EntityBase, IModifiedEntity
{
    public string Name { get; set; } = string.Empty;
    public decimal Price { get; set; }

    // IModifiedEntity
    public bool IsActive { get; set; }
    public bool IsDeleted { get; set; }
    public DateTime CreatedAt { get; set; }
    public DateTime? UpdatedAt { get; set; }
    public long CreatedById { get; set; }
    public long? UpdatedById { get; set; }
}

2. Entity interfaces

EntityService automatically populates audit fields and checks soft-delete when the entity implements these interfaces.

Repository & Unit of Work

// Resolve a typed repository
IRepository<Product> repo = unitOfWork.GetRepository<Product>();

// Common operations
Product? product    = repo.Get(id);
IQueryable<Product> all = repo.GetQueryable();

repo.Add(product);
repo.Remove(id);
unitOfWork.Save();

EntityService

EntityService<T, TId, TUserId> provides full CRUD, pagination, and spatial intersection out of the box.

public class ProductService : EntityService<Product, long, long>, IProductService
{
    public ProductService(IUnitOfWork unitOfWork) : base(unitOfWork) { }
}

Operations

CrudController

Inherit CrudController to get wired-up HTTP endpoints with zero boilerplate.

[ApiController]
[Route("api/[controller]")]
public class ProductController : CrudController<Product, long, long>
{
    public ProductController(IEntityServiceProvider provider, ILogger<ProductController> logger)
        : base(provider, logger) { }

    protected override long GetCurrentUserId() =>
        long.Parse(User.FindFirstValue(ClaimTypes.NameIdentifier)!);
}

Generated endpoints

Value Generators

OzValueGenerator — Database sequences

// In OnModelCreating:
modelBuilder.Entity<Product>()
    .Property(x => x.Id)
    .HasValueGenerator((_, __) =>
        new OzValueGenerator("product_id_seq", typeof(long), SequenceDbType.POSTGRE));

SnowflakeValueGenerator — Distributed IDs

modelBuilder.Entity<Order>()
    .Property(x => x.Id)
    .HasValueGenerator<SnowflakeValueGenerator>();

Snowflake IDs embed a timestamp, making them sortable and unique across nodes without a central counter.

License

MIT