Java编程规范手册Word文件下载.doc
- 文档编号:13012687
- 上传时间:2022-10-02
- 格式:DOC
- 页数:14
- 大小:111KB
Java编程规范手册Word文件下载.doc
《Java编程规范手册Word文件下载.doc》由会员分享,可在线阅读,更多相关《Java编程规范手册Word文件下载.doc(14页珍藏版)》请在冰豆网上搜索。
1.2注释规范
注释类型
用途
例子
备注
文档注释
(/**………*/)
1.类(Class)
2.接口(Interface)
3.成员函数(MemberFunction)
4.属性(Attribute,Field)
的声明前面。
/**
Customer–Acustomerisanypersonororganizationthatwesellservicesandproductsto.
@authorS.W.Ambler
*/
由于Javadoc能文档注释中的某些特定元素,故文档注释通常用于书写项目文档。
多行注释
(/*………*/)
注释掉暂时不使用的代码。
/*
ThiscodewascommentedoutbyJ.T.KirkonDec9,1997becauseitwasreplacedbytheprecedingcode.Deleteitaftertwoyearsifitisstillnotapplicable.
.
..(thesourcecode)
表明这段源代码暂时不使用。
可能在以后会改变主意使用它。
必须说明原因。
单行注释
(//)
用于成员函数中说明:
1.程序逻辑
2.代码片断
3.临时变量声明等
//Applya5%discounttoallinvoices
//over$1000asdefinedbytheSarek
//generositycampaignstartedin
//Feb.of1995.
建议采用单行注释来进行代码中的说明性行为。
1.3注释的内容
名称
注释内容
Javadoc参数
参数
Arguments/Parameters
l参数类型
l用途
l使用的约束或者前提条件
l尽量给出一个示例
属性
Fields/Attributes
l属性描述
l所有可能的取值或取值范围
l示例
l并发中可能存在的问题
l可见性设置。
通常属性都设置为“私有”类型,如果设置不一样,请给出原因。
l@seeClassName
l@seeClassName#memberFunctionName
成员函数(外部)
MemberFunctions
l功能、用途以及编写该成员函数的原因
l输入的参数
l返回值
l该函数抛出的“例外”以及抛出的条件
l已知的缺陷
l可见性设置
l代码更改历史
l示例(如何调用该成员函数)
l可能的约束和前提条件
l并发性策略
l@paramnamedescription
l@returndescription
l@exceptionnamedescription
l@deprecated
l@since
成员函数(内部)
l注释局部变量
l注释复杂的代码
l注释控制结构,如分支、循环等,表明其控制流向及意图
l注释代码功能以及缘由
局部变量
LocalVariables
实例变量
InstanceVariables
类
Classes
l类的用途
l类实例的所有取值获取值范围
l已知的缺陷(通常在功能尚未完善时)
l类的开发/维护历史
l并发策略
l@author
l@version
接口
Interfaces
l功能、用途
l什么情况下适用该接口
l什么情况下不适用该接口
包
Packages
l文件名
l包名
l版权信息
l所涉及的相关包
l所包含的类
l开发/维护历史
2.命名
2.1原则
l采用有明确意义的英文单词全名(通常为名词、动词)作为描述符,但不宜于太长(一般不超过20个字符)。
l每一个代码行限制在80个字符以内
l采用常见的专业术语。
l混合大小写形式,便于阅读。
通常在定义名称时,采取名称中的每一个单词首字母大写(第一个单词首字母小写),其余字母小写的形式。
l尽量不要采用缩写形式,在其缩写已经被广泛接受的情况下,采用相应的缩写方式,如URL,HTML,XML等。
l虽然Java是大小写敏感的语言,但避免采用只是大小写不同的名称。
如lastName和LastName等
l避免使用下划线(_)以及$符号,特别是前导或后置下划线。
因为这些变量经常被用作系统变量。
只是在常数定义中,因采用大写形式而加入下划线以增加可读性。
2.2允许的缩写
缩写形式
message
msg
manager
mgr
database
Db
command
Cmd
implementation
impl
2.3命名规范
命名规范
Arguments/
Parameters
l该参数的英文单词
l第一个英文单词首字母小写
l集合参数采用复数形式
firstName
lastName
customers
Fields/
Attributes
l该属性的英文单词
l集合属性采用复数形式
warpSpeed
orderItems
布尔形Get函数
BooleanGetterMemberFunctions
lis+函数名
lhas+函数名
lcan+函数名
isPersistent()
isString()
一般Get函数
GetterMemberFunctions
lget+函数名
getFirstName()
getLastName()
getWarpSpeed()
Set函数
SetterMemberFunctions
lset+函数名
setFirstName()
setLastName()
setWarpSpeed()
成员函数
l尽量以一个英文动词开头
openFile()
addAccount()
测试函数
ltest+函数名
testOpenFile()
主要是便于系统测试。
在测试完成以后,可以搜索测试函数,将其注释调即可。
l第一个英文单词首字母小写,其余单词首字母大写
l不要采用仅仅是大小写不同的局部变量
grandTotal
customer
newAccount
l采用与对象意义相关的
l与普通变量命名法则相同
循环计数器
Loopcounters
l采用惯例
i,j,k,counter
例外
Exceptions
e
常数
Constants
l所有单词采用大写形式
l单词之间用下划线分隔,以便于阅读
MIN_BALANCE
DEFAULT_DATE
l所有单词的首字母均大写
Customer
SavingsAccount
Contactable
Prompter
Singleton
为了明确意义,通常最后一个单词有后缀,如“-able”、“-ible”和“-er”等。
l包中各标识符用句点(.)分隔
l由Sun公司发布的标准包是以“java”标识符开头的
l局部包由小写的标识符分隔而成
l全球发行的包由公司域名倒写而成
java.awt
persistence.mapping.rational
interface.screens
dao.www.interface.screens
dao.www.naisa.dispatcher
析构器
Destructors
lJava本身没有析构器,但可以激活名为finalize()的函数
finalize()
组件
Components/
Widgets
l组件描述符+类型全名
l第一个单词首字母小写
okButton
customerList
fileMenu
构建器
Constructors
l名字与类名完全相同
Customer()
SavingsAccount()
文件名
Files
l主类名+“.java”
Customer.java
SavingsAccount.java
四、格式
1.源文件基本组织
在源文件中,建议采用以下组织。
序号
内容
1
包注释
FILE:
MySourceFile.java
PACKAGE:
Copyright(c)2000NetDao,Inc.AllRightsReserved
Comments
History:
2000/10/20:
DeveloperName
Changesomecode
2000/09/12DeveloperName
AddMemberFunction
2000/09/01DeveloperName
Createthisfile
2
包名
package;
3
引入Java公共包
import;
4
引入第三方包
importcom.weblogic.*;
5
引入自己的项目包
6
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- Java 编程 规范 手册