金秋十月,读阿里JAVA开发手册有感而发

2023-10-24 13:11

本文主要是介绍金秋十月,读阿里JAVA开发手册有感而发,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

前言

最近重温阿里巴巴Java开发手册这本书,思考了什么样的代码是好代码,给大家分享一下我的想法,有哪里不对,欢迎指出,感激不尽。

什么样的代码是好代码?

什么是好代码?实现了功能的代码只是合格的代码,而真正的好代码具有以下特点:

  • 命名易于理解,语义表达清晰而不需人揣摩

  • 代码逻辑清晰透明,层次分明

  • 代码格式公整美观

  • 性能效率高

  • 安全性高

好的命名

好的命名,命名易于理解,语义表达清晰。是酝酿好代码的第一步。以下列举阿里JAVA开发手册的几点,都是在强调好的命名,以便于阅读。

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

理由:大家约定俗成这样写,阅读者一看这个类就知道它是抽象类还是异常类,岂不美哉。

推荐指数:五星

杜绝完全不规范的缩写,避免望文不知义。

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

推荐指数:五星

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

正例:在 JDK 中,表达原子更新的类名为:AtomicReferenceFieldUpdater。

反例:变量 int a 的随意命名方式

理由:完整的单词,表达意思更清楚。

推荐指数:四星

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

正例:

   public class OrderFactory;     public class LoginProxy;      public class ResourceObserver;

理由:将设计模式体现在名字中,有利于阅读者快速理解架构设计理念。

推荐指数:四星

不允许任何魔法值(即未经预先定义的常量)直接出现在代码中。

反例:

String key = "Id#taobao_" + tradeId;      
cache.put(key, value); 

理由:魔法值只有开发者自己知道,或者过一段时间他自己也不知道了。。。还谈何维护。。。

推荐指数:五星

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

正例:枚举名字为 ProcessStatusEnum 的成员名称:SUCCESS / UNKNOWN_REASON。

理由:枚举其实就是特殊的类,域成员均为常量,且构造方法被默认强制是私有。

推荐指数:三星

清晰的结构,分明的层次,明了的逻辑

好的代码,还表现在清晰的结构,分明的层次,明了的逻辑。不仅表现在代码功能层明上,代码块、函数各司其职,符合设计模式设计理念,还表现在项目结构轮廓分明。列举了以下几点:

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

正例:缓存相关常量放在类 CacheConsts 下,系统配置相关常量放在类 ConfigConsts 下。

理由:大而全的常量类,杂乱无章,使用查找功能才能定位到修改的常量,不利于理解和维护。

推荐指数:四星

一个过于冗长的函数或者一段需要注释才能让人理解用途的代码,可以考虑把它切分成一个功能明确的函数单元,并定义清晰简短的函数名,这样会让代码变得更加优雅。

反例:

  private String name;private Vector<Order> orders = new Vector<Order>();public void printOwing() {//print bannerSystem.out.println("****************");System.out.println("*****customer Owes *****");System.out.println("****************");//calculate totalAmountEnumeration env = orders.elements();double totalAmount = 0.0;while (env.hasMoreElements()) {Order order = (Order) env.nextElement();totalAmount += order.getAmout();}//print detailsSystem.out.println("name:" + name);System.out.println("amount:" + totalAmount);}

正例:

private String name;private Vector<Order> orders = new Vector<Order>();public void printOwing() {//print bannerprintBanner();//calculate totalAmountdouble totalAmount = getTotalAmount();//print detailsprintDetail(totalAmount);}void printBanner(){System.out.println("****************");System.out.println("*****customer Owes *****");System.out.println("****************");}double getTotalAmount(){Enumeration env = orders.elements();double totalAmount = 0.0;while (env.hasMoreElements()) {Order order = (Order) env.nextElement();totalAmount += order.getAmout();}return totalAmount;}void printDetail(double totalAmount){System.out.println("name:" + name);System.out.println("amount:" + totalAmount);}

推荐指数:四星

使用多态或者适当的设计模式替代复杂冗长的if...else/switch

比如:

 int getArea() {switch (shape){case SHAPE.CIRCLE:return 3.14 * _r * _r; break;case SHAPE.RECTANGEL;return width *,heigth;}}

使用多态后:

class Shape {int getArea(){};}class Circle extends Shape {int getArea() {return 3.14 * r * r; }}class Rectangel extends Shape {int getArea() {return width * heigth;}}

推荐指数:三星

项目结构需要轮廓分明,简言之分包名划分清楚。

说明:如下为rocketMq源码项目结构图。

推荐指数:四星

代码格式优雅

优雅的代码格式,是使代码有个好看的皮囊,所以平时写代码注意用快捷键优化一下格式。

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

  • 1) 左大括号前不换行。

  • 2) 左大括号后换行。

  • 3) 右大括号前换行。

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

推荐指数:五星

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

反例:

if (空格 a == b 空格)

推荐指数:五星

不同逻辑、不同语义、不同业务的代码之间插入一个空行分隔开来以提升可读性。

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

推荐指数:四星

效率性

单单有好看的皮囊当然还是不够,还要持久实用呢,才能称得上好腰杆代码。阿里开发手册以下几点,都有助于提高代码性能。当然,除了这些,还有日常开发中,哪些代码流程是否可以优化,哪些接口是否调用多了,那些代码是不是没用到。总之,这个要看自己总结与积累。

集合初始化时,指定集合初始值大小。

说明:HashMap 使用 HashMap(int initialCapacity) 初始化。

正例:initialCapacity = (需要存储的元素个数 / 负载因子) + 1。注意负载因子(即loader factor)默认为 0.75,如果暂时无法确定初始值大小,请设置为 16(即默认值)。

反例:HashMap 需要放置 1024 个元素,由于没有设置容量初始大小,随着元素不断增加,容 量 7 次被迫扩大,resize 需要重建 hash 表,严重影响性能。

推荐指数:四星

线程资源必须通过线程池提供,不允许在应用中自行显式创建线程。

说明:使用线程池的好处是减少在创建和销毁线程上所消耗的时间以及系统资源的开销,解决 资源不足的问题。如果不使用线程池,有可能造成系统创建大量同类线程而导致消耗完内存或 者“过度切换”的问题。

对于接口性能,可以考虑缓存,分批,SQl索引等这些手段。

说明:以上几点,是针对代码块的性能优化。对于接口,跟SQL有关的话,考虑添加索引等手段,如果涉及大量数据,可以考虑分批思想,还可以考虑添加缓存,冷热数据区分等。

安全性

安全性对于好代码的判断标准,具有一票否决权。对于这一点,我们平时可以积累,避开以下一些雷区外,有时间可以看一些常用框架,中间件的源码,如rocketMq,sring,jdk源码等,学习里面一些写法,以及避开可能的坑。

Object 的 equals 方法容易抛空指针异常,应使用常量或确定有值的对象来调用 equals

正例:"test".equals(object);

反例:object.equals("test");

说明:推荐使用 java.util.Objects#equals(JDK7 引入的工具类)

推荐指数:五星。

ArrayList的subList结果不可强转成ArrayList,否则会抛出ClassCastException 异常,即 java.util.RandomAccessSubList cannot be cast to java.util.ArrayList

理由:subList 返回的是 ArrayList 的内部类 SubList,并不是 ArrayList 而是 ArrayList 的一个视图,对于 SubList 子列表的所有操作最终会反映到原列表上

推荐指数:五星。

用户请求传入的任何参数必须做有效性验证。

说明:忽略参数校验可能导致:

  • page size 过大导致内存溢出

  • 恶意 order by 导致数据库慢查询

  • 任意重定向

  • SQL 注入

  • 反序列化注入

  • 正则输入源串拒绝服务 ReDoS

说明:Java 代码用正则来验证客户端的输入,有些正则写法验证普通用户输入没有问题, 但是如果攻击人员使用的是特殊构造的字符串来验证,有可能导致死循环的结果。

推荐指数:五星。

慎用无界队列线程池,如newFixedThreadPool线程池导致的内存飙升。

说明:newFixedThreadPool线程池可能导致的内存飙升问题,是因为它使用了无界队列。所以这些点需要我们积累以及看一下常用类的源码,如线程池,AQS等等。

推荐指数:三星。

总结

所以具有以下几点特性的代码,就是好代码

  • 好的命名

  • 清晰的结构

  • 优雅的格式

  • 性能好,效率高

  • 安全稳定

平时我们可以多点积累,看书,看源码,着这里给大家推荐几本书

  • 阿里巴巴Java开发书册》

  • 《重构 改善既有代码的设计》

  • 《Spring源码深度解析》

  • 《HeadFirst设计模式》

参考与感谢

  • 《阿里巴巴Java开发书册》

  • 《重构 改善既有代码的设计》

个人公众号

  • 如果你是个爱学习的好孩子,可以关注我公众号,一起学习讨论。

  • 如果你觉得本文有哪些不正确的地方,可以评论,也可以关注我公众号,私聊我,大家一起学习进步哈。

这篇关于金秋十月,读阿里JAVA开发手册有感而发的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!


原文地址:https://blog.csdn.net/weiwenhou/article/details/102645131
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.chinasem.cn/article/275387

相关文章

Spring Boot中WebSocket常用使用方法详解

《SpringBoot中WebSocket常用使用方法详解》本文从WebSocket的基础概念出发,详细介绍了SpringBoot集成WebSocket的步骤,并重点讲解了常用的使用方法,包括简单消... 目录一、WebSocket基础概念1.1 什么是WebSocket1.2 WebSocket与HTTP

SpringBoot+Docker+Graylog 如何让错误自动报警

《SpringBoot+Docker+Graylog如何让错误自动报警》SpringBoot默认使用SLF4J与Logback,支持多日志级别和配置方式,可输出到控制台、文件及远程服务器,集成ELK... 目录01 Spring Boot 默认日志框架解析02 Spring Boot 日志级别详解03 Sp

java中反射Reflection的4个作用详解

《java中反射Reflection的4个作用详解》反射Reflection是Java等编程语言中的一个重要特性,它允许程序在运行时进行自我检查和对内部成员(如字段、方法、类等)的操作,本文将详细介绍... 目录作用1、在运行时判断任意一个对象所属的类作用2、在运行时构造任意一个类的对象作用3、在运行时判断

java如何解压zip压缩包

《java如何解压zip压缩包》:本文主要介绍java如何解压zip压缩包问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录Java解压zip压缩包实例代码结果如下总结java解压zip压缩包坐在旁边的小伙伴问我怎么用 java 将服务器上的压缩文件解压出来,

SpringBoot中SM2公钥加密、私钥解密的实现示例详解

《SpringBoot中SM2公钥加密、私钥解密的实现示例详解》本文介绍了如何在SpringBoot项目中实现SM2公钥加密和私钥解密的功能,通过使用Hutool库和BouncyCastle依赖,简化... 目录一、前言1、加密信息(示例)2、加密结果(示例)二、实现代码1、yml文件配置2、创建SM2工具

Spring WebFlux 与 WebClient 使用指南及最佳实践

《SpringWebFlux与WebClient使用指南及最佳实践》WebClient是SpringWebFlux模块提供的非阻塞、响应式HTTP客户端,基于ProjectReactor实现,... 目录Spring WebFlux 与 WebClient 使用指南1. WebClient 概述2. 核心依

Spring Boot @RestControllerAdvice全局异常处理最佳实践

《SpringBoot@RestControllerAdvice全局异常处理最佳实践》本文详解SpringBoot中通过@RestControllerAdvice实现全局异常处理,强调代码复用、统... 目录前言一、为什么要使用全局异常处理?二、核心注解解析1. @RestControllerAdvice2

Spring IoC 容器的使用详解(最新整理)

《SpringIoC容器的使用详解(最新整理)》文章介绍了Spring框架中的应用分层思想与IoC容器原理,通过分层解耦业务逻辑、数据访问等模块,IoC容器利用@Component注解管理Bean... 目录1. 应用分层2. IoC 的介绍3. IoC 容器的使用3.1. bean 的存储3.2. 方法注

Spring事务传播机制最佳实践

《Spring事务传播机制最佳实践》Spring的事务传播机制为我们提供了优雅的解决方案,本文将带您深入理解这一机制,掌握不同场景下的最佳实践,感兴趣的朋友一起看看吧... 目录1. 什么是事务传播行为2. Spring支持的七种事务传播行为2.1 REQUIRED(默认)2.2 SUPPORTS2

怎样通过分析GC日志来定位Java进程的内存问题

《怎样通过分析GC日志来定位Java进程的内存问题》:本文主要介绍怎样通过分析GC日志来定位Java进程的内存问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录一、GC 日志基础配置1. 启用详细 GC 日志2. 不同收集器的日志格式二、关键指标与分析维度1.