'代码规范(编写中)'
This commit is contained in:
parent
cd9d4d8b25
commit
4c926c3c79
|
|
@ -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缩写成AbsClass;condition缩写成condi;Function缩写成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>:KeyPair,GlobalConfig
|
||||
> <font color="red">【反例】</font>:areaSlice,AreaSlice1,AreaSlice2
|
||||
|
||||
- <font color="green">【推荐】</font>采用【名词】,【形容词+名词】的格式进行命名
|
||||
|
||||
> <font color="green">【正例】</font>:SMSSender,GlobalConfig
|
||||
> <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进行传输。
|
||||
|
||||
## 异常处理
|
||||
|
||||
## 工程结构
|
||||
|
|
@ -112,7 +112,7 @@ IDEA社区版运行tomcat必装
|
|||
|
||||
### 代码规范
|
||||
|
||||
推荐遵循[阿里官方Java开发手册代码规范](https://github.com/alibaba/p3c)
|
||||
[Java后端开发规范](Java后端开发规范.md)
|
||||
|
||||
### 注释规范
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue