java编程规范第三版.docx
- 文档编号:28663
- 上传时间:2022-10-01
- 格式:DOCX
- 页数:10
- 大小:17.88KB
java编程规范第三版.docx
《java编程规范第三版.docx》由会员分享,可在线阅读,更多相关《java编程规范第三版.docx(10页珍藏版)》请在冰豆网上搜索。
java编程规范第三版
竭诚为您提供优质文档/双击可除
java编程规范第三版
篇一:
java编程的标准之jaVa编程规范
java编程的标准之jaVa编程规范简介
本文提供一整套编写高效可靠的java代码的标准、约定和指南。
它们以安全可靠的软件工程原则为基础,使代码易于理解、维护和增强。
而且,通过遵循这些程序设计标准,你作为一个java软件开发者的生产效率会有显著提高。
经验证明,若从一开始就花时间编写高质量的代码,则在软件开发阶段,对代码的修改要容易很多。
最后,遵循一套通用的程序设计标准将带来更大的一致性,使软件开发团队的效率明显提高。
最根本的原则:
运用常识。
当找不到任何规则或指导方针,当规则明显不能适用,当所有的方法都失效的时侯:
运用常识并核实这些基本原则。
这条规则比其它所有规则都重要。
常识是必不可少的。
程序设计标准
java的程序设计标准很重要,原因在于它将提高开发团队各成员的代码的一致性。
一致性的提高会使代码更易理解,这意味着它更易开发和维护。
从而降低了应用程序的总开发成本。
你必须牢记的是:
你的java代码在你已离开并开始另一个项目之后,会保留相当长的一端时间。
因此开发过程中一个很重要的目标就是要确保在开发成员或开发团队之间的工作可以顺利交接,不必花很大的力气便能理解已编写的代码,以便继续维护和改进以前的工作。
如果代码难以理解,很有可能被废弃和重写。
命名约定
我们将在整个标准中讨论命名约定,所以让我们先讨论几个基本点:
1.使用可以准确说明变量/字段/类的完整的英文描述符。
例如,采用类
似firstname,grandtotal或corporatecustomer这样的名字。
虽
然象x1,y1或fn这样的名字很简短,输入起来容易,但是我们
难以知道它们代表什么、结果是什么含义,因而使代码难以理解、
维护和改进。
2.采用该领域的术语。
如果用户称他们的“客户”(clients)为“顾客”
(customers),那么就采用术语customer来命名这个类,而不用
client。
许多程序开发者会犯的一个错误是,不去使用工业或领域里
已经存在着很完美的术语时,却生造出一些普通词汇。
3.采用大小写混合,提高名字的可读性。
一般应该采用小写字母,但是
类和接口的名字的首字母,以及任何中间单词的首字母应该大写。
4.尽量少用缩写,但如果一定要使用,就要谨慎地使用。
这意味着应该
保留一个标准缩写的列表,明智地从中选取,并且在使用时保持一
致。
例如,想对单词“number”采用缩写,那么可从nbr,no或者num
中选取一个,说明一下采用了哪一个(具体是哪个倒无所谓),并且
只使用这一种形式。
5.避免使用长名字(最好不超过15个字母)。
虽然
physicalorVirtualproductorservice看起来似乎是个不错的类名,
但是这个名字太长了,应该考虑重新给它起个短一点的名字,比如
象offering。
6.避免使用相似或者仅在大小写上有区别的名字。
例如,不应同时使用
变量名persistentobject和persistentobjects,以及
ansqldatabase和ansqldatabase。
7.避免使用下划线作为名字的首末字母。
以下划线为首末字母的名字通
常为系统保留,除预处理定义之外,一般不用作用户命名。
更重要
的是,下划线经常造成麻烦而且难输入,所以尽量避免使用。
注释约定
我们还会对注释约定进行讨论,所以,我们先谈谈一些基本点:
1.注释应该增加代码的清晰度。
代码注释的目的是要使代码更易于被同
时参与程序设计的开发人员以及其他后继开发人员理解。
2.如果你的程序不值得注释,那么它也很可能也不值得运行[nag95]。
3.避免使用装饰性内容,也就是说,不要使用象广告横幅那样的注释语
句。
二十世纪六十年代和七十年代,cobol程序员们养成了画框
的习惯,典型的是用星号将他们的内部注释圈起来。
当然,这给他
们的艺术创造欲一个发泄方式,但是坦白地说,这只是在大量浪费
时间,并不能给最终的产品增加丝毫价值。
要写的是清晰的代码,
不是外表可爱的代码。
此外,由于有些字体的显示和打印是成比例
的,但有些又不是,所以无法将那些框排整齐。
4.保持注释的简洁。
最好的注释应该是简单明了的注释。
注释不必洋洋
洒洒,只需提供足够的信息,使别人能够理解你的代码。
5.先写注释,后写代码。
写代码注释的最好方法是在写代码之前就写注
释。
这使你在写代码之前可以想想代码的功能和运行。
而且这样确
保不会遗漏注释。
另一种方法是边写代码边写注释。
因为注释可以
使代码更易理解,所以在程序开发的过程中,也可以利用这一点。
如果打算花些时间写注释,那么至少你应从这个过程中获得些什么
[amb98]。
6.注释信息不仅要包括代码的功能,还应给出原因。
例如,下面例1中
的代码显示金额在$1,000以上(包括$1,000)的定单可给予5%
的折扣。
为什么要这样做呢?
难道有一个商业法则规定大额定单可
以得到折扣吗?
这种给大额定单的特殊是有时限的呢,还是一直都
这样?
最初的程序设计者是否只是由于慷慨大度才这样做呢?
除非
它们在某个地方(或者是在源代码本身,或者是在一个外部文档里)
被注释出来,否则你不可能知道这些。
例1.1
if(grandtotal>=1000.00)
{
grandtotal=grandtotal*0.95;
}
java注释语句类型
java有三种注释语句风格:
以/**开始,*/结束
的文档注释,以/*开始,以*/结束的c语言风格
注释,以及以//开始,代码行末尾结束的单行注释。
下表是对各类注释语句建议用法的一个概括,也给出
了几个例子。
一件很重要的事情是,你的机构应该制订一套如何使
用c语言风格注释和单行注释的标准,并始终严格
遵守。
使用一种注释方式来说明业务逻辑,使用另一
种方式注释掉旧的代码。
业务逻辑采用单行注释,因
为这样可以将注释和代码放在同一行(这又叫做“内
联”)。
采用c语言风格的注释屏蔽掉旧的代码,
因为这样可以同时注释掉数行。
c语言风格注释看起
来很象文档注释,所以为了防止混淆,不应在别处使
用。
注意行末注释。
[mco93]强烈反对采用行内注释,即
在一行的末尾加上注释。
他指出,这种注释必须在代
码的右端对齐,这样才能避免代码结构看起来混乱。
结果,这些注释的格式难以划一。
“如果你使用了很
多这样的注释,则要花时间去将它们排列整齐。
这些
时间并没有花在更多地了解代码上,而完全花在了敲
击空格键和制表符这种冗长乏味的工作上。
”他又指
出,行末注释也难以维护。
因为当该行程序的代码加
长时,它们会将这些注释挤出该行,如果你将它们排
齐了,你不得不对余下的注释做同样的工作。
快速浏览javadoc
sun公司的javadevelopmentkit(jdk)中有一个
名为javadoc的程序。
它可以处理java的源代码
文件,并且为java程序产生html文件形式的外部
注释文档。
javadoc支持一定数目的标记,标识注释
文档中各段起始位置的保留字。
详情请参考jdk
javadoc文档。
你注释代码的方式很大地影响着你的工作效率以及所有维护改进代码的后继开发者的工作效率。
在软件开发过程中及早注释代码,会促使你在开始撰写代码之前仔细考虑这些代码,从而带来更高的工作效率。
而且,当你重新阅读数天前或者数星期前所写的代码时,你可以很容易地判断出当时你是怎么想的,因为这一切都有记录。
篇二:
java编程规范_参考
java编码规范
制定本编程格式的目的是为了使软件可读性好、兼容性好、易维护等等。
注:
加(*)者为重要保证要求。
一、命名规范
1.1package的命名(*)
package的名字应由一个小写单词组成。
为了保证包的唯一性,一般以公司国际域名开头。
例如:
com.elanbase.db。
1.2class的命名(*)
class的名字必须由大写字母开头,并且其它单词的首写字母也要大写。
例如:
dbaccess。
1.3class成员属性及变量的命名(*)
变量/成员属性的名字用一个小写字母开头,后面的单词以大写字母开头。
例如:
privatestringlastname;
1.4常量的命名(*)
java里的常量,是用staticfinal修饰的,应该用全大写加下划线命名,并且常量名应尽量指出完整含义。
如:
publicstaticfinalstringoRacle_db_dRiVeR="oracle.jdbc.driver.oracledriver";
1.5数组的命名
数组应该总是用下面的形式来命名:
byte[]buffs;
而不是:
bytebuffs[];
1.6方法的参数
和变量的命名规范一致,且应使用有意义的参数命名,如果可能的话,使用和要赋值的属性一样的名字,如:
setcounter(intsize){
this.size=size;
}
1.7方法命名(*)
用一个小写字母开头,后面的单词以大写字母开头。
应意义明确,对于属性的存取方法,应使用getxxx()和setxxx()名称,以isxxx(),hasxxx()来命名返回值为boolean类型的方法。
1.8一般命名注意事项
a.用有意义的名字命名变量
首先,用完整的英语单词或约定俗成的简写命名变量,鼓励多用约定俗成的简写命名变量。
例如:
publicstringzipcode
publicinterrno
b.用复数命名collection类变量
collection,包括数组,Vector等。
命名时使用复数:
例如:
publiccollectioncustomers
二、java源文件样式
java(*.java)源文件应遵守如下的样式规则
2.1class代码布局:
package
javadoc注释或者其它文件头注释
类声明
Fields声明
空行
构造函数
空行
克隆方法
空行
其它方法(不包括main)
空行
内部(inner)类
空行
main()方法
2.2版权信息
版权信息必须在java文件的开头,
例如:
/**
* title:
编码过滤器
* description:
该类实现把request请求编码为web.xml文件中所配置的字符集
* copyright:
copyright(c)20xx
* company:
华软软件学院
*@authorweiowen
*@version1.0
*/
2.3package/imports(*)
package行要在版权信息之前,中间空一行。
将import的classes归类,按顺序罗列:
a.java标准类(java.*)
b.java扩充类(javax.*)
c.第三方类
d.你的应用程序的类
每一类空一行。
注
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- java 编程 规范 第三