Module brave

Package brave.internal

Class MapPropagationFields<K,V>

java.lang.Object

brave.internal.PropagationFields<K,V>

brave.internal.MapPropagationFields<K,V>

Type Parameters:

K - Must be immutable to ensure copy-on-write is effective.

V - Must be immutable to ensure copy-on-write is effective.

public class MapPropagationFields<K,V>
extends PropagationFields<K,V>

Copy-on-write keeps propagation changes in a child context from affecting its parent.

Type parameters must be immutable to ensure copy-on-write branch safety. For example, if they weren't, modifications by a child span could effect its parent and siblings.

Nested Class Summary

Nested classes/interfaces inherited from class brave.internal.PropagationFields

PropagationFields.FieldConsumer<K,V>

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	MapPropagationFields()
protected	MapPropagationFields(MapPropagationFields<K,V> parent)
protected	MapPropagationFields(java.util.Map<K,V> parent)

Method Summary

Modifier and Type	Method	Description
boolean	equals(java.lang.Object o)
void	forEach(PropagationFields.FieldConsumer<K,V> fieldConsumer)	Invokes the consumer for every non-null field value
V	get(K key)	Returns the value of the field with the specified key or null if not available
int	hashCode()
boolean	isEmpty()
void	put(K key, V value)	Replaces the value of the field with the specified key, ignoring if not a permitted field
protected void	putAllIfAbsent(PropagationFields parent)
java.util.Map<K,V>	toMap()	for testing and default toString

Methods inherited from class brave.internal.PropagationFields

get, put, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

MapPropagationFields

protected MapPropagationFields()

MapPropagationFields

protected MapPropagationFields(java.util.Map<K,V> parent)

MapPropagationFields

protected MapPropagationFields(MapPropagationFields<K,V> parent)

Method Detail

get

public V get(K key)

Description copied from class: PropagationFields

Returns the value of the field with the specified key or null if not available

Specified by:

get in class PropagationFields<K,V>

forEach

public void forEach(PropagationFields.FieldConsumer<K,V> fieldConsumer)

Description copied from class: PropagationFields

Invokes the consumer for every non-null field value

Specified by:

forEach in class PropagationFields<K,V>

put

public final void put(K key,
                      V value)

Description copied from class: PropagationFields

Replaces the value of the field with the specified key, ignoring if not a permitted field

Specified by:

put in class PropagationFields<K,V>

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in class PropagationFields<K,V>

putAllIfAbsent

protected final void putAllIfAbsent(PropagationFields parent)

toMap

public final java.util.Map<K,V> toMap()

Description copied from class: PropagationFields

for testing and default toString

Specified by:

toMap in class PropagationFields<K,V>

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object