网站大量收购闲置独家精品文档,联系QQ:2885784924

JAVA编码的规约.doc

  1. 1、本文档共15页,可阅读全部内容。
  2. 2、有哪些信誉好的足球投注网站(book118)网站文档一经付费(服务费),不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
  3. 3、本站所有内容均由合作方或网友上传,本站不对文档的完整性、权威性及其观点立场正确性做任何保证或承诺!文档内容仅供研究参考,付费前请自行鉴别。如您付费,意味着您自己接受本站规则且自行承担风险,本站不退款、不进行额外附加服务;查看《如何避免下载的几个坑》。如果您已付费下载过本站文档,您可以点击 这里二次下载
  4. 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 =

文档评论(0)

liwenhua00 + 关注
实名认证
内容提供者

该用户很懒,什么也没介绍

1亿VIP精品文档

相关文档