21 lines
1.2 KiB
Markdown
21 lines
1.2 KiB
Markdown
|
---
|
||
|
|
name: holdwell-java-style
|
||
|
|
description: 用于在编写、修改、评审或重构 Java 17 / Spring Boot / MyBatis 后端代码时启用，适用于需要遵循 Holdwell 团队规范的 coding 项目后台服务，包括：使用 ResultPo / PageResult 响应结构、使用 @Resource 注入、基于注解进行参数校验、共享 DTO 放在 product-api 模块、手动字段映射而不是使用 BeanUtils.copyProperties、使用中文注释/日志，以及优先依赖数据库默认值等实践。
|
||
|
|
---
|
||
|
|
|
||
|
|
# NL Java Backend Skill
|
||
|
|
|
||
|
|
## 何时使用
|
||
|
|
- 在编写Java代码的时候
|
||
|
|
- 新增或调整 `Controller`、`Service`、`ServiceImpl`、`Mapper`、`Config`、`Dto`、`Api`、
|
||
|
|
- 评审或重构 Java / Spring / MyBatis 代码时，需要严格对照团队规范。
|
||
|
|
|
||
|
|
## 使用方式
|
||
|
|
1. 开始改代码前，先阅读 [references/rules.md](references/rules.md)。
|
||
|
|
3. 实现时优先满足返回值、校验、注入、注释、日志、数据库约束，不要额外写“防御性兜底”代码。
|
||
|
|
4. 交付前检查命名[rules.md](references/rules.md)、排序、分页入参、字段映射、删除语义、远程调用失败处理是否符合规范。
|
||
|
|
|
||
|
|
|
||
|
|
## 参考
|
||
|
|
- 详细规则与反例见 [references/rules.md](references/rules.md)。
|