reactor.util.context

接口 Context

所有超级接口:

ContextView

public interface Context
extends ContextView

A key/value store 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 implementations are thread-safe and immutable: mutative operations like put(Object, Object) will in fact return a new Context instance.

Note that contexts are optimized for low cardinality key/value storage, and a user might want to associate a dedicated mutable structure to a single key to represent his own context instead of using multiple put(java.lang.Object, java.lang.Object), which could be more costly. Past five user key/value pair, the Context will use a copy-on-write implementation backed by a new Map on each put(java.lang.Object, java.lang.Object).

作者:

Stephane Maldini

方法概要

限定符和类型	方法和说明
Context	delete(java.lang.Object key) Return a new Context that will resolve all existing keys except the removed one, key.
static Context	empty() Return an empty Context
static Context	of(ContextView contextView) Create a Context out of a ContextView, enabling write API on top of the read-only view.
static Context	of(java.util.Map<?,?> map) Create a Context out of a Map.
static Context	of(java.lang.Object key, java.lang.Object value) Create a Context pre-initialized with one key-value pair.
static Context	of(java.lang.Object key1, java.lang.Object value1, java.lang.Object key2, java.lang.Object value2) Create a Context pre-initialized with two key-value pairs.
static Context	of(java.lang.Object key1, java.lang.Object value1, java.lang.Object key2, java.lang.Object value2, java.lang.Object key3, java.lang.Object value3) Create a Context pre-initialized with three key-value pairs.
static Context	of(java.lang.Object key1, java.lang.Object value1, java.lang.Object key2, java.lang.Object value2, java.lang.Object key3, java.lang.Object value3, java.lang.Object key4, java.lang.Object value4) Create a Context pre-initialized with four key-value pairs.
static Context	of(java.lang.Object key1, java.lang.Object value1, java.lang.Object key2, java.lang.Object value2, java.lang.Object key3, java.lang.Object value3, java.lang.Object key4, java.lang.Object value4, java.lang.Object key5, java.lang.Object value5) Create a Context pre-initialized with five key-value pairs.
Context	put(java.lang.Object key, java.lang.Object value) Create a new Context that contains all current key/value pairs plus the given key/value pair.
default Context	putAll(Context context) 已过时。 will be removed in 3.5, kept for backward compatibility with 3.3. Until then if you need to work around the deprecation, use putAll(ContextView) combined with readOnly()
default Context	putAll(ContextView other) Create a new Context by merging the content of this context and a given ContextView.
default Context	putAllMap(java.util.Map<?,?> from) Create a new Context by merging the content of this context and a given Map.
default Context	putNonNull(java.lang.Object key, java.lang.Object valueOrNull) Create a new Context that contains all current key/value pairs plus the given key/value pair only if the value is not null.
default ContextView	readOnly() Switch to the ContextView interface, which only allows reading from the context.

从接口继承的方法 reactor.util.context.ContextView

forEach, get, get, getOrDefault, getOrEmpty, hasKey, isEmpty, size, stream

方法详细资料

empty

static Context empty()

Return an empty Context

返回:

an empty Context

of

static Context of(java.lang.Object key,
                  java.lang.Object value)

Create a Context pre-initialized with one key-value pair.

参数:

key - the key to initialize.

value - the value for the key.

返回:

a Context with a single entry.

抛出:

java.lang.NullPointerException - if either key or value are null

of

static Context of(java.lang.Object key1,
                  java.lang.Object value1,
                  java.lang.Object key2,
                  java.lang.Object value2)

Create a Context pre-initialized with two key-value pairs.

参数:

key1 - the first key to initialize.

value1 - the value for the first key.

key2 - the second key to initialize.

value2 - the value for the second key.

返回:

a Context with two entries.

抛出:

java.lang.NullPointerException - if any key or value is null

of

static Context of(java.lang.Object key1,
                  java.lang.Object value1,
                  java.lang.Object key2,
                  java.lang.Object value2,
                  java.lang.Object key3,
                  java.lang.Object value3)

Create a Context pre-initialized with three key-value pairs.

参数:

key1 - the first key to initialize.

value1 - the value for the first key.

key2 - the second key to initialize.

value2 - the value for the second key.

key3 - the third key to initialize.

value3 - the value for the third key.

返回:

a Context with three entries.

抛出:

java.lang.NullPointerException - if any key or value is null

of

static Context of(java.lang.Object key1,
                  java.lang.Object value1,
                  java.lang.Object key2,
                  java.lang.Object value2,
                  java.lang.Object key3,
                  java.lang.Object value3,
                  java.lang.Object key4,
                  java.lang.Object value4)

Create a Context pre-initialized with four key-value pairs.

参数:

key1 - the first key to initialize.

value1 - the value for the first key.

key2 - the second key to initialize.

value2 - the value for the second key.

key3 - the third key to initialize.

value3 - the value for the third key.

key4 - the fourth key to initialize.

value4 - the value for the fourth key.

返回:

a Context with four entries.

抛出:

java.lang.NullPointerException - if any key or value is null

of

static Context of(java.lang.Object key1,
                  java.lang.Object value1,
                  java.lang.Object key2,
                  java.lang.Object value2,
                  java.lang.Object key3,
                  java.lang.Object value3,
                  java.lang.Object key4,
                  java.lang.Object value4,
                  java.lang.Object key5,
                  java.lang.Object value5)

Create a Context pre-initialized with five key-value pairs.

参数:

key1 - the first key to initialize.

value1 - the value for the first key.

key2 - the second key to initialize.

value2 - the value for the second key.

key3 - the third key to initialize.

value3 - the value for the third key.

key4 - the fourth key to initialize.

value4 - the value for the fourth key.

key5 - the fifth key to initialize.

value5 - the value for the fifth key.

返回:

a Context with five entries.

抛出:

java.lang.NullPointerException - if any key or value is null

of

static Context of(java.util.Map<?,?> map)

Create a Context out of a Map. Prefer this method if you're somehow incapable of checking keys are all distinct in other of(Object, Object, Object, Object, Object, Object, Object, Object) implementations.

of

static Context of(ContextView contextView)

Create a Context out of a ContextView, enabling write API on top of the read-only view. If the ContextView is already a Context, return the same instance.

参数:

contextView - the ContextView to convert (or cast) to Context

返回:

the converted Context for further modifications

readOnly

default ContextView readOnly()

Switch to the ContextView interface, which only allows reading from the context.

返回:

the ContextView of this context

put

Context put(java.lang.Object key,
            java.lang.Object value)

Create a new Context that contains all current key/value pairs plus the given key/value pair. If that key existed in the current Context, its associated value is replaced in the resulting Context.

参数:

key - the key to add/update in the new Context

value - the value to associate to the key in the new Context

返回:

a new Context including the provided key/value

抛出:

java.lang.NullPointerException - if either the key or value are null

putNonNull

default Context putNonNull(java.lang.Object key,
                           @Nullable
                           java.lang.Object valueOrNull)

Create a new Context that contains all current key/value pairs plus the given key/value pair only if the value is not null. If that key existed in the current Context, its associated value is replaced in the resulting Context.

参数:

key - the key to add/update in the new Context

valueOrNull - the value to associate to the key in the new Context, null to ignore the operation

返回:

a new Context including the provided key/value, or the same Context if value is null

抛出:

java.lang.NullPointerException - if the key is null

delete

Context delete(java.lang.Object key)

Return a new Context that will resolve all existing keys except the removed one, key.

Note that if this Context doesn't contain the key, this method simply returns this same instance.

参数:

key - the key to remove.

返回:

a new Context that doesn't include the provided key

putAll

default Context putAll(ContextView other)

Create a new Context by merging the content of this context and a given ContextView. If the other context is empty, the same Context instance is returned.

参数:

other - the other ContextView from which to copy entries

返回:

a new Context with a merge of the entries from this context and the given context.

putAllMap

default Context putAllMap(java.util.Map<?,?> from)

Create a new Context by merging the content of this context and a given Map. If the Map is empty, the same Context instance is returned.

参数:

from - the Map from which to include entries in the resulting Context.

返回:

a new Context with a merge of the entries from this context and the given Map.

putAll

@Deprecated
default Context putAll(Context context)

已过时。 will be removed in 3.5, kept for backward compatibility with 3.3. Until then if you need to work around the deprecation, use putAll(ContextView) combined with readOnly()

See putAll(ContextView).

参数:

context - the Context from which to copy entries

返回:

a new Context with a merge of the entries from this context and the given context.