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

    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 +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 +taskStealingOnEmptyQueue +tasksQueueSize +tasksStealingOnBackPressure +unsetTaskStealing +unsetTasksStealingOnBackPressure +updateEluWorkerUsage +updateRunTimeWorkerUsage +updateTaskStatisticsWorkerUsage +updateTaskStolenStatisticsWorkerUsage +updateWaitTimeWorkerUsage +workerListener

    Constructors

    - + +

    Returns AbstractPool<Worker, Data, Response>

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

    - -
    emitter?: PoolEmitter
    -

    Emitter on which events can be listened to.

    + +
    emitter?: __module | 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:73
  • - +
    filePath: string

    Path to the worker file.

    -
    +
  • Defined in src/pools/abstract-pool.ts:128
  • +
    + +
    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:127
  • - +
    opts: PoolOptions<Worker>

    Options for the pool.

    -
    +
  • Defined in src/pools/abstract-pool.ts:129
  • - -
    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:109
  • +
    + +
    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:88
  • - -
    workerNodes: WorkerNode<Worker, Data>[] = []
    + +
    workerNodes: IWorkerNode<Worker, Data>[] = []

    Pool worker nodes.

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

    - +
    +
  • Defined in src/pools/abstract-pool.ts:660
  • - +
    +
  • Defined in src/pools/abstract-pool.ts:651
  • - +
    +
  • Defined in src/pools/abstract-pool.ts:271
  • - +
    +
  • Defined in src/pools/abstract-pool.ts:484
  • - +
    +
  • Defined in src/pools/abstract-pool.ts:477
  • +
    + +
    - +
    +
  • Defined in src/pools/abstract-pool.ts:467
  • +
    + +
    - +
    +
  • Defined in src/pools/abstract-pool.ts:472
  • Methods

    +
    + +
    +
    + +
    - + +

    Returns void

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

    Returns void

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

    Returns void

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

    Returns TasksQueueOptions

    -
    - +
  • Defined in src/pools/abstract-pool.ts:600
  • +
    +
    -
    - +
  • Defined in src/pools/abstract-pool.ts:1571
  • +
    +
    -
    - +
  • Defined in src/pools/abstract-pool.ts:1559
  • +
    +
    -
    - +
  • Defined in src/pools/abstract-pool.ts:1565
  • +
    + +

    Returns void

    +
    +

    Throws

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

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

    Returns void

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

    Returns void

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

    Returns void

    -
    - -
    +
    + +
    +
    + +
    -
    - +
  • Defined in src/pools/abstract-pool.ts:1252
  • +
    +
    +
  • Defined in src/pools/abstract-pool.ts:1208
  • - +
    +
  • Defined in src/pools/abstract-pool.ts:1201
  • +
    + +
    - +

    Returns undefined | Task<Data>

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

    Returns Promise<void>

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

    Returns void

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

    Returns number

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

    Returns Promise<Response>

    Promise that will be fulfilled when the task is completed.

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

    Returns void

    +
    -
    - -
    +
    + +

    Returns void

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

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

    Returns void

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

    Returns void

    -

    Returns void

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

    Returns void

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

    Returns void

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

    Returns void

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

    Returns void

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

    Returns void

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

    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:1457
  • +
    +
    +
    + +
    +
    + +

    Returns void

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

    Returns void

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

    Returns void

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

    Returns void

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

    On This Page

    +

    On This Page

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