rocks.xmpp.extensions.shim.model

Class Headers

java.lang.Object

rocks.xmpp.extensions.shim.model.Headers

public final class Headers
extends java.lang.Object

The implementation of the <headers/> element in the http://jabber.org/protocol/shim namespace.

This class is immutable.

See Also:

XEP-0131: Stanza Headers and Internet Metadata, XML Schema, Header

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	NAMESPACE http://jabber.org/protocol/shim

Method Summary

Modifier and Type	Method and Description
java.lang.String	findValue(java.lang.String name) Tries to find a value among the headers associated with header name.
java.util.List<Header>	getHeaders() Gets the headers.
static Headers	of(java.util.Collection<Header> headers) Creates a headers element.
static Headers	of(Header... headers) Creates a headers element.
static Headers	of(java.util.Map<java.lang.String,java.lang.String> headers) Creates a headers element from a map.
static Headers	ofTimePeriod(java.time.OffsetDateTime start, java.time.OffsetDateTime stop) Creates a headers element with a time period.
java.lang.String	toString()
Headers	withHeader(Header header) Creates a new headers extension with an additional header.
Headers	withHeader(java.lang.String name, java.lang.String value) Creates a new headers extension with an additional header.
Headers	withoutHeader(java.lang.String name) Removes a header from this collection.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

NAMESPACE

public static final java.lang.String NAMESPACE

http://jabber.org/protocol/shim

See Also:

Constant Field Values

Method Detail

of

public static Headers of(Header... headers)

Creates a headers element.

Parameters:

headers - The headers.

Returns:

The header.

of

public static Headers of(java.util.Collection<Header> headers)

Creates a headers element.

Parameters:

headers - The headers.

Returns:

The header.

of

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

Creates a headers element from a map.

Parameters:

headers - The headers.

Returns:

The header.

ofTimePeriod

public static Headers ofTimePeriod(java.time.OffsetDateTime start,
                                   java.time.OffsetDateTime stop)

Creates a headers element with a time period.

Parameters:

start - The start date.

stop - The stop date.

Returns:

The header.

See Also:

XEP-0149: Time Periods

findValue

public final java.lang.String findValue(java.lang.String name)

Tries to find a value among the headers associated with header name.

Parameters:

name - The name of the header.

Returns:

The found value or null if none could be found.

getHeaders

public final java.util.List<Header> getHeaders()

Gets the headers.

Returns:

The headers.

withHeader

public final Headers withHeader(java.lang.String name,
                                java.lang.String value)

Creates a new headers extension with an additional header. If the header already exists (by their name), it is replaced; otherwise it’s added.

Parameters:

name - The header name.

value - The header value.

Returns:

The headers.

withHeader

public final Headers withHeader(Header header)

Creates a new headers extension with an additional header. If the header already exists (by their name), it is replaced; otherwise it’s added.

Parameters:

header - The header.

Returns:

The headers.

withoutHeader

public final Headers withoutHeader(java.lang.String name)

Removes a header from this collection.

Parameters:

name - The header name.

Returns:

The headers.

toString

public final java.lang.String toString()

Overrides:

toString in class java.lang.Object