java注释规范总结大全

合集下载

Java编程规范总结

Java编程规范总结

Java编程规范总结命名:1. 为包、类、⽅法、变量取⼀个好名字,使代码易于理解2. 禁⽌使⽤魔⿁数字3. 常量命名,由全⼤写单词组成,单词间⽤下划线分隔,且使⽤ static final修饰4. 变量、属性命名,使⽤名词,并采⽤⾸字母⼩写的驼峰命名法5. ⽅法的命名,⽤动词和动宾结构,并采⽤⾸字母⼩写的驼峰命名法6. 类和接⼝的命名,采⽤⾸字母⼤写的驼峰命名法7. 包的命名,由⼀个或若⼲个单词组成,所有的字母均为⼩写8. 数组声明的时候使⽤ int[] index,⽽不要使⽤ int index[]注释:1. 尽量⽤代码来解释⾃⼰2. 注释应解释代码的意图,⽽不是描述代码怎么做的3. 保证注释与代码⼀致,避免产⽣误导4. 注释应与其描述代码位置相邻,放在所注释代码上⽅或右⽅,并与代码采⽤同样缩进5. 不要⽤注释保留废弃代码6. 不要⽤注释记录修改⽇志7. ⼀般单⾏注释⽤//,块注释⽤,JavaDoc注释⽤排版:1. 团队应遵守⼀致的排版风格2. 将排版风格固化到IDE的代码格式化配置⽂件中,并让整个团队使⽤3. 在不同的概念之间,增加空⾏4. 将逻辑紧密相关的代码放在⼀起5. 控制⼀⾏的宽度,不要超过120个字符6. 在不同的概念间(关键字、变量、操作符等)增加空格,以便清楚区分概念7. 采⽤缩进来区分不同层次的概念8. 将局部变量的作⽤域最⼩化9. 给if、for、do、while、switch等语句的执⾏体加⼤括号{}10. 控制⽂件的长度,最好不要超过500⾏变量和类型:1. 谨慎使⽤静态成员变量2. 避免随意进⾏类型强制转换,应改善设计,或在转换前⽤instanceof进⾏判断33. 需要精确计算时不要使⽤float和double4. 不能⽤浮点数作为循环变量5. 浮点型数据判断相等不能直接使⽤==6. 避免同⼀个局部变量在前后表达不同的含义7. 不要在单个的表达式中对相同的变量赋值超过⼀次8. 基本类型优于包装类型,注意合理使⽤包装类型⽅法:1. ⽅法设计的第⼀原则是要短⼩2. ⽅法设计应遵循单⼀职责原则(SRP),⼀个⽅法仅完成⼀个功能3. ⽅法设计应遵循单⼀抽象层次原则(SLAP)4. ⽅法设计应遵循命令与查询职责分离原则(CQRS)5. 不要把⽅法的⼊参当做⼯作变量/临时变量,除⾮特别需要6. 使⽤类名调⽤静态⽅法,⽽不要使⽤实例或表达式来调⽤7. 应明确规定对接⼝⽅法参数的合法性检查由调⽤者负责还是由接⼝⽅法本⾝负责8. ⽅法的参数个数不宜过多9. 谨慎使⽤可变数量参数的⽅法包、类和接⼝:1. 类和接⼝的设计应遵循⾯向对象SOLID设计原则2. 类的设计应遵循迪⽶特法则3. 类的设计应遵循“Tell,Don't ask”原则4. 类设计时优选组合⽽不是继承5. 除提供给外部使⽤的全局常量外,应尽量避免类成员变量被外部直接访问6. 避免在⽆关的变量或⽆关的概念之间重⽤名字,避免隐藏(hide)、遮蔽(shadow)和遮掩(obscure)7. 覆写(override)——⼦类与⽗类间8. 重载(overload)——类内部9. 隐藏(hide)——⼦类与⽗类间10. 遮蔽(shadow)——类内部11. 遮掩(obscure)——类内部12. 不要在⽗类的构造⽅法中调⽤可能被⼦类覆写的⽅法13. 覆写equals⽅法时,应同时覆写hashCode⽅法14. ⼦类覆写⽗类⽅法时应加上@Override注解15. 接⼝定义中去掉多余的修饰词16. 设计时,考虑类的可变性最⼩化异常:1. 只针对真正异常的情况才使⽤exception机制2. 在抛出异常的细节信息中,应包含能捕获失败的信息3. 对可恢复的情况使⽤受检异常(checked exception),对编程错误使⽤运⾏时异常(runtime exception)4. 不要忽略异常5. ⽅法注释和⽂档中要包含所抛出异常的说明6. ⽅法抛出的异常,应该与本⾝的抽象层次相对应7. 对第三⽅API抛出⼤量各类异常进⾏封装8. 使⽤异常来做错误处理,⽽⾮错误码9. 在finally块中不要使⽤return、break或continue使finally块⾮正常结束10. 不要直接捕获受检异常的基类Exception11. ⼀个⽅法不应抛出太多类型的异常12. 充分利⽤断⾔⽇志:1. ⽇志信息准确、繁简得当,满⾜快速定位的需要2. ⽇志的记录,不要使⽤ System.out 与 System.err 进⾏控制台打印,应该使⽤专⽤的⽇志⼯具(⽐如:slf4j+logback)进⾏处理3. ⽇志⼯具对象logger应声明为private static final4. ⽇志应分等级5. ⽇志中不要记录敏感信息多线程并发:1. 多线程访问同⼀个可变变量,需增加同步机制2. 禁⽌不加控制地创建新线程3. 创建新线程时需指定线程名4. 使⽤Thread对象的setUncaughtExceptionHandler⽅法注册Runtime异常的处理者(v1.5+)5. 不要使⽤Thread.stop⽅法,因为该⽅法本质是不安全的,使⽤它可能会导致数据遭到破坏6. 不要依赖线程调度器、线程优先级和yield()⽅法7. 采⽤Java1.5提供新并发⼯具代替wait和notify(v1.5+)8. 使⽤线程安全集合在多线程间共享可变数据9. 多线程操作同⼀个字符串相加,应采⽤StringBuffer10. 针对线程安全性,需要进⾏⽂档(javadoc)说明运算和表达式:1. 不要写复杂的表达式2. 运算时应避免产⽣溢出3. 采⽤括号明确运算的优先级控制语句:1. 采⽤for-each代替传统的for循环(v1.5+)2. 在switch语句的每⼀个case、和default中都放置⼀条break语句序列化:1. 尽量不要实现Serializable接⼝2. 序列化对象中的HashMap、HashSet或HashTable等集合不能包含对象⾃⾝的引⽤3. 实现Serializable接⼝的可序列化类应该显式声明 serialVersionUID泛型:1. 在集合中使⽤泛型(v1.5+)2. 类的设计可优先考虑泛型(v1.5+)3. ⽅法的设计可优先考虑泛型(v1.5+)4. 优先使⽤泛型集合,⽽不是数组(v1.5+)其他语⾔特性:1. 新代码不要使⽤已标注为@deprecated的⽅法2. 使⽤JDK⾃带的API或⼴泛使⽤的开源库,不要⾃⼰写类似的功能。

java文档注释规范(一)

java文档注释规范(一)

java⽂档注释规范(⼀)https:///huangsiqian/article/details/82725214Javadoc⼯具将从四种不同类型的“源”⽂件⽣成输出⽂档:Java语⾔类的源⽂件(.java),包注释⽂件,概述注释⽂件和其他未处理的⽂件。

包注释⽂件(Package Comment File)每个包都有⾃⼰的⽂档注释。

有两种⽅式来创建包注释⽂件:package-info.java - 可以包含包的声明,包注解(anotation),包注释和Javadoc 标签(tag)。

包注释放在包声明之前。

这是JDK 5.0新引⼊的特性。

如下。

File: java/applet/package-info.java 注意:⽂档注释块内部⾏⾸的*号是可选的/*** Provides the classes necessary to create an applet and the classes an applet uses* to communicate with its applet context.* <p>* The applet framework involves two entities:* the applet and the applet context. An applet is an embeddable window (see the* {@link java.awt.Panel} class) with a few extra methods that the applet context* can use to initialize, start, and stop the applet.** @since 1.0* @see java.awt*/package ng.applet;package.html - 只能包含包注释和Javadoc标签,不能包含包注解。

java 开发规范

java 开发规范

java开发规范(一)java命名规范1、变量、成员、方法名统一采用驼峰命名(lowerCamelCase),做到见语知其义例子:变量——用户数据(userList)、方法——getUserData(int type)等。

说明:正常变量定义使用驼峰命名,特殊的如DTO\VO\DO等除外。

2、类名的定义(1)普通类名采用大写字母开始;(2)抽象类采用Abstract或Base开头。

例子:普通类——class UserModel,抽象类——abstract class AbstractUserDefinition等。

3、常量、类型、接口、子类的定义(1)常量使用全大写且单词之间用"_“隔开; (2)boolean变量不能使用is开头;(3)接口尽量不要修饰符、子类紧跟接口追加Impl。

例子:常量——SORT_TYPE,布尔类型——flag,接口——UserService,实现类——UserServiceImpl等。

说明:常量不可组装,需要原子性定义,不能出现"KEY”+SORT_TYPE 这种内部出现。

4、包名、异常、枚举、方法名称的定义(1)包名一律采用小写; (2)异常都采用_Exception结尾; (3)枚举都是以Enum结尾;(4)方法名称——根据方法内容采用如插入insert-*。

例子:异常——UserException,包名——com.test,枚举——UserEnum,方法名称——insertUser等。

5、领域模型定义规范:主要是以VO\DTO\DO等结尾例子:用户数据——UserDTO等(1)数据对象:xxxDO,xxx 即为数据表名。

(2)数据传输对象:xxxDTO,xxx为业务领域相关的名称。

(3)展示对象:xxxVO,xxx一般为网页名称。

(4)POJO是DO/DTO/BO/VO的统称,禁止命名成xxxPOJO。

(二)代码格式规范1、括号代码要求左大括号前不换行、左大括号后换行、右大括号前换行、右大括号后还有else等代码则不换行;表示终止的右大括号后必须换行。

java有效的注释说明

java有效的注释说明

java有效的注释说明Java是一种广泛使用的编程语言。

为了保证代码的清晰易懂以及方便后期维护,我们要给Java程序添加注释。

本文将从以下几个方面介绍Java有效的注释说明。

一、注释的种类Java程序中最常见的注释有三种:单行注释、多行注释、文档注释。

单行注释以"//"开头,多行注释以"/*"开头和"*/"结尾,文档注释以"/**"开头和"*/"结尾。

其中,文档注释最为重要,也最为常用。

二、文档注释的使用文档注释是Java程序中的重要注释,也是Java代码中最常用的注释之一。

文档注释可以让我们用简洁清晰的语言来描述代码的作用、参数、返回值等信息。

其具体写法如下:/*** <p>方法的作用</p>* @param 参数名参数说明* @return 返回值说明*/其中,p标签可以用来描述方法的作用,param标签用来描述参数的名称和说明,return标签用于描述方法的返回值。

三、注释的规范在Java中,注释也是需要遵循一定的规范的。

首先,注释应该写在被注释项的前面或者后面,不需要对齐代码。

其次,注释应该简洁明了,避免出现过于冗长的注释。

最后,避免在注释中出现包含比代码本身还复杂的格式和语法。

四、注释的使用场景注释的使用场景包括以下几个方面:首先,注释可以用来描述程序中的重要变量、方法、类的作用和功能。

其次,注释可以在调试程序时帮助快速定位问题所在。

最后,注释还可以在代码交接、阅读和修改时提供较为清晰的方向和思路。

综上所述,Java有效的注释是保证代码清晰易懂、方便维护的重要方面之一。

Java程序员应该养成良好的注释习惯,在代码编写上也应该注重注释的规范性、简洁性和对实际需求的协调性。

java优雅注释原则和代码格式列举

java优雅注释原则和代码格式列举

java优雅注释原则和代码格式列举Java作为一种高级编程语言,注释和代码格式是编写优雅代码的重要组成部分。

本文将列举一些优雅注释原则和代码格式,并提供一些指导意义,帮助读者编写结构清晰且易于阅读的Java代码。

第一条原则是注释的准确性。

注释应该准确描述代码的功能、目的和工作原理。

它们应该足够清晰,以便其他开发人员能够理解代码的意图,并依此进行修改或扩展。

此外,注释还应该包括关于代码的重要信息,例如输入和输出的格式,以及函数或方法的预期行为。

第二条原则是注释的简洁性。

注释应该尽可能简洁明了,避免冗余和重复的描述。

在编写注释时,应该考虑到读者的时间以及注释的可读性。

过长或太多的注释可能会使人感到困惑或厌倦,因此应该尽量保持简洁。

第三条原则是注释的规范性。

代码中的注释应该遵循一定的规范和格式。

这样可以增加代码的可读性,并帮助开发人员更快地理解代码。

例如,可以使用JavaDoc样式的注释,准确地描述方法的参数、返回值和异常。

此外,注释应该按照一定的结构和顺序编写,以增加阅读的连贯性。

除了注释,代码格式也是编写优雅代码的重要方面之一。

以下列举一些常见的代码格式原则。

第一条原则是代码缩进和对齐。

在Java中,使用空格或制表符来缩进代码,并保持一致的格式。

适当的缩进和对齐可以使代码的层次结构更加清晰,便于阅读。

第二条原则是空行的使用。

通过在代码的不同部分之间插入空行,可以增加代码的可读性,并帮助读者更好地理解代码的逻辑。

例如,在方法之间插入空行,以分隔不同功能的代码块。

第三条原则是适当地使用空格。

在Java中,应该在运算符前后、逗号和分号后添加空格,以增加代码的可读性。

这可以帮助他人更容易地理解代码的逻辑和计算。

第四条原则是使用适当的命名约定。

在Java代码中,变量、方法和类的命名应该具有描述性,并遵循一定的命名约定。

例如,变量名应该以小写字母开头,采用驼峰式命名法,以提高代码的可读性和可维护性。

通过遵循这些优雅注释和代码格式原则,开发人员可以编写结构清晰、易于阅读和维护的Java代码。

java代码注释规范

java代码注释规范

java代码注释规范展开全文一、规范存在的意义应用编码规范对于软件本身和软件开发人员而言尤为重要,有以下几个原因:1、好的编码规范可以尽可能的减少一个软件的维护成本, 并且几乎没有任何一个软件,在其整个生命周期中,均由最初的开发人员来维护;2、好的编码规范可以改善软件的可读性,可以让开发人员尽快而彻底地理解新的代码;3、好的编码规范可以最大限度的提高团队开发的合作效率;4、长期的规范性编码还可以让开发人员养成好的编码习惯,甚至锻炼出更加严谨的思维;二、命名规范1、一般概念1、尽量使用完整的英文描述符2、采用适用于相关领域的术语3、采用大小写混合使名字可读4、尽量少用缩写,但如果用了,必须符合整个工程中的统一定义5、避免使用长的名字(小于 15 个字母为正常选择)6、避免使用类似的名字,或者仅仅是大小写不同的名字7、避免使用下划线(除静态常量等)2、标识符类型说明1、包( Package )的命名Package 的名字应该采用完整的英文描述符,都是由一个小写单词组成。

并且包名的前缀总是一个顶级域名,通常是 com、edu、gov、mil、net、org 等;如: com.yjhmily.test2、类( Class )的命名类名应该是个一名词,采用大小写混合的方式,每个单词的首字母大写。

尽量保证类名简洁而富于描述。

使用完整单词,避免缩写词( 除非工程内有统一缩写规范或该缩写词被更广泛使用,像 URL , HTML)如: FileDescription3、接口( Interface )的命名基本与 Class 的命名规范类似。

在满足 Classd 命名规则的基础之上,保证开头第一个字母为”I”,便于与普通的 Class区别开。

其实现类名称取接口名的第二个字母到最后,且满足类名的命名规范;如: IMenuEngine4、枚举( Enum )的命名基本与 Class 的命名规范类似。

在满足 Classd 命名规则的基础之上,保证开头第一个字母为”E” ,便于与普通的 Class区别开。

JAVA代码注释规范

JAVA代码注释规范

JAVA代码注释规范目录JA V A代码注释规范 (1)注释的原则 (1)注释的简洁 (1)注释的一致性 (1)注释的位置 (2)注释的数量 (2)删除无用注释 (2)复杂的注释 (2)多余的注释 (2)必加的注释 (3)JA V A注释技巧 (3)JA V A注释具体实现 (4)源文件注释 (4)类(模块)注释: (5)接口注释: (5)构造函数注释: (6)方法注释: (6)方法内部注释: (7)全局变量注释: (7)局部(中间)变量注释: (7)常量 (7)p.s. 注释使用统一的注释文件 (8)注释的原则注释形式统一在整个应用程序中,使用具有一致的标点和结构的样式来构造注释。

如果在其他项目组发现他们的注释规范与这份文档不同,按照他们的规范写代码,不要试图在既成的规范系统中引入新的规范。

注释的简洁内容要简单、明了、含义准确,防止注释的多义性,错误的注释不但无益反而有害。

注释的一致性在写代码之前或者边写代码边写注释,因为以后很可能没有时间来这样做。

另外,如果有机会复查已编写的代码,在今天看来很明显的东西六周以后或许就不明显了。

通常描述性注释先于代码创建,解释性注释在开发过程中创建,提示性注释在代码完成之后创建。

修改代码的同时修改相应的注释,以保证代码与注释的同步。

注释的位置保证注释与其描述的代码相邻,即注释的就近原则。

对代码的注释应放在其上方相邻或右方的位置,不可放在下方。

避免在代码行的末尾添加注释;行尾注释使代码更难阅读。

不过在批注变量声明时,行尾注释是合适的;在这种情况下,将所有行尾注释要对齐。

注释的数量注释必不可少,但也不应过多,在实际的代码规范中,要求注释占程序代码的比例达到20%左右。

注释是对代码的“提示”,而不是文档,程序中的注释不可喧宾夺主,注释太多了会让人眼花缭乱,注释的花样要少。

不要被动的为写注释而写注释。

删除无用注释在代码交付或部署发布之前,必须删掉临时的或无关的注释,以避免在日后的维护工作中产生混乱。

java 代码规范

java 代码规范

java 代码规范Java代码规范是指在Java程序设计中遵循的一些规则和约定,旨在提高代码的可读性、可维护性和可移植性。

遵守代码规范可以帮助团队成员更好地理解和协作开发,提高代码的质量和可靠性。

本文将围绕Java代码规范展开讨论,包括命名规范、代码风格、注释规范、异常处理等方面的内容。

一、命名规范1.包名规范包名应该全小写,连接符可以使用小写字母和下划线,不推荐使用数字。

包名应该能够清晰地表达包所包含的内容,不要使用太长或者太短的包名。

2.类名规范类名应该采用驼峰命名法,首字母大写,类名应该能够清晰地表达类的用途,不要使用太长或者太短的类名。

如果类名由多个单词组成,应该遵循每个单词首字母大写的命名规范。

3.接口名规范接口名应该采用驼峰命名法,首字母大写,接口名应该能够清晰地表达接口的用途,不要使用太长或者太短的接口名。

如果接口名由多个单词组成,应该遵循每个单词首字母大写的命名规范。

4.变量名规范变量名应该采用驼峰命名法,首字母小写,变量名应该能够清晰地表达变量的用途,不要使用太长或者太短的变量名。

如果变量名由多个单词组成,应该遵循每个单词首字母小写的命名规范。

5.常量名规范常量名应该全大写,单词之间使用下划线分隔,常量名应该能够清晰地表达常量的用途,不要使用太长或者太短的常量名。

6.方法名规范方法名应该采用驼峰命名法,首字母小写,方法名应该能够清晰地表达方法的用途,不要使用太长或者太短的方法名。

如果方法名由多个单词组成,应该遵循每个单词首字母小写的命名规范。

二、代码风格1.缩进和空格缩进使用4个空格,不使用tab键。

在操作符前后使用空格,增强代码的可读性。

2.大括号的使用在类定义、方法定义、控制结构等的语句块后面使用大括号,增强代码的可读性。

3.代码行长度每行代码的长度不要超过80个字符,超过80个字符的代码应该使用换行符进行分割。

4.引号的使用字符串常量应该使用双引号,字符常量应该使用单引号。

java 注释标准

java 注释标准

java 注释标准在Java开发中,注释被广泛应用于代码的编写与维护过程中。

通过注释,开发人员可以为自己的代码添加解释说明,方便其他开发人员理解和使用代码。

本文将介绍Java中常用的注释标准,以及它们的使用方法与注意事项。

一、单行注释单行注释以"//"开头,用于对单行代码进行解释说明。

它可以出现在代码的任何位置,对该行代码进行注释,不会影响代码的执行。

例如:```javaint x = 10; // 定义一个整型变量x,初始值为10二、多行注释多行注释以"/*"开头,以"*/"结尾,用于对多行代码进行注释。

多行注释常用于对函数、类或一段代码的功能进行描述。

例如:```java/** 计算两个整数的和* @param a 整数1* @param b 整数2* @return 两个整数的和*/public int add(int a, int b) {return a + b;}三、文档注释文档注释以"/**"开头,以"*/"结尾,用于对类、接口、方法、字段等进行详细的描述。

文档注释是Java API文档的一部分,在生成API 文档时会被提取出来。

例如:```java/*** 学生类*/public class Student {/*** 学生姓名*/private String name;/*** 获取学生姓名* @return 学生姓名*/public String getName() {return name;}/*** 设置学生姓名* @param name 学生姓名*/public void setName(String name) { = name;}}四、注释的使用方法与注意事项1. 注释应该简洁明了,使用清晰的语言描述代码的功能、用途、参数、返回值等信息,以便其他开发人员理解和使用。

2. 注释应该与代码保持同步更新,避免注释与代码不一致的情况发生。

JAVA开发设计规范

JAVA开发设计规范

JAVA开发设计规范JAVA开发设计规范是指在进行JAVA开发过程中,为了统一编码风格、提高代码可读性和可维护性而制定的一系列约定和规范。

本文将从命名规范、代码布局规范、注释规范、异常处理规范、编码规范等方面介绍JAVA开发设计规范。

1.命名规范变量、方法和类名应使用有意义的英文单词或缩写,遵循驼峰命名法。

-变量名应代表该变量的含义,且不使用无意义的单字母命名。

-方法名应清晰表达方法的功能和作用。

-类名应使用名词或名词短语,首字母大写。

2.代码布局规范-使用缩进方式使代码结构清晰可读。

-使用空行分隔不同的功能块。

-代码行长度应限制在80个字符之内,方便查看和打印。

3.注释规范-对于每个类、方法和成员变量,都应添加必要的注释说明其功能和用法。

-注释应该与代码同步更新,并保持准确性。

-注释应使用简洁明了的语言,不应包含冗余信息。

4.异常处理规范- 在代码中必须使用try-catch块处理可能抛出的受检异常。

- 不应使用catch(Exception e)的方式处理异常,在catch块中应提供相应的处理逻辑。

- 应避免在catch块中直接打印异常信息,而是应使用日志框架打印异常。

5.编码规范-尽量使用局部变量而不是全局变量。

-代码中不应包含硬编码的常量,应使用常量变量或配置文件存储。

-代码中应避免使用魔法数字,而使用有意义的命名常量代替。

-尽量避免使用复杂的表达式和语句,提高代码的可读性。

以上只是JAVA开发设计规范的一部分。

在实际开发过程中,还应根据团队的需求和实际情况进行适当的调整和补充。

良好的编码规范可以提高代码的可读性、可维护性和可扩展性,从而提高开发效率和代码质量。

同时,开发人员应定期进行代码审查和重构,以保证代码的质量和规范的执行。

代码注释规范

代码注释规范

代码注释规范代码注释在软件开发中扮演着至关重要的角色。

它不仅向其他开发者传递了有关代码功能的关键信息,还能帮助团队成员更好地理解和维护代码。

因此,遵循统一的代码注释规范是十分必要的。

本文将介绍一些常见的代码注释规范,以帮助开发者编写清晰、易读的注释。

1. 注释格式代码注释应该采用统一的注释格式,以增加代码可读性。

以下是几种常见的注释格式:1.1 单行注释单行注释适用于简短的注释内容,通常放在代码行的上方。

注释内容与注释符号之间应有一个空格。

```java// 这是一个单行注释的示例```1.2 块注释块注释用于较长的注释内容,通常放在代码块的上方。

注释内容与注释符号之间应有一个空格。

```java/** 这是一个块注释的示例*/```2. 注释内容好的注释应该准确地描述代码的功能和意图,增加代码可读性。

以下是一些常见的注释模板,开发者可以根据实际情况选择适用的模板。

2.1 类注释类注释用于描述类的功能、用途和作者等信息。

```java/*** 类名:ClassName* 功能:描述类的功能* 作者:作者姓名* 时间:编写日期*/```2.2 方法注释方法注释应该清晰地描述方法的功能、参数、返回值和异常等信息。

```java/*** 方法名:methodName* 功能:描述方法的功能* 参数:* - param1 参数1的描述* - param2 参数2的描述* 返回值:返回值的描述* 异常:可能抛出的异常*/```2.3 变量注释变量注释应该描述变量的含义、作用和取值范围等信息。

```java/*** 变量名:variableName* 含义:变量的含义和作用* 取值范围:变量的取值范围* 默认值:变量的默认值*/```3. 注释注意事项在编写代码注释时,还需注意以下几点:3.1 更新及时注释应该与代码保持同步,并及时更新。

当代码发生变化时,相应的注释也应进行相应的修改,以保持一致性。

3.2 简洁明了注释应该简洁明了,不要冗长而又模糊不清。

java注解类型命名规则

java注解类型命名规则

在Java 中,注解的命名规则与其他标识符的命名规则类似。

以下是一些通用的命名规则和建议:
1. 首字母小写驼峰式命名:注解的名称应该以小写字母开头,并且采用驼峰式命名法。

例如:`myAnnotation`。

2. 使用清晰、有意义的名字:注解的名称应该能够准确地描述它所表示的含义或功能。

3. 避免使用保留字或关键字:不要将注解的名称选为Java 的保留字或关键字,以避免编译错误。

4. 使用名词或名词短语:注解的名称应该使用名词或者能够表示名词短语的形式,以便更好地描述被注解的元素。

5. 使用后缀`Annotation`:为了明确表示一个标注是一个注解类型,可以在注解名称后添加`Annotation` 后缀,以示区分。

例如:`MyAnnotationAnnotation`。

Java项目命名规范

Java项目命名规范

Java项目命名规范一、命名规范1、项目名全部小写2、包名全部小写3、类名首字母大写,如果类名由多个单词组成,每个单词的首字母都要大写。

如:public class MyFirstClass{}4、变量名、方法名首字母小写,如果名称由多个单词组成,每个单词的首字母都要大写。

如:int index=0;public void toString(){}5、常量名全部大写如:public static final String GAME_COLOR=”RED”;6、所有命名规则必须遵循以下规则:1)、名称只能由字母、数字、下划线、$符号组成2)、不能以数字开头3)、名称不能使用JAVA中的关键字。

4)、坚决不允许出现中文及拼音命名。

二、注释规范1、类注释在每个类前面必须加上类注释,注释模板如下:/*** Copyright (C), 2006-2010, ChengDu Lovo info. Co., Ltd.* FileName: Test.java* 类的详细说明** @author 类创建者姓名* @Date 创建日期* @version 1.00*/2、属性注释在每个属性前面必须加上属性注释,注释模板如下:/** 提示信息*/private String strMsg = null;3、方法注释在每个方法前面必须加上方法注释,注释模板如下:/*** 类方法的详细使用说明** @param 参数1 参数1的使用说明* @return 返回结果的说明* @throws 异常类型.错误代码注明从此类方法中抛出异常的说明*/4、构造方法注释在每个构造方法前面必须加上注释,注释模板如下:/*** 构造方法的详细使用说明** @param 参数1 参数1的使用说明* @throws 异常类型.错误代码注明从此类方法中抛出异常的说明*/5、方法内部注释在方法内部使用单行或者多行注释,该注释根据实际情况添加。

java编码规范_缩进和注释

java编码规范_缩进和注释

java编码规范_缩进和注释1. 缩进排版(Indentation)4个空格常被作为缩进排版的⼀个单位。

缩进的确切解释并未详细指定(空格 vs. 制表符)。

⼀个制表符等于n个空格(视具体的编辑器⽽定,Eclipse默认⼀个制表符为4个字符)。

3.1 ⾏长度(Line Length)尽量避免⼀⾏的长度超过80个字符,因为很多终端和⼯具不能很好处理之。

注意:鉴于Eclipse开发⼯具⼯作区的左侧和右侧都被⾮代码编辑器所占据,因此建议每⾏的代码长度不要超过70个字符。

3.2 换⾏(Wrapping Lines)当⼀个表达式⽆法容纳在⼀⾏内时,可以依据如下⼀般规则断开之:·在⼀个逗号后⾯断开;·在⼀个操作符前⾯断开;·宁可选择较⾼级别(higher-level)的断开,⽽⾮较低级别(lower-level)的断开;·新的⼀⾏应该与上⼀⾏同⼀级别表达式的开头处对齐。

·如果以上规则导致你的代码混乱或者使你的代码都堆挤在右边,那就代之以缩进8个空格,或者以调⽤参数的⾸个括号对齐,或者以⾸个运对齐。

以下是断开⽅法调⽤的⼀些例⼦:someMethod(longExpression1, longExpression2, longExpression3,longExpression4,longExpression5);var = someMethod1(longExpression1,someMethod2(longExpression2, longExpression3));以下是两个断开算术表达式的例⼦。

前者更好,因为断开处位于括号表达式的外边,这是个较⾼级别的断开。

longName1 = longName2 * ( longName3 + longName4 - longName5 ) +4 * longname6; //推荐使⽤longName1 = longName2 * ( longName3 + longName4- longName5 ) + 4 * longname6; //应避免这样使⽤以下是两个缩进⽅法声明的例⼦。

java代码编写规范

java代码编写规范

java代码编写规范Java代码编写规范是为了保持代码的一致性、可读性、可维护性和可扩展性而制定的一套规则。

以下是一些常见的Java代码编写规范:1. 命名规范:- 类名使用大写字母开头的驼峰命名法,如MyClass。

- 方法名使用小写字母开头的驼峰命名法,如myMethod。

- 变量名使用小写字母开头的驼峰命名法,并能直观地描述变量的含义,如myVariable。

- 常量名使用全大写的下划线命名法,如MAX_SIZE。

2. 缩进和空格:- 使用4个空格进行缩进,不要使用Tab键。

- 运算符之间加空格,如 a + b。

- 逗号之后加空格,如int a, int b。

- 括号之间加空格,如if (condition)。

- 方法和类的左括号不另起一行。

3. 注释规范:- 使用Javadoc格式进行注释,包括类、方法和成员变量的说明。

- 每个方法需说明参数、返回值和可能抛出的异常。

- 不要保留没有用的注释。

- 注释应该与代码保持一致,不要误导阅读者。

4. 类和方法的设计:- 类应该具有单一的职责,不要包含无关的功能。

- 方法应该具有清晰的目的和语义,不要过长或过于复杂。

- 类和方法应该尽量避免过多的参数,如果参数过多,可以考虑使用封装对象。

5. 异常处理:- 对于可能抛出的异常,应该根据情况进行合理的处理,而不是简单地忽略或抛出异常。

- 使用try-catch语句来捕获并处理异常,避免在代码中出现不受控制的异常。

6. 代码重构:- 定期进行代码重构,提高代码的可读性和可维护性。

- 删除无用的代码和注释。

- 提取公共代码块,避免重复的代码。

7. 包名和导入:- 包名应该以小写字母开头,使用有意义的命名。

- 导入语句应该只导入使用到的类,不要使用通配符导入。

8. 代码格式化:- 使用自动代码格式化工具来保持代码的一致性,如Eclipse 的代码格式化功能。

9. 单元测试:- 编写单元测试来验证代码的正确性和可靠性。

java语言三种注释的语法格式以及用途

java语言三种注释的语法格式以及用途

java语言三种注释的语法格式以及用途
Java语言中有三种注释方式,它们分别是:
1. 单行注释:
语法格式:使用两个斜杠(//)开始注释,后面跟随注释内容。

示例:
```java
// 这是一个单行注释
int x = 10; // 将 x 的值设为 10
```
用途:用于在一行中对代码进行简要说明,帮助开发者理解代码的功能和意图。

2. 多行注释:
语法格式:使用 / 开始注释,使用 / 结束注释。

示例:
```java
/
这是一个多行注释,可以跨越多行。

在这里说明代码的功能和作用。

/
int y = 20; / 将 y 的值设为 20 /
```
用途:用于对代码块进行详细说明,可以跨越多行。

通常用于解释复杂的代码逻辑或提供额外的信息。

3. Javadoc 注释:
语法格式:使用 / 开始注释,使用 / 结束注释。

这种注释方式也被称为Javadoc 注释。

示例:
```java
/
这是一个 Javadoc 注释,用于描述类的功能和属性。

在这里编写对类的描述信息。

/
public class MyClass { / ... / }
```
用途:用于生成 Javadoc 文档。

通过 Javadoc 工具,可以将注释解析为HTML 格式的文档,提供给开发人员参考和查阅。

java开发规范文档

java开发规范文档

java开发规范文档Java开发规范文档一、命名规范:1.类名使用大驼峰命名法,首字母大写。

2.方法名使用小驼峰命名法,首字母小写。

3.变量名使用小驼峰命名法,首字母小写。

4.常量名使用全大写字母,多个单词之间用下划线连接。

二、代码风格规范:1.代码缩进使用4个空格,不使用制表符。

2.每行代码尽量不超过80个字符。

3.每个方法应该有注释说明其作用。

4.使用行注释或块注释对代码进行注释。

三、类结构规范:1.每个源文件只包含一个类,类名与文件名保持一致。

2.类的字段应该在声明处进行初始化。

3.类的方法按照功能进行分组,相似功能的方法放在一起。

4.类的字段和方法应该用private修饰,对外提供访问的方法使用public修饰。

四、包规范:1.包名采用小写英文字母,多个单词之间用点号(.)分隔。

2.包名应该能够反映出所包含类的功能和用途。

五、注释规范:1.源文件开头应该包含版权声明和作者信息。

2.对于每个类、方法及其参数,应该提供注释,说明其作用和用途。

3.注释应该简洁明了,尽量使用英文。

六、异常处理规范:1.不要在catch块中使用空的catch块。

2.能够处理的异常应该在模块内进行处理,不能处理的异常应该抛出。

七、代码排版规范:1.应该将相关的变量和方法放在一起。

2.应该根据代码逻辑来进行代码的排版,让代码易于阅读。

八、代码复用规范:1.不要重复编写相同功能的代码,应该进行代码复用。

2.可以将公共的代码封装成方法或类,供其他地方使用。

九、版本控制规范:1.使用版本控制工具进行源代码的管理。

2.提交代码前进行代码的版本比较和合并。

以上是Java开发规范的一些常见规范,开发人员应该遵守这些规范,以便提高代码的可维护性和可读性。

规范的遵守可以减少代码的错误和提高代码的质量,有助于团队的合作和项目的开发进度。

java注释书写规范

java注释书写规范

Java注释书写规范Javadoc是Sun公司提供的一个技术,它从程序源代码中抽取类、方法、成员等注释形成一个和源代码配套的API帮助文档。

也就是说,只要在编写程序时以一套特定的标签作注释,在程序编写完成后,通过Javadoc就可以同时形成程序的开发文档了。

注释注释是指程序中的解释性文字。

这些文字供程序的阅读者查看,编译器将不对其进行编译。

注释能够帮助读者理解程序,并为后续进行测试和维护提供明确的指导信息。

注释要简明,恰到好处,没有注释的代码是糟糕编程习惯的显著标志。

基本原则注释应该增加代码的清晰度。

代码注释的目的是要使代码更易于被其他开发人员等理解。

避免使用装饰性内容。

保持注释的简洁。

注释信息不仅要包括代码的功能,还应给出原因。

不要为注释而注释。

除变量定义等较短语句的注释可用行尾注释外,其他注释应当避免使用行尾注释。

从用途上分,注释可以分为序言性注释和功能性注释。

序言性注释:通称位于程序或者模块的开始部分。

它给出了程序或模块的整体说明,这种描述不包括程序的执行过程细节。

功能性注释:一般嵌入在源程序体之中。

其主要描述某个语句或程序段做什么,执行该语句或程序段会怎样,不是解释怎么做。

只有复杂的执行细节才需要嵌入注释,描述其实现方法。

根据注释符的不同,在java程序中有三种注释。

行注释符“/ / ”编译器会认为以“/ /”开头的字符直至本行末尾都是注释,所以又称行注释。

它一般用于对某条语句或某个变量的注释,以及一些文字不多的注释。

块注释符“/ * ”和“*/ ”“/ * ”和“*/ ”是成对出现的,它们之间的文字都是注释。

这些注释可以分成多行不必再添加行注释符。

文档注释“/ ** ”和“*/ ”文档注释也是一种块注释,它是用来生成帮助文档的。

当程序员编写完程序以后,可以通过JDK提供的javadoc命令,生成所编程序的API文档,而文档中的内容主要就是从文档注释中提取的。

该API文档以HTML文件的形式出现,与java帮助文档的风格及形式完全一致。

  1. 1、下载文档前请自行甄别文档内容的完整性,平台不提供额外的编辑、内容补充、找答案等附加服务。
  2. 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
  3. 3、如文档侵犯您的权益,请联系客服反馈,我们会尽快为您处理(人工客服工作时间:9:00-18:30)。

在软件开发的过程中总是强调注释的规范,但是没有一个具体的标准进行说明,通常都是在代码编写规范中简单的描述几句,不能作为一个代码注释检查的标准和依据,做什么都要有一个依据吗:),现在我特整理了一个《Java的注释规范》,内容来自网络、书籍和自己的实际积累。

JA V A注释规范版本/状态作者版本日期1.0 ghc 2008-07-02一、背景1、当我们第一次接触某段代码,但又被要求在极短的时间内有效地分析这段代码,我们需要什么样的注释信息?2、怎么样避免我们的注释冗长而且凌乱不堪呢?3、在多人协同开发、维护的今天,我们需要怎么样的注释来保证高质、高交的进行开发和维护工作呢?二、意义程序中的注释是程序设计者与程序阅读者之间通信的重要手段。

应用注释规范对于软件本身和软件开发人员而言尤为重要。

并且在流行的敏捷开发思想中已经提出了将注释转为代码的概念。

好的注释规范可以尽可能的减少一个软件的维护成本, 并且几乎没有任何一个软件,在其整个生命周期中,均由最初的开发人员来维护。

好的注释规范可以改善软件的可读性,可以让开发人员尽快而彻底地理解新的代码。

好的注释规范可以最大限度的提高团队开发的合作效率。

长期的规范性编码还可以让开发人员养成良好的编码习惯,甚至锻炼出更加严谨的思维能力。

三、注释的原则1、注释形式统一在整个应用程序中,使用具有一致的标点和结构的样式来构造注释。

如果在其他项目组发现他们的注释规范与这份文档不同,按照他们的规范写代码,不要试图在既成的规范系统中引入新的规范。

2、注释的简洁内容要简单、明了、含义准确,防止注释的多义性,错误的注释不但无益反而有害。

3、注释的一致性在写代码之前或者边写代码边写注释,因为以后很可能没有时间来这样做。

另外,如果有机会复查已编写的代码,在今天看来很明显的东西六周以后或许就不明显了。

通常描述性注释先于代码创建,解释性注释在开发过程中创建,提示性注释在代码完成之后创建。

修改代码的同时修改相应的注释,以保证代码与注释的同步。

4、注释的位置保证注释与其描述的代码相邻,即注释的就近原则。

对代码的注释应放在其上方相邻或右方的位置,不可放在下方。

避免在代码行的末尾添加注释;行尾注释使代码更难阅读。

不过在批注变量声明时,行尾注释是合适的;在这种情况下,将所有行尾注释要对齐。

5、注释的数量注释必不可少,但也不应过多,在实际的代码规范中,要求注释占程序代码的比例达到20%左右。

注释是对代码的“提示”,而不是文档,程序中的注释不可喧宾夺主,注释太多了会让人眼花缭乱,注释的花样要少。

不要被动的为写注释而写注释。

6、删除无用注释在代码交付或部署发布之前,必须删掉临时的或无关的注释,以避免在日后的维护工作中产生混乱。

7、复杂的注释如果需要用注释来解释复杂的代码,请检查此代码以确定是否应该重写它。

尽一切可能不注释难以理解的代码,而应该重写它。

尽管一般不应该为了使代码更简单便于使用而牺牲性能,但必须保持性能和可维护性之间的平衡。

8、多余的注释描述程序功能和程序各组成部分相互关系的高级注释是最有用的,而逐行解释程序如何工作的低级注释则不利于读、写和修改,是不必要的,也是难以维护的。

避免每行代码都使用注释。

如果代码本来就是清楚、一目了然的则不加注释,避免多余的或不适当的注释出现。

9、必加的注释典型算法必须有注释。

在代码不明晰或不可移植处必须有注释。

在代码修改处加上修改标识的注释。

在循环和逻辑分支组成的代码中添加注释。

为了防止问题反复出现,对错误修复和解决方法的代码使用注释,尤其是在团队环境中。

10、注释在编译代码时会被忽略,不编译到最后的可执行文件中,所以注释不会增加可执行文件的大小。

四、JA V A注释技巧1、空行和空白字符也是一种特殊注释。

利用缩进和空行,使代码与注释容易区别,并协调美观。

2、当代码比较长,特别是有多重嵌套时,为了使层次清晰,应当在一些段落的结束处加注释(在闭合的右花括号后注释该闭合所对应的起点),注释不能写得很长,只要能表示是哪个控制语句控制范围的结束即可,这样便于阅读。

3、将注释与注释分隔符用一个空格分开,在没有颜色提示的情况下查看注释时,这样做会使注释很明显且容易被找到。

4、不允许给块注释的周围加上外框。

这样看起来可能很漂亮,但是难于维护。

5、每行注释(连同代码)不要超过120个字(1024×768),最好不要超过80字(800×600) 。

6、Java编辑器(IDE)注释快捷方式。

Ctrl+/ 注释当前行,再按则取消注释。

7、对于多行代码的注释,尽量不采用“/*......*/”,而采用多行“//”注释,这样虽然麻烦,但是在做屏蔽调试时不用查找配对的“/*......*/”。

8、注释作为代码切换开关,用于临时测试屏蔽某些代码。

例一://*/codeSegement1;//*/改动第一行就成了:/*/codeSegement1;//*/例二://----------------------第一段有效,第二段被注释//*/codeSegement1;/*/codeSegement2;//*/只需删除第一行的/就可以变成://----------------------第一段被注释,第二段有效/*/codeSegement1;/*/codeSegement2;//*/五、JA V A注释方法及格式1、单行(single-line)--短注释://……单独行注释:在代码中单起一行注释,注释前最好有一行空行,并与其后的代码具有一样的缩进层级。

如果单行无法完成,则应采用块注释。

注释格式:/* 注释内容*/行头注释:在代码行的开头进行注释。

主要为了使该行代码失去意义。

注释格式:// 注释内容行尾注释:尾端(trailing)--极短的注释,在代码行的行尾进行注释。

一般与代码行后空8(至少4)个格,所有注释必须对齐。

注释格式:代码+ 8(至少4)个空格+ // 注释内容2、块(block)--块注释:/*……*/注释若干行,通常用于提供文件、方法、数据结构等的意义与用途的说明,或者算法的描述。

一般位于一个文件或者一个方法的前面,起到引导的作用,也可以根据需要放在合适的位置。

这种域注释不会出现在HTML报告中。

注释格式通常写成:/** 注释内容*/3、文档注释:/**……*/注释若干行,并写入javadoc文档。

每个文档注释都会被置于注释定界符/**......*/之中,注释文档将用来生成HTML格式的代码报告,所以注释文档必须书写在类、域、构造函数、方法,以及字段(field)定义之前。

注释文档由两部分组成——描述、块标记。

注释文档的格式如下:/*** The doGet method of the servlet.* This method is called when a form has its tag value method* equals to get.* @param request* the request send by the client to the server* @param response* the response send by the server to the client* @throws ServletException* if an error occurred* @throws IOException* if an error occurred*/public void doGet (HttpServletRequest request, HttpServletResponse response)throws ServletException, IOException {doPost(request, response);}前两行为描述,描述完毕后,由@符号起头为块标记注释。

更多有关文档注释和javadoc的详细资料,参见javadoc的主页:/javadoc/index.html4、javadoc注释标签语法@author 对类的说明标明开发该类模块的作者@version 对类的说明标明该类模块的版本@see 对类、属性、方法的说明参考转向,也就是相关主题@param 对方法的说明对方法中某参数的说明@return 对方法的说明对方法返回值的说明@exception 对方法的说明对方法可能抛出的异常进行说明六、JA V A注释具体实现1、源文件注释源文件注释采用/** ……*/,在每个源文件的头部要有必要的注释信息,包括:文件名;文件编号;版本号;作者;创建时间;文件描述包括本文件历史修改记录等。

中文注释模版:/*** 文件名:* CopyRright (c) 2008-xxxx:* 文件编号:* 创建人:* 日期:* 修改人:* 日期:* 描述:* 版本号:*/2、类(模块)注释:类(模块)注释采用/** ……*/,在每个类(模块)的头部要有必要的注释信息,包括:工程名;类(模块)编号;命名空间;类可以运行的JDK版本;版本号;作者;创建时间;类(模块)功能描述(如功能、主要算法、内部各部分之间的关系、该类与其类的关系等,必要时还要有一些如特别的软硬件要求等说明);主要函数或过程清单及本类(模块)历史修改记录等。

英文注释模版:/*** CopyRright (c)2008-xxxx: <展望软件Forsoft >* Project: <项目工程名>* Module ID: <(模块)类编号,可以引用系统设计中的类编号>* Comments: <对此类的描述,可以引用系统设计中的描述>* JDK version used: <JDK1.6>* Namespace: <命名空间>* Author:<作者中文名或拼音缩写>* Create Date:<创建日期,格式:YYYY-MM-DD>* Modified By:<修改人中文名或拼音缩写>* Modified Date: <修改日期,格式:YYYY-MM-DD>* Why & What is modified <修改原因描述>* Version: <版本号>*/如果模块只进行部分少量代码的修改时,则每次修改须添加以下注释://Rewriter//Rewrite Date:<修改日期:格式YYYY-MM-DD> Start1:/* 原代码内容*///End1:将原代码内容注释掉,然后添加新代码使用以下注释://Added by//Add date:<添加日期,格式:YYYY-MM-DD> Start2://End2:如果模块输入输出参数或功能结构有较大修改,则每次修改必须添加以下注释://Log ID:<Log编号,从1开始一次增加>//Depiction:<对此修改的描述>//Writer:修改者中文名//Rewrite Date:<模块修改日期,格式:YYYY-MM-DD>2、接口注释:接口注释采用/** ……*/,在满足类注释的基础之上,接口注释应该包含描述接口的目的、它应如何被使用以及如何不被使用,块标记部分必须注明作者和版本。

相关文档
最新文档