文档介绍:JAVA源代码规范————————————————————————————————作者:————————————————————————————————日期: JAVA代码规范(初稿)、维护、批准涉及人员如下:创建/修改者:XX维护者:XX批准者:XX具体版本更新记录如表1-1:表1-1版本更新记录版本号修改确认日期修改人修改位置修改方式(AMD):A-增加M-修改D-删除目的本文提供一整套编写高效可靠的Java代码的标准、约定和指南。它们以安全可靠的软件工程原则为基础,使代码易于理解、维护和增强灵活性。通过遵循一套通用的程序设计标准,显著提高Java软件开发者的生产效率,为开发团队的程序设计带来更大的一致性,使软件开发团队的效率明显提高。规范的执行本文档适用于公司内进行软件开发的所有技术人员,即公司内软件开发人员编写的所有源代码都必须遵循本规范。除临时性项目之外的任何项目均应严格按照此标准执行,“临时性项目”指:为市场推广目的而编写的示程序为一次性用途而编写的临时性小程序为学习目的而编写的测试程序文档类别本文档属标准规范类的项目限制级文档,未经总经理及总经理授权人员批准,不得提供公司以外的人员阅读和使用。版本更新条件本文档的定期评审时间为每年的1月,评审及修订步骤依据SEPG工作规范规定。此外,如遇下列条件可进行评审,并根据评审结果决定是否需要进行修订:本文档所列的引用的标准已经更新。本文档的使用者若对本文档有任何评论、建议或意见,请通过企业内部网络发电子邮件给SEPG,所收到的电子邮件将会在评审和修订时给予充分的考虑。使用对象本文档的使用对象包括:项目管理者质量保证人员软件开发人员目录1 介绍 为什么要有编码规范 72 通用代码格式 文件组织 缩进 行长度 换行 空行 空格 注释 注释约定 实现注释的格式 文档注释 快速浏览javadoc 声明 每行声明变量的数量 初始化 布局 类和接口的声明 语句 简单语句 复合语句 返回语句 if,if-else,ifelse-ifelse语句 for语句 while语句 do-while语句 switch语句 try-catch语句 SQL 183 命名规范 总则 项目命名 命名规则 变量命名机制 基本类型变量命名规则:变量类型标识+逻辑名 一般常用对象命名规则 临时变量命名规则 全局变量、成员变量、局部变量命名规则 常量命名机制 HTML元素变量命名机制 JSP文件命名机制 224 类、接口、包和编译单元的标准 类的标准 命名类 注释类 接口标准 命名接口 注释接口 包的标准 命名包 注释包 编译单元标准 命名编译单元 注释编译单元 255 字段标准(字段/属性) 字段可见性 注释一个字段 使用存取成员方法 存取函数的可见性 一定要初始化静态字段 276 成员函数和方法标准 命名函数和成员方法 命名存取成员函数和方法 命名构造函数 成员函数和方法的可见性 成员函数和方法参数标准 命名参数 注释参数 注释成员函数和方法 307 编程惯例 提供对实例以及类变量的访问控制 引用类变量和类方法 常量 变量赋值 328 其它惯例 圆括号 返回值 条件运算符"?"前的表达式 特殊注释 349 代码范例 源文件范例 3410 缩写说明 3511 参考资料 36介绍为什么要有编码规范编码规范对于程序员而言尤为重要,有以下几个原因:一个软件产品的80%的生命期是在维护。几乎没有一个软件在它的整个生命期里都是被它的作者