com.azure.core.util

Class Context

java.lang.Object

com.azure.core.util.Context

public class Context
extends Object

Context offers a means of passing arbitrary data (key-value pairs) to pipeline policies. Most applications do not need to pass arbitrary data to the pipeline and can pass Context.NONE or null. Each context object is immutable. The addData(Object, Object) method creates a new Context object that refers to its parent, forming a linked list.

Field Summary

Fields

Modifier and Type	Field and Description
static Context	NONE Signifies that no data need be passed to the pipeline.

Constructor Summary

Constructors

Constructor and Description
Context(Object key, Object value) Constructs a new Context object.

Method Summary

Modifier and Type	Method and Description
Context	addData(Object key, Object value) Adds a new immutable Context object with the specified key-value pair to the existing Context chain.
Optional<Object>	getData(Object key) Scans the linked-list of Context objects looking for one with the specified key.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

NONE

public static final Context NONE

Signifies that no data need be passed to the pipeline.

Constructor Detail

Context

public Context(Object key,
               Object value)

Constructs a new Context object.

Parameters:

key - the key

value - the value

Throws:

IllegalArgumentException - If key is null.

Method Detail

addData

public Context addData(Object key,
                       Object value)

Adds a new immutable Context object with the specified key-value pair to the existing Context chain.

Parameters:

key - the key

value - the value

Returns:

the new Context object containing the specified pair added to the set of pairs

Throws:

IllegalArgumentException - If key is null.

getData

public Optional<Object> getData(Object key)

Scans the linked-list of Context objects looking for one with the specified key. Note that the first key found, i.e. the most recently added, will be returned.

Parameters:

key - the key to search for

Returns:

the value of the key if it exists

Throws:

IllegalArgumentException - If key is null.