docs: update bullmq get workers

Author: czy88840616

site/docs/extensions/bullmq.md

@@ -411,6 +411,40 @@ export default {
 }
 ```
 
+### 获取任务处理器
+
+通过内置的方法，我们可以获取到原始的任务处理器（Worker）。
+
+可以启动任意多个 Worker 监听同一个队列，在这种情况下 BullMQ 会把队列中的任务轮流（round-robin）分配给这些 Worker。
+
+当队列中有任务被添加时，BullMQ 会在这两个 Worker 之间自动分配任务。
+
+我们可以通过方法 `getWorker` 获取到首个监听的 Worker 对象，也可以通过方法 `getWorkers` 获取到该队列监听的所有 Worker 对象。
+
+```typescript
+import { Configuration, Inject } from '@midwayjs/core';
+import * as bullmq from '@midwayjs/bullmq';
+
+@Configuration({
+  imports: [
+    // ...
+    bullmq,
+  ]
+})
+export class MainConfiguration {
+
+  @Inject()
+  bullmqFramework: bullmq.Framework;
+
+  async onServerReady() {
+    const testWorker = this.bullmqFramework.getWorker('test');
+    const allWorkers = this.bullmqFramework.getWorkers('test');
+  }
+}
+
+```
+
+
 ## 组件日志
 
 组件有着自己的日志，默认会将 `ctx.logger` 记录在 `midway-bullmq.log` 中。

site/docs/sidebars.json

@@ -321,6 +321,7 @@
       "items": [
         "extensions/validate",
         "extensions/cache",
+        "extensions/bull",
         "extensions/upload",
         "legacy/mongodb",
         "legacy/sequelize",

site/i18n/en/docusaurus-plugin-content-docs/current/extensions/bullmq.md

@@ -411,6 +411,40 @@ export default {
 }
 ```
 
+### Getting Task Processors
+
+Through built-in methods, we can get the original task processors (Workers).
+
+You can start any number of Workers to listen to the same queue. In this case, BullMQ will distribute tasks in the queue to these Workers in a round-robin manner.
+
+When tasks are added to the queue, BullMQ will automatically distribute tasks between these Workers.
+
+We can get the first listening Worker object through the `getWorker` method, or get all Worker objects listening to the queue through the `getWorkers` method.
+
+```typescript
+import { Configuration, Inject } from '@midwayjs/core';
+import * as bullmq from '@midwayjs/bullmq';
+
+@Configuration({
+  imports: [
+    // ...
+    bullmq,
+  ]
+})
+export class MainConfiguration {
+
+  @Inject()
+  bullmqFramework: bullmq.Framework;
+
+  async onServerReady() {
+    const testWorker = this.bullmqFramework.getWorker('test');
+    const allWorkers = this.bullmqFramework.getWorkers('test');
+  }
+}
+
+```
+
+
 ## Component Logging
 
 The component has its own logs, by default recording `ctx.logger` in `midway-bullmq.log`.

site/i18n/en/docusaurus-plugin-content-docs/version-3.0.0/extensions/bullmq.md

@@ -411,6 +411,40 @@ export default {
 }
 ```
 
+### Getting Task Processors
+
+Through built-in methods, we can get the original task processors (Workers).
+
+You can start any number of Workers to listen to the same queue. In this case, BullMQ will distribute tasks in the queue to these Workers in a round-robin manner.
+
+When tasks are added to the queue, BullMQ will automatically distribute tasks between these Workers.
+
+We can get the first listening Worker object through the `getWorker` method, or get all Worker objects listening to the queue through the `getWorkers` method.
+
+```typescript
+import { Configuration, Inject } from '@midwayjs/core';
+import * as bullmq from '@midwayjs/bullmq';
+
+@Configuration({
+  imports: [
+    // ...
+    bullmq,
+  ]
+})
+export class MainConfiguration {
+
+  @Inject()
+  bullmqFramework: bullmq.Framework;
+
+  async onServerReady() {
+    const testWorker = this.bullmqFramework.getWorker('test');
+    const allWorkers = this.bullmqFramework.getWorkers('test');
+  }
+}
+
+```
+
+
 ## Component Logging
 
 The component has its own logs, by default recording `ctx.logger` in `midway-bullmq.log`.

site/versioned_docs/version-3.0.0/extensions/bullmq.md

@@ -411,6 +411,40 @@ export default {
 }
 ```
 
+### 获取任务处理器
+
+通过内置的方法，我们可以获取到原始的任务处理器（Worker）。
+
+可以启动任意多个 Worker 监听同一个队列，在这种情况下 BullMQ 会把队列中的任务轮流（round-robin）分配给这些 Worker。
+
+当队列中有任务被添加时，BullMQ 会在这两个 Worker 之间自动分配任务。
+
+我们可以通过方法 `getWorker` 获取到首个监听的 Worker 对象，也可以通过方法 `getWorkers` 获取到该队列监听的所有 Worker 对象。
+
+```typescript
+import { Configuration, Inject } from '@midwayjs/core';
+import * as bullmq from '@midwayjs/bullmq';
+
+@Configuration({
+  imports: [
+    // ...
+    bullmq,
+  ]
+})
+export class MainConfiguration {
+
+  @Inject()
+  bullmqFramework: bullmq.Framework;
+
+  async onServerReady() {
+    const testWorker = this.bullmqFramework.getWorker('test');
+    const allWorkers = this.bullmqFramework.getWorkers('test');
+  }
+}
+
+```
+
+
 ## 组件日志
 
 组件有着自己的日志，默认会将 `ctx.logger` 记录在 `midway-bullmq.log` 中。