X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=docs%2Fclasses%2FAbstractPool.html;h=e382e9e16e85fa1b4736e8df9cfd0842e9c02057;hb=3eed67feea0f527e3ee31a6ebb1063883eec3855;hp=c67d842f1d422de5b07647acb15ad441ecc3dcb8;hpb=f8350486e75b15ed17249cda3d0a55ee807a6a9f;p=poolifier.git diff --git a/docs/classes/AbstractPool.html b/docs/classes/AbstractPool.html index c67d842f..e382e9e1 100644 --- a/docs/classes/AbstractPool.html +++ b/docs/classes/AbstractPool.html @@ -1,13 +1,13 @@ -AbstractPool | poolifier
+AbstractPool | poolifier - v2.6.45
-
+
  • The search index is not available
  • poolifier - v2.6.45 +
    @@ -17,22 +17,26 @@

    Class AbstractPool<Worker, Data, Response>Abstract

    Base class that implements some shared logic for all poolifier pools.

    -
    +
    +

    Type Parameters

    +
  • 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.

    +
    +

    Hierarchy

    +
  • Defined in src/pools/abstract-pool.ts:59
  • - +

    Constructors

    -

    Properties

    -

    Accessors

    -

    Methods

    -
    afterTaskExecutionHook -afterWorkerSetup -beforeTaskExecutionHook -buildTasksQueueOptions -checkAndEmitEvents -checkFilePath -checkNumberOfWorkers -checkPoolOptions -checkValidTasksQueueOptions -checkValidWorkerChoiceStrategy -checkValidWorkerChoiceStrategyOptions -chooseWorkerNode -createAndSetupWorker -createWorker -dequeueTask -destroy -destroyWorker -enableTasksQueue -enqueueTask -execute -executeTask -flushTasksQueue -flushTasksQueues -getWorkerNodeKey -internalBusy -isMain -pushWorkerNode -registerWorkerMessageListener -removeWorkerNode -sendToWorker -setTasksQueueOptions -setWorkerChoiceStrategy -setWorkerChoiceStrategyOptions -setWorkerNode -setWorkerNodeTasksUsage -setupHook -tasksQueueSize -updateRunTimeTasksUsage -updateWaitTimeTasksUsage -workerListener +
    addWorkerNode +afterTaskExecutionHook +afterWorkerNodeSetup +beforeTaskExecutionHook +buildTasksQueueOptions +checkAndEmitDynamicWorkerCreationEvents +checkAndEmitTaskExecutionEvents +checkAndEmitTaskQueuingEvents +checkDynamicPoolSize +checkFilePath +checkMessageWorkerId +checkNumberOfWorkers +checkPoolOptions +checkValidTasksQueueOptions +checkValidWorkerChoiceStrategy +checkValidWorkerChoiceStrategyOptions +chooseWorkerNode +createAndSetupDynamicWorkerNode +createAndSetupWorkerNode +createWorker +dequeueTask +destroy +destroyWorkerNode +enableTasksQueue +enqueueTask +execute +executeTask +flushTasksQueue +flushTasksQueues +getWorkerInfo +getWorkerNodeKeyByWorker +getWorkerNodeKeyByWorkerId +handleTaskExecutionResponse +handleWorkerReadyResponse +hasBackPressure +hasWorkerNodeBackPressure +internalBusy +isMain +listTaskFunctions +redistributeQueuedTasks +registerWorkerMessageListener +removeWorkerNode +sendKillMessageToWorker +sendStartupMessageToWorker +sendStatisticsMessageToWorker +sendToWorker +setTaskStealing +setTasksQueueOptions +setTasksQueueSize +setTasksStealingOnBackPressure +setWorkerChoiceStrategy +setWorkerChoiceStrategyOptions +setupHook +shallCreateDynamicWorker +shallExecuteTask +shallUpdateTaskFunctionWorkerUsage +start +taskStealingOnEmptyQueue +tasksQueueSize +tasksStealingOnBackPressure +unsetTaskStealing +unsetTasksStealingOnBackPressure +updateEluWorkerUsage +updateRunTimeWorkerUsage +updateTaskStatisticsWorkerUsage +updateTaskStolenStatisticsWorkerUsage +updateWaitTimeWorkerUsage +workerListener

    Constructors

    - + +

    Returns AbstractPool<Worker, Data, Response>

    +
    +
  • Defined in src/pools/abstract-pool.ts:114
  • Properties

    - +
    emitter?: PoolEmitter

    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 concurrently their tasks quota.
    • +
    • '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.
    • +
    • 'backPressure': Emitted when all worker nodes have back pressure (i.e. their tasks queue is full: queue size >= maximum queue size).
    -
    -
    - +
  • Defined in src/pools/abstract-pool.ts:68
  • +
    +
    filePath: string

    Path to the worker file.

    -
    -
    - +
  • Defined in src/pools/abstract-pool.ts:116
  • +
    + +
    max?: number
    +

    Dynamic pool maximum size property placeholder.

    +
    +
    +
    +
    numberOfWorkers: number

    Number of workers that this pool should manage.

    -
    -
    - +
  • Defined in src/pools/abstract-pool.ts:115
  • +
    +
    opts: PoolOptions<Worker>

    Options for the pool.

    -
    +
  • Defined in src/pools/abstract-pool.ts:117
  • - -
    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.

    When we receive a message from the worker, we get a map entry with the promise resolve/reject bound to the message id.

    -
    +
    +
    + +
    startTimestamp: number
    +

    The start timestamp of the pool.

    +
    +
    +
    + +
    started: boolean
    +

    Whether the pool is started or not.

    +
    +
    +
  • Defined in src/pools/abstract-pool.ts:97
  • +
    + +
    starting: boolean
    +

    Whether the pool is starting or not.

    +
    +
    - +
    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:83
  • - -
    workerNodes: WorkerNode<Worker, Data>[] = []
    + +
    workerNodes: IWorkerNode<Worker, Data>[] = []

    Pool worker nodes.

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

    - +
    +
  • Defined in src/pools/abstract-pool.ts:731
  • - +
    -
    - -
    +
    + +
    -
    - -
    +
    + +
    -
    - -
    +
    + +
    -
    - -
    +
    + +
    +
    + +
    +
    + +
    +
    + +
    +
  • Defined in src/pools/abstract-pool.ts:543
  • Methods

    +
    + +
    - + +

    Returns void

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

    Returns void

    +
    +
  • Defined in src/pools/abstract-pool.ts:1209
  • - + -

    Returns void

    +
  • Defined in src/pools/abstract-pool.ts:905
  • - +

    Returns TasksQueueOptions

    -
    - +
  • Defined in src/pools/abstract-pool.ts:671
  • +
    +
    +
  • Defined in src/pools/abstract-pool.ts:1444
  • +
    + +
    +
    + +
    +
    + +
    - +

    Returns void

    +
  • Defined in src/pools/abstract-pool.ts:156
  • +
    + +
    - +

    Returns void

    +
  • Defined in src/pools/abstract-pool.ts:169
  • - +

    Returns void

    +
  • Defined in src/pools/abstract-pool.ts:213
  • - +

    Returns void

    +
  • Defined in src/pools/abstract-pool.ts:304
  • - +

    Returns void

    +
  • Defined in src/pools/abstract-pool.ts:244
  • - +

    Returns void

    -
    - -
    +
    + +
    -
    - +
  • Defined in src/pools/abstract-pool.ts:1062
  • +
    +
    +
  • Defined in src/pools/abstract-pool.ts:1152
  • +
    + +
    - +
    +
  • Defined in src/pools/abstract-pool.ts:1101
  • - +

    Returns undefined | Task<Data>

    +
  • Defined in src/pools/abstract-pool.ts:1534
  • - +
    -
    - +
  • Defined in src/pools/abstract-pool.ts:850
  • +
    + +

    Returns Promise<void>

    +
    +
  • Defined in src/pools/abstract-pool.ts:881
  • - + +

    Returns void

    +
    +
  • Defined in src/pools/abstract-pool.ts:636
  • - +

    Returns number

    +
  • Defined in src/pools/abstract-pool.ts:1528
  • - +

    Returns Promise<Response>

    Promise that will be fulfilled when the task is completed.

    -
    +
  • Defined in src/pools/abstract-pool.ts:779
  • - + +

    Returns void

    +
    -
    - -
    +
    + +

    Returns void

    +
  • Defined in src/pools/abstract-pool.ts:1542
  • - +
    -
    - +
  • Defined in src/pools/abstract-pool.ts:1552
  • +
    + +
    +
    + -

    Returns number

    The worker node key if the worker is found in the pool worker nodes, -1 otherwise.

    -
    +
    + +
    +
    + +
    +
    + +
    +
  • Defined in src/pools/abstract-pool.ts:1390
  • +
    + +
    +
    + +
    - +
    +
  • Defined in src/pools/abstract-pool.ts:738
  • - +
    -
    - -
    +
    + +
    +
    + + +

    Returns void

    +
  • Defined in src/pools/abstract-pool.ts:1253
  • - +

    Returns void

    -

    Returns void

    +
  • Defined in src/pools/abstract-pool.ts:1196
  • - + -

    Returns void

    +
    + +
    +
  • Defined in src/pools/abstract-pool.ts:860
  • +
    + +
    +
    + +
    - + +

    Returns void

    +
    +
    + +
    +
  • Defined in src/pools/abstract-pool.ts:691
  • - + +

    Returns void

    +
    +
  • Defined in src/pools/abstract-pool.ts:650
  • +
    + +
    +
    + +
    - + +

    Returns void

    +
    +
  • Defined in src/pools/abstract-pool.ts:603
  • - + -

    Returns void

    -
    - +
  • Defined in src/pools/abstract-pool.ts:622
  • +
    + +
    +
    +
    +
    + +
    +
    + + +

    Returns boolean

    true if the worker node shall update its task function worker usage, false otherwise.

    + +
    +
    + +
    +
    + +
    +
    + +
    +
    + +

    Returns void

    -
    - +
  • Defined in src/pools/abstract-pool.ts:1329
  • +
    +
    +
    + +
    +
    + +

    Returns void

    -
    - -
    +
    + +
    -
    - +
  • Defined in src/pools/abstract-pool.ts:995
  • +
    + +

    Returns void

    -
    - +
  • Defined in src/pools/abstract-pool.ts:977
  • +
    +

    Returns void

    -
    - +
  • Defined in src/pools/abstract-pool.ts:1278
  • +
    +

    Returns void

    +
  • Defined in src/pools/abstract-pool.ts:1009
  • - +
    +
  • Defined in src/pools/abstract-pool.ts:1372
  • -

    On This Page

    +

    On This Page

    +
  • constructor
  • +
  • emitter
  • +
  • filePath
  • +
  • max
  • +
  • numberOfWorkers
  • +
  • opts
  • +
  • promiseResponseMap
  • +
  • startTimestamp
  • +
  • started
  • +
  • starting
  • +
  • workerChoiceStrategyContext
  • +
  • workerNodes
  • +
  • busy
  • +
  • full
  • +
  • info
  • +
  • maxSize
  • +
  • minSize
  • +
  • ready
  • +
  • type
  • +
  • utilization
  • +
  • worker
  • +
  • addWorkerNode
  • +
  • afterTaskExecutionHook
  • +
  • afterWorkerNodeSetup
  • +
  • beforeTaskExecutionHook
  • +
  • buildTasksQueueOptions
  • +
  • checkAndEmitDynamicWorkerCreationEvents
  • +
  • checkAndEmitTaskExecutionEvents
  • +
  • checkAndEmitTaskQueuingEvents
  • +
  • checkDynamicPoolSize
  • +
  • checkFilePath
  • +
  • checkMessageWorkerId
  • +
  • checkNumberOfWorkers
  • +
  • checkPoolOptions
  • +
  • checkValidTasksQueueOptions
  • +
  • checkValidWorkerChoiceStrategy
  • +
  • checkValidWorkerChoiceStrategyOptions
  • +
  • chooseWorkerNode
  • +
  • createAndSetupDynamicWorkerNode
  • +
  • createAndSetupWorkerNode
  • +
  • createWorker
  • +
  • dequeueTask
  • +
  • destroy
  • +
  • destroyWorkerNode
  • +
  • enableTasksQueue
  • +
  • enqueueTask
  • +
  • execute
  • +
  • executeTask
  • +
  • flushTasksQueue
  • +
  • flushTasksQueues
  • +
  • getWorkerInfo
  • +
  • getWorkerNodeKeyByWorker
  • +
  • getWorkerNodeKeyByWorkerId
  • +
  • handleTaskExecutionResponse
  • +
  • handleWorkerReadyResponse
  • +
  • hasBackPressure
  • +
  • hasWorkerNodeBackPressure
  • +
  • internalBusy
  • +
  • isMain
  • +
  • listTaskFunctions
  • +
  • redistributeQueuedTasks
  • +
  • registerWorkerMessageListener
  • +
  • removeWorkerNode
  • +
  • sendKillMessageToWorker
  • +
  • sendStartupMessageToWorker
  • +
  • sendStatisticsMessageToWorker
  • +
  • sendToWorker
  • +
  • setTaskStealing
  • +
  • setTasksQueueOptions
  • +
  • setTasksQueueSize
  • +
  • setTasksStealingOnBackPressure
  • +
  • setWorkerChoiceStrategy
  • +
  • setWorkerChoiceStrategyOptions
  • +
  • setupHook
  • +
  • shallCreateDynamicWorker
  • +
  • shallExecuteTask
  • +
  • shallUpdateTaskFunctionWorkerUsage
  • +
  • start
  • +
  • taskStealingOnEmptyQueue
  • +
  • tasksQueueSize
  • +
  • tasksStealingOnBackPressure
  • +
  • unsetTaskStealing
  • +
  • unsetTasksStealingOnBackPressure
  • +
  • updateEluWorkerUsage
  • +
  • updateRunTimeWorkerUsage
  • +
  • updateTaskStatisticsWorkerUsage
  • +
  • updateTaskStolenStatisticsWorkerUsage
  • +
  • updateWaitTimeWorkerUsage
  • +
  • workerListener
  • +
    -

    Generated using TypeDoc

    -
    \ No newline at end of file +

    Generated using TypeDoc

    +
    \ No newline at end of file