👁 Image
SyZero.AutoMapper 1.1.9

SyZero.AutoMapper

SyZero 框架的 AutoMapper 集成模块，提供对象映射自动配置。

📦 安装

dotnet add package SyZero.AutoMapper

✨ 特性

• 🚀 自动扫描 - 自动扫描并注册所有 Profile
• 💾 依赖注入 - 无缝集成 Microsoft DI
• 🔒 类型安全 - 编译时类型检查
• 📦 集合映射 - 内置 AutoMapper.Collection 支持
• 🎯 多目标框架 - 支持 net8.0、net9.0

🚀 快速开始

注册服务

// Program.cs
var builder = WebApplication.CreateBuilder(args);
// 添加SyZero
builder.AddSyZero();

// 方式1 - 自动扫描所有程序集
builder.Services.AddSyZeroAutoMapper();

// 方式2 - 指定程序集
builder.Services.AddSyZeroAutoMapper(typeof(UserProfile).Assembly);

// 方式3 - 多个程序集
builder.Services.AddSyZeroAutoMapper(
 typeof(UserProfile).Assembly,
 typeof(OrderProfile).Assembly
);

// 方式4 - 自定义配置
builder.Services.AddSyZeroAutoMapper(cfg =>
{
 cfg.AllowNullCollections = true;
 cfg.AllowNullDestinationValues = false;
}, typeof(UserProfile).Assembly);

var app = builder.Build();
// 使用SyZero
app.UseSyZero();
app.Run();

使用示例

public class UserProfile : Profile
{
 public UserProfile()
 {
 CreateMap<User, UserDto>();
 CreateMap<CreateUserInput, User>();
 
 // 集合映射（由 AutoMapper.Collection 提供）
 CreateMap<User, UserDto>()
 .EqualityComparison((src, dest) => src.Id == dest.Id);
 }
}

public class UserService
{
 private readonly IObjectMapper _mapper;

 public UserService(IObjectMapper mapper)
 {
 _mapper = mapper;
 }

 public UserDto GetUser(User user)
 {
 return _mapper.Map<UserDto>(user);
 }
 
 public void UpdateUser(UserDto dto, User user)
 {
 _mapper.Map(dto, user);
 }
}

📖 API 说明

IObjectMapper 接口（SyZero 抽象）

IMapper 接口（AutoMapper 原生）

所有映射操作都是线程安全的

🔧 高级用法

自定义值转换

public class UserProfile : Profile
{
 public UserProfile()
 {
 CreateMap<User, UserDto>()
 .ForMember(dest => dest.FullName, 
 opt => opt.MapFrom(src => $"{src.FirstName} {src.LastName}"));
 }
}

条件映射

CreateMap<User, UserDto>()
 .ForMember(dest => dest.Email, 
 opt => opt.Condition(src => src.IsEmailVerified));

⚠️ 注意事项

1. Profile 类 - 所有映射配置应在 Profile 类中定义
2. 循环引用 - 注意处理对象间的循环引用
3. 性能 - 避免在热路径中使用动态映射

📄 许可证

MIT License - 详见