Afrowave.AJIS.EntityFramework 1.1.0

Afrowave.AJIS.EntityFramework

Entity Framework Core integration for the AJIS (.NET) framework. Provides value converters for storing complex types as AJIS in database columns.

Overview

The EntityFramework library enables storing AJIS-serialized objects in Entity Framework Core databases:

• Value converters - EF Core ValueConverter for AJIS serialization
• Configuration API - Simple configuration with UseAjisSerialization()
• LINQ support - Query support for AJIS properties
• Complex type mapping - Nested objects, collections, and dictionaries
• Database agnostic - Works with all EF Core providers (SQL Server, PostgreSQL, SQLite, etc.)

Features

• Value converter - AjisValueConverter<T> for automatic serialization
• Collection converter - AjisCollectionConverter<T> for collections
• ** DbContext base** - AjisDbContext with automatic configuration
• Repository pattern - AjisFileRepository<T> for file-based storage
• LINQ translation - Query support for AJIS properties
• Migration support - Works with EF Core migrations
• Type mapping - Full support for AJIS type mapping features

Installation

dotnet add package Afrowave.AJIS.EntityFramework

Dependencies

Library Summary

API

See the API Reference for complete documentation.

Key Types

Usage

Basic configuration

public class UserProfile
{
    public int Id { get; set; }
    public string Username { get; set; }

    // Complex object stored as AJIS
    public UserPreferences Preferences { get; set; }
}

public class AppDbContext : AjisDbContext
{
    public DbSet<UserProfile> UserProfiles { get; set; }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        base.OnModelCreating(modelBuilder);

        // Configure AJIS serialization
        modelBuilder.Entity<UserProfile>()
            .Property(e => e.Preferences)
            .UseAjisSerialization();
    }
}

Repository usage

public class UserRepository : AjisFileRepository<User>
{
    public UserRepository() : base("users.ajis") { }
}

// Usage
var repo = new UserRepository();
await repo.InsertAsync(new User { Name = "Alice" });
var user = await repo.GetByIdAsync(1);

LINQ queries

var users = context.Users
    .Where(u => u.Preferences.DarkMode)
    .OrderBy(u => u.Username)
    .ToList();

Documentation

• API Reference - Complete API documentation
• EF Core Integration - EF Core design details
• Getting Started - Quick start guide

Compatibility

• .NET 10.0+
• Entity Framework Core 10.0+
• Nullable reference types enabled

License

MIT