DynamicClusterPool

X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=docs%2Fclasses%2FDynamicClusterPool.html;h=de0075674122a9d0b46cc59eaff29958284f73c8;hb=f6c09c25b3e7ab087ac7daebaf9cb9945798efac;hp=ae34f527d938c417ca34dfdb07def1ef26d6ab7f;hpb=afa30fd0dd5bbc5d305cc30be663966a449efc08;p=poolifier.git diff --git a/docs/classes/DynamicClusterPool.html b/docs/classes/DynamicClusterPool.html index ae34f527..de007567 100644 --- a/docs/classes/DynamicClusterPool.html +++ b/docs/classes/DynamicClusterPool.html @@ -1,4 +1,4 @@ -DynamicClusterPool | poolifier

+DynamicClusterPool | poolifier - v2.6.8

@@ -30,12 +30,12 @@ When the maximum number of workers 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 workers is reached and workers are busy, an event is

DynamicClusterPool

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

@@ -74,6 +74,7 @@ When the maximum number of workers is reached and workers are busy, an event is maxSize minSize type +utilization worker

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

afterTaskExecutionHook afterWorkerSetup beforeTaskExecutionHook -chooseWorkerNode +createAndSetupDynamicWorker createAndSetupWorker createWorker destroy @@ -90,7 +91,6 @@ When the maximum number of workers is reached and workers are busy, an event is execute internalBusy isMain -registerWorkerMessageListener sendToWorker setTasksQueueOptions setWorkerChoiceStrategy @@ -141,7 +141,7 @@ When the maximum number of workers is reached and workers are busy, an event is

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

Properties

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

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

`Protected` `Readonly` filePath

filePath: string

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

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

`Protected` `Readonly` max

max: number

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

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

`Protected` `Readonly` numberOfWorkers

numberOfWorkers: number

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

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

`Protected` `Readonly` opts

opts: ClusterPoolOptions = {}

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

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

`Protected` promiseResponseMap

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

@@ -208,17 +208,16 @@ When the maximum number of workers is reached and workers are busy, an event is

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

`Protected` workerChoiceStrategyContext

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:78

`Readonly` workerNodes

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

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

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

Accessors

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

Defined in src/pools/cluster/dynamic.ts:47

`Private` utilization

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

`Protected` worker

Defined in src/pools/cluster/fixed.ts:92

Methods

@@ -336,7 +348,7 @@ Can be overridden.

message: MessageValue<Response, Worker | MessagePort>

message: MessageValue<Response, unknown>

The received message.

@@ -344,14 +356,14 @@ Can be overridden.

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

`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
@@ -365,11 +377,11 @@ Can be overridden.
Inherited from FixedClusterPool.afterWorkerSetup
- Defined in src/pools/cluster/fixed.ts:97

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

`Protected` beforeTaskExecutionHook

beforeTaskExecutionHook(workerNodeKey): void
beforeTaskExecutionHook(workerNodeKey, task): void
Hook executed before the worker task execution. Can be overridden.
@@ -381,26 +393,30 @@ Can be overridden.

workerNodeKey: number

The worker node key.

+
+
task: Task<Data>
+
The task to execute.
+

Returns void

`Protected` chooseWorkerNode

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

`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 FixedClusterPool.chooseWorkerNode
+
Inherited from FixedClusterPool.createAndSetupDynamicWorker
- Defined in src/pools/abstract-pool.ts:554

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

`Protected` createAndSetupWorker

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

`Protected` createWorker

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

-
Returns Worker
+
Returns Worker
Newly created worker.
+
Inherited from FixedClusterPool.createWorker
- Defined in src/pools/cluster/fixed.ts:92

Defined in src/pools/cluster/fixed.ts:82

destroy

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

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

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

`Protected` destroyWorker

destroyWorker(worker): void
-
Shutdowns the given worker.
+
Terminates the given worker.
Parameters
@@ -457,7 +474,7 @@ Can be overridden.
Inherited from FixedClusterPool.destroyWorker
- Defined in src/pools/cluster/fixed.ts:73

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

enableTasksQueue

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

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.
@@ -508,16 +525,20 @@ Can be overridden.
Inherited from FixedClusterPool.execute
- Defined in src/pools/abstract-pool.ts:383

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

`Protected` internalBusy

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

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

`Protected` isMain

`Protected` registerWorkerMessageListener

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

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

`Protected` sendToWorker

-
message: MessageValue<Data, Worker | MessagePort>
+
message: MessageValue<Data, unknown>

The message.

@@ -595,7 +575,7 @@ Can be overridden.

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

setTasksQueueOptions

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

setWorkerChoiceStrategy

Parameters

-
workerChoiceStrategy: "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"
+
workerChoiceStrategy: "ROUND_ROBIN" | "LEAST_USED" | "LEAST_BUSY" | "LEAST_ELU" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN" | "INTERLEAVED_WEIGHTED_ROUND_ROBIN"

The worker choice strategy.

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

setWorkerChoiceStrategyOptions

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

`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 FixedClusterPool.setupHook
- Defined in src/pools/cluster/fixed.ts:63

Defined in src/pools/cluster/fixed.ts:58

`Protected` workerListener

Parameters

-
message: MessageValue<Response, 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:973

WorkerTypes

availableParallelism

Generated using TypeDoc

\ No newline at end of file

Parameters

message: MessageValue<Message, Worker | MessagePort>

Returns void