reactor.util.context

接口 ContextView

所有已知子接口:

Context

public interface ContextView

A read-only view of a collection of key/value pairs that is propagated between components such as operators via the context protocol. Contexts are ideal to transport orthogonal information such as tracing or security tokens.

Context is an immutable variant of the same key/value pairs structure which exposes a write API that returns new instances on each write.

从以下版本开始:

3.4.0

作者:

Simon Baslé

方法概要

限定符和类型	方法和说明
default void	forEach(java.util.function.BiConsumer<java.lang.Object,java.lang.Object> action) Perform the given action for each entry in this ContextView.
default <T> T	get(java.lang.Class<T> key) Resolve a value given a type key within the Context.
<T> T	get(java.lang.Object key) Resolve a value given a key that exists within the Context, or throw a NoSuchElementException if the key is not present.
default <T> T	getOrDefault(java.lang.Object key, T defaultValue) Resolve a value given a key within the Context.
default <T> java.util.Optional<T>	getOrEmpty(java.lang.Object key) Resolve a value given a key within the Context.
boolean	hasKey(java.lang.Object key) Return true if a particular key resolves to a value within the Context.
default boolean	isEmpty() Return true if the Context is empty.
int	size() Return the size of this Context, the number of immutable key/value pairs stored inside it.
java.util.stream.Stream<java.util.Map.Entry<java.lang.Object,java.lang.Object>>	stream() Stream key/value pairs from this Context

方法详细资料

get

<T> T get(java.lang.Object key)

Resolve a value given a key that exists within the Context, or throw a NoSuchElementException if the key is not present.

类型参数:

T - an unchecked casted generic for fluent typing convenience

参数:

key - a lookup key to resolve the value within the context

返回:

the value resolved for this key (throws if key not found)

抛出:

java.util.NoSuchElementException - when the given key is not present

另请参阅:

getOrDefault(Object, Object), getOrEmpty(Object), hasKey(Object)

get

default <T> T get(java.lang.Class<T> key)

Resolve a value given a type key within the Context.

类型参数:

T - an unchecked casted generic for fluent typing convenience

参数:

key - a type key to resolve the value within the context

返回:

the value resolved for this type key (throws if key not found)

抛出:

java.util.NoSuchElementException - when the given type key is not present

另请参阅:

getOrDefault(Object, Object), getOrEmpty(Object)

getOrDefault

@Nullable
default <T> T getOrDefault(java.lang.Object key,
                                      @Nullable
                                      T defaultValue)

Resolve a value given a key within the Context. If unresolved return the passed default value.

参数:

key - a lookup key to resolve the value within the context

defaultValue - a fallback value if key doesn't resolve

返回:

the value resolved for this key, or the given default if not present

getOrEmpty

default <T> java.util.Optional<T> getOrEmpty(java.lang.Object key)

Resolve a value given a key within the Context.

参数:

key - a lookup key to resolve the value within the context

返回:

an Optional of the value for that key.

hasKey

boolean hasKey(java.lang.Object key)

Return true if a particular key resolves to a value within the Context.

参数:

key - a lookup key to test for

返回:

true if this context contains the given key

isEmpty

default boolean isEmpty()

Return true if the Context is empty.

返回:

true if the Context is empty.

size

int size()

Return the size of this Context, the number of immutable key/value pairs stored inside it.

返回:

the size of the Context

stream

java.util.stream.Stream<java.util.Map.Entry<java.lang.Object,java.lang.Object>> stream()

Stream key/value pairs from this Context

返回:

a Stream of key/value pairs held by this context

forEach

default void forEach(java.util.function.BiConsumer<java.lang.Object,java.lang.Object> action)

Perform the given action for each entry in this ContextView. If the action throws an exception, it is immediately propagated to the caller and the remaining items will not be processed.

参数:

action - The action to be performed for each entry

抛出:

java.lang.NullPointerException - if the specified action is null