欢迎来到天天文库
浏览记录
ID:11480978
大小:61.50 KB
页数:16页
时间:2018-07-12
《java程序书写规范》由会员上传分享,免费在线阅读,更多相关内容在行业资料-天天文库。
1、java程序书写规范命名规范 1、一般概念 1、尽量使用完整的英文描述符 2、采用适用于相关领域的术语 3、采用大小写混合使名字可读 4、尽量少用缩写,但如果用了,必须符合整个工程中的统一定义 5、避免使用长的名字(小于15个字母为正常选择) 6、避免使用类似的名字,或者仅仅是大小写不同的名字 7、避免使用下划线(除静态常量等) 2、标识符类型说明 1、包(Package)的命名 Package的名字应该采用完整的英文描述符,都是由一个小写单词
2、组成。并且包名的前缀总是一个顶级域名, 通常是com、edu、gov、mil、net、org等; 如:com.yjhmily.test 2、类(Class)的命名 类名应该是个一名词,采用大小写混合的方式,每个单词的首字母大写。尽量保证类名简洁而富于描述。 使用完整单词,避免缩写词(除非工程内有统一缩写规范或该缩写词被更广泛使用,像URL,HTML) 如:FileDescription 3、接口(Interface)的命名 基本与Class的命名规范类似
3、。在满足Classd命名规则的基础之上,保证开头第一个字母为”I”, 便于与普通的Class区别开。其实现类名称取接口名的第二个字母到最后,且满足类名的命名规范; 如:IMenuEngine 4、枚举(Enum)的命名 基本与Class的命名规范类似。在满足Classd命名规则的基础之上,保证开头第一个字母为”E”, 便于与普通的Class区别开。 如:EUserRole 5、异常(Exception)的命名 异常(Exception)通常采用字母e表示异常
4、,对于自定义的异常类,其后缀必须为Exception 如:BusinessException 6、方法(Method)的命名 方法名是一个动词,采用大小写混合的方式,第一个单词的首字母小写,其后单词的首字母大写。 方法名尽可能的描述出该方法的动作行为。返回类型为Boolean值的方法一般由“is”或“has”来开头 如:getCurrentUser()、addUser()、hasAuthority() 7、参数(Param)的命名 第一个单词的首字母小写,其后单词的首字母
5、大写。参数量名不允许以下划线或美元符号开头, 虽然这在语法上是允许的。参数名应简短且富于描述。 如:publicUserContextgetLoginUser(StringloginName); 8、常量字段(Constants)的命名 静态常量字段(staticfinal)全部采用大写字母,单词之间用下划线分隔; 如:publicstaticfinalLongFEEDBACK; publicstaticLongUSER_STATUS;1. 风格务必保持一贯性(Consiste
6、nt)一位同胞顶着我的鼻子问,为什么我们的Java代码缩进格式非得是这样,而不能是他那样,他就是喜欢他自己的这一种,因此他写的代码总是用他自己习惯的风格。结果在CodeReview里被大家毙掉,责令修改。因此他是大大地不服。就是风格一贯性问题。其实他的风格,本来也没有什么问题,但在项目里,和其他程序员的程序的风格,显得扃异,那就存在问题了。比如这个缩进,又比如变量命名方法,不同的类,不同的Methods里,各自不同,这程序就很难看了。所以一旦你选择了某种风格,一定要贯彻始终。如果一个项目里规定了一个风格,即便很不符合你自己的习惯,也要贯彻始终,绝不应该
7、有标新立异。2. 缩进风格(indent)既然是从缩进说起,就先说说缩进风格;一般来说,象Java这样的类C语言,都采用缩进风格。而常用的,有四种A.K&R风格这是C程序最早的缩进风格,由C的发明者Ritchie和他的合作者Kernighan率先使用:if () { }其特点,是大括号和if判断在同一行。通常,缩进为8个空格或一个tab键,但在C++和Java里,也常缩进4个空格。有人喜欢用两个空格,窃以为不好,不明显。B. BSD 风格又称Allman Style,源自Unix BSD程序员Eric Allman--他为
8、BSD写过很多程序:if (){ }特点:大括号和条件判断分在两
此文档下载收益归作者所有