script-utils-common/com.pambrose.common.script/AbstractExprEvaluatorPool

AbstractExprEvaluatorPool

abstract class AbstractExprEvaluatorPool<T : AbstractExprEvaluator>(val size: Int)

Abstract base class for a pool of AbstractExprEvaluator instances.

Uses a coroutine Channel as a bounded buffer to manage evaluator instances. Subclasses are responsible for populating the pool in their init block.

Parameters

size

the number of evaluator instances in the pool

Type Parameters

the concrete type of AbstractExprEvaluator managed by this pool

Constructors

AbstractExprEvaluatorPool

constructor(size: Int)

Properties

isEmpty

val isEmpty: Boolean

Returns an approximate, point-in-time indication of whether the pool currently has no evaluators available. Delegates to Channel.isEmpty, which is racy under concurrent borrow/recycle and may return a stale result, so do not rely on it for correctness.

size

val size: Int

Functions

blockingEval

fun blockingEval(expr: String): Boolean

Evaluates expr by borrowing an evaluator from the pool, blocking the current thread until one is available and recycling it afterwards.

eval

suspend fun eval(expr: String): Boolean

Suspends until an evaluator can be borrowed from the pool, evaluates expr, and recycles the evaluator afterwards. Suspends (rather than blocking) when all size evaluators are in use.