feat: Implement blocking queue SPI extension and add documentation (#1612)

* Add BlockingQueueManager

* Remove hardcoded queues

* Add queue extension and switching test code

* Add a custom queue documents

* Update queue switching description

* fix: upgrade Mockito to 4.11.0

* optimize ThreadPoolRebuilder

* Add custom SPI blocking queue type support

* fix:  Enable inline mock maker to support static mocks

* Apply default capacity for custom queue types

* Remove ThreadPoolRebuilder runtime queue switching

* Clarify responsibilities and eliminate redundancy in BlockingQueueManager

* rollback mockito version to 3.12.4

* Update frontend static files with custom queue support

* Allow passing queue capacity to custom blocking queue SPI

Author: mingri31164

docs/docs/user_docs/dev_manual/queue-custom.md

@@ -0,0 +1,89 @@
+---
+sidebar_position: 4
+---
+
+# 阻塞队列自定义
+
+Hippo4j 通过 SPI 的方式对拒绝策略进行扩展，可以让用户在 Hippo4j 中完成自定义阻塞队列实现。
+
+## 1. 定义自定义队列类
+
+实现接口 `cn.hippo4j.common.executor.support.CustomBlockingQueue<T>`：
+
+```java
+public class MyArrayBlockingQueue implements CustomBlockingQueue<Runnable> {
+
+    @Override
+    public Integer getType() {
+        return 1001; 
+    }
+
+    @Override
+    public String getName() {
+        return "MyArrayBlockingQueue"; 
+    }
+
+    @Override
+    public BlockingQueue<Runnable> generateBlockingQueue(Integer capacity) {
+        int effectiveCapacity = capacity == null || capacity <= 0 ? 1024 : capacity;
+        return new ArrayBlockingQueue<>(effectiveCapacity);
+    }
+}
+```
+
+> 兼容提示：旧版只需实现 `generateBlockingQueue()` 的实现仍然有效，框架会在未覆写新方法时回退到旧逻辑，但推荐改为覆写带 `capacity` 入参的方法，以便直接复用服务端配置。
+
+## 2. 声明 SPI 文件
+
+在 `src/main/resources/META-INF/services/` 目录下新增文件：
+```
+cn.hippo4j.common.executor.support.CustomBlockingQueue
+```
+
+文件内容仅一行：
+```
+com.example.queue.MyArrayBlockingQueue
+```
+
+## 3. 服务端生效方式
+
+当服务端下发的 `queueType` 与 `capacity` 命中自定义类型时，框架会通过 SPI 自动创建队列，并将服务端配置的容量参数传入 `generateBlockingQueue(Integer capacity)`。
+
+### 3.1 队列创建与验证
+
+```java
+// 创建队列
+BlockingQueue<T> q = BlockingQueueTypeEnum.createBlockingQueue(queueType, capacity);
+
+// 或者通过队列名称创建
+BlockingQueue<T> q2 = BlockingQueueTypeEnum.createBlockingQueue("ArrayBlockingQueue", capacity);
+
+// 验证队列配置
+boolean valid = BlockingQueueManager.validateQueueConfig(queueType, capacity);
+
+// 动态调整容量（仅 ResizableCapacityLinkedBlockingQueue 支持）
+boolean ok = BlockingQueueManager.changeQueueCapacity(executor.getQueue(), newCapacity);
+```
+
+### 3.2 队列类型生效
+
+- **配置模板**：在线程池管理页面编辑队列类型，会保存到数据库，但不会推送到运行中的客户端。
+- **生效时机**：客户端应用重启时，会从服务端读取最新配置，并使用反射替换线程池的 `workQueue` 字段。
+- **运行时调整**：运行时仅支持队列容量的动态调整（仅限 `ResizableCapacityLinkedBlockingQueue`），不支持队列类型切换。
+
+服务端动态刷新处的实现：
+
+```java
+// ServerThreadPoolDynamicRefresh#handleQueueChanges
+// 仅支持容量调整，不支持队列类型切换
+if (parameter.getCapacity() != null) {
+    if (BlockingQueueManager.canChangeCapacity(executor.getQueue())) {
+        boolean success = BlockingQueueManager.changeQueueCapacity(
+            executor.getQueue(), parameter.getCapacity());
+        if (success) {
+            log.info("Queue capacity changed to: {} for thread pool: {}", 
+                     parameter.getCapacity(), parameter.getTpId());
+        }
+    }
+}
+```

docs/docs/user_docs/dev_manual/queue-info.md

@@ -0,0 +1,47 @@
+---
+sidebar_position: 3
+---
+
+# 内置阻塞队列
+
+Hippo4j 内置多种常用阻塞队列类型，支持开箱即用，亦可通过 SPI 扩展自定义队列类型。
+
+## 内置类型清单
+
+以下类型可直接在服务端或配置中选择（枚举：`BlockingQueueTypeEnum`）：
+
+- ArrayBlockingQueue（数组有界队列）
+- LinkedBlockingQueue（链表队列）
+- LinkedBlockingDeque（双端队列）
+- SynchronousQueue（同步移交队列）
+- LinkedTransferQueue（可转移队列）
+- PriorityBlockingQueue（优先级队列）
+- ResizableCapacityLinkedBlockingQueue（可在线动态调容量的链表队列）
+
+## 枚举定义
+
+**ResizableCapacityLinkedBlockingQueue**：支持在线变更 `capacity`。
+
+```java
+// cn.hippo4j.common.executor.support.BlockingQueueTypeEnum
+RESIZABLE_LINKED_BLOCKING_QUEUE(9, "ResizableCapacityLinkedBlockingQueue") {
+    @Override
+    <T> BlockingQueue<T> of(Integer capacity) {
+        return new ResizableCapacityLinkedBlockingQueue<>(capacity);
+    }
+    @Override
+    <T> BlockingQueue<T> of() {
+        return new ResizableCapacityLinkedBlockingQueue<>();
+    }
+}
+```
+
+## 使用建议
+
+- 需要在线调容量：优先选择 `ResizableCapacityLinkedBlockingQueue`
+- 需要严格有界：选择 `ArrayBlockingQueue`
+- 需要无界吞吐：选择 `LinkedBlockingQueue`
+- 需要优先级：选择 `PriorityBlockingQueue`
+- 需要同步移交：选择 `SynchronousQueue`
+
+如需自定义队列类型，请参考《阻塞队列自定义》。

docs/i18n/zh/docusaurus-plugin-content-docs/current/user_docs/dev_manual/queue-custom.md

@@ -0,0 +1,89 @@
+---
+sidebar_position: 4
+---
+
+# 阻塞队列自定义
+
+Hippo4j 通过 SPI 的方式对拒绝策略进行扩展，可以让用户在 Hippo4j 中完成自定义阻塞队列实现。
+
+## 1. 定义自定义队列类
+
+实现接口 `cn.hippo4j.common.executor.support.CustomBlockingQueue<T>`：
+
+```java
+public class MyArrayBlockingQueue implements CustomBlockingQueue<Runnable> {
+
+    @Override
+    public Integer getType() {
+        return 1001; 
+    }
+
+    @Override
+    public String getName() {
+        return "MyArrayBlockingQueue"; 
+    }
+
+    @Override
+    public BlockingQueue<Runnable> generateBlockingQueue(Integer capacity) {
+        int effectiveCapacity = capacity == null || capacity <= 0 ? 1024 : capacity;
+        return new ArrayBlockingQueue<>(effectiveCapacity);
+    }
+}
+```
+
+> 兼容提示：旧版只需实现 `generateBlockingQueue()` 的实现仍然有效，框架会在未覆写新方法时回退到旧逻辑，但推荐改为覆写带 `capacity` 入参的方法，以便直接复用服务端配置。
+
+## 2. 声明 SPI 文件
+
+在 `src/main/resources/META-INF/services/` 目录下新增文件：
+```
+cn.hippo4j.common.executor.support.CustomBlockingQueue
+```
+
+文件内容仅一行：
+```
+com.example.queue.MyArrayBlockingQueue
+```
+
+## 3. 服务端生效方式
+
+当服务端下发的 `queueType` 与 `capacity` 命中自定义类型时，框架会通过 SPI 自动创建队列，并将服务端配置的容量参数传入 `generateBlockingQueue(Integer capacity)`。
+
+### 3.1 队列创建与验证
+
+```java
+// 创建队列
+BlockingQueue<T> q = BlockingQueueTypeEnum.createBlockingQueue(queueType, capacity);
+
+// 或者通过队列名称创建
+BlockingQueue<T> q2 = BlockingQueueTypeEnum.createBlockingQueue("ArrayBlockingQueue", capacity);
+
+// 验证队列配置
+boolean valid = BlockingQueueManager.validateQueueConfig(queueType, capacity);
+
+// 动态调整容量（仅 ResizableCapacityLinkedBlockingQueue 支持）
+boolean ok = BlockingQueueManager.changeQueueCapacity(executor.getQueue(), newCapacity);
+```
+
+### 3.2 队列类型生效
+
+- **配置模板**：在线程池管理页面编辑队列类型，会保存到数据库，但不会推送到运行中的客户端。
+- **生效时机**：客户端应用重启时，会从服务端读取最新配置，并使用反射替换线程池的 `workQueue` 字段。
+- **运行时调整**：运行时仅支持队列容量的动态调整（仅限 `ResizableCapacityLinkedBlockingQueue`），不支持队列类型切换。
+
+服务端动态刷新处的实现：
+
+```java
+// ServerThreadPoolDynamicRefresh#handleQueueChanges
+// 仅支持容量调整，不支持队列类型切换
+if (parameter.getCapacity() != null) {
+    if (BlockingQueueManager.canChangeCapacity(executor.getQueue())) {
+        boolean success = BlockingQueueManager.changeQueueCapacity(
+            executor.getQueue(), parameter.getCapacity());
+        if (success) {
+            log.info("Queue capacity changed to: {} for thread pool: {}", 
+                     parameter.getCapacity(), parameter.getTpId());
+        }
+    }
+}
+```

docs/i18n/zh/docusaurus-plugin-content-docs/current/user_docs/dev_manual/queue-info.md

@@ -0,0 +1,47 @@
+---
+sidebar_position: 3
+---
+
+# 内置阻塞队列
+
+Hippo4j 内置多种常用阻塞队列类型，支持开箱即用，亦可通过 SPI 扩展自定义队列类型。
+
+## 内置类型清单
+
+以下类型可直接在服务端或配置中选择（枚举：`BlockingQueueTypeEnum`）：
+
+- ArrayBlockingQueue（数组有界队列）
+- LinkedBlockingQueue（链表队列）
+- LinkedBlockingDeque（双端队列）
+- SynchronousQueue（同步移交队列）
+- LinkedTransferQueue（可转移队列）
+- PriorityBlockingQueue（优先级队列）
+- ResizableCapacityLinkedBlockingQueue（可在线动态调容量的链表队列）
+
+## 枚举定义
+
+**ResizableCapacityLinkedBlockingQueue**：支持在线变更 `capacity`。
+
+```java
+// cn.hippo4j.common.executor.support.BlockingQueueTypeEnum
+RESIZABLE_LINKED_BLOCKING_QUEUE(9, "ResizableCapacityLinkedBlockingQueue") {
+    @Override
+    <T> BlockingQueue<T> of(Integer capacity) {
+        return new ResizableCapacityLinkedBlockingQueue<>(capacity);
+    }
+    @Override
+    <T> BlockingQueue<T> of() {
+        return new ResizableCapacityLinkedBlockingQueue<>();
+    }
+}
+```
+
+## 使用建议
+
+- 需要在线调容量：优先选择 `ResizableCapacityLinkedBlockingQueue`
+- 需要严格有界：选择 `ArrayBlockingQueue`
+- 需要无界吞吐：选择 `LinkedBlockingQueue`
+- 需要优先级：选择 `PriorityBlockingQueue`
+- 需要同步移交：选择 `SynchronousQueue`
+
+如需自定义队列类型，请参考《阻塞队列自定义》。