org.junit.jupiter.api.extension

Interface ExtensionContext.Store

Enclosing interface:

ExtensionContext

public static interface ExtensionContext.Store

Store provides methods for extensions to save and retrieve data.

Method Summary

Modifier and Type	Method and Description
java.lang.Object	get(java.lang.Object key) Get the value that is stored under the supplied key.
<V> V	get(java.lang.Object key, java.lang.Class<V> requiredType) Get the value of the specified required type that is stored under the supplied key.
<K,V> java.lang.Object	getOrComputeIfAbsent(K key, java.util.function.Function<K,V> defaultCreator) Get the value that is stored under the supplied key.
<K,V> V	getOrComputeIfAbsent(K key, java.util.function.Function<K,V> defaultCreator, java.lang.Class<V> requiredType) Get the value of the specified required type that is stored under the supplied key.
void	put(java.lang.Object key, java.lang.Object value) Store a value for later retrieval under the supplied key.
java.lang.Object	remove(java.lang.Object key) Remove the value that was previously stored under the supplied key.
<V> V	remove(java.lang.Object key, java.lang.Class<V> requiredType) Remove the value of the specified required type that was previously stored under the supplied key.

Method Detail

get

java.lang.Object get(java.lang.Object key)

Get the value that is stored under the supplied key.

If no value is stored in the current ExtensionContext for the supplied key, ancestors of the context will be queried for a value with the same key in the Namespace used to create this store.

For greater type safety, consider using get(Object, Class) instead.

Parameters:

key - the key; never null

Returns:

the value; potentially null

See Also:

get(Object, Class)

get

<V> V get(java.lang.Object key,
          java.lang.Class<V> requiredType)

Get the value of the specified required type that is stored under the supplied key.

If no value is stored in the current ExtensionContext for the supplied key, ancestors of the context will be queried for a value with the same key in the Namespace used to create this store.

Type Parameters:

V - the value type

Parameters:

key - the key; never null

requiredType - the required type of the value; never null

Returns:

the value; potentially null

See Also:

get(Object)

getOrComputeIfAbsent

<K,V> java.lang.Object getOrComputeIfAbsent(K key,
                                            java.util.function.Function<K,V> defaultCreator)

Get the value that is stored under the supplied key.

If no value is stored in the current ExtensionContext for the supplied key, ancestors of the context will be queried for a value with the same key in the Namespace used to create this store. If no value is found for the supplied key, a new value will be computed by the defaultCreator (given the key as input), stored, and returned.

For greater type safety, consider using getOrComputeIfAbsent(Object, Function, Class) instead.

Type Parameters:

K - the key type

V - the value type

Parameters:

key - the key; never null

defaultCreator - the function called with the supplied key to create a new value; never null

Returns:

the value; potentially null

See Also:

getOrComputeIfAbsent(Object, Function, Class)

getOrComputeIfAbsent

<K,V> V getOrComputeIfAbsent(K key,
                             java.util.function.Function<K,V> defaultCreator,
                             java.lang.Class<V> requiredType)

Get the value of the specified required type that is stored under the supplied key.

If no value is stored in the current ExtensionContext for the supplied key, ancestors of the context will be queried for a value with the same key in the Namespace used to create this store. If no value is found for the supplied key, a new value will be computed by the defaultCreator (given the key as input), stored, and returned.

Type Parameters:

K - the key type

V - the value type

Parameters:

key - the key; never null

defaultCreator - the function called with the supplied key to create a new value; never null

requiredType - the required type of the value; never null

Returns:

the value; potentially null

See Also:

getOrComputeIfAbsent(Object, Function)

put

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

Store a value for later retrieval under the supplied key.

A stored value is visible in child ExtensionContexts for the store's Namespace unless they overwrite it.

Parameters:

key - the key under which the value should be stored; never null

value - the value to store; may be null

remove

java.lang.Object remove(java.lang.Object key)

Remove the value that was previously stored under the supplied key.

The value will only be removed in the current ExtensionContext, not in ancestors.

For greater type safety, consider using remove(Object, Class) instead.

Parameters:

key - the key; never null

Returns:

the previous value or null if no value was present for the specified key

See Also:

remove(Object, Class)

remove

<V> V remove(java.lang.Object key,
             java.lang.Class<V> requiredType)

Remove the value of the specified required type that was previously stored under the supplied key.

The value will only be removed in the current ExtensionContext, not in ancestors.

Type Parameters:

V - the value type

Parameters:

key - the key; never null

requiredType - the required type of the value; never null

Returns:

the previous value or null if no value was present for the specified key

See Also:

remove(Object)