.NET 源代码自动生成：MediatR、CQRS 与源代码生成器
内容提要
现代软件开发中，代码生成器越来越流行，特别是在.NET 5中。本文介绍如何使用.NET源代码生成器结合MediatR库和CQRS模式自动生成API。首先，理解中介者模式和命令处理程序。然后，介绍CQRS模式和源代码生成器。最后，结合MediatR和CQRS模式创建源代码生成器自动生成API控制器和Action方法，并使用Swashbuckle生成API文档。通过源代码生成器，可以减少手动编写的代码量，提高开发效率。
延伸解读
编译时生成：减少样板代码的关键
文章强调源代码生成器是 Roslyn 编译器的特性，能在编译过程中自动生成额外的 C# 代码。这意味着开发者无需手动编写重复的控制器和 Action 方法，从而减少样板代码量。这种机制将代码生成提前到编译阶段，有助于保持代码一致性，并降低因手动编写而引入的错误。
MediatR 与 CQRS 的职责分离
文章通过示例展示了 MediatR 如何实现中介者模式，将请求发送与处理解耦。结合 CQRS 模式，命令（写操作）和查询（读操作）被分离为不同的接口和记录类型，如 ICommand 和 IQuery。这种分离让代码结构更清晰，便于维护和扩展，但文章未深入讨论其可能带来的复杂性。
自动生成 API 与文档的实践
文章演示了如何创建源代码生成器，为 Command 和 Query 自动生成 ASP.NET Core 控制器和 Action 方法，并添加了 ProducesResponseType 等特性。随后，通过 Swashbuckle 为这些自动生成的 API 生成 OpenAPI 文档。这一流程将代码生成与 API 文档化结合，提升了开发效率，但具体实现细节需参考完整代码。
Q&A
什么是.NET源代码生成器？
.NET源代码生成器是Roslyn编译器的特性，允许在编译时自动生成代码，减少手动编写的样板代码。
MediatR库在中介者模式中有什么作用？
MediatR库是实现中介者模式的流行库，它通过中介对象封装对象之间的交互。
CQRS模式的主要特点是什么？
CQRS模式要求将系统中的命令（写操作）与查询（读操作）分离，以提高系统的可维护性和扩展性。
如何使用源代码生成器自动生成API控制器？
可以结合MediatR和CQRS模式创建源代码生成器，自动为Command和Query生成相应的ASP.NET Core控制器和Action方法。
使用Swashbuckle可以实现什么功能？
使用Swashbuckle可以为自动生成的API控制器生成OpenAPI（Swagger）文档，方便API的文档化和测试。
源代码生成器如何提高开发效率？
源代码生成器显著减少手动编写的代码量，从而提高开发效率并降低出错率。
