BatMap 使用手册

1. 目录结构及介绍

BatMap 是一个基于约定优于配置的快速对象映射库，主要用于在.NET环境中便捷地转换EF实体与数据传输对象(DTO)。下面是其基本的目录结构概述：

• Benchmark: 包含用于基准测试的代码，利用BenchmarkDotNet评估映射性能。
• BenchmarkBatMap: 具体的基准测试类，对比不同映射库的速度。
• BatMap: 核心映射逻辑所在，包括映射配置和执行映射操作的类。
  • BatMap.cs 可能包含了主要的映射执行逻辑。
• BatMap.Tests: 测试套件，确保映射功能正确无误。
• gitattributes, gitignore: 版本控制相关的忽略文件和属性设置。
• LICENSE: 许可证文件，表明项目遵循MIT许可证。
• README.md: 项目简介和快速入门指南。
• _config.yml: 可能是用于项目配置的YAML文件。
• appveyor.yml: 连接到AppVeyor的持续集成配置文件。
• logo.ico, logo.png: 项目图标。

2. 项目的启动文件介绍

该项目作为一个库，并没有直接提供一个“启动”文件以运行整个应用，而是通过NuGet包安装在其他.NET应用程序中使用。若需体验或测试其功能，开发者通常会通过单元测试(BatMap.Tests)来验证其功能，或者在自己的项目中引入并调用其API进行映射操作。

3. 项目的配置文件介绍

• MapConfiguration: 虽然不是传统意义上的配置文件，但在实际使用中，创建一个MapConfiguration实例是对BatMap进行配置的主要方式。你可以在这里启用动态映射、设置是否保持引用等。

  var mapper = new MapConfiguration(
      dynamicMapping: true,
      preserveReferences: true);
  

• 注册映射: 在MapConfiguration或通过静态方法，你可以注册类型映射规则，这可以看作一种配置过程。

  Mapper.RegisterMap<Customer, CustomerDTO>();
  

• 外部配置: 没有直接提到XML或JSON等标准配置文件的使用，配置更多是通过代码进行的。对于复杂的映射逻辑，可以通过继承自ExpressionProvider的类来定制成员绑定逻辑，然后注入到配置中。

在应用该库时，不需要单独寻找或编辑配置文件，一切都依赖于编程式配置。通过这种方式，开发人员能够灵活地控制映射行为，而无需依赖于外部的配置文件结构。