示意图
(Service之间可以相互调用,使用依赖倒置原则:例如某个服务可注入到另一个服务,用法:private readonly IyyyService _yyyService;)
命名约定
- WebAPI 控制器: 建议命名为
XXXXController
或XXXXManagementController(也有的命名为
XXXXManagementService)
,主要用于处理HTTP请求。 - 业务逻辑层服务(BLL): 命名为
XXXXService
,主要用于增删改查和写基本逻辑,通常会被 Web API 控制器调用。 - 数据访问层仓储(DAL): 使用
XXXXRepository
命名, ORM(对象关系映射)处理,很可能用到反射之类的技术。
接口定义
- 通常,为了实现解耦和便于测试,建议为业务逻辑层服务 (
XXXXService
) 和数据访问层仓储 (XXXXRepository
) 定义接口。这些接口可以放在Application.Contracts
命名空间下。 - 责任: 定义服务和仓储层的合同,以便于实现依赖注入和松耦合。
调用关系
- 一个 WebAPI 控制器不允许调用另一个 WebAPI 控制器。
- 直接的控制器间调用可能会导致架构复杂度增加,维护困难,调试困难。更好的做法是通过服务层 (
XXXXService
) 进行协调,将所需的业务逻辑封装在服务层内部,然后由需要的控制器调用相应的服务方法来获取或处理数据。 - 如果两个Webapi控制器相互注入,会导致循环依赖从而无法解析依赖,导致程序无法启动或启动后增加额外开销,影响系统稳定性
反例:
[HttpGet]
[Route("GetMenuAsync")]//MenuManageService.cs
public async Task GetMenuAsyncc(IputDto input)
{
var com_list = (await _componentManageService.GetListAsync());//【错误】一个控制器调用另外一个控制器
}
[HttpGet]
[Route("GetListAsync")]//componentManageService.cs
public async Task<PagedResultDto<ComponentTypeDto>> GetListAsync(ComponentTypeDto input)
{
//省略方法
}
【补充】 有人说Webapi控制器A和B之间不能相互调用,但是可以调用它们的接口IA或IB,不会造成依赖循环,但是我还是认为不妥,维护难度太大了。前后端都调这个接口,如果稍微调整一下都会引起蝴蝶效应。
综上所述,在实际开发过程中,尽量避免控制器之间的直接调用,而是通过共享的服务层来协调不同的业务需求,这样可以确保系统架构更加清晰、易于维护。