import type { IPoolInternal } from '../pool-internal'
-import { PoolType } from '../pool-internal'
import type { IPoolWorker } from '../pool-worker'
-import { DynamicPoolWorkerChoiceStrategy } from './dynamic-pool-worker-choice-strategy'
import type {
IWorkerChoiceStrategy,
+ RequiredStatistics,
WorkerChoiceStrategy
} from './selection-strategies-types'
import { WorkerChoiceStrategies } from './selection-strategies-types'
-import { SelectionStrategiesUtils } from './selection-strategies-utils'
+import { getWorkerChoiceStrategy } from './selection-strategies-utils'
/**
* The worker choice strategy context.
*
- * @template Worker Type of worker.
- * @template Data Type of data sent to the worker. This can only be serializable data.
- * @template Response Type of response of execution. This can only be serializable data.
+ * @typeParam Worker - Type of worker.
+ * @typeParam Data - Type of data sent to the worker. This can only be serializable data.
+ * @typeParam Response - Type of response of execution. This can only be serializable data.
*/
export class WorkerChoiceStrategyContext<
Worker extends IPoolWorker,
Data,
Response
> {
- private workerChoiceStrategy!: IWorkerChoiceStrategy<Worker>
+ private workerChoiceStrategy!: IWorkerChoiceStrategy
/**
* Worker choice strategy context constructor.
*
- * @param pool The pool instance.
- * @param createDynamicallyWorkerCallback The worker creation callback for dynamic pool.
- * @param workerChoiceStrategy The worker choice strategy.
+ * @param pool - The pool instance.
+ * @param createWorkerCallback - The worker creation callback for dynamic pool.
+ * @param workerChoiceStrategy - The worker choice strategy.
*/
public constructor (
private readonly pool: IPoolInternal<Worker, Data, Response>,
- private createDynamicallyWorkerCallback: () => Worker,
+ private readonly createWorkerCallback: () => number,
workerChoiceStrategy: WorkerChoiceStrategy = WorkerChoiceStrategies.ROUND_ROBIN
) {
+ this.execute.bind(this)
this.setWorkerChoiceStrategy(workerChoiceStrategy)
}
/**
- * Gets the worker choice strategy instance specific to the pool type.
+ * Gets the worker choice strategy required statistics.
*
- * @param workerChoiceStrategy The worker choice strategy.
- * @returns The worker choice strategy instance for the pool type.
+ * @returns The required statistics.
*/
- private getPoolWorkerChoiceStrategy (
- workerChoiceStrategy: WorkerChoiceStrategy = WorkerChoiceStrategies.ROUND_ROBIN
- ): IWorkerChoiceStrategy<Worker> {
- if (this.pool.type === PoolType.DYNAMIC) {
- return new DynamicPoolWorkerChoiceStrategy(
- this.pool,
- this.createDynamicallyWorkerCallback,
- workerChoiceStrategy
- )
- }
- return SelectionStrategiesUtils.getWorkerChoiceStrategy(
- this.pool,
- workerChoiceStrategy
- )
- }
-
- /**
- * Gets the worker choice strategy used in the context.
- *
- * @returns The worker choice strategy.
- */
- public getWorkerChoiceStrategy (): IWorkerChoiceStrategy<Worker> {
- return this.workerChoiceStrategy
+ public getRequiredStatistics (): RequiredStatistics {
+ return this.workerChoiceStrategy.requiredStatistics
}
/**
* Sets the worker choice strategy to use in the context.
*
- * @param workerChoiceStrategy The worker choice strategy to set.
+ * @param workerChoiceStrategy - The worker choice strategy to set.
*/
public setWorkerChoiceStrategy (
workerChoiceStrategy: WorkerChoiceStrategy
): void {
this.workerChoiceStrategy?.reset()
- this.workerChoiceStrategy = this.getPoolWorkerChoiceStrategy(
+ this.workerChoiceStrategy = getWorkerChoiceStrategy<Worker, Data, Response>(
+ this.pool,
workerChoiceStrategy
)
}
/**
- * Chooses a worker with the underlying selection strategy.
+ * Chooses a worker with the worker choice strategy.
*
- * @returns The chosen one.
+ * @returns The key of the chosen one.
*/
- public execute (): Worker {
+ public execute (): number {
+ if (
+ this.workerChoiceStrategy.isDynamicPool &&
+ !this.pool.full &&
+ this.pool.findFreeWorkerKey() === -1
+ ) {
+ return this.createWorkerCallback()
+ }
return this.workerChoiceStrategy.choose()
}
+
+ /**
+ * Removes a worker in the worker choice strategy internals.
+ *
+ * @param workerKey - The key of the worker to remove.
+ * @returns `true` if the removal is successful, `false` otherwise.
+ */
+ public remove (workerKey: number): boolean {
+ return this.workerChoiceStrategy.remove(workerKey)
+ }
}