This is an old revision of the document!
如果没有特别说明,可以参照Google或阿里的编码规范(文后附有下载地址)
参考资料:
文件命名
Java文件命名采用类名.java,例如Employee.java, EmployeeContact.java
代码命名规范
默认规则
不同类型的标识符命名规则
包名:全部字母小写,使用com.companyname.project的形式
类名:首字母大写的驼峰法命名
JSP名:首字母小写的驼峰法+下划线功能命名,例如:clinicFinanceMonthlyStatistics_detail.jsp(这是我们现在框架的格式)
方法名:首字母小写的驼峰法命名
常量名:所有字母都大写,用下划线分隔单词
变量名:首字母小写的驼峰法命名
参数名:首字母小写的驼峰法命名
局部变量名:首字母小写的驼峰法命名
每个类不能长于1000行,一个方法的长度尽量控制在50行内
每个类、每个方法都必须都有注释,在一个方法内长于10行必须要有注释
一个方法只能有一项明确的责任
让一切东西都尽可能地“私有”——private,除非有特别好的理由,不要把任何类变量或实例变量公众化(public)。我们规定,实例变量是不需要显式的设置或获取的,统一设成私有的,要取则必须通过某种方法来完成
尽量使用interfaces,不要使用abstract类
避免代码重复
文件格式化
文件格式化,采用IntelliJ IDEA或Eclipse默认的格式化风格,即Reformat Code功能自动实现的文件格式化。
代码之间需要用空行分隔的,仅空一行。
最佳实践
1.如果没有特殊情况,所有的异常捕获后,都需要处理,并记录到日志中,不能捕获后什么都不做 2.复杂逻辑可以先将逻辑分步写好,然后逐步实现,避免中途被其他事情干扰,需要重新拾取思路
JavaDoc
所有public的class,method和enum等都需要加JavaDoc注释,除非方法或类名特别清晰,随便找个英语好的人一看就知道类和方法是什么意思,方法里面做了什么处理