1 import type { IWorker
} from
'../worker'
2 import type { IPool
} from
'../pool'
4 DEFAULT_MEASUREMENT_STATISTICS_REQUIREMENTS
,
5 DEFAULT_WORKER_CHOICE_STRATEGY_OPTIONS
7 import { AbstractWorkerChoiceStrategy
} from
'./abstract-worker-choice-strategy'
10 TaskStatisticsRequirements
,
11 WorkerChoiceStrategyOptions
12 } from
'./selection-strategies-types'
15 * Selects the next worker with an interleaved weighted round robin scheduling algorithm.
17 * @typeParam Worker - Type of worker which manages the strategy.
18 * @typeParam Data - Type of data sent to the worker. This can only be structured-cloneable data.
19 * @typeParam Response - Type of execution response. This can only be structured-cloneable data.
21 export class InterleavedWeightedRoundRobinWorkerChoiceStrategy
<
22 Worker
extends IWorker
,
26 extends AbstractWorkerChoiceStrategy
<Worker
, Data
, Response
>
27 implements IWorkerChoiceStrategy
{
29 public readonly taskStatisticsRequirements
: TaskStatisticsRequirements
= {
35 waitTime
: DEFAULT_MEASUREMENT_STATISTICS_REQUIREMENTS
,
36 elu
: DEFAULT_MEASUREMENT_STATISTICS_REQUIREMENTS
42 private roundId
: number = 0
44 * Default worker weight.
46 private readonly defaultWorkerWeight
: number
50 private roundWeights
: number[]
54 private workerNodeId
: number = 0
56 * Worker virtual task runtime.
58 private workerVirtualTaskRunTime
: number = 0
62 pool
: IPool
<Worker
, Data
, Response
>,
63 opts
: WorkerChoiceStrategyOptions
= DEFAULT_WORKER_CHOICE_STRATEGY_OPTIONS
66 this.setTaskStatisticsRequirements(this.opts
)
67 this.defaultWorkerWeight
= this.computeDefaultWorkerWeight()
68 this.roundWeights
= this.getRoundWeights()
72 public reset (): boolean {
73 this.resetWorkerNodeKeyProperties()
76 this.workerVirtualTaskRunTime
= 0
81 public update (): boolean {
86 public choose (): number | undefined {
88 let roundIndex
= this.roundId
;
89 roundIndex
< this.roundWeights
.length
;
92 this.roundId
= roundIndex
94 let workerNodeKey
= this.workerNodeId
;
95 workerNodeKey
< this.pool
.workerNodes
.length
;
98 this.workerNodeId
= workerNodeKey
100 this.workerNodeId
!== this.nextWorkerNodeKey
&&
101 this.workerVirtualTaskRunTime
!== 0
103 this.workerVirtualTaskRunTime
= 0
106 this.opts
.weights
?.[workerNodeKey
] ?? this.defaultWorkerWeight
108 workerWeight
>= this.roundWeights
[roundIndex
] &&
109 this.workerVirtualTaskRunTime
< workerWeight
111 this.workerVirtualTaskRunTime
=
112 this.workerVirtualTaskRunTime
+
113 this.getWorkerTaskRunTime(workerNodeKey
)
114 this.setPreviousWorkerNodeKey(this.nextWorkerNodeKey
)
115 this.nextWorkerNodeKey
= workerNodeKey
116 return this.nextWorkerNodeKey
120 this.interleavedWeightedRoundRobinNextWorkerNodeId()
123 private interleavedWeightedRoundRobinNextWorkerNodeId (): void {
125 this.roundId
=== this.roundWeights
.length
- 1 &&
126 this.workerNodeId
=== this.pool
.workerNodes
.length
- 1
129 this.workerNodeId
= 0
130 } else if (this.workerNodeId
=== this.pool
.workerNodes
.length
- 1) {
131 this.roundId
= this.roundId
+ 1
132 this.workerNodeId
= 0
134 this.workerNodeId
= this.workerNodeId
+ 1
139 public remove (workerNodeKey
: number): boolean {
140 if (this.pool
.workerNodes
.length
=== 0) {
144 this.workerNodeId
=== workerNodeKey
&&
145 this.workerNodeId
> this.pool
.workerNodes
.length
- 1
147 this.workerNodeId
= this.pool
.workerNodes
.length
- 1
150 this.previousWorkerNodeKey
=== workerNodeKey
&&
151 this.previousWorkerNodeKey
> this.pool
.workerNodes
.length
- 1
153 this.previousWorkerNodeKey
= this.pool
.workerNodes
.length
- 1
159 public setOptions (opts
: WorkerChoiceStrategyOptions
): void {
160 super.setOptions(opts
)
161 this.roundWeights
= this.getRoundWeights()
164 private getRoundWeights (): number[] {
165 if (this.opts
.weights
== null) {
166 return [this.defaultWorkerWeight
]
170 Object.values(this.opts
.weights
)
172 .sort((a
, b
) => a
- b
)