Java代码编写规范(参考)

合集下载

阿里JAVA开发规范,助你写出更干净整洁的代码

阿里JAVA开发规范,助你写出更干净整洁的代码

阿⾥JAVA开发规范,助你写出更⼲净整洁的代码⼀、命名风格1.【强制】类名使⽤UpperCamelCase 风格,必须遵从驼峰形式,但以下情形例外:DO / BO / DTO / VO / AO2.正例:MarcoPolo / UserDO / XmlService / TcpUdpDeal /TaPromotion3.反例:macroPolo / UserDo / XMLService / TCPUDPDeal /TAPromotion4.【强制】⽅法名、参数名、成员变量、局部变量都统⼀使⽤lowerCamelCase 风格,必须遵从驼峰形式。

5.正例:localValue / getHttpMessage() / inputUserId6.【强制】常量命名全部⼤写,单词间⽤下划线隔开,⼒求语义表达完整清楚,不要嫌名字长。

7.正例:MAX_STOCK_COUNT 反例:MAX_COUNT8.【强制】抽象类命名使⽤Abstract 或Base 开头;异常类命名使⽤Exception 结尾;测试类命名以它要测试的类的名称开始,以Test 结尾。

9.【强制】Model 类中布尔类型的变量,都不要加is,否则部分框架解析会引起序列化错误。

10.反例:定义为基本数据类型Boolean isDeleted;的属性,它的⽅法也是isDeleted(),RPC框架在反向解析的时候,“以为”对应的属性名称是deleted,导致属性获取不到,进⽽抛出异常。

11.【强制】对于Service 和DAO 类,基于SOA 的理念,暴露出来的服务⼀定是接⼝,内部的实现类⽤Impl 的后缀与接⼝区别。

正例:CacheManagerImpl 实现CacheManager 接⼝。

12.【推荐】为了达到代码⾃解释的⽬标,任何⾃定义编程元素在命名时,使⽤尽量完整的单词组合来表达其意。

正例:从远程仓库拉取代码的类命名为PullCodeFromRemoteRepository 反例:变量int a;的随意命名⽅式。

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或⼴泛使⽤的开源库,不要⾃⼰写类似的功能。

项目编码规范(仅供借鉴)

项目编码规范(仅供借鉴)

项目代码编程规范1.应用范围本规范应用于采用J2EE规范的项目中,所有项目中的JAVA代码(含JSP,SERVLET,JAVABEAN,EJB)JS代码、HTML代码及数据库设计均应遵守这个规范。

同时,也可作为其它项目的参考。

2.设计类和方法2.1. 创建具有很强内聚力的类方法的重要性往往比类的重要性更容易理解,方法是指执行一个独立逻辑的一段代码。

类常被错误的视为是一个仅仅用于存放方法的容器。

有些开发人员甚至把这种思路作了进一步的发挥,将他们的所有方法放入单个类之中。

之所以不能正确的认识类的功能,原因之一是类的实现实际上并不影响程序的执行。

当一个工程被编译时,如果所有方法都放在单个类中或者放在几十个类中,这没有任何关系。

虽然类的数量对代码的执行并无太大的影响,但是当创建便于调试和维护的代码时,类的数量有时会带来很大的影响。

类应该用来将相关的方法组织在一起。

当类包含一组紧密关联的方法时,该类可以说具有强大的内聚力。

当类包含许多互不相关的方法时,该类便具有较弱的内聚力。

应该努力创建内聚力比较强的类。

大多数工程都包含许多并不十分适合与其他方法组合在一起的方法。

在这种情况下,可以为这些不合群的方法创建一个综合性收容类。

创建类时,应知道“模块化”这个术语的含义是什么。

类的基本目的是创建相当独立的程序单元。

2.2. 创建松散连接和高度专用的方法2.2.1.使所有方法都执行专门的任务每个方法都应执行一项特定的任务,它应出色的完成这项任务。

应避免创建执行许多不同任务的方法。

创建专用方法有许多好处。

首先调试将变得更加容易。

2.2.2.尽量使方法成为自成一体的独立方法当一个方法依赖于其他方法的调用时,称为与其他方法紧密连接的方法。

紧密连接的方法会使调试和修改变得比较困难,因为它牵涉到更多的因素。

松散连接的方法优于紧密连接的方法,但你不可能使每个方法都成为独立的方法。

若要使方法具备较强的独立性,方法之一是尽量减少类变量。

java代码规范(九)前后端规约

java代码规范(九)前后端规约

java代码规范(九)前后端规约1. 【强制】前后端交互的 API,需要明确协议、域名、路径、请求⽅法、请求内容、状态码、响应体。

说明: 1)协议:⽣产环境必须使⽤ HTTPS。

2)路径:每⼀个 API 需对应⼀个路径,表⽰ API 具体的请求地址:a)代表⼀种资源,只能为名词,推荐使⽤复数,不能为动词,请求⽅法已经表达动作意义。

b) URL 路径不能使⽤⼤写,单词如果需要分隔,统⼀使⽤下划线。

c)路径禁⽌携带表⽰请求内容类型的后缀,⽐如".json",".xml",通过 accept 头表达即可。

3)请求⽅法:对具体操作的定义,常见的请求⽅法如下:a) GET:从服务器取出资源。

b) POST:在服务器新建⼀个资源。

c) PUT:在服务器更新资源。

d) DELETE:从服务器删除资源。

4)请求内容:URL 带的参数必须⽆敏感信息或符合安全要求;body ⾥带参数时必须设置 Content-Type。

5)响应体:响应体 body 可放置多种数据类型,由 Content-Type 头来确定。

2. 【强制】前后端数据列表相关的接⼝返回,如果为空,则返回空数组[]或空集合{}。

说明:此条约定有利于数据层⾯上的协作更加⾼效,减少前端很多琐碎的 null 判断。

3. 【强制】服务端发⽣错误时,返回给前端的响应信息必须包含 HTTP 状态码,errorCode、errorMessage、⽤户提⽰信息四个部分。

说明:四个部分的涉众对象分别是浏览器、前端开发、错误排查⼈员、⽤户。

其中输出给⽤户的提⽰信息 要求:简短清晰、提⽰友好,引导⽤户进⾏下⼀步操作或解释错误原因,提⽰信息可以包括错误原因、上下⽂环境、推荐操作等。

errorCode:参考附表 3。

errorMessage:简要描述后端出错原因,便于错误排查⼈员快速定位问题,注意不要包含敏感数据信息。

正例:常见的 HTTP 状态码如下1) 200 OK: 表明该请求被成功地完成,所请求的资源发送到客户端。

JAVA编程规范(修订)

JAVA编程规范(修订)

JAVA编程规范1.1 Java文件名与文件组织结构1.一个java源文件不应该超过2 000行。

2.在Java源文件中应该包含一个单一的公共类(class)或接口(interface),这个公共类或公共接口,应该是这个源文件的第一个类或接口。

3.一个Java源文件一般由下面的顺序构成:(1)文件注释头(2)包名(package)(3)引入(import)声明(4)类(class)或接口(interface)的声明部分1.2 Java文件注释头Java类文件注释头是用来描述该类功能及其特点,以及相关开发信息的,如该类的关联类(通常情况下不描述Java系统核心类如java.util.Vector, ng.Thread等)、开发公司或单位、版权、作者、代码审定人该类所支持的JDK版本、该类版本、开发日期、最后更改日期、修改人、复审人等信息,下面就是一个Java类文件注释头:/****************************************************************** 该类功能及其特点的描述(例如:该类是用来……)** 该类未被编译测试过。

** @see(与该类相关联的类):(AnatherClass.java)*** 开发公司或单位:××软件有限公司研发中心** 版权:本文件版权归属××公司研发中心*** @author(作者):必胜利** @since(该文件所支持的JDK版本):Jdk1.3 或JDK1.42.在重点同时难以理解的地方另加注释。

方法体内的注释应该与其所描述的代码位于同一个层次上。

在一个块注释之前一般有一空白行用于做区分代码与注释的边界。

1.7 变量的声明初始化与放置1.7.1 变量声明1.在一般情况下我们建议每一行代码,只声明一个变量;2.如果变量名称较短并且又是同一数据类型同一结构类型,并且没有给变量初始化则可以在同一行声明;1.7.2 变量初始化尽量在变量声明的地方初始化,如果变量的初始化与有待于计算或处理后的值有关,则我们可以在取得这个值后对变量做初始化。

java代码格式规范

java代码格式规范

SOAR项目Java开发规范1. 引言 (2)2.文件 (2)3.命名规则 (3)3.1基本的规则 (3)3.2常量命名 (3)3.3变量命名 (3)3.4方法命名 (5)3.5类和接口的命名 (5)3.6包的命名 (6)4.注释规范 (6)4.1 基本规则 (6)4.2 Java中有三种注释方式说明 (6)4.2.1文档注释/** */ (6)4.2.2行注释// (7)4.2.3块注释:/* */ (7)4.3类/接口注释 (7)4.4 变量注释 (8)4.5 方法注释 (9)4.6 修改记录 (10)5.编码规范 (10)5.1基本原则 (10)5.2类编写规范 (14)5.3变量 (14)5.4方法 (15)5.5 语言使用及书写规范 (16)1. 引言软件开发涉及到各方面人员的交互、协作,为了有效地进行项目开发的沟通,完善代码的维护和交付,有必要在一个小组中采用统一的软件开发标准。

一般来说,制定这样的标准有下列好处:方便软件维护。

据统计,80%的软件开发费用在维护,规范化的代码才方便维护,降低维护成本。

在软件的整个生命期内,期望一个编码人员从开始到该软件报废一致维护其代码是不现实的,必然需要不断地交付、协同好的编码规范能够大大增强代码的可读性,便于开发人员快速的理解新代码。

任何产品都需要好的包装。

我们可以把代码本身看作是一种产品,那么按照规范编程也是对这个“产品”的包装规范化的代码也是软件质量的保证手段之一,也是软件过程能够流畅的基础。

我们每个人必须牢牢树立这样的观念:你今天所编写的代码,会一直使用很多年,并且很有可能被其他人维护和改进。

所以,我们必须努力写出“干净”和易读的代码。

本文档适用于软件开发过程中开发人员,主要包括编码人员、测试人员,开发人员,规范必须严格遵守,否则程序被视为不合格程序。

注:本规范中标红的内容为强制性遵循内容,开发人员必须遵守。

蓝色为强烈建议性内容,最好遵守,这样可以避免程序出现一些莫名奇妙的问题。

java代码方法书写顺序

java代码方法书写顺序

java代码方法书写顺序Java代码的方法书写顺序在代码的可读性和可维护性方面起着重要的作用。

良好的方法书写顺序可以使代码结构清晰,方便他人理解和修改。

本文将介绍一种常见的Java代码方法书写顺序,以帮助开发者编写更好的Java代码。

在Java代码中,可以按照以下的顺序书写方法:1. 类变量声明:首先声明类的静态变量(即使用static关键字修饰的变量),它们在整个类中都是可见的。

这些变量通常用来保存与该类相关的一般配置或共享数据。

2. 实例变量声明:接下来声明类的实例变量(即没有使用static关键字修饰的变量)。

这些变量通常用来保存每个对象的状态信息。

3. 构造方法:在声明变量后,编写类的构造方法。

构造方法在创建对象时被调用,用于初始化实例变量。

4. 公共方法:在构造方法之后,编写类的公共方法。

公共方法通常是供其他类调用的方法,因此应该放在较前的位置,方便其他程序员使用和查找。

5. 私有方法:在公共方法之后,编写类的私有方法。

私有方法通常是供类内部调用,用于实现一些具体的功能。

6. Getter和Setter方法:在私有方法之后,编写实例变量的Getter和Setter方法。

这些方法用于获取和设置实例变量的值,保证了封装性。

7. 静态方法:最后,编写类的静态方法。

静态方法是用于整个类的操作,不依赖于任何特定的实例。

按照这个顺序编写代码可以使类的结构和功能更加清晰,易于阅读和维护。

此外,还可以根据需要对方法进行分组,在每个分组内按照上述顺序进行排序。

除了方法的书写顺序,还应注意以下几点:1. 使用空行分隔不同类型的方法:为了提高代码的可读性,可以在不同类型的方法(类方法、实例方法、私有方法)之间添加空行。

2. 使用适当的注释:在每个方法之前,使用注释来解释方法的功能、参数、返回值等。

这样可以使其他程序员更容易理解代码的意图和用法。

3. 遵循命名规范:采用有意义的方法名,并遵循Java的命名规范。

JAVA编码(代码)规范(WORD版)

JAVA编码(代码)规范(WORD版)

Java编码规范及实践目录Java编码规范及实践 (1)1.2术语 (2)1.3约束 (3)||!(condition5 && condition6)) { (14)4.1一般命名规范 (14)IQuery, IDataAccess,IReportBuilder (15)MAX_TIMES, DEFAULT_NAME (15)4.2特殊命名规范 (17)AbstractReportBuilder,AbstractBeanFactory (18)AccessException, RuntimeException (19)5.2一般原则 (20)1.代码应该和注释保持同步,如果代码和注释不同步,则阅读代码的人会 (20)2.注释尽量简洁,尺度没有准确的定义,大部分人能明白即可,可以将自 (20)Result getResult() throws Exception{ (21)Object getAction(); (22)JavaDoc 工具不要改变格式. (22)Get a default date/time formatter that uses the SHORT (23)Thread.sleep(1000); (24)Derived,如果一个方法可以接受基类对象b 的话:method1(Base b), (25)7.1工厂模式 (26)7.1.1简单工厂 (26)7.1.2工厂方法 (26)7.2单例模式 (27)Client: (27)7.3适配器模式 (28)7.4组合模式 (29)Client: (29)7.5外观模式 (30)Client: (30)7.6代理模式 (31)7.7命令模式 (32)Client: (33)7.8观察者模式 (33)7.9策略模式 (35)Client: (35)IKeyPairGenerable desGenerator = (35)IKeyPairGenerable rsaGenerator = (36)IKeyPairGenerable ideaGenerator = (36)KeyPairManager manager = new KeyPairManager(); (36)7.10模版方法模式 (36)7.11参观者模式 (38)总价格 (40)Client: (40)第1章概述1.1前言代码之于程序员,就像零件之于机械工,庄稼之于农民,它是软件的基石,一行行代码都是程序员的心血经过日日夜夜凝结成的。

java伪代码标准

java伪代码标准

java伪代码标准在编写Java程序时,我们经常会用到伪代码来描述算法和逻辑结构。

伪代码是一种近似于编程语言的描述方式,它可以帮助我们更清晰地表达程序的逻辑,而不受具体编程语言的限制。

在编写Java伪代码时,我们需要遵循一定的标准,以确保代码的可读性和易理解性。

本文将介绍Java伪代码的标准格式和常用规范,帮助大家更好地编写清晰、规范的Java伪代码。

一、注释。

在编写Java伪代码时,注释是非常重要的。

注释可以帮助我们解释代码的用途、逻辑和实现细节,提高代码的可读性和可维护性。

在Java伪代码中,我们可以使用//来添加单行注释,使用/ /来添加多行注释。

在编写注释时,应尽量清晰、简洁地描述代码的功能和用途,避免出现冗长、复杂的注释内容。

二、命名规范。

在编写Java伪代码时,变量、函数和类的命名应该符合一定的规范。

变量名应该具有描述性,能够清晰地表达其用途和含义。

函数名应该能够准确地描述函数的功能和作用。

类名应该采用大驼峰命名法,即每个单词的首字母大写。

在编写Java伪代码时,应该遵循这些命名规范,以提高代码的可读性和可维护性。

三、缩进和格式化。

在编写Java伪代码时,应该遵循一定的缩进和格式化规范。

合适的缩进可以帮助我们清晰地表达代码的逻辑结构,提高代码的可读性。

在编写条件语句、循环语句和函数定义时,应该采用适当的缩进和格式化,使代码结构清晰、易于理解。

四、控制结构。

在编写Java伪代码时,应该遵循一定的控制结构规范。

条件语句应该具有清晰的逻辑判断和简洁的表达方式,避免出现冗长、复杂的条件判断。

循环语句应该具有清晰的循环条件和循环体,避免出现无限循环或者死循环的情况。

在编写控制结构时,应该注意代码的可读性和可维护性,避免出现混乱、难以理解的代码结构。

五、函数和方法。

在编写Java伪代码时,函数和方法的定义应该具有清晰的参数列表和返回值类型,能够准确地描述函数的功能和作用。

函数和方法的实现应该符合一定的规范,避免出现冗长、复杂的代码逻辑。

JAVA编码规范

JAVA编码规范

第二章重要规范
( 6 )服务端,对关键交易请求要素进行日志输出,交易处理完成后 输出处理结果; ( 7 )和外部系统交互,可将日志输出详细些,日志中尽量包括:请 求地址、内容、http响应码等状态信息、外部系统响应内容等信息; ( 8 )数据库操作,捕获SQLException并对异常进行输出,可增加数 据库操作错误排查; ( 9 )捕获异常后要对异常信息输出ERROR级别的日志,输出示例: logger.error(“XXX操作异常:”+e.getMassage(),e); ( 10 ) ERROR级别日志输出一般原则:对于由于系统原因造成业务 处理失败的事件,需要记录错误日志。非系统原因的业务处理失败, 不应该记录错误日志(推荐使用warn级别),避免错误日志过大,影 响紧急情况下的故障分析和诊断;
第三章命名规范
3、1包命名规则 java开发中产生的包分为两类,一类是与各业务系统相关的 包;另一类是与业务系统无关的、可公用的包。 规则:
包名应全部是小写字母; 包名中不能出现下划线和其他特殊字符; 第一个字母不能是数字。
示例:
与业务系统相关的包命名格式为:com. lianpay.<projectname>.<modulename>
其中:<projectname>为项目英文简称或缩写; <modulename>为模块英文名称或简称,如果无细分模块的话可 省略模块名。
与业务系统无关的、可公用的包:com. lianpay.share.<modulename>//所有项目通用
第三章命名规范
3.2类接口命名规则 规则:
类的名称应使用名词; 类和接口首字母必须大写,每个单词的首字母应大写(骆驼法 则); 接口名称应以大写I开始,接口实现类以Impl结尾。

代码编写规范精选文档

代码编写规范精选文档

代码编写规范精选文档 TTMS system office room 【TTMS16H-TTMS2A-TTMS8Q8-知识管理系统代码编写规范一、介绍本文档为《知识管理系统》代码编写规范,为保证代码风格的一致性和后期的可维护性,文档讲述的内容要求所有开发人员必须遵守。

本规范主要参考了Google Java Style,包括了其他一些业界约定俗成的公约和普遍采用的标准。

本规范并非最终标准,一些规定还需再做商讨。

术语说明本文档除非特殊说明,否则:1.类(class)统指普通类、枚举类、接口和注解类型。

2.注释(comment)只用来指实现注释(implementation comments)。

我们不使用“文档注释”这样的说法,而会直接说Javadoc。

其他“术语说明”,将在文档中需要说明的地方单独说明。

文档说明本文档中的代码并不一定符合所有规范。

即使这些代码遵循本规范,但这不是唯一的代码方式。

例子中可选的格式风格也不应该作为强制执行的规范。

二、源码文件基础文件名源文件以其最顶层的类名来命名,大小写敏感,文件扩展名为.java。

文件编码:UTF-8源码文件使用UTF-8编码。

特殊字符空格字符除了换行符外,ASCII 水平空白字符(0x20)是源码文件中唯一支持的空格字符。

这意味着:1.其他空白字符将被转义。

2.Tab字符不被用作缩进控制。

特殊转义字符串任何需要转义字符串表示的字符(例如\b,\t,\n,\f,\r,\",\'和\\等),采用这种转义字符串的方式表示,而不采用对应字符的八进制数(例如\012)或 Unicode 码(例如\u000a)表示。

非 ASCII 字符对于其余非ASCII字符,直接使用Unicode字符(例如∞),或者对应的Unicode 码(例如\u221e)转义都是允许的。

唯一需要考虑的是,何种方式更能使代码容易阅读和理解。

注意:在使用Unicode码转义,或者甚至是有时直接使用Unicode字符的时候,添加一点说明注释将对别人读懂代码很有帮助。

Java规范代码风格(阿里开发规范精简)

Java规范代码风格(阿里开发规范精简)

Java规范代码风格(阿⾥开发规范精简)制定代码规约的意义统⼀的代码风格可以让开发⼯程师们没有代码⼼理壁垒,每个⼈可以轻松阅读并快速理解代码逻辑,便于⾼效协作,逐步形成团队代码的风格。

⾼效标准统⼀,提升沟通效率和协作效率,好的编码规范可以最⼤限度的提⾼团队开发的合作效率。

质量长期的规范性编码还可以让开发⼈员养成好的编码习惯,甚⾄锻炼出更加严谨的思维,防患未然,提升质量意识,降低故障率和维护成本,快速定位问题。

情怀程序员应该追求代码的美、系统的美、设计的美,追求卓越的⼯匠精神,打磨精品代码。

命名【规范】类名使⽤UpperCamelCase 风格,必须遵从驼峰形式,但以下情形例外:(领域模型的相关命名)DO / BO / DTO / VO 等。

[正例]: MarcoPolo / UserDO / XmlService / TcpUdpDeal / TaPromotion[反例]: macroPolo / UserDo / XMLService / TCPUDPDeal / TAPromotion【规范】⽅法名、参数名、成员变量、局部变量都统⼀使⽤lowerCamelCase 风格,必须遵从驼峰形式。

[正例]:localValue / getHttpMessage() / inputUserId【规范】常量命名全部⼤写,单词间⽤下划线隔开,⼒求语义表达完整清楚,不要嫌名字长。

public static final String GET_APPLICATION_SETTINGS_BY_MESSAGE_NAME_AND_APP_NAME = "/v1/capp/common/getApplicationSettingsWithMessageNameAndAppName";【规范】抽象类命名使⽤ Abstract 或 Base 开头;异常类命名使⽤ Exception 结尾;测试类命名以它要测试的类的名称开始,以 Test 结尾。

java代码规范(三)代码格式

java代码规范(三)代码格式

java代码规范(三)代码格式1. 【强制】如果是⼤括号内为空,则简洁地写成{}即可,⼤括号中间⽆需换⾏和空格;如果是⾮ 空代码块则: 1)左⼤括号前不换⾏。

2)左⼤括号后换⾏。

3)右⼤括号前换⾏。

4)右⼤括号后还有 else 等代码则不换⾏;表⽰终⽌的右⼤括号后必须换⾏。

2. 【强制】左⼩括号和右边相邻字符之间不出现空格;右⼩括号和左边相邻字符之间也不出现空格;⽽左⼤括号前需要加空格。

详见第 5 条下⽅正例提⽰。

反例:if (空格 a == b 空格)3. 【强制】if/for/while/switch/do 等保留字与括号之间都必须加空格。

4. 【强制】任何⼆⽬、三⽬运算符的左右两边都需要加⼀个空格。

说明:包括赋值运算符=、逻辑运算符&&、加减乘除符号等。

5. 【强制】采⽤ 4 个空格缩进,禁⽌使⽤ Tab 字符。

说明:如果使⽤ Tab 缩进,必须设置 1 个 Tab 为 4 个空格。

IDEA 设置 Tab 为 4 个空格时,请勿勾选 Use tab character;⽽在 Eclipse 中,必须勾选 insert spaces for tabs。

正例:(涉及 1-5 点)public static void main(String[] args) {// 缩进 4 个空格String say = "hello";// 运算符的左右必须有⼀个空格int flag = 0;// 关键词 if 与括号之间必须有⼀个空格,括号内的 f 与左括号,0 与右括号不需要空格if (flag == 0) {System.out.println(say);}// 左⼤括号前加空格且不换⾏;左⼤括号后换⾏if (flag == 1) {System.out.println("world");// 右⼤括号前换⾏,右⼤括号后有 else,不⽤换⾏} else {System.out.println("ok");// 在右⼤括号后直接结束,则必须换⾏}}6. 【强制】注释的双斜线与注释内容之间有且仅有⼀个空格。

java代码开发规范

java代码开发规范

java代码开发规范Java代码开发规范(Java Coding Convention)是一组编写Java 代码的规范和约定,以提高代码的可读性、可维护性和可重用性。

下面是一个包含大约1000字的Java代码开发规范概述:1. 命名规范:- 类名使用大写开头的驼峰式命名法,如MyClass。

- 方法名和变量名使用小写开头的驼峰式命名法,如myMethod。

- 常量名使用全大写字母和下划线的命名法,如MY_CONSTANT。

- 包名使用全小写字母,可以使用多级包名,如com.example.myproject。

2. 缩进和空格:- 使用4个空格进行代码块缩进。

- 除了特殊情况,每行代码最多120个字符。

- 操作符前后加上空格,如a + b。

3. 注释:- 使用Javadoc风格的类、方法和变量注释。

- 注释应该简洁明了,不要使用废话或无关信息。

- 注释应该更新以反映代码的变化。

4. 源文件:- 每个源文件只包含一个公有类。

- 源文件应该以UTF-8编码保存。

- 导入语句应该按照字母顺序排序。

5. 类的结构:- 每个类应该包含类的成员变量、构造方法、公有方法和私有方法,按照这个顺序。

- 成员变量应该使用private修饰,并提供相应的getter和setter方法。

- 公有方法应该提供必要的参数检查和异常处理。

6. 代码块:- 使用大括号包围代码块,即使代码块只有一行。

- 尽量减少嵌套层次,避免深层次的if-else或循环嵌套。

- switch语句应该包含default情况,并在每个case结束后加上break。

7. 异常处理:- 每个抛出异常的方法都应该声明可能抛出的异常类型。

- 在需要捕获异常的地方使用try-catch语句,并处理异常。

8. 并发编程:- 尽量使用线程安全的类和方法。

- 保护共享资源时使用synchronized关键字或者Lock对象。

9. 测试代码:- 每个公有类应该有相应的单元测试类。

代码编写规范

代码编写规范

代码编写规范知识管理系统代码编写规范⼀、介绍本⽂档为《知识管理系统》代码编写规范,为保证代码风格的⼀致性和后期的可维护性,⽂档讲述的内容要求所有开发⼈员必须遵守。

本规范主要参考了Google Java Style,包括了其他⼀些业界约定俗成的公约和普遍采⽤的标准。

本规范并⾮最终标准,⼀些规定还需再做商讨。

1.1 术语说明本⽂档除⾮特殊说明,否则:1. 类(class)统指普通类、枚举类、接⼝和注解类型。

2. 注释(comment)只⽤来指实现注释(implementation comments)。

我们不使⽤“⽂档注释”这样的说法,⽽会直接说Javadoc。

其他“术语说明”,将在⽂档中需要说明的地⽅单独说明。

1.2 ⽂档说明本⽂档中的代码并不⼀定符合所有规范。

即使这些代码遵循本规范,但这不是唯⼀的代码⽅式。

例⼦中可选的格式风格也不应该作为强制执⾏的规范。

⼆、源码⽂件基础2.1 ⽂件名源⽂件以其最顶层的类名来命名,⼤⼩写敏感,⽂件扩展名为.java。

2.2 ⽂件编码:UTF-8源码⽂件使⽤UTF-8编码。

2.3 特殊字符2.3.1 空格字符除了换⾏符外,ASCII ⽔平空⽩字符(0x20)是源码⽂件中唯⼀⽀持的空格字符。

这意味着:1. 其他空⽩字符将被转义。

2. Tab字符不被⽤作缩进控制。

2.3.2 特殊转义字符串任何需要转义字符串表⽰的字符(例如\b, \t, \n, \f, \r, \", \'和\\等),采⽤这种转义字符串的⽅式表⽰,⽽不采⽤对应字符的⼋进制数(例如\012)或Unicode 码(例如\u000a)表⽰。

2.3.3 ⾮ASCII 字符对于其余⾮ASCII字符,直接使⽤Unicode字符(例如∞),或者对应的Unicode 码(例如\u221e)转义都是允许的。

唯⼀需要考虑的是,何种⽅式更能使代码容易阅读和理解。

注意:在使⽤Unicode码转义,或者甚⾄是有时直接使⽤Unicode字符的时候,添加⼀点说明注释将对别⼈读懂代码很有帮助。

java编码规范

java编码规范

编码规范1.编写目的本规范的目的在于编写可靠的、一致的、便于理解的JAVA源代码,并且写出的代码被其他人阅读,所有的JAVA代码保持良好的致性,容易在以后的阶段中进行维护和升级。

同时,也是为了通过一定时间的实践,增加我们的软件产品的投入产出量,以提高我们的工作效率。

2.适应范围适用于JAVA程序开发人员,或后续开发人员。

可以方便系统的开发与维护,使系统开发与维护可以顺利展开。

3.代码命名一般原则我们开发的是一个JSP新闻发布系统,用的编码方式是JAVA,因此用的命名总原则是:3.1.用全英文单词命名的方式,准确地描述变量、属性、类等。

如:使用firstNname、grandTotal、等命名就比x1、y1、fn等更容易让人理解其含义,尽管它们的长度要大一些。

3.2.采用一些更加准确的术语来命名。

例如:如果我们的用户称他们的clients为customers ,那么我们就应该用customer来命名,而不是采用client来命名。

这是一些细微的地方,但也希望能注意。

3.3.采用大小写混合的方式来命名,以便命名有很好的可读性。

在JAVA代码中,将采用如下原则:类或接口命名中每个单词的首字母均大写,而单词的剩余部分均小写。

其它像变量、成员方法、属性等除第一个单词全部小写以外,其它单词的首写字母均大写,而单词的剩余部分均小写。

3.4.尽量少用单词的缩写形式,但如果一定要用,则选择大家通用的缩写方式,并且要在本JAVA源代码中坚持用它,而不要一会用这种缩写方式,一会用那种缩写方式。

比如,如果要用“number”的缩写方式,则可用“no”或“num”两种缩写方式,而不要用“nu”这种大家不常用的缩写方式,并且要保持不变。

3.5.尽量避免太长的命名,一般以少于20个字符为宜。

3.6.尽量避免使用这样命名:两个或多个命名仅仅是其中的有些字符大小写不一样,或者仅仅是其中有些单词是单复数之区别。

例如:persistentObject与persistentObjexts;anSqlDatabase与anSQLDataBase等。

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代码开发规范⼀编码规范1.1 命名规范1. 代码中的命名均不能以特殊字符(如下划线、$#符号)开始或结束。

反例: _name / #Object2. 代码中的命名严禁使⽤拼⾳与英⽂混合的⽅式,更不允许直接使⽤中⽂的⽅式。

反例: toubao / lipei。

3. 类名使⽤UpperCamelCase风格,必须遵从驼峰形式。

正例:CommonUtils / BaseVo4. ⽅法名、参数名、成员变量、局部变量都统⼀使⽤lowerCamelCase风格,必须遵从驼峰形式。

正例: orderService / getOrderService()5. 常量命名全部⼤写,单词间⽤下划线隔开,⼒求语义表达完整清楚,不要嫌名字长。

正例: ZK_CONFIG_ROOTNODE6. 抽象类命名使⽤Abstract或Base开头;异常类命名使⽤Exception结尾;测试类命名以它要测试的类的名称开始,以Test结尾。

7. 包名使⽤com.hetai.服务名.分层名。

正例: oauth系统的DAO, com.hetai.oauth.dao8. 如果使⽤到了设计模式或具有明确职责,建议在类名中体现出具体模式或职责。

正例:ExecutorFactory / AbstractProducer9. 各分层都需要接⼝和实现类,实现类⽤Impl作后缀与接⼝区别。

正例:OrderServiceImpl实现OrderService接⼝。

10. 枚举类名建议带上Enum后缀,枚举成员名称需要全⼤写,单词间⽤下划线隔开。

正例:枚举名字:PolicyIdTypeEnum,成员名称:ID_CARD/ PASSPORT。

11. 各层⽅法命名规范: 1)查询的⽅法⽤get/ query做前缀。

2)插⼊的⽅法⽤add 或insert做前缀。

3)删除的⽅法⽤remove 或delete做前缀。

4)修改的⽅法⽤modify/ update做前缀。

Java编码规范(中文版)

Java编码规范(中文版)

Java编码规范(中⽂版)S u n MicrosystemCode C onven t i on s for the J a v a?P r o g r a mm i n g Language (中⽂⽂档)Revised April 20, 1999整理:杨海昕yhx001@/doc/836330750.html 2007-12-171 / 21前⾔ (4)1 导论 (4)1.1 为什么要有程序代码惯例 (4)1.2 致谢 (4)2 ⽂件名 (5)2.1 扩展名 (5)2.2 ⼀般⽂件名 (5)3. 档案组织 (5)3.1 J ava原始码档案 (5)3.1.1 起始批注 (6)3.1.2 package 和import 叙述 (6)3.1.3 class 和interface 宣告 (6)4. 缩排 (7)4.1 ⾏长度 (7)5. 批注 (7)5.1 实作批注格式 (8)5.1.1 区块批注 (8)5.1.2 单⾏批注 (8)5.1.3 尾随批注 (9)5.1.4 ⾏结尾批注 (9)5.2 ⽂件批注 (9)6. 宣告 (10)6.1 每⼀⾏的数⽬ (10)6.2 初始化 (11)6.3 布置 (11)6.4 类别和接⼝宣告 (11)7. 叙述 (12)7.1 简单叙述 (12)7.2 复合叙述 (12)7.3 return 叙述 (12)7.4 if, if-else, if else-if else 叙述 (13)7.5 for 叙述 (13)7.6 while 叙述 (14)7.7 do-while 叙述 (14)7.8 s w i t ch叙述 (14)7.9 try-catch 叙述 (15)8. 空⽩ (15)8.1 空⽩⾏ (15)8.2 空⽩ (15)9. 命名惯例 (16)10. 程序习惯 (18)10.1 提供实体变量和类别变量的权限 (18)10.2 引⽤类别变量和⽅法 (18)10.3 常数 (18)10.4 变数指定 (18)10.5 杂项惯例 (19)10.5.1 ⼩括号 (19)10.5.2 传回值 (19)10.5.3 在条件运算符中"?" 之前的表⽰式 (19)10.5.4 特别批注 (20)11 J ava原始码档案范例 (20)11.1 J ava原始码档案范例 (20)以下⽂件翻译⾃h tt p://j a v a.s un.c o m/do cs/c ode c on v/i nde x.h t m l PDF 版翻译取⾃⽹络繁体版本(h tt p://www.j a v a w o r l d.c o m.t w),若未获得授权请勿以商业⽤途的任意形式转载复制或是修改C op y r i gh t 1995-1999 Sun M i c r o sys t e m s,I n c.A ll r i gh t s r e s e r v ed.U s ed by pe r m i ss i on.前⾔因为⽬前J ava领域的应⽤是⼀个世界性的潮流,对我们国内的有志于计算机编程的⼈员来说,学习J ava是⼀个提⾼⾃⾝⽔平,获取新技术的途径。

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

命名规范:
1.所有的标识都只能使用ASCII字母(A-Z或a-z)、数字(0-9)和
下划线”_”。

2.一个唯一包名的前缀总是用全部小写的字母。

3.类名是一个名词,采用大小写混合的方式,每个单词的首字母大
写。

4.接口的大小写规则与类名相似。

5.方法名是一个动词或是动词词组,采用大小写混合的方式,第一
个单词的首字母小写,其后单词的首字母大写。

6.变量名的第一个字母小写,任何中间单词的首字母大写,变量名
应简短且可以顾名思义,易于记忆。

避免单个字符的变量名,除非是一次性的临时变量。

7.常量的声明应该全部大写,每个单词之间用”_”连接。

注释规范:
1.注释尽可能使用”//”,对于所有的Javadoc的注释使用/***/,而
临时对代码块进行注释应尽量使用/**/。

2.所有的源文件都应该在开头有一个注释,其中列出文件名、日期
和类的功能概述。

每个方法必须添加文档注释(main除外)。

3.每个属性必须加注释。

4.代码中至少包含15%的注释。

5.注释使用中文。

缩进排版规范:
1.避免一行的长度超过60个字符。

2.使用Eclipse源代码的格式化功能完成代码的缩进排版。

文件名规范:
1.一个Java源文件只能储存一个Java类。

2.文件名与Java类相同。

3.一个类文件不超过200行。

声明规范:
1.一行声明一个变量。

2.不要将不同类型变量的声明放在同一行。

3.只在代块的开始处声明变量。

4.所有的变量必须在声明时初始化。

5.避免声明的局部变量覆盖上一级声明的变量。

6.方法与方法直接以空行分隔。

语句规范:
1.每行至少包含一条简单语句。

2.在return语句中,返回值不使用小括号”()”括起来。

3.If月总是用{和}括起来。

4.在for语句的初始化或者更新子句中,避免因使用3个以上变量,
而导致复杂度提高。

5.当switch的一个case顺着往下执行时(因为没有break),通常
应在break语句的位置添加注释。

其他:
为了防止再写if的判断语句时把i==3,错写成i=3,可以将i==3的写法改为3==i。

相关文档
最新文档