java开发手册
文章平均质量分 85
主要收录一些编程规范
L纸鸢
图难于其易,为大于其细
展开
-
开发手册——一、编程规约_9.其他
如果想获取更加精确的纳秒级时间值,使用 System.nanoTime()的方式。在 JDK8 中, 针对统计时间等场景,推荐使用 Instant 类。对于暂时被注释掉,后续可能恢复使用的代码片断,在注释代码上方,统一规定使用三个斜杠(///)来说明注释掉代码的理由。本篇文章主要借鉴于《注意如果是 Boolean 包装类对象,优先调用 getXxx() 的方法。对于垃圾代码或过时配置,坚决清理干净,避免程序过度臃肿,代码冗余。根据 MVC 理论,视图的职责是展示,不要抢模型和控制器的活。原创 2023-03-04 10:46:49 · 344 阅读 · 0 评论 -
开发手册——一、编程规约_8.注释规约
在 IDE 编辑窗口中,Javadoc 方式会提示相关注释,生成 Javadoc 可以正确输出相应注 释;在 IDE 中,工程调用方法时,不进入方法即可悬浮提示方法、参数、返回值的意义,提高阅读效率。方法名 put,加上两个有意义的变量名 elephant 和 fridge,已经说明了这是在干什么,语义清晰的代码不需要额外的注释。代码与注释更新不同步,就像路网与导航软件更新不同步一样,如果导航软件严重滞后, 就失去了导航的意义。本篇文章主要借鉴于《对子类的实现要求,或者调用注意事项,请一并说明。原创 2023-03-04 10:41:30 · 338 阅读 · 0 评论 -
开发手册——一、编程规约_7.控制语句
很多 if 语句内的逻辑相当复杂,阅读者需要分析条件表达式的最终结果,才能明确什么样的条件执行什么样的语句,那么,如果阅读者分析逻辑表达式错误呢?如果非得使用 if()...else if()...else...方式表达逻辑,【强制】避免后续代码维护困难,请勿超过 3 层。这篇文章主要梳理了在java的实际开发过程中的编程规范问题。本篇文章主要借鉴于《下面我们一起来看一下吧。原创 2023-03-04 10:29:50 · 442 阅读 · 0 评论 -
开发手册——一、编程规约_6.并发处理
如果是 JDK8 的应用,可以使用 Instant 代替 Date,LocalDateTime 代替 Calendar, DateTimeFormatter 代替 SimpleDateFormat,官方给出的解释:simple beautiful strong immutable thread-safe。使用线程池的好处是减少在创建和销毁线程上所花的时间以及系统资源的开销,解决资源不足的问题。允许的创建线程数量为 Integer.MAX_VALUE,可能会创建大量的线程,从而导致 OOM。原创 2023-03-04 00:19:48 · 405 阅读 · 0 评论 -
开发手册——一、编程规约_5.集合处理
如果数组元素大于实际所需,下标为 [ list.size() ] 的数组元素将被置为 null,其它数组元素保持原值,因此最好将方法入参数组大小定义与集合元素个数一致。有序性是指遍历的结果是按某种比较规则依次排列的。subList 返回的是 ArrayList 的内部类 SubList,并不是 ArrayList ,而是 ArrayList 的一个视图,对于 SubList 子列表的所有操作最终会反映到原列表上。Arrays.asList 体现的是适配器模式,只是转换接口,后台的数据仍是数组。原创 2023-03-03 22:52:54 · 545 阅读 · 0 评论 -
开发手册——一、编程规约_4.OOP规约
在-128 至 127 范围内的赋值,Integer 对象是在IntegerCache.cache 产生,会复用已有对象,这个区间内的 Integer 值可以直接使用==进行判断,但是这个区间之外的所有数据,都会在堆上产生,并不会复用已有对象,这是一个大坑, 推荐使用 equals 方法进行判断。比如显示成交总额涨跌情况,即正负 x%,x 为基本数据类型,调用的 RPC 服务,调用 不成功时,返回的是默认值,页面显示为 0%,这是不合理的,应该显示成中划线。任何类、方法、参数、变量,严控访问范围。原创 2023-03-03 22:27:09 · 568 阅读 · 0 评论 -
开发手册——一、编程规约_3.代码格式
说明:如果使用 tab 缩进,必须设置 1 个 tab 为 4 个空格。说明:增加 sb1 这个变量,如果需要对齐,则给 a、b、c 都要增加几个空格,在变量比较多的 情况下,是一种累赘的事情。// 参数很多的方法调用可能超过 120 个字符,不要在逗号前换行。// 超过 120 个字符的情况下,不要在括号前换行。说明:运算符包括赋值运算符=、逻辑运算符&&、加减乘除符号等。正例:// 注释内容,注意在//和注释内容之间有一个空格。正例:下例中实参的"a",后边必须要有一个空格。下面我们一起来看一下吧。原创 2023-03-02 18:04:10 · 476 阅读 · 0 评论 -
开发手册——一、编程规约_2.常量定义
正例:public Enum { MONDAY(1), TUESDAY(2), WEDNESDAY(3), THURSDAY(4), FRIDAY(5), SATURDAY(6), SUNDAY(7);1) 跨应用共享常量:放置在二方库中,通常是 client.jar 中的 constant 目录下。2) 应用内共享常量:放置在一方库中,通常是 modules 中的 constant 目录下。说明:Long a = 2l;说明:大而全的常量类,非得使用查找功能才能定位到修改的常量,不利于理解和维护。原创 2023-03-02 17:07:13 · 351 阅读 · 0 评论 -
开发手册——一、编程规约_1.命名风格
的属性,它的方法也是 isDeleted(),RPC框架在反向解析的时候,“以为”对应的属性名称是 deleted,导致属性获取不到,进而抛出异常。1)【强制】对于 Service 和 DAO 类,基于 SOA 的理念,暴露出来的服务一定是接口,内部 的实现类用 Impl 的后缀与接口区别。正例:alibaba / taobao / youku / hangzhou 等国际通用的名称,可视同英文。反例:_name / __name / $Object / name_ / name$ / Object$原创 2023-03-02 16:59:13 · 318 阅读 · 2 评论