/**
* Virtual task runtime.
*/
-type TaskRunTime = {
+interface TaskRunTime {
weight: number
runTime: number
}
* Selects the next worker with a weighted round robin scheduling algorithm.
* Loosely modeled after the weighted round robin queueing algorithm: https://en.wikipedia.org/wiki/Weighted_round_robin.
*
- * @template Worker Type of worker which manages the strategy.
- * @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 which manages the strategy.
+ * @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 WeightedRoundRobinWorkerChoiceStrategy<
Worker extends IPoolWorker,
Data,
Response
> extends AbstractWorkerChoiceStrategy<Worker, Data, Response> {
- /** @inheritDoc */
+ /** {@inheritDoc} */
public readonly requiredStatistics: RequiredStatistics = {
runTime: true
}
- /**
- * Worker index where the previous task was submitted.
- */
- private previousWorkerIndex: number = 0
/**
* Worker index where the current task will be submitted.
*/
/**
* Default worker weight.
*/
- private defaultWorkerWeight: number
+ private readonly defaultWorkerWeight: number
/**
* Per worker virtual task runtime map.
*/
private readonly workersTaskRunTime: Map<Worker, TaskRunTime> = new Map<
- Worker,
- TaskRunTime
+ Worker,
+ TaskRunTime
>()
/**
* Constructs a worker choice strategy that selects with a weighted round robin scheduling algorithm.
*
- * @param pool The pool instance.
+ * @param pool - The pool instance.
*/
public constructor (pool: IPoolInternal<Worker, Data, Response>) {
super(pool)
this.initWorkersTaskRunTime()
}
- /** @inheritDoc */
- public resetStatistics (): boolean {
+ /** {@inheritDoc} */
+ public reset (): boolean {
+ this.currentWorkerIndex = 0
this.workersTaskRunTime.clear()
this.initWorkersTaskRunTime()
return true
}
- /** @inheritDoc */
+ /** {@inheritDoc} */
public choose (): Worker {
- const currentWorker = this.pool.workers[this.currentWorkerIndex]
- if (
- this.isDynamicPool === true &&
- this.workersTaskRunTime.has(currentWorker) === false
- ) {
- this.initWorkerTaskRunTime(currentWorker)
+ const chosenWorker = this.pool.workers[this.currentWorkerIndex]
+ if (this.isDynamicPool && !this.workersTaskRunTime.has(chosenWorker)) {
+ this.initWorkerTaskRunTime(chosenWorker)
}
- const workerVirtualTaskRunTime =
- this.getWorkerVirtualTaskRunTime(currentWorker) ?? 0
+ const workerTaskRunTime =
+ this.workersTaskRunTime.get(chosenWorker)?.runTime ?? 0
const workerTaskWeight =
- this.workersTaskRunTime.get(currentWorker)?.weight ??
+ this.workersTaskRunTime.get(chosenWorker)?.weight ??
this.defaultWorkerWeight
- if (this.currentWorkerIndex === this.previousWorkerIndex) {
- const workerTaskRunTime =
- (this.workersTaskRunTime.get(currentWorker)?.runTime ?? 0) +
- workerVirtualTaskRunTime
+ if (workerTaskRunTime < workerTaskWeight) {
this.setWorkerTaskRunTime(
- currentWorker,
+ chosenWorker,
workerTaskWeight,
- workerTaskRunTime
+ workerTaskRunTime +
+ (this.getWorkerVirtualTaskRunTime(chosenWorker) ?? 0)
)
} else {
- this.setWorkerTaskRunTime(currentWorker, workerTaskWeight, 0)
- }
- if (workerVirtualTaskRunTime < workerTaskWeight) {
- this.previousWorkerIndex = this.currentWorkerIndex
- } else {
- this.previousWorkerIndex = this.currentWorkerIndex
this.currentWorkerIndex =
- this.pool.workers.length - 1 === this.currentWorkerIndex
+ this.currentWorkerIndex === this.pool.workers.length - 1
? 0
: this.currentWorkerIndex + 1
+ this.setWorkerTaskRunTime(
+ this.pool.workers[this.currentWorkerIndex],
+ workerTaskWeight,
+ 0
+ )
}
- return this.pool.workers[this.currentWorkerIndex]
+ return chosenWorker
}
private initWorkersTaskRunTime (): void {
let cpusCycleTimeWeight = 0
for (const cpu of cpus()) {
// CPU estimated cycle time
- const numberOfDigit = cpu.speed.toString().length - 1
- const cpuCycleTime = 1 / (cpu.speed / Math.pow(10, numberOfDigit))
- cpusCycleTimeWeight += cpuCycleTime * Math.pow(10, numberOfDigit)
+ const numberOfDigits = cpu.speed.toString().length - 1
+ const cpuCycleTime = 1 / (cpu.speed / Math.pow(10, numberOfDigits))
+ cpusCycleTimeWeight += cpuCycleTime * Math.pow(10, numberOfDigits)
}
return Math.round(cpusCycleTimeWeight / cpus().length)
}