diff --git a/clean_java_code_rules.md b/clean_java_code_rules.md index 1d37043..865f111 100644 --- a/clean_java_code_rules.md +++ b/clean_java_code_rules.md @@ -1,14 +1,16 @@ 请遵照以下原则书写干净的Java源码: -- 请积极优先使用Lombok注解,无需担心编译速度被拖慢。 -- NULL值处理优先使用`Optional`而不是`if`。 -- 优先使用`Stream`而不是`for`循环。 -- 如果`Stream`的`map`中的代码块超过5行,单独写一个函数。 -- 如果`Stream`的`map`中代码块需要一个中间对象,请优先使用`record`类型,并且把record类源文件放到DTO目录下。 -- 方法体内的行数不得超过20行,超过行数请拆成多个方法。 -- 构建`JavaBean`对象优先使用构造函数而不是单独写工具类,只有3个以内的Bean对象,应该提供一个全部参数的构造函数。 -- 对于`Set`类型集合,除非对排序有要求,否则优先使用HashSet而不是LinkedHashSet。 -- 对于`Map`类型的变量,除非对排序要要求,否则优先使用HashMap而不是`LinkedHashMap`或者`TreeMap`。 -- 如果JDK>=21,对于IO类型的异步或并发任务,请积极使用虚拟线程处理。 +- 积极采用JDK11~21的新特性,例如:局部变量类型推断、Switch表达式、模式匹配、文本块、记录类、密封类、虚拟线程。 +- 虚拟线程应当用于IO密集型的任务,而不是CPU密集型任务。 - 为了降低代码耦合度,提高可维护性,请积极的采用工厂、模板、策略、发布订阅等常用的设计模式。 -- 在`Spring`框架中遇到某一个操作将触发多个行为变更的场景,请积极使用`ApplicationEventPublisher`与`@EventListener`解耦代码。 \ No newline at end of file +- 对于发布订阅模式,请根据以下情况判断: + - 跨服务通信、集群实例广播消息,优先使用RocketMQ消息队列。 + - 单进程通信使用ApplicationEventPublisher和@EventListener即可。 +- 请积极优先使用Lombok注解,无需担心编译速度被拖慢。 +- 对于工具类的使用,请优先采纳hutool,除非hutool没有提供才新建一个工具类。 +- 对于null处理优先使用Optional而不是if,优先使用Stream而不是循环。 +- 如果Stream的map代码块超过5行就单独写一个函数,如果map中代码块需要中间对象,优先使用记录类,记录类和DTO存放在一起。 +- 一个方法体内的行数不得超过20行,若超过20行,请拆成多个方法。 +- 构建JavaBean对象,优先使用构造函数而不是单独写工具类或方法,只有3个以内的属性,应提供一个全部参数的构造函数。 +- 对于Set集合,除非对排序有要求,否则优先使用HashSet而不是LinkedHashSet或TreeSet,如果存在并发场景,应优先使用`cn.hutool.core.collection.ConcurrentHashSet`。 +- 对于Map集合,除非对排序要要求,否则优先使用HashMap而不是LinkedHashMap或TreeMap,如果存在并发场景,应优先使用ConcurrentHashMap或ConcurrentSkipListMap。 \ No newline at end of file