【阿里巴巴Java编程规范学习 一】Java基本编程规约(上)

简介: 【阿里巴巴Java编程规范学习 一】Java基本编程规约(上)

编程规约是比较重要的部分,按照基础和高级,我分成了两篇来学习,上篇涉及到命名风格、常量定义、代码格式OOP规约都是面向对象基础部分和一些通识命名规范。红色加粗字体为自己可能会犯的错误以及不规范的地方,蓝色结论部分为几条规则的归纳或一条规则的阐述。

命名风格

条目较多,所以使用金字塔的风格进行分类整理,易于记忆。命名风格可以按照级别和通识基础进行如下分类:

  • 通识规范:通识的规范,使各种命名更容易被理解。
  • 包名规范:包的命名规范。
  • 类和接口名规范:类和接口相关的命名规范。
  • 方法、参数、成员变量和局部变量规范

分为以上几个级别和大类之后,再理解规则会更深刻。

首先明确两种命名规范:

  • Camel(驼峰)命名法:首个单词首字母小写,后续单词首字母大写:适用于变量命名,例如:tmlGetGirl
  • Pascal(帕斯卡)命名法(UpperCamelCase):每个单词首字母均大写:适用于方法和类,例如:TmlAiTest

1 通用命名规范

通识规范有如下几条:

1, 【强制】代码中的命名均不能以下划线或美元符号开始,也不能以下划线或美元符号结束。

  • 反例: _name / __name / $name / name_ / name$ / name__

2,【强制】代码中的命名严禁使用拼音与英文混合的方式,更不允许直接使用中文的方式

  • 说明:正确的英文拼写和语法可以让阅读者易于理解,避免歧义。注意,即使纯拼音命名方式也要避免采用。
  • 正例: alibaba / taobao / youku / hangzhou 等国际通用的名称,可视同英文。
  • 反例: DaZhePromotion [ 打折 ] / getPingfenByName() [ 评分 ] / int 某变量 = 3

3,【强制】杜绝完全不规范的缩写,避免望文不知义

  • 反例: AbstractClass “缩写”命名成 AbsClass;condition “缩写”命名成 condi ,此类随意缩写严重降低代码的可阅读性。

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

  • 正例:在 JDK 中,表达原子更新的类名为:AtomicReferenceFieldUpdater
  • 反例:变量 int a 的随意命名方式。

阅读完以上四条规范,回忆下Java的命名规范:

  • 名称只能由字母、数字、下划线、$符号组成
  • 不能以数字开头
  • 名称不能使用JAVA中的关键字
  • 坚决不允许出现中文及拼音命名。

综合阿里和标准的Java命名规范,得出规范:

结论1:最好使用纯英文且尽量完整的单词进行命名,_和$符只能出现在中间,数字只能出现在中间和末尾

5,【推荐】如果模块、接口、类、方法使用了设计模式,在命名时需体现出具体模式。

  • 说明:将设计模式体现在名字中,有利于阅读者快速理解架构设计理念。
  • 正例: public class OrderFactory; public class LoginProxy;public class ResourceObserver;

6,【强制】代码和注释中都要避免使用任何语言的种族歧视性词语。

  • 正例:日本人 / 印度人 / blockList / allowList / secondary
  • 反例:RIBENGUIZI / Asan / blackList / whiteList / slave

7,【参考】各层命名规约:这里个人容易不符合规范

  • A) Service / DAO 层方法命名规约
  • 获取单个对象的方法用 get 做前缀
  • 获取多个对象的方法用 list 做前缀,复数形式结尾如:listObjects
  • 获取统计值的方法用 count 做前缀
  • 插入的方法用 save/insert 做前缀
  • 删除的方法用 remove/delete 做前缀
  • 修改的方法用 update 做前缀
  • B) 领域模型命名规约
  • 数据对象: xxxDO , xxx 即为数据表名。
  • 数据传输对象: xxxDTO , xxx 为业务领域相关的名称。
  • 展示对象: xxxVO , xxx 一般为网页名称。
  • POJO 是 DO / DTO / BO / VO 的统称,禁止命名成 xxxPOJO

2 包名规范

1,【强制】包名统一使用小写,点分隔符之间有且仅有一个自然语义的英语单词包名统一使用单数形式,但是类名如果有复数含义,类名可以使用复数形式。

  • 正例:应用工具类包名为 com . alibaba . ai . util 、类名为 MessageUtils( 此规则参考 spring的框架结构 )

3 类和接口名规范

1,【强制】类名使用 UpperCamelCase 风格,但以下情形例外: DO / BO / DTO / VO / AO /PO / UID 等。

  • 正例: MarcoPolo / UserDO / XmlService / TcpUdpDeal / TaPromotion
  • 反例: macroPolo / UserDo / XMLService / TCPUDPDeal / TAPromotion

除外的原因是DO / BO / DTO / VO / AO /PO / UID 等本身是缩写。补充说明:类的名字要用名词, 例如计划清单类:PlanList

2,【参考】枚举类名建议带上 Enum 后缀,枚举成员名称需要全大写,单词间用下划线隔开。说明:枚举其实就是特殊的常量类,域成员均为常量且构造方法被默认强制是私有

  • 正例:枚举名字为 ProcessStatusEnum 的 成员名称: SUCCESS / UNKNOWN _ REASON 。

3【强制】抽象类命名使用 Abstract 或 Base 开头异常类命名使用 Exception 结尾测试类命名以它要测试的类的名称开始,以 Test 结尾

  • 正例:AbstractTmlPlanList、TmlPlanListException 、TmlPlanListTest

结论2:类均采用UpperCamelCase 命名法且均为名词,并且特殊用途时需要加特殊前后缀

4,【推荐】接口类中的方法和属性不要加任何修饰符号 (public 也不要加 )保持代码的简洁性,并加上有效的 Javadoc 注释。尽量不要在接口里定义变量,如果一定要定义变量,肯定是与接口方法相关,并且是整个应用的基础常量。这里个人容易不符合规范

  • 正例:接口方法签名 void commit(); 接口基础常量 String COMPANY = " alibaba " ;
  • 反例:接口方法定义 public abstract void f();
  • 说明: JDK 8 中接口允许有默认实现,那么这个 default 方法,是对所有实现类都有价值的默认实现。

5,接口和实现类的命名有两套规则:

  • 【强制】对于 Service 和 DAO 类,基于 SOA 的理念,暴露出来的服务一定是接口,内部的实现类用 Impl 的后缀与接口区别。
  • 正例: CacheServiceImpl 实现 CacheService 接口
  • 【推荐】 如果是形容能力的接口名称,取对应的形容词为接口名 ( 通常是– able的形式 ) 。这里个人容易不符合规范
  • 正例: AbstractTranslator 实现 Translatable 接口

4 方法名、参数名、成员变量、局部变量

1,【强制】方法名、参数名、成员变量、局部变量都统一使用 lowerCamelCase 风格,必须遵从驼峰形式。

  • 正例: localValue / getHttpMessage() / inputUserId

2【强制】类型与中括号紧挨相连来表示数组变量定义。

  • 正例:定义整形数组 int[] arrayDemo;
  • 反例:在 main 参数中,使用 String args[]来定义。

3 【强制】避免在子父类的成员变量之间、或者不同代码块的局部变量之间采用完全相同的命名,使可理解性降低。这里个人容易不符合规范

  • 说明:子类、父类成员变量名相同,即使是 public 类型的变量也能够通过编译,另外,局部变量在同一方法内的不同代码块中同名也是合法的,这些情况都要避免。对于非 setter/getter 的参数名称也要避免与成员变量名称相同。
  • 反例:反例代码如下,同名变量出现多次,虽然编译能过,但要避免。
public class ConfusingName {
    public int stock;
    // 非 setter/getter 的参数名称,不允许与本类成员变量同名
    public void get(String alibaba) {
        if (condition) {
            final int money = 666;
            // ...
        }
        for (int i = 0; i < 10; i++) {
            // 在同一方法体中,不允许与其它代码块中的 money 命名相同
            final int money = 15978;
            // ...
        }
    }
}
class Son extends ConfusingName {
    // 不允许与父类的成员变量名称相同
    public int stock;
}

4,【强制】 POJO 类中布尔类型的变量,都不要加 is 前缀 ,否则部分框架解析会引起序列化错误。这里个人容易不符合规范

  • 说明:在 MySQL 规约中的建表约定第一条,表达是与否的变量采用 is_xxx 的命名方式,所以,需要在<resultMap>设置从 is_xxxxxx 的映射关系
  • 反例:定义为基本数据类型 Boolean isDeleted 的属性,它的方法也是 isDeleted() , RPC框架在反向解析的时候,“误以为”对应的属性名称是 deleted ,导致属性获取不到,进而抛出异常。

注:POJO 专指只有 setter / getter/ toString 的简单类,包括 DO/DTO/BO/VO 等。属于贫血类,相对于领域驱动设计里的充血类而言的。

主要是因为用IDEA自己提供的setter和getter方法会自动把is干掉,这样序列化和反序列化就找不到了。
public boolean isTest() {
        return isTest;
    }
    public void setTest(boolean test) {
        isTest = test;
    }
    private boolean isTest;
    public String getIsTdest() {
        return isTdest;
    }
    public void setIsTdest(String isTdest) {
        this.isTdest = isTdest;
    }
    private String isTdest;

5 【推荐】在常量与变量的命名时,表示类型的名词放在词尾,以提升辨识度。这里个人容易不符合规范

  • 正例:startTime / workQueue / nameList / TERMINATED_THREAD_COUNT
  • 反例:startedAt / QueueOfWork / listName /COUNT_TERMINATED_THREAD

常量定义

1, 【强制】常量命名全部大写,单词间用下划线隔开,力求语义表达完整清楚,不要嫌名字长。

  • 正例: MAX _ STOCK _ COUNT
  • 反例: MAX _ COUNT

2,【强制】不允许任何魔法值 ( 即未经预先定义的常量 ) 直接出现在代码中。反例:这里个人容易不符合规范

3,【强制】在 long 或者 Long 赋值时,数值后使用大写的 L ,不能是小写的 l ,小写容易跟数字1 混淆,造成误解。这里个人容易不符合规范

  • 说明: Long a = 2 l; 写的是数字的 21,还是 Long 型的 2?

4,【推荐】不要使用一个常量类维护所有常量,要按常量功能进行归类,分开维护。

  • 说明:大而全的常量类,杂乱无章,使用查找功能才能定位到修改的常量,不利于理解和维护。
  • 正例:缓存相关常量放在类 CacheConsts 下 ; 系统配置相关常量放在类 ConfigConsts 下。

5,【推荐】常量的复用层次有五层:跨应用共享常量、应用内共享常量、子工程内共享常量、包内共享常量、类内共享常量。这里个人容易不符合规范

  1. 跨应用共享常量:放置在二方库中,通常是 client . jar 中的 constant 目录下。
  2. 应用内共享常量:放置在一方库中,通常是子模块中的 constant 目录下。
  • 反例:易懂变量也要统一定义成应用内共享常量,两位攻城师在两个类中分别定义了表示“是”的变量:类 A 中: public static final String YES = " yes " ;类 B 中: public static final String YES = " y " ;A . YES . equals(B . YES) ,预期是 true ,但实际返回为 false ,导致线上问题。
  1. 子工程内部共享常量:即在当前子工程Module的 constant 目录下。
  2. 包内共享常量:即在当前包下单独的 constant 目录下。
  3. 类内共享常量:直接在类内部 private static final 定义。

解释下:一方库: 本工程内部子项目模块依赖的库(jar 包)。二方库: 公司内部发布到中央仓库,可供公司内部其它应用依赖的库(jar 包)。三方库: 公司之外的开源库(jar 包)。

6,【推荐】如果变量值仅在一个固定范围内变化用 enum 类型来定义固化。

  • 说明:如果存在名称之外的延伸属性应使用 enum 类型,下面正例中的数字就是延伸信息,表示一年中的第几个季节。通俗的说就是变量值变化范围有限采用枚举类来定义!
public enum SeasonEnum {
    SPRING(1), SUMMER(2), AUTUMN(3), WINTER(4);
    private int seq;
    SeasonEnum(int seq) {
        this.seq = seq;
    }
    public int getSeq() {
        return seq;
    }
}

代码格式

一些代码编排规范:

1 空格、换行和缩进规范

1,【强制】大括号的使用约定。如果是大括号内为空,则简洁地写成{}即可,不需要换行 ; 如果是非空代码块则:

  • 左大括号前不换行,左大括号后换行。
  • 右大括号前换行,右大括号后还有 else 等代码则不换行 ; 表示终止的右大括号后必须换行。

2,【强制】左小括号和字符之间不出现空格 ; 同样,右小括号和字符之间也不出现空格;而左大括号前需要空格。

  • 反例: if (空格 a == b 空格)

3,【强制】 if / for / while / switch / do保留字与括号之间都必须加空格

4,【强制】任何二目、三目运算符的左右两边都需要加一个空格

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

5,【强制】采用 4 个空格缩进,禁止使用 tab 字符。

  • 说明:如果使用 tab 缩进,必须设置 1 个 tab 为 4 个空格。IDEA 设置 Tab 为 4 个空格时,请勿勾选 Use tab character

以上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,else不用换行
            System.out.println("ok");
        } // 在右大括号后直接结束,则必须换行
    }

6,【强制】注释的双斜线与注释内容之间有且仅有一个空格这里个人容易不符合规范

7,【强制】方法参数在定义和传入时,多个参数逗号后边必须加空格。

  • 正例:下例中实参的 args1,后边必须要有一个空格。method(args1, args2, args3);

8,【推荐】没有必要增加若干空格来使某一行的字符与上一行对应位置的字符对齐。正例:

int one = 1;
    long two = 2L;
    float three = 3F;
    StringBuffer stringBuffer = new StringBuffer();

说明:增加 stringBuffer 这个变量,如果需要对齐,则给 one 、two 、three 都要增加几个空格,在变量比较多的情况下,是非常累赘的事情。

9,【强制】在进行类型强制转换时,右括号与强制转换值之间不需要任何空格隔开。

正例:double first = 3.2d; int second = (int)first + 2;

10,【推荐】不同逻辑、不同语义、不同业务的代码之间插入一个空行分隔开来以提升可读性。这里个人容易不符合规范

  • 说明:任何情形,没有必要插入多个空行进行隔开。

2 代码长度与拆分规范

1,【强制】单行字符数限制不超过 120 个,超出需要换行,换行时遵循如下原则:这里个人容易不符合规范

  • 第二行相对第一行缩进 4 个空格,从第三行开始,不再继续缩进,
  • 运算符与下文一起换行。 方法调用的点符号与下文一起换行。见正例
  • 方法调用中的多个参数需要换行时,在逗号后进行,在括号前不要换行,见反例。

正例:

StringBuilder sb = new StringBuilder();
// 超过 120 个字符的情况下,换行缩进 4 个空格,并且方法前的点号一起换行
sb.append("yang").append("hao")...
            .append("chen")...
            .append("chen")...
            .append("chen");

反例:

StringBuilder sb = new StringBuilder();
// 超过 120 个字符的情况下,不要在括号前换行
sb.append("you").append("are")...append
            ("lucky");
    // 参数很多的方法调用可能超过 120 个字符,逗号后才是换行处
    method(args1, args2, args3, ...
            , argsX);

2,【推荐】单个方法的总行数不超过 80 行。

  • 说明:包括方法签名、结束右大括号、方法内代码、注释、空行、回车及任何不可见字符的总行数不超过 80 行。
  • 正例:代码逻辑分清红花和绿叶个性和共性,绿叶逻辑单独出来成为额外方法,使主干代码更加清晰;共性逻辑抽取成为共性方法,便于复用和维护。

结论3:要注意代码的圈复杂度,在适当的时候要进行拆分和整理

3 格式设置

1,【强制】 IDE 的 text file encoding 设置为 UTF -8 ; IDE 中文件的换行符使用 Unix 格式,不要使用 Windows 格式。

OOP规约

OOP也就是面向对象编程,涉及这几个方面的规约吧:

  • 类和接口的使用:怎么用才能降低性能损耗,减少错误的发生
  • 方法的使用:有些方法天生不能写业务逻辑,同样,有些方法调用时候也要看看实现逻辑再用
  • 常用操作规范:你clone的不一定是你想clone的,比较的时候注点儿
  • 调用规范:调别人接口时候别给人家改了,给别人写接口的时候看看自己的旧版本能不能扔了

通盘考虑,提高性能。

1 通用定义规范

1【推荐】 final 可以声明类、成员变量、方法、以及本地变量,下列情况使用 final 关键字:

  • 不允许被继承的类,如: String 类。
  • 不允许修改引用的域对象。
  • 不允许被重写的方法,如: POJO 类的 setter 方法。
  • 不允许运行过程中重新赋值的局部变量。
  • 避免上下文重复使用一个变量,使用 final 描述可以强制重新定义一个变量,方便更好地进行重构。

2 类和接口的定义

1,【强制】避免通过一个类的对象引用访问此类的静态变量或静态方法,无谓增加编译器解析成本,直接用类名来访问即可。

2, 关于基本数据类型与包装数据类型的使用标准如下:这里个人容易不符合规范

  • 【强制】所有的 POJO 类属性必须使用包装数据类型
  • 【强制】 RPC 方法的返回值和参数必须使用包装数据类型(RPC就是远程调用的意思)
  • 【推荐】所有的局部变量使用基本数据类型

说明: POJO 类属性没有初值是提醒使用者在需要使用时,必须自己显式地进行赋值,任何NPE 问题(NPE指空指针异常),或者入库检查,都由使用者来保证。

  • 正例:数据库的查询结果可能是 null ,因为自动拆箱,用基本数据类型接收有 NPE 风险。
  • 反例:比如显示成交总额涨跌情况,即正负 x %, x 为基本数据类型,调用的 RPC 服务,调用不成功时,返回的是默认值,页面显示为 0%,这是不合理的,应该显示成中划线。所以包装数据类型的 null 值,能够表示额外的信息,如:远程调用失败,异常退出。

通俗的说远程调用返回值只有包装类型才能包装没有NPE风险并且可以提供额外错误信息

3,【强制】所有的覆写方法,必须加@ Override 注解。

  • 说明: getObject() 与 get 0 bject() 的问题。一个是字母的 O ,一个是数字的 0,加@ Override可以准确判断是否覆盖成功。另外,如果在抽象类中对方法签名进行修改,其实现类会马上编译报错。

4,【强制】定义 DO / DTO / VO 等 POJO 类时,不要设定任何属性默认值这里个人容易不符合规范

  • 反例: POJO 类的属性createTime 默认值为 new Date(), 但是这个属性在数据提取时并没有置入具体值,在更新其它字段时又附带更新了此字段,导致创建时间被修改成当前时间。

5,【强制】 POJO 类必须写 toString 方法。使用 IDE 中的工具: source > generate toString,时,如果继承了另一个 POJO 类,注意在前面加一下 super . toString 。说明:在方法执行抛出异常时,可以直接调用 POJO 的 toString() 方法打印其属性值,便于排查问题。,或者直接加lombook注解。

6,【强制】禁止在 POJO 类中,同时存在对应属性 xxx 的 isXxx() 和 getXxx() 方法。说明:框架在调用属性 xxx 的提取方法时,并不能确定哪个方法一定是被优先调用到。

7,【推荐】当一个类有多个构造方法,或者多个同名方法,这些方法应该按顺序放置在一起,便于阅读。这条规则优先于规则【类内方法定义顺序】

8,【推荐】 类内方法定义的顺序依次是:公有方法或保护方法 > 私有方法 > getter / setter方法这里个人容易不符合规范

  • 说明:公有方法是类的调用者和维护者最关心的方法,首屏展示最好 ; 保护方法虽然只是子类关心,也可能是“模板设计模式”下的核心方法 ; 而私有方法外部一般不需要特别关心,是一个黑盒实现 ; 因为承载的信息价值较低,所有 Service 和 DAO 的 getter / setter 方法放在类体最后(或者直接注解@Data)。

9, 【推荐】类成员与方法访问控制从严,其实就是访问修饰符如何使用的问题:这里个人容易不符合规范

  • 如果不允许外部直接通过 new 来创建对象,那么构造方法必须是 private 。
  • 工具类不允许有 public 或 default 构造方法。当然了,是做事的,不是包含内容的
  • 类非 static 成员变量并且与子类共享,必须是 protected 。
  • 类非 static 成员变量并且仅在本类使用,必须是 private 。
  • 类 static 成员变量如果仅在本类使用,必须是 private 。
  • 若是 static 成员变量,考虑是否为 final 。考虑一下静态变量被修改了麻烦了,推荐使用final
  • 类成员方法只供类内部调用,必须是 private 。
  • 类成员方法只对继承类公开,那么限制为 protected 。

说明:任何类、方法、参数、变量,严控访问范围。过于宽泛的访问范围,不利于模块解耦

思考:如果是一个 private 的方法,想删除就删除,可是一个 public 的 service 成员方法或成员变量,删除一下,不得手心冒点汗吗?变量像自己的小孩,尽量在自己的视线内,变量作用域太大,无限制的到处跑,那么你会担心的。

结论4:无论何种编程语言,类、方法、成员的访问是能严就严,性能损耗能小就小,少定默认值,多用包装类

10 【强制】任何货币金额,均以最小货币单位且整型类型来进行存储。

11 .【强制】定义数据对象 DO 类时,属性类型要与数据库字段类型相匹配。这里个人容易不符合规范

  • 正例:数据库字段的 bigint 必须与类属性的 Long 类型相对应。
  • 反例:某个案例的数据库表 id 字段定义类型 bigint unsigned,实际类对象属性为 Integer,随着 id 越来越大,超过 Integer 的表示范围而溢出成为负数。

12,【强制】序列化类新增属性时,请不要修改 serialVersionUID 字段,避免反序列失败 ; 如果完全不兼容升级,避免反序列化混乱,那么请修改 serialVersionUID 值。这里个人容易不符合规范

  • 说明:注意 serialVersionUID 不一致会抛出序列化运行时异常。

3 方法的定义

1,【强制】构造方法里面禁止加入任何业务逻辑,如果有初始化逻辑,请放在 init 方法中。

2,【推荐】 setter 方法中,参数名称与类成员变量名称一致, this .成员名 = 参数名。在getter / setter 方法中,不要增加业务逻辑,增加排查问题的难度反例

public Integer getData() {
        if (condition) {
           return this.data + 100;
         } else {
        return this.data - 100;
        }
    }

结论5:无论何种编程语言,PoJo类的那几个初始化方法(构造方法、setter、getter)都别写业务逻辑,并且有时候系统提供的方法不一定满足要求要按业务重构

3【强制】相同参数类型,相同业务含义,才可以使用 Java 的可变参数,避免使用 Object 。

  • 说明:可变参数必须放置在参数列表的最后。 ( 提倡同学们尽量不用可变参数编程 )
  • 正例: public List listUsers(String type, Long… ids) {…}
  • 可变参数: 适用于参数个数不确定类型确定的情况。java把可变参数当做数组处理

4 类和方法调用及代码逻辑规范

关于类和方法调用的一些规范:

1,【强制】外部正在调用或者二方库依赖的接口,不允许修改方法签名,避免对接口调用方产生影响。接口过时必须加@ Deprecated 注解,并清晰地说明采用的新接口或者新服务是什么。这里个人容易不符合规范

2,【强制】不能使用过时的类或方法

  • 说明: java . net . URLDecoder 中的方法 decode(String encodeStr) 这个方法已经过时,应该使用双参数 decode(String source, String encode) 。接口提供方既然明确是过时接口,那么有义务同时提供新的接口 ; 作为调用方来说,有义务去考证过时方法的新实现是什么。

结论6:别随便改第三方接口的方法签名,同时,长点儿心,更新了接口考虑好兼容性就把旧的替了好不好,不然很让调用方苦恼的。

3 【强制】Object 的 equals 方法容易抛空指针异常,应使用常量或确定有值的对象来调用 equals。这里个人容易不符合规范

  • 正例:"test".equals(object);
  • 反例:object.equals("test");
  • 说明:推荐使用 JDK7 引入的工具类 java.util.Objects#equals(Object a, Object b)

4,【强制】所有的相同类型的包装类对象之间值的比较,全部使用 equals 方法比较

  • 说明:对于 Integer var = ? 在-128 至 127 范围内的赋值, Integer 对象是在IntegerCache . cache 产生,会复用已有对象,这个区间内的 Integer 值可以直接使用==进行判断,但是这个区间之外的所有数据,都会在堆上产生,并不会复用已有对象,这是一个大坑,推荐使用 equals 方法进行判断。

5 【强制】浮点数之间的等值判断,基本数据类型不能用==来比较,包装数据类型不能用 equals来判断。

  • 说明:浮点数采用“尾数+阶码”的编码方式,类似于科学计数法的“有效数字+指数”的表示方式。二进制无法精确表示大部分的十进制小数

反例:

float a = 1.0F - 0.9F;
float b = 0.9F - 0.8F;
if(a ==b)
    {
        // 预期进入此代码块,执行其它业务逻辑
        // 但事实上 a==b 的结果为 false
    }
Float x = Float.valueOf(a);
Float y = Float.valueOf(b);
if(x.equals(y))
    {
        // 预期进入此代码块,执行其它业务逻辑
        // 但事实上 equals 的结果为 false
    }

正例:

(1)指定一个误差范围,两个浮点数的差值在此范围之内,则认为是相等的。
float a = 1.0F - 0.9F;
float b = 0.9F - 0.8F;
float diff = 1e-6F;
if(Math.abs(a -b) <diff)
    {
        System.out.println("true");
    }
(2)使用 BigDecimal来定义值,再进行浮点数的运算操作。
    java.math.BigDecimal a = new BigDecimal("1.0");
    BigDecimal b = new BigDecimal("0.9");
    BigDecimal c = new BigDecimal("0.8");
    BigDecimal x = a.subtract(b);
    BigDecimal y = b.subtract(c);
    if(x.compareTo(y)==0)
    {
        System.out.println("true");
    }

6.【强制】如上所示 BigDecimal 的等值比较应使用 compareTo()方法,而不是 equals()方法。

  • 说明:equals()方法会比较值和精度(1.0 与 1.00 返回结果为 false),而 compareTo()则会忽略精度。

7 【强制】禁止使用构造方法 BigDecimal(double)的方式把 double 值转化为 BigDecimal 对象。

  • 说明:BigDecimal(double)存在精度损失风险,在精确计算或值比较的场景中可能会导致业务逻辑异常。如:BigDecimal g = new BigDecimal(0.1F); 实际的存储值为:0.10000000149
  • 正例:优先推荐入参为 String 的构造方法,或使用 BigDecimal 的 valueOf 方法,此方法内部其实执行了Double 的 toString,而 Double 的 toString 按double 的实际能表达的精度对尾数进行了截断。
BigDecimal recommend1 = new BigDecimal("0.1");
 BigDecimal recommend2 = BigDecimal.valueOf(0.1);

8,【推荐】使用索引访问用 String 的 split 方法得到的数组时,需做最后一个分隔符后有无内容的检查,否则会有抛 IndexOutOfBoundsException 的风险。

String str = "a,b,c,,";
    String[] ary = str.split(",");
    // 预期大于 3,结果是 3
    System.out.println(ary.length);

9,【推荐】循环体内,字符串的连接方式,使用 StringBuilder 的 append 方法进行扩展这里个人容易不符合规范

  • 说明:下例中,反编译出的字节码文件显示每次循环都会 new 出一个 StringBuilder 对象,然后进行 append 操作,最后通过 toString 方法返回 String 对象,造成内存资源浪费。反例:
String str = "start";
    for (int i = 0; i < 100; i++) {
    str = str + "hello";
    }

10,【推荐】慎用 Object 的 clone 方法来拷贝对象。,说明:对象的 clone 方法默认是浅拷贝,若想实现深拷贝需要重写 clone 方法实现域对象的深度遍历式拷贝。关于深拷贝和浅拷贝可以看我另一篇博客讲到了 深浅拷贝,可以参考下

总结一下

收获还是很多的,在写和学习的过程中思考了下自己之前写代码的一些不规范和考虑不到的点,例如代码逻辑中自己会搞多行空格,注释反斜杠直接挨着注释内容,字符串直接拼,调用equals方法不做NPE校验,甚至从来不考虑类内各种方法的顺序,也从来不想着访问修饰符的严格级别,还有常量的共享级别、方法和变量命名格式等,仔细想想这些看起来的小问题之后可能真的是很难排查的大问题,保持一个好的编程习惯真的很重要啊。

相关文章
|
19天前
|
Java 程序员
Java编程中的异常处理:从基础到高级
在Java的世界中,异常处理是代码健壮性的守护神。本文将带你从异常的基本概念出发,逐步深入到高级用法,探索如何优雅地处理程序中的错误和异常情况。通过实际案例,我们将一起学习如何编写更可靠、更易于维护的Java代码。准备好了吗?让我们一起踏上这段旅程,解锁Java异常处理的秘密!
|
3天前
|
算法 Java 调度
java并发编程中Monitor里的waitSet和EntryList都是做什么的
在Java并发编程中,Monitor内部包含两个重要队列:等待集(Wait Set)和入口列表(Entry List)。Wait Set用于线程的条件等待和协作,线程调用`wait()`后进入此集合,通过`notify()`或`notifyAll()`唤醒。Entry List则管理锁的竞争,未能获取锁的线程在此排队,等待锁释放后重新竞争。理解两者区别有助于设计高效的多线程程序。 - **Wait Set**:线程调用`wait()`后进入,等待条件满足被唤醒,需重新竞争锁。 - **Entry List**:多个线程竞争锁时,未获锁的线程在此排队,等待锁释放后获取锁继续执行。
26 12
|
22天前
|
设计模式 Java 开发者
Java多线程编程的陷阱与解决方案####
本文深入探讨了Java多线程编程中常见的问题及其解决策略。通过分析竞态条件、死锁、活锁等典型场景,并结合代码示例和实用技巧,帮助开发者有效避免这些陷阱,提升并发程序的稳定性和性能。 ####
|
22天前
|
缓存 Java 开发者
Java多线程编程的陷阱与最佳实践####
本文深入探讨了Java多线程编程中常见的陷阱,如竞态条件、死锁和内存一致性错误,并提供了实用的避免策略。通过分析典型错误案例,本文旨在帮助开发者更好地理解和掌握多线程环境下的编程技巧,从而提升并发程序的稳定性和性能。 ####
|
16天前
|
安全 算法 Java
Java多线程编程中的陷阱与最佳实践####
本文探讨了Java多线程编程中常见的陷阱,并介绍了如何通过最佳实践来避免这些问题。我们将从基础概念入手,逐步深入到具体的代码示例,帮助开发者更好地理解和应用多线程技术。无论是初学者还是有经验的开发者,都能从中获得有价值的见解和建议。 ####
|
16天前
|
Java 调度
Java中的多线程编程与并发控制
本文深入探讨了Java编程语言中多线程编程的基础知识和并发控制机制。文章首先介绍了多线程的基本概念,包括线程的定义、生命周期以及在Java中创建和管理线程的方法。接着,详细讲解了Java提供的同步机制,如synchronized关键字、wait()和notify()方法等,以及如何通过这些机制实现线程间的协调与通信。最后,本文还讨论了一些常见的并发问题,例如死锁、竞态条件等,并提供了相应的解决策略。
40 3
|
21天前
|
开发框架 安全 Java
Java 反射机制:动态编程的强大利器
Java反射机制允许程序在运行时检查类、接口、字段和方法的信息,并能操作对象。它提供了一种动态编程的方式,使得代码更加灵活,能够适应未知的或变化的需求,是开发框架和库的重要工具。
36 2
|
22天前
|
安全 Java 开发者
Java中的多线程编程:从基础到实践
本文深入探讨了Java多线程编程的核心概念和实践技巧,旨在帮助读者理解多线程的工作原理,掌握线程的创建、管理和同步机制。通过具体示例和最佳实践,本文展示了如何在Java应用中有效地利用多线程技术,提高程序性能和响应速度。
54 1
|
23天前
|
Java API 数据库
Java 反射机制:动态编程的 “魔法钥匙”
Java反射机制是允许程序在运行时访问类、方法和字段信息的强大工具,被誉为动态编程的“魔法钥匙”。通过反射,开发者可以创建更加灵活、可扩展的应用程序。
39 0
|
26天前
|
缓存 Java 开发者
Java中的多线程编程:从基础到进阶
在Java的世界中,多线程编程是一块不可或缺的拼图。它不仅提升了程序的效率和响应性,还让复杂任务变得井然有序。本文将带你领略多线程编程的魅力,从创建线程的基础操作到高级同步机制的应用,再到线程池的高效管理,我们将一步步揭开多线程编程的神秘面纱。无论你是初学者还是有一定经验的开发者,这篇文章都会为你提供新的视角和深入的理解。让我们一起探索Java多线程编程的世界,开启一段精彩的旅程吧!
39 0
下一篇
DataWorks