CoreContext

public interface CoreContext

Added in version 1.23.0-ms5.

Механизм распространения контекста, который может переносить ограниченные значения через границы API и между потоками.

Объект Context может быть установлен в текущее хранилище контекста, что эффективно формирует область для контекста. Область действия привязана к текущему потоку. В пределах области его контекст доступен даже за пределами границ API через CoreTelemetry.getCurrentContext(). Позже область действия закрывается при AutoCloseable.close() закрытии области.

Methods

get

<V> V get(Object key)

Возвращает значение, хранящееся в этом CoreContext для указанного контекстного ключа, или null если в этом контексте для ключа нет значения.

Parameters:
  • key – ключ. Тот же объект, что был передан ранее в метод with(Object, Object).

  • <V> – тип значения.

Returns:

значение или null.

makeCurrent

CoreScope makeCurrent()

Делает этот CoreTelemetry.getCurrentContext() текущим контекстом и возвращает CoreScope, который соответствует области выполнения этого контекста. CoreTelemetry.getCurrentContext() будет возвращать этот CoreContext до тех пор, пока не будет вызвана AutoCloseable.close(). AutoCloseable.close() должен быть вызван для правильного восстановления предыдущего контекста до этой области выполнения или контекст будет работать неправильно. Рекомендуется использовать try-with-resources для вызова AutoCloseable.close() автоматически.

Реализация этого метода по умолчанию сохраняет контекст CoreContext в ThreadLocal.

CoreTelemetry coreTelemetry = CoreServer$.MODULE$.getInstance().getCurrentSolution().getTelemetry();
CoreContext prevCtx = coreTelemetry.getCurrentContext();
Object contextKey = coreTelemetry.getContextKeyProvider().newContextKey("MyKey");
CoreContext ctx = coreTelemetry.getCurrentContext().with(contextKey, 100500L);
try (CoreScope ignored = ctx.makeCurrent()) {
    assert coreTelemetry.getCurrentContext().equals(ctx);
    // .....
}
assert coreTelemetry.getCurrentContext().equals(prevCtx);
Returns:

экземпляр CoreScope

with

<V> CoreContext with(Object key, V value)

Возвращает новый контекст с заданным набором значений ключа.

Parameters:
Returns:

Новый экземпляр контекста.

with

<V> CoreContext with(CoreImplicitContextKeyed value)

Возвращает новый контекст CoreContext с заданным набором CoreImplicitContextKeyed.

Parameters:
Returns:

Новый экземпляр контекста.