(代码规范.docVIP

命名规范尽量使用完整的英文描述符采用适用于相关领域的术语采用大小写混合使名字可读尽量少用缩写，但如果用了，要明智地使用，且在整个工程中统一message的缩写可以为msg。 避免使用长的名字（小于 15 个字母是个好主意）避免使用类似的名字，或者仅仅是大小写不同的名字避免使用下划线（除静态常量等）ackage 的命名ackage 的名字应该都是由小写单词组成Class 的命名Class 的名字必须由大写字母开头而其他字母都小写的单词组成对于所有标识符，其中包含的所有单词都应紧靠在一起，而且大写中间单词的首字母。 public class ThisAClassName{} 变量的命名 对于，所有单词都应紧靠在一起，而且大写中间单词的首字母。DB_CONFIG）。 参数的命名 参数的名字必须和变量的命名规范一致。数组的命名 数组方法的参数使用有意义的参数命名赋值的字段一样的名字 setSize(int size){ this.size = size; } 方法的命名 方法的命名遵循变量的命名，方法的名字必须用一个小写字母开头。后面的单词用大写字母开头注释规范 文字说明代码的作用； 明确指出该代码的编写思路和逻辑方法； 使阅读者注意到代码中的重要转折点； 使阅读者不必在他们的头脑中仿真运行代码的执行方法。 何时书写注释：1）请在每个if语句的前面加上注释；2）在每个switch语句的前面加上注释。与if语句一样，switch语句用于评估对程序执行产生影响的表达式。 3）在每个循环的前面加上注释。每个循环都有它的作用，许多情况下这个作用不清楚直观。 Java的注释 单行注释：// 注释一行注释若干行 文档注释：注释若干行，并写入 javadoc 文档 ＜%-- comment --%＞ JSP注释，也称为“隐藏注释”。JSP引擎将忽略它。标记内的所有JSP脚本元素、指令和动作都将不起作用。＜!-- comment --＞ HTML注释，也称为“输出的注释”，直接出现在结果HTML文档中。标记内的所有JSP脚本元素、指令和动作正常执行。代码编写格式username ＝ new String(); …… 而非以下形式： if( flag == true) flag == false; String username ＝ new String(); …… try-catch语句块 try-catch语句块应遵循如下格式： try{ …… }catch(Exception ex){ …… }finally{ …… } 方法与方法之间以空行分隔方法与方法之间首先是类的公共变量，随后是保护变量，再后是包一级别的变量(没有访问修饰符，access modifier)，最后是私有变量使用圆括号来避免运算符优先级问题即使运算符的优先级对你而言可能很清楚，但对其他人未必如此。你不能假设别的程序员和你一样清楚运算符的优先级。import使用规定 引入jdk及j2ee标准类时可以使用*，如import java.io.*； 引入自定义类时，请一个类一条import语句，以增强代码可读性。如import dfjh.basic.db.dbaccess； Exception异常处理 通常的思想是只对错误采用异常处理：逻辑和编程错误，设置错误，被破坏的数据，资源耗尽等。 通常的法则是系统在正常状态下以及无重载和硬件失效状态下，不应产生任何异常。异常处理时可以采用适当的日志机制来报告异常，包括异常发生的时刻。不要使用异常实现来控制程序流程结构。 分别捕获子类的异常而非父类Exception 比较合理的做法是分别捕获各个子类异常之后，分别处理不同的异常，不要一个方法内就一个try{}catch(){}块。 使用Exception来返回异常，而非返回值 尽量使用Exception来反映函数运行中的异常，而不是使用返回值来反映，除非有充分理由这样做。越是底层的类越应该使用Exception来反映函数运行中的异常。 禁止使用空的catch(){}代码 绝对不允许代码中出现catch(){}而什么也没做。因为这样做还不如直接把异常抛出，让使用该方法的人来处理。同时只要你catch了一个异常，JVM就认为你已经处理了该异常，其实你什么也没有做，这样就使很多的异常可能隐藏起来了。 Exception信息输出 在每一个catch到一个异常的时候，在调试状态下请使用ex.printStackTrace()来输出错误信息；在运行状态下请使用ex.getMessege()来输出错误信息。通常情况下应该加上比较容易读懂的中文信息的输出。 性能优化（推荐标准） 避免不必要的对象构造不要在循环中构造和释放对象使用 StringBuffer 对