Spring Boot中Controller/Service/Mapper的注释命名规范

在 Spring Boot 以及标准的 Java Web 开发规范中,CapitalOptionController 的规范叫法是 资金选项控制器

具体原因如下:

  1. 架构层次术语

    • 控制层:通常指代整个架构中的一个层次(即 Controller 层),是一个相对宏观的、集合性的概念。例如:“控制层负责接收前端请求”

    • 控制器:特指被 @Controller 或 @RestController 注解修饰的单个类

  2. 命名习惯
    在代码审查、技术文档或团队沟通中,针对具体的类名 XxxController,通用的说法是 “Xxx 控制器”。因此,CapitalOptionController 应译为“资金选项控制器”。

总结:如果说“资金选项控制层”,通常是指 controller 包下的这一组类所组成的分层结构;而针对这个具体的类,规范的叫法是 资金选项控制器


针对 CapitalOptionService 和 CapitalOptionMapper,在 Spring Boot 分层架构中的规范叫法如下:

  • CapitalOptionService → 资金选项服务(或 资金选项业务服务
    属于业务逻辑层(Service 层),负责封装核心业务规则和流程。在代码评审或文档中,通常直接称其为“资金选项服务”或“资金选项服务类”。

  • CapitalOptionMapper → 资金选项映射器(或 资金选项数据访问接口
    属于数据访问层(Mapper 层),在 MyBatis 等框架中负责数据库操作。规范叫法为“资金选项映射器”,若强调层级也可称“资金选项数据访问层接口”。

总结

  • 具体类/接口:XxxController → “Xxx 控制器”,XxxService → “Xxx 服务”,XxxMapper → “Xxx 映射器”。

  • 层次概念:Controller 层、Service 层、Mapper 层分别称为“控制层”“业务层”“数据访问层/映射层”。

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值