Java项目开发规范

2019-07-05  本文已影响0人  Apple_Boy

1.命名规范:

    *所有标识都只能用ASCII字母、数字和下划线

    *类名是一个名词,采用大小写混合的方式,每个单词的首字母大写  如:NeeKe

    *方法名是一个动词或动词词组,采用大小写混合的方式,第一个单词的首字母小写,其后单词的首字母大写,如setNeeKeName(String neekeName)

    *变量名第一个字母大写,任何中间单词的首字母大写。要简短顾名思义,便于记忆,如:neekeName、neekeAddress  避免单个字符的变量名(springset方法),除非是一次性的临时变量。不能出现类似a等名称的变量

    *常量的声明应该全部大写,每个单词之间用_连接  如:final String WWW_INEEKE_CN="www.ineeke.com"

2.注释规范:

    *注释尽可能用//  所有的javadoc用/**  */  临时对代码块注释/* */

    *源文件都应该在开头有一个注释,其中列出文件名、日期和类的功能概述

    *每个方法必须添加文档注释【类的main除外】,注释内容为参数说明,如果一个类里面的方法是由多个人完成的,每个方法注明是谁写的

    *每个属性必须注释

3.缩进版本规范:

    使用Eclipse的格式化ctrl+f

4.文件命名规范:

    *一个java源文件只能存储一个java类

    *文件名与java类名相同

5.声明规范:

    *一行声明一个变量

    *不要将不同类型变量的声明放在同一行

    *只在代码块的开始处声明变量

    *编码声明的局部变量覆盖上一级声明的变量

    *方法与方法之间以空行分隔

6.语句规范:

    *每行至少包含一条简单语句

    *在return语句中,返回值不适用小括号"()"括起来

    *if语句总是用"{" 和"}"括起来

    *在for语句的初始化或更新子句中,避免使用三个以上变量而导致复杂度提高

    *当switch的一个case顺着往下执行时(因为没有break),通常在break语句时位置添加注释!

    *while if for 等循环嵌套语句不能超过三层

7.编程规范:

    *提供对实例以及类变量的public或者private访问控制,尽可能不适用默认值或者protected访问控制

    *避免使用一个对象访问一个类的静态变量或方法,应该使用类名

    *避免在一个语句中给多个变量赋相同的值

    *用于设置对象状态的方法前缀必须是set;用于检索一个布尔类型对象状态的方法必须是is;用于检索其他方法前缀必须是get

    *程序中应该尽可能少使用数字(或字符),尽可能定义静态变量来说明该数字(或字符)的含义---使用枚举类???程序中需要进行赋值或比较时,使用前面定义的静态变量。在循环控制中例外

    *所有的异常应该都向上抛出

上一篇下一篇

猜你喜欢

热点阅读