reactor.bus

Class Event.Headers

java.lang.Object

reactor.bus.Event.Headers

All Implemented Interfaces:

java.io.Serializable, java.lang.Iterable<reactor.fn.tuple.Tuple2<java.lang.String,java.lang.Object>>

Enclosing class:

Event<T>

public static class Event.Headers
extends java.lang.Object
implements java.io.Serializable, java.lang.Iterable<reactor.fn.tuple.Tuple2<java.lang.String,java.lang.Object>>

Headers are a Map-like structure of name-value pairs. Header names are case-insensitive, as determined by String.CASE_INSENSITIVE_ORDER. A header can be removed by setting its value to null.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	ORIGIN The name of the origin header

Constructor Summary

Constructors

Constructor and Description
Headers() Create an empty Headers
Headers(java.util.Map<java.lang.String,java.lang.Object> headers) Creates a new Headers instance by copying the contents of the given headers Map.

Method Summary

Modifier and Type	Method and Description
java.util.Map<java.lang.String,java.lang.Object>	asMap() Get these headers as an unmodifiable Map.
boolean	contains(java.lang.String name) Determine whether the headers contain a value for the given name.
<V> V	get(java.lang.String name) Get the value for the given header.
java.lang.String	getOrigin() Get the origin header
java.util.Iterator<reactor.fn.tuple.Tuple2<java.lang.String,java.lang.Object>>	iterator() Returns an unmodifiable Iterator over a copy of this Headers' contents.
Event.Headers	readOnly() Get the headers as a read-only version
<V> Event.Headers	set(java.lang.String name, V value) Set the header value.
Event.Headers	setAll(java.util.Map<java.lang.String,java.lang.Object> headers) Sets all of the headers represented by entries in the given headers Map.
Event.Headers	setOrigin(java.lang.String id) Set the origin header.
Event.Headers	setOrigin(java.util.UUID id) Set the origin header.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Field Detail

ORIGIN

public static final java.lang.String ORIGIN

The name of the origin header

See Also:

setOrigin(String), setOrigin(UUID), getOrigin(), Constant Field Values

Constructor Detail

Headers

public Headers(java.util.Map<java.lang.String,java.lang.Object> headers)

Creates a new Headers instance by copying the contents of the given headers Map. Note that, as the map is copied, subsequent changes to its contents will have no effect upon the Headers.

Parameters:

headers - The map to copy.

Headers

public Headers()

Create an empty Headers

Method Detail

setAll

public Event.Headers setAll(java.util.Map<java.lang.String,java.lang.Object> headers)

Sets all of the headers represented by entries in the given headers Map. Any entry with a null value will cause the header matching the entry's name to be removed.

Parameters:

headers - The map of headers to set.

Returns:

this

set

public <V> Event.Headers set(java.lang.String name,
                             V value)

Set the header value. If value is null the header with the given name will be removed.

Parameters:

name - The name of the header.

value - The header's value.

Returns:

this

setOrigin

public Event.Headers setOrigin(java.util.UUID id)

Set the origin header. The origin is simply a unique id to indicate to consumers where it should send replies. If id is null the origin header will be removed.

Parameters:

id - The id of the origin component.

Returns:

this

getOrigin

public java.lang.String getOrigin()

Get the origin header

Returns:

The origin header, may be null.

setOrigin

public Event.Headers setOrigin(java.lang.String id)

Set the origin header. The origin is simply a unique id to indicate to consumers where it should send replies. If id is null this origin header will be removed.

Parameters:

id - The id of the origin component.

Returns:

this

get

public <V> V get(java.lang.String name)

Get the value for the given header.

Parameters:

name - The header name.

Returns:

The value of the header, or null if none exists.

contains

public boolean contains(java.lang.String name)

Determine whether the headers contain a value for the given name.

Parameters:

name - The header name.

Returns:

true if a value exists, false otherwise.

asMap

public java.util.Map<java.lang.String,java.lang.Object> asMap()

Get these headers as an unmodifiable Map.

Returns:

The unmodifiable header map

readOnly

public Event.Headers readOnly()

Get the headers as a read-only version

Returns:

A read-only version of the headers.

iterator

public java.util.Iterator<reactor.fn.tuple.Tuple2<java.lang.String,java.lang.Object>> iterator()

Returns an unmodifiable Iterator over a copy of this Headers' contents.

Specified by:

iterator in interface java.lang.Iterable<reactor.fn.tuple.Tuple2<java.lang.String,java.lang.Object>>

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object