X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=src%2Fworker%2Fcluster-worker.ts;h=49b0f984f3ca7a42721a79452da29eab34f09f22;hb=a86b6df187001e7e2e5c248ddb828286f985096c;hp=e750126b929ec93cb7d8e38bcfd9d754eefe6059;hpb=325f50bc1777ea44abc9736ce9d780ec0c8f90e2;p=poolifier.git diff --git a/src/worker/cluster-worker.ts b/src/worker/cluster-worker.ts index e750126b..49b0f984 100644 --- a/src/worker/cluster-worker.ts +++ b/src/worker/cluster-worker.ts @@ -1,96 +1,59 @@ -import { AsyncResource } from 'async_hooks' -import { isMaster, worker } from 'cluster' -import type { MessageValue } from '../utility-types' +import type { Worker } from 'node:cluster' +import cluster from 'node:cluster' +import type { + MessageValue, + TaskFunctions, + WorkerFunction +} from '../utility-types' +import { AbstractWorker } from './abstract-worker' import type { WorkerOptions } from './worker-options' /** - * An example worker that will be always alive, you just need to **extend** this class if you want a static pool. + * A cluster worker used by a poolifier `ClusterPool`. * - * When this worker is inactive for more than 1 minute, it will send this info to the main worker, - * if you are using DynamicClusterPool, the workers created after will be killed, the min num of worker will be guaranteed. + * When this worker is inactive for more than the given `maxInactiveTime`, + * it will send a termination request to its main worker. * + * If you use a `DynamicClusterPool` the extra workers that were created will be terminated, + * but the minimum number of workers will be guaranteed. + * + * @typeParam Data - Type of data this worker receives from pool's execution. This can only be serializable data. + * @typeParam Response - Type of response the worker sends back to the main worker. This can only be serializable data. * @author [Christopher Quadflieg](https://github.com/Shinigami92) * @since 2.0.0 */ -// eslint-disable-next-line @typescript-eslint/no-explicit-any -export class ClusterWorker extends AsyncResource { - protected readonly maxInactiveTime: number - protected readonly async: boolean - protected lastTask: number - protected readonly interval?: NodeJS.Timeout - +export class ClusterWorker< + Data = unknown, + Response = unknown +> extends AbstractWorker { + /** + * Constructs a new poolifier cluster worker. + * + * @param taskFunctions - Task function(s) processed by the worker when the pool's `execution` function is invoked. + * @param opts - Options for the worker. + */ public constructor ( - fn: (data: Data) => Response, - public readonly opts: WorkerOptions = {} + taskFunctions: + | WorkerFunction + | TaskFunctions, + opts: WorkerOptions = {} ) { - super('worker-cluster-pool:pioardi') - - this.maxInactiveTime = this.opts.maxInactiveTime ?? 1000 * 60 - this.async = !!this.opts.async - this.lastTask = Date.now() - if (!fn) throw new Error('Fn parameter is mandatory') - // keep the worker active - if (!isMaster) { - // console.log('ClusterWorker#constructor', 'is not master') - this.interval = setInterval( - this.checkAlive.bind(this), - this.maxInactiveTime / 2 - ) - this.checkAlive.bind(this)() - } - worker.on('message', (value: MessageValue) => { - // console.log("cluster.on('message', value)", value) - if (value?.data && value.id) { - // here you will receive messages - // console.log('This is the main worker ' + isMaster) - if (this.async) { - this.runInAsyncScope(this.runAsync.bind(this), this, fn, value) - } else { - this.runInAsyncScope(this.run.bind(this), this, fn, value) - } - } else if (value.kill) { - // here is time to kill this worker, just clearing the interval - if (this.interval) clearInterval(this.interval) - this.emitDestroy() - } - }) - } - - protected checkAlive (): void { - if (Date.now() - this.lastTask > this.maxInactiveTime) { - worker.send({ kill: 1 }) - } + super( + 'worker-cluster-pool:poolifier', + cluster.isPrimary, + taskFunctions, + cluster.worker, + opts + ) } - protected run ( - fn: (data?: Data) => Response, - value: MessageValue - ): void { - try { - const res = fn(value.data as Data) - worker.send({ data: res, id: value.id }) - this.lastTask = Date.now() - } catch (e) { - const err = e instanceof Error ? e.message : e - worker.send({ error: err, id: value.id }) - this.lastTask = Date.now() - } + /** @inheritDoc */ + protected sendToMainWorker (message: MessageValue): void { + this.getMainWorker().send(message) } - protected runAsync ( - fn: (data?: Data) => Promise, - value: MessageValue - ): void { - fn(value.data) - .then(res => { - worker.send({ data: res, id: value.id }) - this.lastTask = Date.now() - return null - }) - .catch(e => { - const err = e instanceof Error ? e.message : e - worker.send({ error: err, id: value.id }) - this.lastTask = Date.now() - }) + /** @inheritDoc */ + protected handleError (e: Error | string): string { + return e instanceof Error ? e.message : e } }