doc/skills
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

add

Browse Source
This commit is contained in:
V-LiuShuang
2026-09-10 13:59:27 +08:00
parent 8a19c5dadb
commit dc5e8b4cc3
1 changed files with 4 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files
mis-spec/references/coding_rules.md
+4 -4
View File
@@ -3,16 +3,16 @@
| 类目 | 使用原则 | 描述 | | 类目 | 使用原则 | 描述 |
|:--- | :--- | :--- | |:--- | :--- | :--- |
| 工单 | 适当应用 | 阅读文档[worksheet.md](../references/worksheet.md) <br/>拿捏不准请询问用户是否需要使用工单 | | 工单 | 适当应用 | 阅读文档[worksheet.md](../references/worksheet.md) <br/>拿捏不准请询问用户是否需要使用工单 |
| JDK11~21的新特性 | 积极使用 | 局部变量类型推断<br/>Switch表达式<br/>模式匹配<br/>文本块<br/>记录类<br/>密封类<br/>虚拟线程<br/>**虚拟线程应当用于IO密集型的任务，而不是CPU密集型任务。**| | JDK11~21的新特性 | 积极使用 | 局部变量类型推断、Switch表达式、模式匹配、文本块、记录类、虚拟线程。<br/>**虚拟线程应当用于IO密集型的任务，而不是CPU密集型任务。**|
| 设计模式 | 非常看重 | 为了降低代码耦合度，提高可维护性。<br/>请积极的采用工厂、模板、策略、发布订阅等常用的设计模式。<br/>一个Java源文件的代码行数不得超过300行，超出则拆成多个文件。<br/>一个方法体内的行数不得超过20行，超出则拆成多个方法。<br/>对于发布订阅模式，请根据以下情况判断：<br/>跨服务通信、集群实例广播消息，优先使用RocketMQ消息队列。<br/>进程内通信则使用ApplicationEventPublisher和@EventListener即可。| | 设计模式 | 非常看重 | 为了降低代码耦合度，提高可维护性。<br/>请积极的采用工厂、模板、策略、发布订阅等常用的设计模式。<br/>一个Java源文件的代码行数不得超过300行，超出则拆成多个文件。<br/>一个方法体内的行数不得超过20行，超出则拆成多个方法。<br/>对于发布订阅模式，请根据以下情况判断：<br/>跨服务通信、集群实例广播消息，优先使用RocketMQ消息队列。<br/>进程内通信则使用ApplicationEventPublisher和@EventListener即可。|
| Lombok注解 | 积极使用 | 无需担心编译速度被拖慢。| | Lombok注解 | 积极使用 | 无需担心编译速度被拖慢。|
| Null值处理 | 适当应用 | 优先考虑`Optional.ofNullable(obj)`而不是`if (obj == null)` | | Null值处理 | 适当应用 | 优先考虑`Optional.ofNullable(obj)`而不是`if (obj == null)` |
| Stream | 积极使用 | 优先使用Stream而不是循环，若map代码块超过5行就单独写一个方法。<br/>如果需要中间对象则优先使用记录类，记录类和DTO存放在一个目录。| | Stream | 积极使用 | 优先使用Stream而不是循环，若map代码块超过5行就单独写一个方法。<br/>如果需要中间对象则优先使用记录类，记录类和DTO存放在一个目录。|
| 工具类 | 积极使用 | 优先采纳hutool，除非hutool没有提供才新建一个工具类。| | 工具类 | 积极使用 | 优先采纳hutool，除非hutool没有提供才新建一个工具类。|
| 构建对象 | 非常看重 | 构建JavaBean对象，优先使用构造函数而不是单独写工具类或方法。<br/>只有3个以内的属性，应提供一个全部参数的构造函数。| | 构建对象 | 非常看重 | 构建JavaBean对象，优先使用构造函数而不是单独写工具类或方法。<br/>只有3个以内的属性，应提供一个全部参数的构造函数。|
| List | 适当应用 | 在非多线程场景，默认用ArrayList就够了。<br/>只有需要按照插入顺序遍历元素的场景，才考虑使用LinkedList。<br/>需考虑线程安全用CopyOnWriteArrayList。| | List | 适当应用 | 在非多线程场景，默认用`ArrayList`。<br/>有需要按照插入顺序遍历元素的场景，使用`LinkedList`。<br/>需考虑线程安全用`CopyOnWriteArrayList`。|
| Set | 适当应用 | 在非多线程场景，默认用HashSet。<br/>对排序要求考虑用LinkedHashSet或TreeSet。<br/>需考虑线程安全用：<br/>`cn.hutool.core.collection.ConcurrentHashSet`<br/>`ConcurrentSkipListSet`<br/>`CopyOnWriteArraySet`| | Set | 适当应用 | 在非多线程场景，默认用`HashSet`。<br/>按照插入顺序遍历元素的场景用`LinkedHashSet`。<br/>有排序的需求则使用`TreeSet`。<br/>需考虑线程安全用：<br/>`cn.hutool.core.collection.ConcurrentHashSet`<br/>`ConcurrentSkipListSet`<br/>`CopyOnWriteArraySet`|
| Map | 适当应用 | 在非线程场景，默认使用HashMap就够了。<br/>对排序要求考虑用LinkedHashMap或TreeMap。<br/>如果存在并发场景，用`ConcurrentHashMap`或`ConcurrentSkipListMap`。| | Map | 适当应用 | 在非线程场景，默认用`HashMap`。<br/>对排序要求考虑用LinkedHashMap或TreeMap。<br/>如果存在并发场景，用`ConcurrentHashMap`或`ConcurrentSkipListMap`。|
| Queue | 适当应用 | 要控制内存，用`ArrayBlockingQueue`。<br/>经典生产者消费者，用`LinkedBlockingQueue`。<br/>要窃取任务，用`LinkedBlockingDeque`。<br/>追求极致吞吐且不怕队列暴涨，用`ConcurrentLinkedQueue`。<br/>必须双端且高吞吐，用`ConcurrentLinkedDeque`。| | Queue | 适当应用 | 要控制内存，用`ArrayBlockingQueue`。<br/>经典生产者消费者，用`LinkedBlockingQueue`。<br/>要窃取任务，用`LinkedBlockingDeque`。<br/>追求极致吞吐且不怕队列暴涨，用`ConcurrentLinkedQueue`。<br/>必须双端且高吞吐，用`ConcurrentLinkedDeque`。|
| Lock | 适当应用 | 分布式锁使用`Redisson`相关API<br/>单机使用`ReentrantLock`、`StampedLock`。| | Lock | 适当应用 | 分布式锁使用`Redisson`相关API<br/>单机使用`ReentrantLock`、`StampedLock`。|