'代码规范(编写中)'

This commit is contained in:
黎润豪 2021-12-20 16:30:26 +08:00
parent cd9d4d8b25
commit 4c926c3c79
2 changed files with 53 additions and 1 deletions

View File

@ -0,0 +1,52 @@
# Java后端开发规范
> 拟稿:[黎润豪](/lirh)<a href="https://blog.lroyia.top" target="_blank">(个人博客)</a>
>
> <div><font>版本号 1.0.0 </font></div>
>
## 前言
本文为公司Java后端开发的代码规范规范分如下两级
- <font color="red">【强制】</font>:开发者必须遵循的开发规范要求
- <font color="green">【推荐】</font>:开发者选择性遵循的开发规范要求
## 编程约束
### 命名
- <font color="red">【强制】</font>杜绝完全不规范的缩写,避免望文不知义。
> <font color="red">【反例】</font>AbstractClass缩写成AbsClasscondition缩写成condiFunction缩写成Fu。
- <font color="red">【强制】</font>严禁使用非全世界都知道的拼音命名。
> <font color="green">正例</font>alibaba/youku/hangzhou
> <font color="red">反例</font>suanFen【算分】getGTHTypeCode【获取个体户类型编码】
#### 类命名
- <font color="red">【强制】</font>采用大驼峰UpperCamelCase命名法禁止使用数字命名。
> <font color="green">【正例】</font>KeyPairGlobalConfig
> <font color="red">【反例】</font>areaSliceAreaSlice1AreaSlice2
- <font color="green">【推荐】</font>采用【名词】,【形容词+名词】的格式进行命名
> <font color="green">【正例】</font>SMSSenderGlobalConfig
> <font color="red">【反例】</font>SendSMS
- <font color="red">【强制】</font>抽象类必须以Abstract或Base开头工具类例外如StringUtils异常类名明必须以Exception结尾测试类必须以Test结尾。
- <font color="red">【强制】</font>接口的参数类必须要以VO或Dto结尾命名接口与接口之间的传输参数传输类必须以Dto结尾命名。
#### 方法命名
- <font color="red">【强制】</font>采用小驼峰LowerCamelCase命名法进制使用拼音命名
- <font color="green">【推荐】</font>方法参数不多于5个多于5个后改用DTO进行传输。
## 异常处理
## 工程结构

View File

@ -112,7 +112,7 @@ IDEA社区版运行tomcat必装
### 代码规范
推荐遵循[阿里官方Java开发手册代码规范](https://github.com/alibaba/p3c)
[Java后端开发规范](Java后端开发规范.md)
### 注释规范