- 1、本文档共15页,可阅读全部内容。
- 2、有哪些信誉好的足球投注网站(book118)网站文档一经付费(服务费),不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
- 3、本站所有内容均由合作方或网友上传,本站不对文档的完整性、权威性及其观点立场正确性做任何保证或承诺!文档内容仅供研究参考,付费前请自行鉴别。如您付费,意味着您自己接受本站规则且自行承担风险,本站不退款、不进行额外附加服务;查看《如何避免下载的几个坑》。如果您已付费下载过本站文档,您可以点击 这里二次下载。
- 4、如文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“版权申诉”(推荐),也可以打举报电话:400-050-0827(电话支持时间:9:00-18:30)。
查看更多
JAVA编码的规约
JAVA编码规约
介绍
1为什么要有代码惯例
代码惯例之所以重要有以下几点原因:
软件寿命价值的80%是维护。
几乎没有软件在整个使用过程中都有由原作者维护。
代码惯例增加了软件包的可读性,使工程师们能更快、更完整地理解新软件。
如果你想把你的原始代码变成产品,你需要确认它是否和你生产的其它产品一样有好的包装。
2确认
这个文件在SUN 公司的JAVA语言说明书中反映了JAVA语言编码标准。这方面规定主要来自Peter King,Patrick Naughton,Jonni Kanerva,and Scott Hommel.
关于这个文档的改写、修改或再分配的问题,请看版权公告。
对于这个文档的建议请发贴自alans@
2文件名
这一节列举了常用的文件后缀与名称。
2.1文件后缀
JAVA使用以下后缀:
文件种类 后缀 JAVA source .java JAVA bytecode .class 2.2普通文档名称
通常用的文档名称
文档名称 使用 GNUmakefile makefile最恰当的名字。我们使用gnumake制造我们的软件。 Readme 概括特定目录内容的文档的最恰当名称。
3. 文件的组织结构
一个文件应当由多个被分隔的段组成,并由空行和可选择注释来识别。
超过2000行的文件由于冗长而应当避免。Java程序的正确格式可参看第19页的范例“Java源文件范例”。
3.1 Java源文件
每一个Java源文件包含一个单一的公共类或界面。当私有类或界面与一个公共类发生联系时,你可以将它们以一个公共类放入同一个源文件。公共类应当是文件中的第一类或界面。
Java源文件有如下次序:
(起始注释(参看第4页“起始注释”)
(组件和导入语句
(类和界面声明(参看第4页“类和界面声明”)
3.1.1 起始注释
所有源文件应当以C格式注释开始,并列出类名,版本信息,时间和版权说明:
/*
*类名
*
*版本信息
*
*时间
*
*版权说明
*/
3.1.2 组件和导入语句
对于大部分Java源文件而言,第一个无注释行是组件语句。之后,紧跟着是导入语句。举例如下:
组件 java.awt;
导入 java.awt.peer.CanvasPeer
注释:对于唯一的组件名,第一部分总是小写的ASCII码格式的文本文件,并且是最高级别的域名之一。目前可用com,edu,gov,mil,net或ISO3166标准(1981)中规定的用于识别国家的英文两个字母的模式。
3.1.3 类和界面声明
下表按出现的先后顺序描述了一个类或界面说明的各部分。参见第19页“java源文件范例”中一个包含注释的示例。
类/界面声明的各部分 注释 1 类/界面文档注释(/**…*/) 参看第9页“文挡注释”中注释的具体内容 2 类或界面语句 3 类/界面补充注释(/*…*/),如果必要的话 这一注释应包含任一类宽或界面宽度的信息,它不适合于类/界面文档注释。 4 类(静态的)变量 首先是公共类变量,其次是保护类,然后是组件级(无访问修改权),最后是私有类。 5 实例变量 首先是公共类,其次是保护类,然后是组建级(无访问修改权),最后是私有类。 6 构成 7 过程 这些过程应当以功能而非作用域和可访问性来分组。举例说明,一个私有类变量过程可在两个公共实例过程中。其目的是使读和理解代码更为容易。
缩进格式
四个空格作为一个缩进单位。确切的缩进格式结构(空格符与制表符)未被规范。表格的设置必须在每8个空格后(而非4个)。
4.1 行的长度
由于难于被大多数终端和工具进行处理,应当避免一行超过80个字符。
注释:在文档中所列举的范例其行的长度应稍短些,一般不超过70个字符。
4.2 绕回行
当表达式一行无法写完时,使用以下一般规则进行中断:
(在逗号后中断。
(在一个运算符前中断。
(优先选择高级中断指令。
(新行起始表达式的位置应与旧行表达式的位置对齐。
(如果上述规则导致代码混乱或编码时顶到了右边界,以8个空格代替。
以下是几个中断程序的调用范例:
someMethod(longExpression1, longExpression2, longExpression3,
longExpression4, longExpression5);
var = someMethod1(longExpression1,
someMethod2(longExpression2,
longExpression3);
以下是两个关于中断算术表达式的例子。第一个例子由于中断发生在插入表达式以外,因而选择了高级中断指令。
longName1 =
您可能关注的文档
最近下载
- 高三日语复习4:高考日语句型对应练习.pdf VIP
- 人教版八年级下册英语全册课件(2024年2月修订).pptx
- 新引流管护理.ppt VIP
- 2024年高压电工证考试题库及答案(1000题).pdf VIP
- 高三日语复习4:高考日语阅读练习2.pdf VIP
- 统编版高中政治必修1《中国特色社会主义》期末复习:判断题100题专项练习题(含答案解析).pdf VIP
- 常见毒性气体量程及报警值设定 Ver2.0.docx
- 高三日语复习4:高考日语句型、助词、补助动词 练习.pdf VIP
- (详细)高压隔离开关与高压负荷开关课件.ppt
- Q_320281AWP03-2020SBJ型屑饼机企业标准.pdf
文档评论(0)