欢迎来到天天文库
浏览记录
ID:17882393
大小:58.00 KB
页数:11页
时间:2018-09-08
《java编程规范92574》由会员上传分享,免费在线阅读,更多相关内容在教育资源-天天文库。
1、JAVA编程规范版本:2.01.应用范围本规范适用于J2EE开发的所有项目中,所有项目中的JAVA代码(含JSP/SERVLET,JAVABEAN,EJB)均应遵守这个规范。2.设计类和方法2.1.创建具有很强内聚力的类方法的重要性往往比类的重要性更容易理解,方法是指执行一个统一函数的一段代码。类常被错误的视为是一个仅仅用于存放方法的容器。有些开发人员甚至把这种思路作了进一步的发挥,将他们的所有方法放入单个类之中。之所以不能正确的认识类的功能,原因之一是类的实现实际上并不影响程序的执行。当一个工程被编译时,如果所有方法都放在单
2、个类中或者放在几十个类中,这没有任何关系。虽然类的数量对代码的执行并无太大的影响,但是当创建便于调试和维护的代码时,类的数量有时会带来很大的影响。类应该用来将相关的方法组织在一起。当类包含一组紧密关联的方法时,该类可以说具有强大的内聚力。当类包含许多互不相关的方法时,该类便具有较弱的内聚力。应该努力创建内聚力比较强的类。大多数工程都包含许多并不十分适合与其他方法组合在一起的方法。在这种情况下,可以为这些不合群的方法创建一个综合性收容类。创建类时,应知道“模块化”这个术语的含义是什么。类的基本目的是创建相当独立的程序单元。2.2
3、.创建松散连接和高度专用的方法2.2.1.使所有方法都执行专门的任务每个方法都应执行一项特定的任务,它应出色的完成这项任务。应避免创建执行许多不同任务的方法。创建专用方法有许多好处。首先调试将变得更加容易。2.2.2.尽量使方法成为自成一体的独立方法当一个方法依赖于其他方法的调用时,称为与其他方法紧密连接的方法。紧密连接的方法会使调试和修改变得比较困难,因为它牵涉到更多的因素。松散连接的方法优于紧密连接的方法,但你不可能使每个方法都成为独立的方法。若要使方法具备较强的独立性,方法之一是尽量减少类变量。创建方法时,设法将每个方法
4、视为一个黑箱,其他例程不应要求了解该方法的内部工作情况,该方法也不应要求了解它外面的工程情况。这就是为什么你的方法应依靠参数而不应依靠全局变量的原因。创建专用方法时,请考虑下列指导原则:1)将复杂进程放入专用方法。如果应用程序使用复杂的数学公式,请考虑将每个公式放入它自己的方法中。这样使用这些公式的其他方法就不包含用于该公式的实际代码。这样也可以更容易发现与公式相关的问题。2)将数据输入/输出(I/O)放入专用方法。3)将专用方法中可能要修改的代码隔离。如果你知道某个进程经常变更,请将这个多变的代码放入专用方法,以便以后可以更
5、容易的进行修改,并减少无意中给其他进程带来问题的可能性。4)将业务规则封装在专用方法中。业务规则常属于要修改的代码类别,应与应用程序的其余部分隔开。其他方法不应知道业务规则,只有要调用的方法才使用这些规则2.2.3.设计类和方法时,要达到下列目的:1)创建更加容易调试和维护的方法2)创建具有强大内聚力的类3)创建高度专用的方法4)创建松散连接的方法5)尽量使方法具有独立性6)提高方法的扇入性7)降低方法的扇出性2.3.编程原则2.3.1.为方法和类赋予表义性强的名字为了使代码更加容易理解,最容易的方法之一是为你的方法赋予表义性
6、强的名字。函数名DoIt、GetIt的可读性很难与CalculateSalesTax、RetrieveUserID相比。由缩写方法名组成的代码很难理解和维护,没有理由再这样做了。给方法正确的命名,可使程序工程的调试和维护工作大大的改观。请认真对待方法命名的工作,不要为了减少键入操作量而降低方法的可理解度。实际应用举例:1)给方法命名时应大小写字母混合使用。如果句子全使用大写字母,那么阅读起来就非常困难,而大小写字母混合使用的句子,阅读起来就很容易。2)定义方法名时不要使用缩写。如果你认为应用程序中的某些工程应使用缩写,那么请将
7、这些情况加上注释,并确保每个人在所有时间内都使用这些缩写。决不要在某些方法中对某些单词进行缩写,而在别的方法中却不使用缩写。2.3.2.为每个方法赋予单个退出点2.3.3.创建方法时,始终都应显式地定义它的作用域1)如果你真的想创建一个公用方法,请向代码阅读者说明这一点。2)通过为每个方法赋予一个明确定义的作用域,可以减少代码阅读者需要投入的工作量。应确保你为方法赋予最有意义的作用域。如果一个方法只被同一类中的另一个方法调用,那么请将它创建成私有方法。如果该方法是从多个类中的多个方法中调用,请将该说明为公用方法。2.3.4.用
8、参数在方法之间传递数据应尽量避免使用类变量。一般来说,变量的作用域越小越好。为了减少类变量,方法之一是将数据作为参数在不同方法之间传递,而不是让方法共享类变量。1)为每个参数指定数据类型。2)始终要对数进行检验,决不要假设你得数据没有问题。程序员常犯的一个错误是在编写方法时假
此文档下载收益归作者所有