X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=docs%2Fclasses%2FFixedThreadPool.html;h=b0447260169ffc39b243e3fa2c43855c988917eb;hb=f9a95a93439b96a3ba1262ef807e1ba39b65bca4;hp=b8b8e4a84c8891535718d2298c9bdce134c0b3d3;hpb=881050e41e8c464ce0c3537d05898bd42ed87631;p=poolifier.git diff --git a/docs/classes/FixedThreadPool.html b/docs/classes/FixedThreadPool.html index b8b8e4a8..b0447260 100644 --- a/docs/classes/FixedThreadPool.html +++ b/docs/classes/FixedThreadPool.html @@ -6,7 +6,7 @@
Readonly
fileProtected
next
Id of the next message.
+Path to the worker-file.
Of Workers
-Readonly
number
-Readonly
optsOptions for the pool.
+Inherited from AbstractPool.opts
-- Defined in src/pools/abstract-pool.ts:81
Map
-Protected
promiseThe promise map.
+ Response Map
+Protected
promiseThe execution response promise map.
-
-
+
+
-key
: This is the message Id of each submitted task.value
: An object that contains the worker, the resolve function and the reject function.key
: The message id of each submitted task.value
: An object that contains the worker, the execution response promise resolve and reject callbacks.When we receive a message from the worker we get a map entry and resolve/reject the promise based on the message.
+When we receive a message from the worker, we get a map entry with the promise resolve/reject bound to the message id.
Inherited from AbstractPool.promiseMap
+Inherited from AbstractPool.promiseResponseMap
-- Defined in src/pools/abstract-pool.ts:50
Protected
workerWorker choice strategy instance implementing the worker choice algorithm.
-Default to a strategy implementing a round robin algorithm.
+Worker choice strategy context referencing a worker choice algorithm implementation.
+Default to a round robin algorithm.
Inherited from AbstractPool.workerChoiceStrategyContext
-- Defined in src/pools/abstract-pool.ts:65
-Readonly
workers Nodes
+Readonly
workerInherit Doc
Inherited from AbstractPool.workers
+Inherited from AbstractPool.workerNodes
-- Defined in src/pools/abstract-pool.ts:31
Tasks Usage
-Readonly
workersInherit Doc
Inherited from AbstractPool.workersTasksUsage
--- Defined in src/pools/abstract-pool.ts:34
Accessors
Returns boolean
Overrides AbstractPool.busy
-- Defined in src/pools/thread/fixed.ts:95
number Of Running Tasks
--- get numberOfRunningTasks(): number
+- Defined in src/pools/thread/fixed.ts:105
full
++- get full(): boolean
-
+
+
Inherit Doc
Returns boolean
Overrides AbstractPool.full
++- Defined in src/pools/thread/fixed.ts:100
Of Queued Tasks
+Private
number+- get numberOfQueuedTasks(): number
+-
+
+
+
Number of tasks queued in the pool.
+Returns number
Inherited from AbstractPool.numberOfQueuedTasks
++- Defined in src/pools/abstract-pool.ts:166
Of Running Tasks
+Private
number+- get numberOfRunningTasks(): number
+-
+
Number of tasks running in the pool.
+Returns number
Inherited from AbstractPool.numberOfRunningTasks
-- Defined in src/pools/abstract-pool.ts:151
type
@@ -240,32 +247,32 @@
Returns PoolType
Overrides AbstractPool.type
-- Defined in src/pools/thread/fixed.ts:90
Methods
- Promise Worker Response Hook
+Protected
afterProtected
after-- after
Promise Worker Response Hook(message: MessageValue<Response, unknown>, promise: PromiseWorkerResponseWrapper<ThreadWorkerWithMessageChannel, Response>): void
+- after
Task Execution Hook(worker: ThreadWorkerWithMessageChannel, message: MessageValue<Response, unknown>): void
-
-
-
-
-
-
-
+- Defined in src/pools/abstract-pool.ts:304
Worker Setup
-
-- Defined in src/pools/thread/fixed.ts:85
+
+ Task Execution Hook
Hook executed after the worker task promise resolution. +
Hook executed after the worker task execution. Can be overridden.
Parameters
message: MessageValue<Response, unknown>
-The received message.
+worker: ThreadWorkerWithMessageChannel
+The worker.
promise: PromiseWorkerResponseWrapper<ThreadWorkerWithMessageChannel, Response>
-The Promise response.
+message: MessageValue<Response, unknown>
+The received message.
Returns void
Inherited from AbstractPool.afterPromiseWorkerResponseHook
+Inherited from AbstractPool.afterTaskExecutionHook
-- Defined in src/pools/abstract-pool.ts:260
Protected
after@@ -281,53 +288,53 @@ Can be overridden.
Returns void
Overrides AbstractPool.afterWorkerSetup
-- Defined in src/pools/thread/fixed.ts:80
Promise Worker Response Hook
+Protected
beforeProtected
before-- before
Promise Worker Response Hook(worker: ThreadWorkerWithMessageChannel): void
+- before
Task Execution Hook(workerNodeKey: number): void
-
-
-
-
-
-
-- Defined in src/pools/abstract-pool.ts:293
+
+ Worker Node
+- Defined in src/pools/abstract-pool.ts:189
Hook
- setup
Hook(): void
-
-
+- Defined in src/pools/abstract-pool.ts:278
Listener
- worker
Listener(): ((message: MessageValue<Response, unknown>) => void)
-
-
@@ -590,7 +515,7 @@ to run code before workers are created in the abstract constructor.
- (message: MessageValue<Response, unknown>): void
-
-
@@ -602,7 +527,7 @@ to run code before workers are created in the abstract constructor.
+ - Defined in src/pools/abstract-pool.ts:422
Hook executed before the worker task promise resolution. +
Hook executed before the worker task execution. Can be overridden.
Parameters
worker: ThreadWorkerWithMessageChannel
-The worker.
+workerNodeKey: number
+The worker node key.
Returns void
Inherited from AbstractPool.beforePromiseWorkerResponseHook
+Inherited from AbstractPool.beforeTaskExecutionHook
-- Defined in src/pools/abstract-pool.ts:249
Worker
+Protected
chooseProtected
choose-- choose
Worker(): ThreadWorkerWithMessageChannel
+- choose
Worker Node(): [number, WorkerNode<ThreadWorkerWithMessageChannel, Data>]
-
-
-
-
+
+- Defined in src/pools/abstract-pool.ts:337
And Setup Worker
- create
And Setup Worker(): ThreadWorkerWithMessageChannel
-
-
+- Defined in src/pools/abstract-pool.ts:399
Worker
+- Defined in src/pools/thread/fixed.ts:78
+- Defined in src/pools/abstract-pool.ts:256
+- Defined in src/pools/thread/fixed.ts:54
-
-
-
-- Defined in src/pools/abstract-pool.ts:228
+
+
-
-
-
-
-
-- Defined in src/pools/abstract-pool.ts:221
+
+ Busy
-
-
+- Defined in src/pools/abstract-pool.ts:216
Main
+- Defined in src/pools/thread/fixed.ts:49
-
-
+- Defined in src/pools/thread/fixed.ts:70
To Worker
+- Defined in src/pools/thread/fixed.ts:62
+
Chooses a worker for the next task.
-The default implementation uses a round robin algorithm to distribute the load.
+Chooses a worker node for the next task.
+The default uses a round robin algorithm to distribute the load.
-Returns
Worker.
+Returns
[worker node key, worker node].
Returns ThreadWorkerWithMessageChannel
Inherited from AbstractPool.chooseWorker
+Returns [number, WorkerNode<ThreadWorkerWithMessageChannel, Data>]
Inherited from AbstractPool.chooseWorkerNode
-- Defined in src/pools/abstract-pool.ts:287
Protected
createCreates a new worker for this pool and sets it up completely.
+Creates a new worker and sets it up completely in the pool worker nodes.
Returns
New, completely set up worker.
Returns ThreadWorkerWithMessageChannel
Inherited from AbstractPool.createAndSetupWorker
-- Defined in src/pools/abstract-pool.ts:341
Protected
create@@ -338,7 +345,7 @@ Can be overridden.
Returns ThreadWorkerWithMessageChannel
Overrides AbstractPool.createWorker
-- Defined in src/pools/thread/fixed.ts:73
destroy
@@ -349,7 +356,7 @@ Can be overridden.
Returns Promise<void>
Inherited from AbstractPool.destroy
-- Defined in src/pools/abstract-pool.ts:219
destroy Worker
@@ -365,7 +372,7 @@ Can be overridden.
Returns Promise<void>
Overrides AbstractPool.destroyWorker
-- Defined in src/pools/thread/fixed.ts:49
execute
@@ -381,91 +388,27 @@ Can be overridden.
Returns Promise<Response>
Inherited from AbstractPool.execute
-- Defined in src/pools/abstract-pool.ts:205
find Free Worker
--- find
Free Worker(): false | ThreadWorkerWithMessageChannel
--
-
-
-
-
Inherit Doc
Returns false | ThreadWorkerWithMessageChannel
Inherited from AbstractPool.findFreeWorker
--- Defined in src/pools/abstract-pool.ts:194
get Worker Average Tasks Run Time
+find Free Worker Node Key
-- get
Worker Average Tasks Run Time(worker: ThreadWorkerWithMessageChannel): undefined | number
+- find
Free Worker Node Key(): number
-
-
-
-
-
Inherit Doc
Parameters
---
-
worker: ThreadWorkerWithMessageChannel
Returns undefined | number
Inherited from AbstractPool.getWorkerAverageTasksRunTime
--- Defined in src/pools/abstract-pool.ts:166
get Worker Index
--- get
Worker Index(worker: ThreadWorkerWithMessageChannel): number
--
-
-
-
-
-
Inherit Doc
Parameters
---
-
worker: ThreadWorkerWithMessageChannel
Returns number
Inherited from AbstractPool.getWorkerIndex
--- Defined in src/pools/abstract-pool.ts:156
get Worker Running Tasks
--- get
Worker Running Tasks(worker: ThreadWorkerWithMessageChannel): undefined | number
--
-
-
-
-
-
-
Inherit Doc
Parameters
---
-
worker: ThreadWorkerWithMessageChannel
Returns undefined | number
Inherited from AbstractPool.getWorkerRunningTasks
+Inherited from AbstractPool.findFreeWorkerNodeKey
-- Defined in src/pools/abstract-pool.ts:161
Execute
+Protected
internalProtected
internal-- internal
Execute(worker: ThreadWorkerWithMessageChannel, messageId: number): Promise<Response>
--
-
-
-
-
Parameters
---
-
--
-
worker: ThreadWorkerWithMessageChannel
messageId: number
Returns Promise<Response>
Inherited from AbstractPool.internalExecute
--- Defined in src/pools/abstract-pool.ts:312
Get Busy Status
-Protected
internal-- internal
Get Busy Status(): boolean
+- internal
Busy(): boolean
-
-
Returns boolean
Inherited from AbstractPool.internalGetBusyStatus
+Inherited from AbstractPool.internalBusy
-- Defined in src/pools/abstract-pool.ts:186
Protected
is@@ -476,7 +419,7 @@ Can be overridden.
Returns boolean
Overrides AbstractPool.isMain
-- Defined in src/pools/thread/fixed.ts:44
register Worker Message Listener
@@ -510,25 +453,7 @@ Can be overridden.
Returns void
Overrides AbstractPool.registerWorkerMessageListener
-- Defined in src/pools/thread/fixed.ts:65
Worker
-Protected
remove-- remove
Worker(worker: ThreadWorkerWithMessageChannel): void
--
-
-
-
-
-
Removes the given worker from the pool.
-Parameters
---
-
worker: ThreadWorkerWithMessageChannel
-The worker that will be removed.
-Returns void
Inherited from AbstractPool.removeWorker
--- Defined in src/pools/abstract-pool.ts:274
Protected
send@@ -546,11 +471,11 @@ Can be overridden.
Returns void
Overrides AbstractPool.sendToWorker
-- Defined in src/pools/thread/fixed.ts:57
set Worker Choice Strategy
-- set
Worker Choice Strategy(workerChoiceStrategy: "ROUND_ROBIN" | "LESS_RECENTLY_USED" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN"): void
+- set
Worker Choice Strategy(workerChoiceStrategy: "ROUND_ROBIN" | "LESS_USED" | "LESS_BUSY" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN"): void
-
@@ -558,29 +483,29 @@ Can be overridden.
-
-
Inherit Doc
Parameters
workerChoiceStrategy: "ROUND_ROBIN" | "LESS_RECENTLY_USED" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN"
workerChoiceStrategy: "ROUND_ROBIN" | "LESS_USED" | "LESS_BUSY" | "FAIR_SHARE" | "WEIGHTED_ROUND_ROBIN"
Returns void
Inherited from AbstractPool.setWorkerChoiceStrategy
-- Defined in src/pools/abstract-pool.ts:171
Protected
setupSetup hook that can be overridden by a Poolifier pool implementation -to run code before workers are created in the abstract constructor.
+Setup hook to execute code before worker node are created in the abstract constructor. +Can be overridden
Returns void
Inherited from AbstractPool.setupHook
-- Defined in src/pools/abstract-pool.ts:234
Protected
workerThis function is the listener registered for each worker.
+This function is the listener registered for each worker message.
Returns
The listener function to execute when a message is received from a worker.
This function is the listener registered for each worker.
+This function is the listener registered for each worker message.
Returns
The listener function to execute when a message is received from a worker.
Returns void
Inherited from AbstractPool.workerListener
-- Defined in src/pools/abstract-pool.ts:365
@@ -631,34 +556,29 @@ to run code before workers are created in the abstract constructor.- constructor
- emitter?
- file
Path
-- next
Message Id
- number
Of Workers
- opts
-- promise
Map
+- promise
Response Map
- worker
Choice Strategy Context
-- workers
-- workers
Tasks Usage
+- worker
Nodes
- busy
-- number
Of Running Tasks
+- full
+- number
Of Queued Tasks
+- number
Of Running Tasks
- type
-- after
Promise Worker Response Hook
+- after
Task Execution Hook
- after
Worker Setup
-- before
Promise Worker Response Hook
-- choose
Worker
+- before
Task Execution Hook
+- choose
Worker Node
- create
And Setup Worker
- create
Worker
- destroy
- destroy
Worker
- execute
-- find
Free Worker
-- get
Worker Average Tasks Run Time
-- get
Worker Index
-- get
Worker Running Tasks
-- internal
Execute
-- internal
Get Busy Status
+- find
Free Worker Node Key
+- internal
Busy
- is
Main
- register
Worker Message Listener
-- remove
Worker
- send
To Worker
- set
Worker Choice Strategy
- setup
Hook