com.microsoft.rest.v2

Class Context

java.lang.Object

com.microsoft.rest.v2.Context

public class Context
extends Object

Context offers a means of passing arbitrary data (key/value pairs) to an HttpPipeline's policy objects. 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 withContext with data 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 a 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.

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.

getData

public Optional<Object> getData(Object key)

Scans a 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.