DynamicThreadPool | poolifier

X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=docs%2Fclasses%2FDynamicThreadPool.html;h=7f5443f0094c1a8c3b704cce0a765ac4b00e0c56;hb=04cb7adbacc7fb0d1b76db6122f86c52e33d136d;hp=a1a2ae7db79542b0ffb46bdb780e8fc3665e3ed0;hpb=f05afd162e34836a52c48b05781750e3421424d8;p=poolifier.git diff --git a/docs/classes/DynamicThreadPool.html b/docs/classes/DynamicThreadPool.html index a1a2ae7d..7f5443f0 100644 --- a/docs/classes/DynamicThreadPool.html +++ b/docs/classes/DynamicThreadPool.html @@ -1,4 +1,4 @@ -DynamicThreadPool | poolifier

+DynamicThreadPool | poolifier - v2.6.10

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

Data = unknown
-
Type of data sent to the worker. This can only be serializable data.
+
Type of data sent to the worker. This can only be structured-cloneable data.
Response = unknown
-
Type of execution response. This can only be serializable data.
+
Type of execution response. This can only be structured-cloneable data.

@@ -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,7 +73,10 @@ When the maximum number of threads is reached and workers are busy, an event is info maxSize minSize +ready +starting type +utilization worker

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

afterTaskExecutionHook afterWorkerSetup beforeTaskExecutionHook -chooseWorkerNode +checkDynamicPoolSize +createAndSetupDynamicWorker createAndSetupWorker createWorker destroy @@ -90,7 +94,6 @@ When the maximum number of threads is reached and workers are busy, an event is execute internalBusy isMain -registerWorkerMessageListener sendToWorker setTasksQueueOptions setWorkerChoiceStrategy @@ -141,7 +144,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

@@ -150,8 +153,9 @@ 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.
'full': Emitted when the pool is dynamic and the number of workers created has reached the maximum size expected.
'ready': Emitted when the number of workers created in the pool has reached the maximum 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.
'error': Emitted when an uncaught error occurs.
'taskError': Emitted when an error occurs while executing a task.

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

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

`Protected` `Readonly` filePath

filePath: string

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

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

`Protected` `Readonly` max

max: number

@@ -176,7 +180,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

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

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

`Protected` `Readonly` opts

opts: ThreadPoolOptions = {}

@@ -194,10 +198,10 @@ When the maximum number of threads is reached and workers are busy, an event is

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

`Protected` promiseResponseMap

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

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

The execution response promise map.

key: The message id of each submitted task.

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

`Protected` workerChoiceStrategyContext

workerChoiceStrategyContext: WorkerChoiceStrategyContext<ThreadWorkerWithMessageChannel, Data, Response>

workerChoiceStrategyContext: WorkerChoiceStrategyContext<Worker, Data, Response>

Worker choice strategy context referencing a worker choice algorithm implementation.

Default to a round robin algorithm.

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

`Readonly` workerNodes

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

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

Pool worker nodes.

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

Accessors

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

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

`Private` ready

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

`Private` starting

get starting(): boolean
+
Returns boolean
+
Inherited from FixedThreadPool.starting
+
- Defined in src/pools/abstract-pool.ts:402

`Protected` type

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

`Private` utilization

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

`Protected` worker

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

Methods

@@ -331,12 +365,12 @@ Can be overridden.

Parameters

-
worker: ThreadWorkerWithMessageChannel
+
worker: Worker

The worker.
-
message: MessageValue<Response, unknown, Worker | MessagePort>
+
message: MessageValue<Response, unknown>

The received message.

@@ -344,20 +378,20 @@ Can be overridden.

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

`Protected` afterWorkerSetup

afterWorkerSetup(worker): void
-
Function that can be hooked up when a worker has been newly created and moved to the pool worker nodes.
-
Can be used to update the maxListeners or binding the main-worker<->worker connection if not bind by default.
+
Function that can be hooked up when a worker has been newly created and moved to the pool worker nodes. +Can be overridden.
Parameters
- -
  worker: ThreadWorkerWithMessageChannel
  +
  worker: Worker
  
  The newly created worker.
@@ -365,7 +399,7 @@ Can be overridden.
Inherited from FixedThreadPool.afterWorkerSetup
- Defined in src/pools/thread/fixed.ts:104

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

`Protected` beforeTaskExecutionHook

`Protected` chooseWorkerNode

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

`Protected` checkDynamicPoolSize

checkDynamicPoolSize(min, max): void
+
+
Parameters
+
- +
  min: number
- +
  max: number
+
Returns void
+
Inherited from FixedThreadPool.checkDynamicPoolSize
+
- Defined in src/pools/abstract-pool.ts:160

`Protected` createAndSetupDynamicWorker

chooseWorkerNode(): number
createAndSetupDynamicWorker(): Worker
-
Chooses a worker node for the next task.
-
The default worker choice strategy uses a round robin algorithm to distribute the load.
+
Creates a new dynamic worker and sets it up completely in the pool worker nodes.

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

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

`Protected` createAndSetupWorker

createAndSetupWorker(): ThreadWorkerWithMessageChannel
createAndSetupWorker(): Worker
Creates a new worker and sets it up completely in the pool worker nodes.

-
Returns ThreadWorkerWithMessageChannel
New, completely set up worker.
+
Returns Worker
New, completely set up worker.
Inherited from FixedThreadPool.createAndSetupWorker
- Defined in src/pools/abstract-pool.ts:672

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

`Protected` createWorker

createWorker(): ThreadWorkerWithMessageChannel
createWorker(): Worker
-
Returns a newly created worker.
+
Creates a new worker.

-
Returns ThreadWorkerWithMessageChannel
+
Returns Worker
Newly created worker.
+
Inherited from FixedThreadPool.createWorker
- Defined in src/pools/thread/fixed.ts:96

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

destroy

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

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

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

`Protected` destroyWorker

destroyWorker(worker): Promise<void>
-
Shutdowns the given worker.
+
Terminates the given worker.
Parameters
- -
  worker: ThreadWorkerWithMessageChannel
  +
  worker: Worker
  
  A worker within workerNodes.
@@ -462,7 +512,7 @@ Can be overridden.
Inherited from FixedThreadPool.destroyWorker
- Defined in src/pools/thread/fixed.ts:72

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

enableTasksQueue

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

execute

Optional data: Data
-
The task input data for the specified worker function. This can only be serializable data.
+
The task input data for the specified worker function. This can only be structured-cloneable data.
@@ -513,16 +563,20 @@ Can be overridden.
Inherited from FixedThreadPool.execute
- Defined in src/pools/abstract-pool.ts:393

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

`Protected` internalBusy

internalBusy(): boolean
-
Returns boolean
+
Whether worker nodes are executing at least one task.
+
+
Returns boolean
Worker nodes busyness boolean status.
+ +
Inherited from FixedThreadPool.internalBusy
- Defined in src/pools/abstract-pool.ts:384

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

`Protected` isMain

`Protected` registerWorkerMessageListener

registerWorkerMessageListener<Message>(worker, listener): void
-
Registers a listener callback on the given worker.
-
-
-
Type Parameters
-
- -
  Message
-
-
Parameters
-
- -
  worker: ThreadWorkerWithMessageChannel
  -
  The worker which should register a listener.
  -
  -
- -
  listener: ((message) => void)
  -
  The message listener callback.
  -
  -
  -
  - -
    - (message): void
    - -
      -
      Parameters
      -
      -
      -
      message: MessageValue<Message, unknown, Worker | MessagePort>
      -
      Returns void
-
Returns void
-
-
Inherited from FixedThreadPool.registerWorkerMessageListener
-
- Defined in src/pools/thread/fixed.ts:88

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

`Protected` sendToWorker

Parameters

-
worker: ThreadWorkerWithMessageChannel
+
worker: Worker

The worker which should receive the message.
-
message: MessageValue<Data, unknown, Worker | MessagePort>
+
message: MessageValue<Data, unknown>

The message.

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

setTasksQueueOptions

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

setWorkerChoiceStrategy

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

setWorkerChoiceStrategyOptions

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

`Protected` setupHook

setupHook(): void
-
Setup hook to execute code before worker node are created in the abstract constructor. -Can be overridden
+
Setup hook to execute code before worker nodes are created in the abstract constructor. +Can be overridden.

Returns void
Inherited from FixedThreadPool.setupHook
- Defined in src/pools/abstract-pool.ts:451

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

`Protected` workerListener

Parameters

-
message: MessageValue<Response, unknown, Worker | MessagePort>

message: MessageValue<Response, unknown>

Returns void

The listener function to execute when a message is received from a worker.

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

WorkerTypes

availableParallelism

Generated using TypeDoc

\ No newline at end of file

Parameters

message: MessageValue<Message, unknown, Worker | MessagePort>

Returns void