X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=src%2Fworker%2FWorkerSet.ts;h=ce25e7e3a6e4ec3428072a05fc6e13d90e14c0fd;hb=4a3807d16c54137840a60af41877f3b21de12950;hp=9b9ad3324540ce37dcbb828f42420535f668acf6;hpb=2a370053f45f2d58e90ab7b292294c521a262ca1;p=e-mobility-charging-stations-simulator.git diff --git a/src/worker/WorkerSet.ts b/src/worker/WorkerSet.ts index 9b9ad332..ce25e7e3 100644 --- a/src/worker/WorkerSet.ts +++ b/src/worker/WorkerSet.ts @@ -1,104 +1,170 @@ -// Partial Copyright Jerome Benoit. 2021. All Rights Reserved. +// Partial Copyright Jerome Benoit. 2021-2023. All Rights Reserved. -import { WorkerMessageEvents, WorkerSetElement } from '../types/Worker'; +import { EventEmitter } from 'node:events'; +import { SHARE_ENV, Worker } from 'node:worker_threads'; -import Utils from '../utils/Utils'; -import { Worker } from 'worker_threads'; -import WorkerAbstract from './WorkerAbstract'; -import { WorkerUtils } from './WorkerUtils'; +import type { ThreadPoolOptions } from 'poolifier'; -export default class WorkerSet extends WorkerAbstract { - public maxElementsPerWorker: number; - private workerSet: Set; +import { WorkerAbstract } from './WorkerAbstract'; +import { WorkerConstants } from './WorkerConstants'; +import { + type SetInfo, + type WorkerData, + WorkerMessageEvents, + type WorkerOptions, + type WorkerSetElement, + WorkerSetEvents, +} from './WorkerTypes'; +import { sleep } from './WorkerUtils'; + +const DEFAULT_POOL_OPTIONS: ThreadPoolOptions = { + enableEvents: true, + restartWorkerOnError: true, +}; + +export class WorkerSet extends WorkerAbstract { + public readonly emitter!: EventEmitter; + private readonly workerSet: Set; /** - * Create a new `WorkerSet`. + * Creates a new `WorkerSet`. * - * @param workerScript - * @param maxElementsPerWorker - * @param workerStartDelay - * @param messageListenerCallback + * @param workerScript - + * @param workerOptions - */ - constructor(workerScript: string, maxElementsPerWorker = 1, workerStartDelay?: number, messageListenerCallback: (message: any) => void = () => { /* This is intentional */ }) { - super(workerScript, workerStartDelay, messageListenerCallback); + constructor(workerScript: string, workerOptions: WorkerOptions) { + super(workerScript, workerOptions); + this.workerOptions.poolOptions = { + ...DEFAULT_POOL_OPTIONS, + ...this.workerOptions.poolOptions, + }; this.workerSet = new Set(); - this.maxElementsPerWorker = maxElementsPerWorker; + if (this.workerOptions.poolOptions?.enableEvents) { + this.emitter = new EventEmitter(); + } + } + + get info(): SetInfo { + return { + version: WorkerConstants.version, + type: 'set', + worker: 'thread', + size: this.size, + elementsExecuting: [...this.workerSet].reduce( + (accumulator, workerSetElement) => accumulator + workerSetElement.numberOfWorkerElements, + 0, + ), + elementsPerWorker: this.maxElementsPerWorker!, + }; } get size(): number { return this.workerSet.size; } - /** - * - * @param elementData - * @returns - * @public - */ - public async addElement(elementData: T): Promise { - if (!this.workerSet) { - throw new Error('Cannot add a WorkerSet element: workers\' set does not exist'); - } - if (this.getLastWorkerSetElement().numberOfWorkerElements >= this.maxElementsPerWorker) { - this.startWorker(); - // Start worker sequentially to optimize memory at startup - await Utils.sleep(this.workerStartDelay); - } - this.getLastWorker().postMessage({ id: WorkerMessageEvents.START_WORKER_ELEMENT, data: elementData }); - this.getLastWorkerSetElement().numberOfWorkerElements++; + get maxElementsPerWorker(): number | undefined { + return this.workerOptions.elementsPerWorker; } - /** - * - * @returns - * @public - */ + /** @inheritDoc */ public async start(): Promise { - this.startWorker(); - // Start worker sequentially to optimize memory at startup - await Utils.sleep(this.workerStartDelay); + this.addWorkerSetElement(); + // Add worker set element sequentially to optimize memory at startup + this.workerOptions.workerStartDelay! > 0 && (await sleep(this.workerOptions.workerStartDelay!)); } - /** - * - * @returns - * @public - */ + /** @inheritDoc */ public async stop(): Promise { for (const workerSetElement of this.workerSet) { + const workerExitPromise = new Promise((resolve) => { + workerSetElement.worker.on('exit', () => { + resolve(); + }); + }); await workerSetElement.worker.terminate(); + await workerExitPromise; } this.workerSet.clear(); } + /** @inheritDoc */ + public async addElement(elementData: WorkerData): Promise { + if (!this.workerSet) { + throw new Error("Cannot add a WorkerSet element: workers' set does not exist"); + } + const workerSetElement = await this.getWorkerSetElement(); + workerSetElement.worker.postMessage({ + id: WorkerMessageEvents.startWorkerElement, + data: elementData, + }); + ++workerSetElement.numberOfWorkerElements; + // Add element sequentially to optimize memory at startup + if (this.workerOptions.elementStartDelay! > 0) { + await sleep(this.workerOptions.elementStartDelay!); + } + } + /** - * - * @private + * Adds a new `WorkerSetElement`. */ - private startWorker(): void { - const worker = new Worker(this.workerScript); - worker.on('message', this.messageListener); - worker.on('error', () => { /* This is intentional */ }); - worker.on('exit', (code) => { - WorkerUtils.defaultExitHandler(code); - this.workerSet.delete(this.getWorkerSetElementByWorker(worker)); + private addWorkerSetElement(): WorkerSetElement { + const worker = new Worker(this.workerScript, { + env: SHARE_ENV, + ...this.workerOptions.poolOptions?.workerOptions, + }); + worker.on( + 'message', + this.workerOptions.poolOptions?.messageHandler ?? WorkerConstants.EMPTY_FUNCTION, + ); + worker.on( + 'error', + this.workerOptions.poolOptions?.errorHandler ?? WorkerConstants.EMPTY_FUNCTION, + ); + worker.on('error', (error) => { + this.emitter?.emit(WorkerSetEvents.error, error); + if (this.workerOptions.poolOptions?.restartWorkerOnError) { + this.addWorkerSetElement(); + } }); - this.workerSet.add({ worker, numberOfWorkerElements: 0 }); + worker.on( + 'online', + this.workerOptions.poolOptions?.onlineHandler ?? WorkerConstants.EMPTY_FUNCTION, + ); + worker.on( + 'exit', + this.workerOptions.poolOptions?.exitHandler ?? WorkerConstants.EMPTY_FUNCTION, + ); + worker.once('exit', () => + this.removeWorkerSetElement(this.getWorkerSetElementByWorker(worker)!), + ); + const workerSetElement: WorkerSetElement = { worker, numberOfWorkerElements: 0 }; + this.workerSet.add(workerSetElement); + return workerSetElement; } - private getLastWorkerSetElement(): WorkerSetElement { - let workerSetElement: WorkerSetElement; - // eslint-disable-next-line no-empty - for (workerSetElement of this.workerSet) { /* This is intentional */ } - return workerSetElement; + private removeWorkerSetElement(workerSetElement: WorkerSetElement): void { + this.workerSet.delete(workerSetElement); } - private getLastWorker(): Worker { - return this.getLastWorkerSetElement().worker; + private async getWorkerSetElement(): Promise { + let chosenWorkerSetElement: WorkerSetElement | undefined; + for (const workerSetElement of this.workerSet) { + if (workerSetElement.numberOfWorkerElements < this.workerOptions.elementsPerWorker!) { + chosenWorkerSetElement = workerSetElement; + break; + } + } + if (!chosenWorkerSetElement) { + chosenWorkerSetElement = this.addWorkerSetElement(); + // Add worker set element sequentially to optimize memory at startup + this.workerOptions.workerStartDelay! > 0 && + (await sleep(this.workerOptions.workerStartDelay!)); + } + return chosenWorkerSetElement; } - private getWorkerSetElementByWorker(worker: Worker): WorkerSetElement { - let workerSetElt: WorkerSetElement; + private getWorkerSetElementByWorker(worker: Worker): WorkerSetElement | undefined { + let workerSetElt: WorkerSetElement | undefined; for (const workerSetElement of this.workerSet) { if (workerSetElement.worker.threadId === worker.threadId) { workerSetElt = workerSetElement;