AIMapper 1.0.0

AIMapper

Fleksibel, intuitif, dan performa tinggi untuk object mapping di .NET

✨ Tentang AIMapper

AIMapper adalah library object-to-object mapping untuk .NET 8 yang mendukung konfigurasi berbasis atribut maupun fluent interface.
Dirancang sebagai alternatif ringan AutoMapper, AIMapper mendukung:

• Flattening & unflattening properti nested
• Mapping berbasis atribut [Map]
• Konfigurasi fluent (cfg.ForMember(...))
• Null substitute, converter, condition, ignore
• Paging async dan collection projection
• ReverseMap dan mapping profile terpusat
• Tanpa konfigurasi runtime

📦 Instalasi

dotnet add package AIMapper

🚀 Quick Start

1. Definisikan Model & DTO

public class User {
    public int Id { get; set; }
    public string? Name { get; set; }
    public UserProfile? Profile { get; set; }
}

public class UserProfile {
    public string? Address { get; set; }
}

public class UserDto {
    public int Id { get; set; }
    public string? Name { get; set; }
    public string? Address { get; set; }
}

2. Tambahkan ke DI

services.AddAIMapper();

3. Konfigurasi Mapping

mapper.Configure<User, UserDto>(cfg => {
    cfg.ForMember("Address", o => o.CustomPath = "Profile.Address");
});

4. Mapping Object & Koleksi

var dto = mapper.Map<User, UserDto>(user);
var dtos = users.ProjectTo<User, UserDto>(mapper).ToList();

🎯 Fitur Fluent Mapping

🔥 Contoh MappingProfile

public class UserProfileMap : MapperProfile
{
    public override void Configure(IMapper mapper)
    {
        mapper.Configure<User, UserDto>(cfg =>
        {
            cfg.ForMember("Address", o => o.CustomPath = "Profile.Address");
            cfg.ForMember("Email", o => o.NullSubstitute("default@email.com"));
            cfg.ForMember("Registered", o => o.ConvertUsing<DateTime?, string?>(dt => dt?.ToString("yyyy-MM-dd")));
            cfg.ForMember("IsActive", o => o.Condition<User, UserDto>((src, dest) => src.Status == StatusEnum.Active));
            cfg.ForMember("Name", o => o.Ignore());
            cfg.BeforeMap((src, dest) => dest.Point = src.Point ?? 0);
            cfg.AfterMap((src, dest) => dest.Name = src.Name?.ToUpper());
            cfg.ReverseMap((Mapper)mapper);
        });

        mapper.Configure<Order, OrderDto>(cfg =>
        {
            cfg.ForMember("CustomerName", o => o.CustomPath = "Customer.Name");
            cfg.ForMember("Total", o => o.NullSubstitute(0));
            cfg.AfterMap((src, dest) => dest.IsPaid = src.Status == OrderStatus.Paid);
            cfg.ReverseMap((Mapper)mapper);
        });
    }
}

Registrasi MappingProfile:

mapper.ApplyProfilesFromCurrentAssembly();

📁 Contoh Lengkap

Lihat AIMapperSampleDemo.cs di project AIMapper.SampleApp untuk contoh implementasi penuh.

📄 Lisensi

Proyek ini menggunakan lisensi MIT License.