JAVA V6 多商户商城 开发文档——插件开发规范

命名规范

java 后端命名规范

结构类型 命名规范与实例 作用
控制器(controller) 首字母大写,驼峰命名,按照不同端口分(adminapi,api,siteapi)。例:ConfigController api接口访问
实体类(entity) 与数据表一致,首字母大写,驼峰,数据表按照首字母小写,多个单词使用下划线,例:GoodsCategory 与数据库对应,实现数据的增删改查
mapper视图(mapper) 与数据表一致,首字母大写,驼峰,例:GoodsCategoryMapper 数据视图
service服务层(service) 接口命名:I+主题+Service,例如IMallGoodsService。接口实现:主题+ServiceImpl。注意分端口admin为adminapi接口服务,api为api接口服务,site为siteapi接口服务,core为其他服务层实现,一般用作公共逻辑 实现逻辑服务,以及为接口实现相关逻辑
enums枚举类(enums) 主题+Enum/TypeEnum/StatusEnum等,例如:MemberActionEnum、OrderFromTypeEnum、OrderStatusEnum 系统业务中固定的数据,比如订单状态,操作类型,订单类型,会员账户类型等
请求参数(param) 参数请求与业务层放在一起,文件夹命名param,类名:主题+Param。例如:MallGoodsParam,MallOrderSearchParam 接口请求参数,包括数据接收,验证等作用
视图(vo) 视图与业务层放在一起,文件夹命名vo,类型:主题+Vo。例如:MallGoodsInfoVo,MallOrderListVo 接口数据,为其他业务逻辑提供相应数据结构。
事件定义(event) 对应行为主题+Event/EventDefiner,例如:OrderPayAfterEvent,MallSupplyGoodsDataInfoEventDefiner 实现行为定义扩展解耦,例如,OrderPayAfterEvent,定义了订单完成后需要执行的事件类,相应的业务去实现事件监听,比如订单支付后结算,分账,计算佣金等
事件监听(listener) 对应监听事件+Listener,例如OrderPayAfterListener 监听行为扩展解耦,例如,OrderPayAfterListener,订单支付完成后会调用事件,这里就可以实现相应的订单支付后的业务
计划任务(job) 文件夹命名job,对应任务类:任务主题+Job,例如:GoodsExpiredJob 定时任务,例如站点到期关闭,活动定时开启,关闭等
admin 前端以及 uniapp 手机前端命名规范
结构类型 命名规范与实例 作用
接口(api) 小写,多单词下划线,例如:article.ts,goods_category.ts 为视图提供接口数据
语言包(lang) 语言包文件夹,例如zh-cn,小写,语言包自动根据文件命名,中间文件夹用"."分割,例如article.edit.json,表示视图view再article下面的edit.json 为视图提供相应的语言定义
视图(views) 对应前端视图页,例如:article.vue 页面视图
相关推荐
嘟哩DuliDuli1 小时前
创作 Agent 的任务状态该如何保存
android·java·javascript
wdfk_prog1 小时前
lely-canopen-rtt:为什么推荐在 RT-Thread 上使用 Lely CANopen 构建主站
java·运维·缓存·docker·容器
海盗12341 小时前
DSH 接入 OpenCode Go 报 400 MissingSessionID:从 LLM 语义层退到 fetch 传输层的完整排障
开发语言·后端·golang
Token掘金室1 小时前
JSON模式结构化输出报错
java·服务器·json
weixin199701080161 小时前
《Mercari OTA 直连接入:日本二手电商出海的API通道与600次/分钟限流实战》(附Python源码)
开发语言·数据库·python
秋饼1 小时前
Spring AI 2.0 接入 DeepSeek V4.1 Flash 生产级实战
java·ai·技术分享·后端开发
IT枫斗者枫哥1 小时前
Java 分批导出仍然 OOM?用 32 MiB 堆复现三种 CSV 写法
java
库玛西1 小时前
深度解构高并发利器:纯事件驱动 Reactor 模式的设计哲学与工程实践
服务器·开发语言·c++·笔记·tcp/ip
shehuiyuelaiyuehao2 小时前
算法43,外观数列,模拟算法+双指针
java·算法