DEV Community
·
什么是清洁架构：第19部分 - 添加控制器
内容提要
本文讲解如何在ASP.NET Core 8中使用MediatR构建松耦合的API控制器。MediatR作为控制器与业务逻辑的中介，帮助解耦应用层，遵循单一职责原则。文章详细介绍了CategoryController和EventsController的实现，处理类别和事件的API请求。MediatR的优势在于关注点分离，便于维护、扩展和测试。未来将探讨其高级特性。
关键要点
-
本文讲解如何在ASP.NET Core 8中使用MediatR构建松耦合的API控制器。
-
MediatR作为控制器与业务逻辑的中介，帮助解耦应用层，遵循单一职责原则。
-
文章介绍了CategoryController和EventsController的实现，处理类别和事件的API请求。
-
MediatR的优势在于关注点分离，便于维护、扩展和测试。
-
在项目中通过AddApplicationServices()方法注册MediatR，确保其在整个应用中可用。
-
CategoryController处理类别相关的API请求，包括获取所有类别和添加新类别。
-
GetAllCategories方法发送GetCategoriesListQuery到MediatR，返回HTTP 200响应。
-
GetCategoriesWithEvents方法根据includeHistory参数决定是否包含历史数据。
-
Create方法处理POST请求以创建新类别，返回处理结果。
-
EventsController处理事件相关的API请求，包括获取所有事件、事件详情、创建、更新和删除事件。
-
GetAllEvents方法使用GetEventsListQuery获取所有事件并返回。
-
GetEventById方法通过GetEventDetailQuery获取特定事件的详细信息。
-
Create方法处理新事件的创建，返回事件ID。
-
Update方法通过UpdateEventCommand更新现有事件，返回204 No Content响应。
-
Delete方法使用DeleteEventCommand根据ID删除事件。
-
通过MediatR实现的控制器关注HTTP请求和响应，业务逻辑由特定处理程序处理，确保API可维护、可扩展。
延伸解读
MediatR的优势
MediatR通过将控制器与业务逻辑解耦，促进了单一职责原则的实施。这种设计使得代码更易于维护和扩展，尤其在大型项目中，能够有效减少不同模块之间的耦合度，提升开发效率。
控制器的实现细节
在CategoryController和EventsController中，使用MediatR处理API请求的方式确保了业务逻辑的集中管理。每个请求都通过特定的命令或查询发送到MediatR，这样可以更清晰地分离请求处理与业务逻辑，便于后期的测试和维护。
注意事项
在使用MediatR时，确保在应用程序的启动阶段正确注册服务是关键。通过AddApplicationServices()方法注册MediatR，可以确保其在整个应用中可用，避免因未注册而导致的运行时错误。
延伸问答
MediatR在ASP.NET Core 8中的作用是什么？
MediatR作为控制器与业务逻辑的中介，帮助解耦应用层，遵循单一职责原则，便于维护、扩展和测试。
如何在项目中注册MediatR？
通过AddApplicationServices()方法在应用层注册MediatR，确保其在整个应用中可用。
CategoryController处理哪些API请求？
CategoryController处理获取所有类别、获取带历史数据的类别和添加新类别的API请求。
EventsController如何处理事件的创建和更新？
EventsController通过CreateEventCommand处理新事件的创建，通过UpdateEventCommand更新现有事件。
使用MediatR的主要优势是什么？
使用MediatR的主要优势是关注点分离，使得控制器专注于HTTP请求和响应，业务逻辑由特定处理程序处理。
如何获取特定事件的详细信息？
通过GetEventDetailQuery并传入事件ID，可以获取特定事件的详细信息。
