X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=docs%2Fclasses%2FAbstractPool.html;h=072c9da05dae4cb0411cc9c601675033feef32ac;hb=b2862722f44d3facf07a2e632d25d261f3dabbce;hp=b283abbbed56bc86fd81e54e0da42e5c76db5944;hpb=184d530faf6acf70e116cb4a3fb831938b73e2c0;p=poolifier.git diff --git a/docs/classes/AbstractPool.html b/docs/classes/AbstractPool.html index b283abbb..072c9da0 100644 --- a/docs/classes/AbstractPool.html +++ b/docs/classes/AbstractPool.html @@ -1,13 +1,13 @@ -AbstractPool | poolifier
+AbstractPool | poolifier - v3.0.1
-
+
  • The search index is not available
  • poolifier - v3.0.1 +
    @@ -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:65
  • - +

    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 +
    addTaskFunction +addWorkerNode +afterTaskExecutionHook +afterWorkerNodeSetup +beforeTaskExecutionHook +buildTasksQueueOptions +checkAndEmitDynamicWorkerCreationEvents +checkAndEmitTaskExecutionEvents +checkAndEmitTaskQueuingEvents +checkMessageWorkerId +checkNumberOfWorkers +checkPoolOptions +checkValidWorkerChoiceStrategyOptions +chooseWorkerNode +createAndSetupDynamicWorkerNode +createAndSetupWorkerNode +createWorker +deleteTaskFunctionWorkerUsages +dequeueTask +deregisterWorkerMessageListener +destroy +destroyWorkerNode +enableTasksQueue +enqueueTask +execute +executeTask +flushTasksQueue +flushTasksQueues +getWorkerInfo +getWorkerNodeKeyByWorker +getWorkerNodeKeyByWorkerId +handleBackPressureEvent +handleEmptyQueueEvent +handleTaskExecutionResponse +handleWorkerReadyResponse +hasBackPressure +hasTaskFunction +hasWorkerNodeBackPressure +initializeEventEmitter +internalBusy +isMain +listTaskFunctionNames +redistributeQueuedTasks +registerOnceWorkerMessageListener +registerWorkerMessageListener +removeTaskFunction +removeWorkerNode +sendKillMessageToWorker +sendStartupMessageToWorker +sendStatisticsMessageToWorker +sendTaskFunctionOperationToWorker +sendTaskFunctionOperationToWorkers +sendToWorker +setDefaultTaskFunction +setTaskStealing +setTasksQueueOptions +setTasksQueueSize +setTasksStealingOnBackPressure +setWorkerChoiceStrategy +setWorkerChoiceStrategyOptions +setupHook +shallCreateDynamicWorker +shallExecuteTask +shallUpdateTaskFunctionWorkerUsage +start +tasksQueueSize +unsetTaskStealing +unsetTasksStealingOnBackPressure +updateEluWorkerUsage +updateRunTimeWorkerUsage +updateTaskStatisticsWorkerUsage +updateTaskStolenStatisticsWorkerUsage +updateWaitTimeWorkerUsage +workerMessageListener

    Constructors

    - + +

    Returns AbstractPool<Worker, Data, Response>

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

    - -
    emitter?: PoolEmitter
    -

    Emitter on which events can be listened to.

    + +
    emitter?: EventEmitterAsyncResource
    +

    Event emitter integrated with async resource on which events can be listened to. +The async tracking tooling identifier is poolifier:<PoolType>-<WorkerType>-pool.

    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:74
  • - +
    filePath: string

    Path to the worker file.

    -
    +
    + +
    max?: number
    +

    Dynamic pool maximum size property placeholder.

    +
    +
    +
  • Defined in src/pools/abstract-pool.ts:79
  • - +
    numberOfWorkers: number

    Number of workers that this pool should manage.

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

    Options for the pool.

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

    Whether the pool is starting or not.

    +
    +
    +
    + +
    taskFunctions: Map<string, TaskFunction<Data, Response>>
    +

    The task functions added at runtime map:

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

    Pool worker nodes.

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

    - +
    +
  • Defined in src/pools/abstract-pool.ts:671
  • - +
    +
  • Defined in src/pools/abstract-pool.ts:662
  • - +
    +
  • Defined in src/pools/abstract-pool.ts:272
  • - +
    +
  • Defined in src/pools/abstract-pool.ts:485
  • - +
    +
  • Defined in src/pools/abstract-pool.ts:478
  • +
    + +
    - +
    +
    + +
    +
  • Defined in src/pools/abstract-pool.ts:447
  • - +
    +
  • Defined in src/pools/abstract-pool.ts:473
  • Methods

    +
    + +
    +
    + +
    - + +

    Returns void

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

    Returns void

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

    Returns void

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

    Returns TasksQueueOptions

    -
    - +
  • Defined in src/pools/abstract-pool.ts:601
  • +
    +
    -
    - +
  • Defined in src/pools/abstract-pool.ts:1589
  • +
    +
    -
    - +
  • Defined in src/pools/abstract-pool.ts:1577
  • +
    +
    -
    - +
  • Defined in src/pools/abstract-pool.ts:1583
  • +
    + +

    Returns void

    +
    +

    Throws

    https://nodejs.org/api/errors.html#class-error If the worker id is invalid.

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

    Returns void

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

    Returns void

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

    Returns void

    -
    - -
    +
    + +
    -
    - +
  • Defined in src/pools/abstract-pool.ts:1171
  • +
    +
    +
  • Defined in src/pools/abstract-pool.ts:1261
  • +
    + +
    - +
    +
  • Defined in src/pools/abstract-pool.ts:1210
  • +
    + +
    - +

    Returns undefined | Task<Data>

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

    Returns Promise<void>

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

    Returns void

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

    Returns number

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

    Returns Promise<Response>

    Promise that will be fulfilled when the task is completed.

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

    Returns void

    +
    -
    - -
    +
    + +

    Returns void

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

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

    Returns void

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

    Returns void

    -

    Returns void

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

    Returns void

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

    Returns void

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

    Returns void

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

    Returns void

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

    Returns void

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

    Returns boolean

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

    + +
    +
    + +
    +
    + + +

    Returns number

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

    Returns void

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

    Returns void

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

    Returns void

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

    Returns void

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

    Returns void

    +
    +
  • Defined in src/pools/abstract-pool.ts:1517
  • +
  • constructor
  • +
  • emitter
  • +
  • filePath
  • +
  • max
  • +
  • numberOfWorkers
  • +
  • opts
  • +
  • promiseResponseMap
  • +
  • startTimestamp
  • +
  • started
  • +
  • starting
  • +
  • taskFunctions
  • +
  • workerChoiceStrategyContext
  • +
  • workerNodes
  • +
  • busy
  • +
  • full
  • +
  • info
  • +
  • maxSize
  • +
  • minSize
  • +
  • ready
  • +
  • type
  • +
  • utilization
  • +
  • worker
  • +
  • addTaskFunction
  • +
  • addWorkerNode
  • +
  • afterTaskExecutionHook
  • +
  • afterWorkerNodeSetup
  • +
  • beforeTaskExecutionHook
  • +
  • buildTasksQueueOptions
  • +
  • checkAndEmitDynamicWorkerCreationEvents
  • +
  • checkAndEmitTaskExecutionEvents
  • +
  • checkAndEmitTaskQueuingEvents
  • +
  • checkMessageWorkerId
  • +
  • checkNumberOfWorkers
  • +
  • checkPoolOptions
  • +
  • checkValidWorkerChoiceStrategyOptions
  • +
  • chooseWorkerNode
  • +
  • createAndSetupDynamicWorkerNode
  • +
  • createAndSetupWorkerNode
  • +
  • createWorker
  • +
  • deleteTaskFunctionWorkerUsages
  • +
  • dequeueTask
  • +
  • deregisterWorkerMessageListener
  • +
  • destroy
  • +
  • destroyWorkerNode
  • +
  • enableTasksQueue
  • +
  • enqueueTask
  • +
  • execute
  • +
  • executeTask
  • +
  • flushTasksQueue
  • +
  • flushTasksQueues
  • +
  • getWorkerInfo
  • +
  • getWorkerNodeKeyByWorker
  • +
  • getWorkerNodeKeyByWorkerId
  • +
  • handleBackPressureEvent
  • +
  • handleEmptyQueueEvent
  • +
  • handleTaskExecutionResponse
  • +
  • handleWorkerReadyResponse
  • +
  • hasBackPressure
  • +
  • hasTaskFunction
  • +
  • hasWorkerNodeBackPressure
  • +
  • initializeEventEmitter
  • +
  • internalBusy
  • +
  • isMain
  • +
  • listTaskFunctionNames
  • +
  • redistributeQueuedTasks
  • +
  • registerOnceWorkerMessageListener
  • +
  • registerWorkerMessageListener
  • +
  • removeTaskFunction
  • +
  • removeWorkerNode
  • +
  • sendKillMessageToWorker
  • +
  • sendStartupMessageToWorker
  • +
  • sendStatisticsMessageToWorker
  • +
  • sendTaskFunctionOperationToWorker
  • +
  • sendTaskFunctionOperationToWorkers
  • +
  • sendToWorker
  • +
  • setDefaultTaskFunction
  • +
  • setTaskStealing
  • +
  • setTasksQueueOptions
  • +
  • setTasksQueueSize
  • +
  • setTasksStealingOnBackPressure
  • +
  • setWorkerChoiceStrategy
  • +
  • setWorkerChoiceStrategyOptions
  • +
  • setupHook
  • +
  • shallCreateDynamicWorker
  • +
  • shallExecuteTask
  • +
  • shallUpdateTaskFunctionWorkerUsage
  • +
  • start
  • +
  • tasksQueueSize
  • +
  • unsetTaskStealing
  • +
  • unsetTasksStealingOnBackPressure
  • +
  • updateEluWorkerUsage
  • +
  • updateRunTimeWorkerUsage
  • +
  • updateTaskStatisticsWorkerUsage
  • +
  • updateTaskStolenStatisticsWorkerUsage
  • +
  • updateWaitTimeWorkerUsage
  • +
  • workerMessageListener
  • +
    -

    Generated using TypeDoc

    -
    \ No newline at end of file +

    Generated using TypeDoc

    +
    \ No newline at end of file