repositories
/
poolifier.git
/ blobdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
|
commitdiff
|
tree
raw
|
inline
| side by side
docs: enhance documentation
[poolifier.git]
/
src
/
pools
/
selection-strategies
/
selection-strategies-types.ts
diff --git
a/src/pools/selection-strategies/selection-strategies-types.ts
b/src/pools/selection-strategies/selection-strategies-types.ts
index 5b844cc572756930980c29991ea3af94ae9a6532..065b310fa5e8a3454f84d5b0edd6324c7c2d0520 100644
(file)
--- a/
src/pools/selection-strategies/selection-strategies-types.ts
+++ b/
src/pools/selection-strategies/selection-strategies-types.ts
@@
-1,5
+1,3
@@
-import type { AbstractPoolWorker } from '../abstract-pool-worker'
-
/**
* Enumeration of worker choice strategies.
*/
/**
* Enumeration of worker choice strategies.
*/
@@
-9,9
+7,13
@@
export const WorkerChoiceStrategies = Object.freeze({
*/
ROUND_ROBIN: 'ROUND_ROBIN',
/**
*/
ROUND_ROBIN: 'ROUND_ROBIN',
/**
- * Less recently used worker selection strategy.
+ * Less used worker selection strategy.
+ */
+ LESS_USED: 'LESS_USED',
+ /**
+ * Less busy worker selection strategy.
*/
*/
- LESS_
RECENTLY_USED: 'LESS_RECENTLY_USED
',
+ LESS_
BUSY: 'LESS_BUSY
',
/**
* Fair share worker selection strategy.
*/
/**
* Fair share worker selection strategy.
*/
@@
-28,28
+30,55
@@
export const WorkerChoiceStrategies = Object.freeze({
export type WorkerChoiceStrategy = keyof typeof WorkerChoiceStrategies
/**
export type WorkerChoiceStrategy = keyof typeof WorkerChoiceStrategies
/**
- *
Tasks usage statistics requirement
s.
+ *
Worker choice strategy option
s.
*/
*/
-export type RequiredStatistics = {
- runTime: boolean
+export interface WorkerChoiceStrategyOptions {
+ /**
+ * Use tasks median run time instead of average run time.
+ */
+ medRunTime?: boolean
}
/**
}
/**
- *
Worker choice strategy interface
.
+ *
Pool worker tasks usage statistics requirements
.
*
*
- * @
template Worker Type of worker which manages the strategy.
+ * @
internal
*/
*/
-export interface
IWorkerChoiceStrategy<Worker extends AbstractPoolWorker>
{
+export interface
RequiredStatistics
{
/**
/**
- *
Is the pool attached to the strategy dynamic?
.
+ *
Require tasks run time
.
*/
*/
- isDynamicPool: boolean
+ runTime: boolean
+ /**
+ * Require tasks average run time.
+ */
+ avgRunTime: boolean
+ /**
+ * Require tasks median run time.
+ */
+ medRunTime: boolean
+}
+
+/**
+ * Worker choice strategy interface.
+ */
+export interface IWorkerChoiceStrategy {
/**
* Required tasks usage statistics.
*/
/**
* Required tasks usage statistics.
*/
- requiredStatistics: RequiredStatistics
+ readonly requiredStatistics: RequiredStatistics
+ /**
+ * Resets strategy internals (counters, statistics, etc.).
+ */
+ reset: () => boolean
+ /**
+ * Chooses a worker node in the pool and returns its key.
+ */
+ choose: () => number
/**
/**
- * Chooses a worker in the pool.
+ * Removes a worker node key from strategy internals.
+ *
+ * @param workerNodeKey - The worker node key.
*/
*/
- choose(): Worker
+ remove: (workerNodeKey: number) => boolean
}
}