DynamicThreadPool | poolifier

X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=docs%2Fclasses%2FDynamicThreadPool.html;h=9e347897eeb2da3b82e3e5c256920cba0ba62751;hb=fb8fbcfd7983c1eadc39411c9b29054e6fa97d5b;hp=b9f6083d82587950875877c2962c4f90e735a921;hpb=c4dfd49dbde2f3af0adc4a33d582b1c653f859b5;p=poolifier.git diff --git a/docs/classes/DynamicThreadPool.html b/docs/classes/DynamicThreadPool.html index b9f6083d..9e347897 100644 --- a/docs/classes/DynamicThreadPool.html +++ b/docs/classes/DynamicThreadPool.html @@ -1,4 +1,4 @@ -DynamicThreadPool | poolifier

+DynamicThreadPool | poolifier - v2.6.28

@@ -45,7 +45,7 @@ When the maximum number of threads is reached and workers are busy, an event is

DynamicThreadPool

Defined in src/pools/thread/dynamic.ts:15

@@ -73,23 +73,32 @@ When the maximum number of threads is reached and workers are busy, an event is info maxSize minSize +ready type +utilization worker

Methods

afterTaskExecutionHook -afterWorkerSetup +afterWorkerNodeSetup beforeTaskExecutionHook -createAndSetupDynamicWorker -createAndSetupWorker +checkDynamicPoolSize +createAndSetupDynamicWorkerNode +createAndSetupWorkerNode createWorker destroy -destroyWorker +destroyWorkerNode enableTasksQueue execute +flushTasksQueue +getWorkerInfo internalBusy isMain +listTaskFunctions +registerWorkerMessageListener +sendKillMessageToWorker +sendStartupMessageToWorker sendToWorker setTasksQueueOptions setWorkerChoiceStrategy @@ -140,7 +149,7 @@ When the maximum number of threads is reached and workers are busy, an event is

Defined in src/pools/thread/dynamic.ts:27

Properties

@@ -149,8 +158,10 @@ When the maximum number of threads is reached and workers are busy, an event is

Emitter on which events can be listened to.

Events that can currently be listened to:

'full': Emitted when the pool is dynamic and full.
'busy': Emitted when the pool is busy.
'ready': Emitted when the number of workers created in the pool has reached the minimum size expected and are ready.
'busy': Emitted when the number of workers created in the pool has reached the maximum size expected and are executing at least one task.
'full': Emitted when the pool is dynamic and the number of workers created has reached the maximum size expected.
'destroy': Emitted when the pool is destroyed.
'error': Emitted when an uncaught error occurs.
'taskError': Emitted when an error occurs while executing a task.

@@ -158,7 +169,7 @@ When the maximum number of threads is reached and workers are busy, an event is

Defined in src/pools/abstract-pool.ts:65

`Protected` `Readonly` filePath

filePath: string

@@ -167,7 +178,7 @@ When the maximum number of threads is reached and workers are busy, an event is

Defined in src/pools/abstract-pool.ts:109

`Protected` `Readonly` max

max: number

@@ -175,7 +186,7 @@ When the maximum number of threads is reached and workers are busy, an event is

Defined in src/pools/thread/dynamic.ts:29

`Protected` `Readonly` numberOfWorkers

numberOfWorkers: number

@@ -184,7 +195,7 @@ When the maximum number of threads is reached and workers are busy, an event is

Defined in src/pools/abstract-pool.ts:108

`Protected` `Readonly` opts

opts: ThreadPoolOptions = {}

@@ -193,11 +204,11 @@ When the maximum number of threads is reached and workers are busy, an event is

Defined in src/pools/thread/fixed.ts:49

`Protected` promiseResponseMap

promiseResponseMap: Map<string, PromiseResponseWrapper<Worker, Response>> = ...

The execution response promise map.

promiseResponseMap: Map<string, PromiseResponseWrapper<Response>> = ...

The task execution response promise map.

key: The message id of each submitted task.
value: An object that contains the worker, the execution response promise resolve and reject callbacks.

Defined in src/pools/abstract-pool.ts:75

`Protected` workerChoiceStrategyContext

workerChoiceStrategyContext: WorkerChoiceStrategyContext<Worker, Data, Response>

@@ -216,16 +227,16 @@ When the maximum number of threads is reached and workers are busy, an event is

Defined in src/pools/abstract-pool.ts:81

`Readonly` workerNodes

workerNodes: WorkerNode<Worker, Data>[] = []

workerNodes: IWorkerNode<Worker, Data>[] = []

Pool worker nodes.

Defined in src/pools/abstract-pool.ts:62

Accessors

@@ -240,7 +251,7 @@ When the maximum number of threads is reached and workers are busy, an event is

Defined in src/pools/thread/dynamic.ts:48

`Protected` full

Defined in src/pools/abstract-pool.ts:615

info

Defined in src/pools/abstract-pool.ts:308

`Protected` maxSize

get maxSize(): number
-
Pool maximum size.
+
The pool maximum size.

Returns number
Overrides FixedThreadPool.maxSize
- Defined in src/pools/thread/dynamic.ts:42

Defined in src/pools/thread/dynamic.ts:43

`Protected` minSize

get minSize(): number
-
Pool minimum size.
+
The pool minimum size.

Returns number
Inherited from FixedThreadPool.minSize
- Defined in src/pools/thread/fixed.ts:91

Defined in src/pools/thread/fixed.ts:132

`Private` ready

get ready(): boolean
+
The pool readiness boolean status.
+
+
Returns boolean
+
+
Inherited from FixedThreadPool.ready
+
- Defined in src/pools/abstract-pool.ts:451

`Protected` type

get type(): "fixed" | "dynamic"
-
Pool type.
+
The pool type.

If it is 'dynamic', it provides the max property.

Returns "fixed" | "dynamic"
Overrides FixedThreadPool.type
- Defined in src/pools/thread/dynamic.ts:37

Defined in src/pools/thread/dynamic.ts:38

`Private` utilization

get utilization(): number
+
The approximate pool utilization.
+
+
Returns number
The pool utilization.
+ +
+
Inherited from FixedThreadPool.utilization
+
- Defined in src/pools/abstract-pool.ts:468

`Protected` worker

get worker(): "cluster" | "thread"
get worker(): "thread" | "cluster"
-
Gets the worker type.
+
The worker type.

-
Returns "cluster" | "thread"
+
Returns "thread" | "cluster"
Inherited from FixedThreadPool.worker
- Defined in src/pools/thread/fixed.ts:86

Defined in src/pools/thread/fixed.ts:127

Methods

`Protected` afterTaskExecutionHook

afterTaskExecutionHook(worker, message): void
afterTaskExecutionHook(workerNodeKey, message): void
Hook executed after the worker task execution. Can be overridden.
@@ -329,8 +365,8 @@ Can be overridden.

Parameters
- -
  worker: Worker
  -
  The worker.
  +
  workerNodeKey: number
  +
  The worker node key.
- @@ -342,28 +378,28 @@ Can be overridden.
  Inherited from FixedThreadPool.afterTaskExecutionHook
  - Defined in src/pools/abstract-pool.ts:504

`Protected` afterWorkerSetup

Defined in src/pools/abstract-pool.ts:795

`Protected` afterWorkerNodeSetup

afterWorkerSetup(worker): void
afterWorkerNodeSetup(workerNodeKey): void
-
Function that can be hooked up when a worker has been newly created and moved to the pool worker nodes. +
Method hooked up after a worker node has been newly created. Can be overridden.
Parameters
- -
  worker: Worker
  -
  The newly created worker.
  +
  workerNodeKey: number
  +
  The newly created worker node key.
Returns void
-
Inherited from FixedThreadPool.afterWorkerSetup
+
Inherited from FixedThreadPool.afterWorkerNodeSetup
- Defined in src/pools/abstract-pool.ts:696

Defined in src/pools/abstract-pool.ts:1028

`Protected` beforeTaskExecutionHook

`Protected` createAndSetupDynamicWorker

Defined in src/pools/abstract-pool.ts:774

`Protected` checkDynamicPoolSize

createAndSetupDynamicWorker(): Worker
checkDynamicPoolSize(min, max): void
-
Creates a new dynamic worker and sets it up completely in the pool worker nodes.
+
+
Parameters
+
- +
  min: number
- +
  max: number
+
Returns void
+
Inherited from FixedThreadPool.checkDynamicPoolSize
+
- Defined in src/pools/abstract-pool.ts:180

`Protected` createAndSetupDynamicWorkerNode

createAndSetupDynamicWorkerNode(): number
+
Creates a new, completely set up dynamic worker node.

-
Returns Worker
New, completely set up dynamic worker.
+
Returns number
New, completely set up dynamic worker node key.
-
Inherited from FixedThreadPool.createAndSetupDynamicWorker
+
Inherited from FixedThreadPool.createAndSetupDynamicWorkerNode
- Defined in src/pools/abstract-pool.ts:739

`Protected` createAndSetupWorker

Defined in src/pools/abstract-pool.ts:975

`Protected` createAndSetupWorkerNode

createAndSetupWorker(): Worker
createAndSetupWorkerNode(): number
-
Creates a new worker and sets it up completely in the pool worker nodes.
+
Creates a new, completely set up worker node.

-
Returns Worker
New, completely set up worker.
+
Returns number
New, completely set up worker node key.
-
Inherited from FixedThreadPool.createAndSetupWorker
+
Inherited from FixedThreadPool.createAndSetupWorkerNode
- Defined in src/pools/abstract-pool.ts:706

Defined in src/pools/abstract-pool.ts:935

`Protected` createWorker

Defined in src/pools/thread/fixed.ts:114

destroy

destroy(): Promise<void>
-
Terminate every current worker in this pool.
+
Terminates all workers in this pool.

Returns Promise<void>
Inherited from FixedThreadPool.destroy
- Defined in src/pools/abstract-pool.ts:449

`Protected` destroyWorker

Defined in src/pools/abstract-pool.ts:720

`Protected` destroyWorkerNode

destroyWorker(worker): Promise<void>
destroyWorkerNode(workerNodeKey): Promise<void>
-
Terminates the given worker.
+
Terminates the worker node given its worker node key.
Parameters
- -
  worker: Worker
  -
  A worker within workerNodes.
  +
  workerNodeKey: number
  +
  The worker node key.
Returns Promise<void>
-
Inherited from FixedThreadPool.destroyWorker
+
Inherited from FixedThreadPool.destroyWorkerNode
- Defined in src/pools/thread/fixed.ts:62

Defined in src/pools/thread/fixed.ts:60

enableTasksQueue

Defined in src/pools/abstract-pool.ts:580

execute

execute(data?, name?): Promise<Response>
execute(data?, name?, transferList?): Promise<Response>
Executes the specified function in the worker constructor with the task data input parameter.

@@ -498,12 +550,17 @@ Can be overridden.
- Optional data: Data
  -
  The task input data for the specified worker function. This can only be structured-cloneable data.
  +
  The optional task input data for the specified task function. This can only be structured-cloneable data.
- Optional name: string
  -
  The name of the worker function to execute. If not specified, the default worker function will be executed.
  +
  The optional name of the task function to execute. If not specified, the default task function will be executed.
  +
  +
- +
  Optional transferList: TransferListItem[]
  +
  An optional array of transferable objects to transfer ownership of. Ownership of the transferred objects is given to the pool's worker_threads worker and they should not be used in the main thread afterwards.
Returns Promise<Response>
Promise that will be fulfilled when the task is completed.
@@ -511,20 +568,55 @@ Can be overridden.
Inherited from FixedThreadPool.execute
- Defined in src/pools/abstract-pool.ts:415

Defined in src/pools/abstract-pool.ts:661

`Protected` flushTasksQueue

flushTasksQueue(workerNodeKey): void
+
+
Parameters
+
- +
  workerNodeKey: number
+
Returns void
+
Inherited from FixedThreadPool.flushTasksQueue
+
- Defined in src/pools/abstract-pool.ts:1246

`Protected` getWorkerInfo

getWorkerInfo(workerNodeKey): WorkerInfo
+
Gets the worker information given its worker node key.
+
+
+
Parameters
+
- +
  workerNodeKey: number
  +
  The worker node key.
  +
  +
+
Returns WorkerInfo
The worker information.
+ +
+
Inherited from FixedThreadPool.getWorkerInfo
+
- Defined in src/pools/abstract-pool.ts:1185

`Protected` internalBusy

internalBusy(): boolean
-
Whether worker nodes are executing at least one task.
+
Whether worker nodes are executing concurrently their tasks quota or not.

Returns boolean
Worker nodes busyness boolean status.
Inherited from FixedThreadPool.internalBusy
- Defined in src/pools/abstract-pool.ts:406

Defined in src/pools/abstract-pool.ts:631

`Protected` isMain

Defined in src/pools/thread/fixed.ts:55

listTaskFunctions

listTaskFunctions(): string[]
+
Lists the names of task function available in this pool.
+
+
Returns string[]
The names of task function available in this pool.
+ +
+
Inherited from FixedThreadPool.listTaskFunctions
+
- Defined in src/pools/abstract-pool.ts:652

`Protected` registerWorkerMessageListener

registerWorkerMessageListener<Message>(workerNodeKey, listener): void
+
Registers a listener callback on the worker given its worker node key.
+
+
+
Type Parameters
+
- +
  Message
+
+
Parameters
+
- +
  workerNodeKey: number
  +
  The worker node key.
  +
  +
- +
  listener: ((message) => void)
  +
  The message listener callback.
  +
  +
  +
  - +
    - (message): void
    - +
      +
      Parameters
      +
      +
      +
      message: MessageValue<Message, unknown>
      +
      Returns void
+
Returns void
+
+
Inherited from FixedThreadPool.registerWorkerMessageListener
+
- Defined in src/pools/thread/fixed.ts:104

`Protected` sendKillMessageToWorker

sendKillMessageToWorker(workerNodeKey, workerId): Promise<void>
+
+
Parameters
+
- +
  workerNodeKey: number
- +
  workerId: number
+
Returns Promise<void>
+
Inherited from FixedThreadPool.sendKillMessageToWorker
+
- Defined in src/pools/abstract-pool.ts:729

`Protected` sendStartupMessageToWorker

sendStartupMessageToWorker(workerNodeKey): void
+
Sends the startup message to worker given its worker node key.
+
+
+
Parameters
+
- +
  workerNodeKey: number
  +
  The worker node key.
  +
  +
+
Returns void
+
+
Inherited from FixedThreadPool.sendStartupMessageToWorker
+
- Defined in src/pools/thread/fixed.ts:88

`Protected` sendToWorker

sendToWorker(worker, message): void
sendToWorker(workerNodeKey, message, transferList?): void
-
Sends a message to the given worker.
+
Sends a message to worker given its worker node key.
Parameters
- -
  worker: Worker
  -
  The worker which should receive the message.
  +
  workerNodeKey: number
  +
  The worker node key.
- message: MessageValue<Data, unknown>
  
  The message.
  
  +
- +
  Optional transferList: TransferListItem[]
  +
  The optional array of transferable objects.
  +
Returns void
Inherited from FixedThreadPool.sendToWorker
- Defined in src/pools/thread/fixed.ts:68

Defined in src/pools/thread/fixed.ts:77

`Protected` workerListener

workerListener(): ((message) => void)
-
This function is the listener registered for each worker message.
+
This method is the listener registered for each worker message.

Returns ((message) => void)
The listener function to execute when a message is received from a worker.
@@ -654,7 +841,7 @@ Can be overridden.
- (message): void
- -
  This function is the listener registered for each worker message.
  +
  This method is the listener registered for each worker message.
  Parameters
  @@ -667,7 +854,7 @@ Can be overridden.
  
  Inherited from FixedThreadPool.workerListener
  
  -
  Defined in src/pools/abstract-pool.ts:764

Defined in src/pools/abstract-pool.ts:1111

workerNodeKey: number

worker: Worker

workerNodeKey: number

workerNodeKey: number

Parameters

message: MessageValue<Message, unknown>

Returns void

workerNodeKey: number

Parameters