《基于MVC架构的J2EE三层开发》第01章[Java编码规范]

《基于MVC架构的J2EE三层开发》第01章了解java编码规范学会使用根据编码规范写代码目的：本规范为一套编写Java代码的标准和约定。它以软件工程原则为基础，使代码易于理解。同时，将带来更大的一致性，使软件开发团队的效率得到提高范围：本规范适用于任何基于J2EE规范的项目，所有项目中的JAVA代码（包含JSP、SERVLET、JAVABEAN）均应遵守这个规范一个文件由被空行分割而成的段落以及标识每个段落的可选注释共同组成。超过2000行的程序难以阅读，应该尽量避免。Java源文件范例提供了一个布局合理的Java程序范例Java源文件：每个Java源文件都包含一个单一的公共类或接口。若私有类和接口与一个公共类相关联，可以将它们和公共类放入同一个源文件。公共类必须是这个文件中的第一个类或接口,Java源文件还遵循以下规则:1.开头注释（参见“开头注释”）2.包和引入语句（参见“包和引入语句”）3.类和接口声明（参见“类和接口声明”）开头注释：/****@(#)类名版本信息创建日期*版权信息*/包和引入语句：1.packagejava.awt;2.importjava.awt.peer.CanvasPeer;行长度1.尽量避免一行的长度超过80个字符，因为很多终端和工具不能很好处理之。2.用于文档中的例子应该使用更短的行长，长度一般不超过70个字符换行当一个表达式无法容纳在一行内时，可以依据如下一般规则断开之：1.在一个逗号后面断开2.在一个操作符前面断开3.宁可选择较高级别(higher-level)的断开，而非较低级别(lower-level)的断开4.新的一行应该与上一行同一级别表达式的开头处对齐5.如果以上规则导致你的代码混乱或者使你的代码都挤在右边，那就代之以缩进8个空格Java程序有两类注释：实现注释(implementationcomments)和文档注释(documentcomments)1.实现注释:那些在C++中见过的，使用/*...*/和//界定的注释。2.文档注释:是Java独有的，并由/**...*/界定。实现注释的格式：程序可以有4种实现注释的风格：块(block)、单行(single-line)、尾端(trailing)和行末(end-of-line)1.块注释(BlockComments)块注释通常用于提供对文件，方法，数据结构和算法的描述1.单行注释短注释可以显示在一行内，并与其后的代码具有一样的缩进层级1.尾端注释极短的注释可以与它们所要描述的代码位于同一行1.行末注释注释界定符//，可以注释掉整行或者一行中的一部分每行声明变量的数量：推荐一行一个声明，因为这样以利于写注释。初始化：尽量在声明局部变量的同时初始化。唯一不这么做的理由是变量的初始值依赖于某些先前发生的计算布局只在代码块的开始处声明变量。类和接口的声明当编写类和接口是，应该遵守以下格式规则：1.在方法名与其参数列表之前的左括号(间不要有空格2.左大括号{位于声明语句同行的末尾3.方法与方法之间以空行分隔简单语句每行至多包含一条语句，例如：argv++;//正确argc--;//正确argv++;argc--;//避免!复合语句被括其中的语句应该较之复合语句缩进一个层次左大括号{应位于复合语句起始行的行尾；右大括号}应另起一行并与复合语句首行对齐。大括号可以被用于所有语句，包括单个语句，只要这些语句是诸如if-else或for控制结构的一部分。这样便于添加语句而无需担心由于忘了加括号而引入bug返回语句return;returnmyDisk.size();return(size?size:defaultSize);if，if-else，ifelse-ifelse语句if(condition){statements;}elseif(condition){statements;}else{statements;}for语句一个for语句应该具有如下格式：for(initialization;condition;update){statements;}while语句一个while语句应该具有如下格式while(condition){statements;}do-while语句do{statements;}while(condition);switch语句switch(condition){caseDEF:statements;break;caseXYZ:statements;break;default:statements;break;}try-catch语句try{statements;}catch(ExceptionClasse){statements;}finally{statements;}空行1.package语句和import语句之间2.import语句和类声明之间3.两个方法之间4.方法内的局部变量和方法的第一条语句之间5.块注释（参见5.1.1）或单行注释（参见5.1.2）之前6.一个方法内的两个逻辑段之间，用以提高可读性空格1.一个紧跟着括号的关键字应该被空格分开2.for语句中的表达式应该被空格分开3.强制转型后应该跟一个空格一般概念◦尽量使用完整的英文描述符◦采用适用于相关领域的术语◦采用大小写混合使名字可读◦尽量少用缩写，但如果用了，必须符合整个工程中的统一定义◦避免使用长的名字（小于15个字母为正常选择）◦避免使用类似的名字，或者仅仅是大小写不同的名字◦避免使用下划线（除静态常量等）标识符类型说明1.包（Package）的命名2.类（Class）的命名采用大小写混合使名字可读3.接口（Interface）的命名4.枚举（Enum）的命名5.异常（Exception）的命名避免使用下划线（除静态常量等）6.方法（Method）的命名7.参数（Param）的命名8.常量字段（Constants）的命名提供对实例以及类变量的访问控制◦若没有足够理由，不要把实例或类变量声明为公有。引用类变量和类方法◦避免用一个对象访问一个类的静态变量和方法常量◦位于for循环中作为计数器值的数字常量，除了-1,0和1之外，不应被直接写入代码变量赋值◦避免在一个语句中给多个变量赋相同的值圆括号◦一般而言，在含有多种运算符的表达式中使用圆括号来避免运算符优先级问题，是个好方法在ArrayList类中，出现了部分文档注释，其含义分别是：@author对类的说明标明开发该类模块的作者@version对类的说明标明该类模块的版本@see对类、属性、方法的说明参考转向，也就是相关主题@param对方法的说明对方法中某参数的说明@return对方法的说明对方法返回值的说明@exception对方法的说明对方法可能抛出的异常进行说明/***@authorJoshBloch*@authorNealGafter*@version1.56,04/21/06*@seeCollectio*@since1.2*/Java程序有两类注释◦实现注释的格式◦文档注释命名规范◦尽量使用完整的英文描述符◦采用适用于相关领域的术语◦采用大小写混合使名字可读◦尽量少用缩写，但如果用了，必须符合整个工程中的统一定义◦避免使用长的名字（小于15个字母为正常选择）◦避免使用类似的名字，或者仅仅是大小写不同的名字◦避免使用下划线（除静态常量等）