X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=src%2Fpools%2Fabstract-pool.ts;h=68e833710f802d7bd30f52bab9955dc373072c35;hb=28cf3617988a06edf63b13e3183e9df866564423;hp=ad21effb3bbb9837977a54c2f8c159c85af6b3c8;hpb=b1989cfdf9af9f2c5e01b9a3f7c81b8c3ed78cb4;p=poolifier.git diff --git a/src/pools/abstract-pool.ts b/src/pools/abstract-pool.ts index ad21effb..68e83371 100644 --- a/src/pools/abstract-pool.ts +++ b/src/pools/abstract-pool.ts @@ -25,10 +25,10 @@ export abstract class AbstractPool< Data = unknown, Response = unknown > implements IPoolInternal { - /** {@inheritDoc} */ + /** @inheritDoc */ public readonly workers: Array> = [] - /** {@inheritDoc} */ + /** @inheritDoc */ public readonly emitter?: PoolEmitter /** @@ -154,7 +154,7 @@ export abstract class AbstractPool< this.opts.enableEvents = opts.enableEvents ?? true } - /** {@inheritDoc} */ + /** @inheritDoc */ public abstract get type (): PoolType /** @@ -174,7 +174,7 @@ export abstract class AbstractPool< return this.workers.findIndex(workerItem => workerItem.worker === worker) } - /** {@inheritDoc} */ + /** @inheritDoc */ public setWorkerChoiceStrategy ( workerChoiceStrategy: WorkerChoiceStrategy ): void { @@ -193,10 +193,10 @@ export abstract class AbstractPool< ) } - /** {@inheritDoc} */ + /** @inheritDoc */ public abstract get full (): boolean - /** {@inheritDoc} */ + /** @inheritDoc */ public abstract get busy (): boolean protected internalBusy (): boolean { @@ -206,14 +206,14 @@ export abstract class AbstractPool< ) } - /** {@inheritDoc} */ + /** @inheritDoc */ public findFreeWorkerKey (): number { return this.workers.findIndex(workerItem => { return workerItem.tasksUsage.running === 0 }) } - /** {@inheritDoc} */ + /** @inheritDoc */ public async execute (data: Data): Promise { const [workerKey, worker] = this.chooseWorker() const messageId = crypto.randomUUID() @@ -229,7 +229,7 @@ export abstract class AbstractPool< return res } - /** {@inheritDoc} */ + /** @inheritDoc */ public async destroy (): Promise { await Promise.all( this.workers.map(async workerItem => { @@ -239,7 +239,7 @@ export abstract class AbstractPool< } /** - * Shutdowns given worker. + * Shutdowns given worker in the pool. * * @param worker - A worker within `workers`. */ @@ -248,6 +248,8 @@ export abstract class AbstractPool< /** * Setup hook that can be overridden by a Poolifier pool implementation * to run code before workers are created in the abstract constructor. + * + * @virtual */ protected setupHook (): void { // Can be overridden @@ -341,6 +343,7 @@ export abstract class AbstractPool< * Can be used to update the `maxListeners` or binding the `main-worker`\<-\>`worker` connection if not bind by default. * * @param worker - The newly created worker. + * @virtual */ protected abstract afterWorkerSetup (worker: Worker): void @@ -423,7 +426,7 @@ export abstract class AbstractPool< } /** - * Gets worker tasks usage. + * Gets the given worker tasks usage in the pool. * * @param worker - The worker. * @returns The worker tasks usage.