CoreContext¶
- public interface CoreContext¶
Added in version 1.23.0-ms5.
Механизм распространения контекста, который может переносить ограниченные значения через границы API и между потоками.
Объект Context может быть
установленв текущее хранилище контекста, что эффективно формирует область для контекста. Область действия привязана к текущему потоку. В пределах области его контекст доступен даже за пределами границ API черезCoreTelemetry.getCurrentContext(). Позже область действия закрывается приAutoCloseable.close()закрытии области.See also
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:
key – ключ, созданный методом
CoreContextKeyProvider.newContextKey(String).value – значение контекстного ключа.
<V> – тип значения.
- Returns:
Новый экземпляр контекста.
with¶
- <V> CoreContext with(CoreImplicitContextKeyed value)¶
Возвращает новый контекст
CoreContextс заданным наборомCoreImplicitContextKeyed.- Parameters:
value – экземпляр
CoreImplicitContextKeyed.<V> – тип возвращаемого значения
- Returns:
Новый экземпляр контекста.