X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;ds=sidebyside;f=src%2Fpools%2Fthread%2Ffixed.ts;h=e3a94b329d4cfcee6f05cd6e2f8ad06e555a6dfc;hb=6a3ecc500583fc68d5bbce89f8448ccd022ab900;hp=a9d8f685fec3432db4fc6829dabcfd84f146babe;hpb=e1e2947c42b2affcabcc1969257b032fba0ac800;p=poolifier.git diff --git a/src/pools/thread/fixed.ts b/src/pools/thread/fixed.ts index a9d8f685..7977cd61 100644 --- a/src/pools/thread/fixed.ts +++ b/src/pools/thread/fixed.ts @@ -1,53 +1,31 @@ import { - MessageChannel, - SHARE_ENV, - Worker, - type WorkerOptions, - isMainThread + isMainThread, + type TransferListItem, + type Worker } from 'node:worker_threads' -import type { Draft, MessageValue } from '../../utility-types' -import { AbstractPool } from '../abstract-pool' -import { - type PoolOptions, - type PoolType, - PoolTypes, - type WorkerType, - WorkerTypes -} from '../pool' -/** - * Options for a poolifier thread pool. - */ -export interface ThreadPoolOptions extends PoolOptions { - /** - * Worker options. - * - * @see https://nodejs.org/api/worker_threads.html#new-workerfilename-options - */ - workerOptions?: WorkerOptions -} +import type { MessageValue } from '../../utility-types.js' +import { AbstractPool } from '../abstract-pool.js' +import { type PoolOptions, type PoolType, PoolTypes } from '../pool.js' +import { type WorkerType, WorkerTypes } from '../worker.js' /** - * A thread worker with message channels for communication between main thread and thread worker. + * Options for a poolifier thread pool. */ -export type ThreadWorkerWithMessageChannel = Worker & Draft +export type ThreadPoolOptions = PoolOptions /** * A thread pool with a fixed number of threads. * - * It is possible to perform tasks in sync or asynchronous mode as you prefer. - * - * This pool selects the threads in a round robin fashion. - * - * @typeParam Data - Type of data sent to the worker. This can only be serializable data. - * @typeParam Response - Type of execution response. This can only be serializable data. + * @typeParam Data - Type of data sent to the worker. This can only be structured-cloneable data. + * @typeParam Response - Type of execution response. This can only be structured-cloneable data. * @author [Alessandro Pio Ardizio](https://github.com/pioardi) * @since 0.0.1 */ export class FixedThreadPool< Data = unknown, Response = unknown -> extends AbstractPool { +> extends AbstractPool { /** * Constructs a new poolifier fixed thread pool. * @@ -58,9 +36,10 @@ export class FixedThreadPool< public constructor ( numberOfThreads: number, filePath: string, - protected readonly opts: ThreadPoolOptions = {} + opts: ThreadPoolOptions = {}, + maximumNumberOfThreads?: number ) { - super(numberOfThreads, filePath, opts) + super(numberOfThreads, filePath, opts, maximumNumberOfThreads) } /** @inheritDoc */ @@ -69,65 +48,86 @@ export class FixedThreadPool< } /** @inheritDoc */ - protected async destroyWorker ( - worker: ThreadWorkerWithMessageChannel - ): Promise { - this.sendToWorker(worker, { kill: 1 }) - await worker.terminate() + protected sendToWorker ( + workerNodeKey: number, + message: MessageValue, + transferList?: readonly TransferListItem[] + ): void { + this.workerNodes[workerNodeKey]?.messageChannel?.port1.postMessage( + { + ...message, + workerId: this.getWorkerInfo(workerNodeKey)?.id + } satisfies MessageValue, + transferList + ) } /** @inheritDoc */ - protected sendToWorker ( - worker: ThreadWorkerWithMessageChannel, - message: MessageValue - ): void { - worker.postMessage(message) + protected sendStartupMessageToWorker (workerNodeKey: number): void { + const workerNode = this.workerNodes[workerNodeKey] + // eslint-disable-next-line @typescript-eslint/no-non-null-assertion + const port2 = workerNode.messageChannel!.port2 + workerNode.worker.postMessage( + { + ready: false, + workerId: this.getWorkerInfo(workerNodeKey)?.id, + port: port2 + } satisfies MessageValue, + [port2] + ) } /** @inheritDoc */ protected registerWorkerMessageListener( - worker: ThreadWorkerWithMessageChannel, + workerNodeKey: number, listener: (message: MessageValue) => void ): void { - worker.port2?.on('message', listener) + this.workerNodes[workerNodeKey].messageChannel?.port1.on( + 'message', + listener + ) } /** @inheritDoc */ - protected createWorker (): ThreadWorkerWithMessageChannel { - return new Worker(this.filePath, { - env: SHARE_ENV, - ...this.opts.workerOptions - }) + protected registerOnceWorkerMessageListener( + workerNodeKey: number, + listener: (message: MessageValue) => void + ): void { + this.workerNodes[workerNodeKey].messageChannel?.port1.once( + 'message', + listener + ) } /** @inheritDoc */ - protected afterWorkerSetup (worker: ThreadWorkerWithMessageChannel): void { - const { port1, port2 } = new MessageChannel() - worker.postMessage({ parent: port1 }, [port1]) - worker.port1 = port1 - worker.port2 = port2 - // Listen to worker messages. - this.registerWorkerMessageListener(worker, super.workerListener()) + protected deregisterWorkerMessageListener( + workerNodeKey: number, + listener: (message: MessageValue) => void + ): void { + this.workerNodes[workerNodeKey].messageChannel?.port1.off( + 'message', + listener + ) } /** @inheritDoc */ - protected get type (): PoolType { - return PoolTypes.fixed + protected shallCreateDynamicWorker (): boolean { + return false } /** @inheritDoc */ - protected get worker (): WorkerType { - return WorkerTypes.thread + protected checkAndEmitDynamicWorkerCreationEvents (): void { + /* noop */ } /** @inheritDoc */ - protected get minSize (): number { - return this.numberOfWorkers + protected get type (): PoolType { + return PoolTypes.fixed } /** @inheritDoc */ - protected get maxSize (): number { - return this.numberOfWorkers + protected get worker (): WorkerType { + return WorkerTypes.thread } /** @inheritDoc */