StompHeaders (Spring Framework 4.3.25.RELEASE API)

java.lang.Object
- org.springframework.messaging.simp.stomp.StompHeaders

All Implemented Interfaces:

Serializable, Map<String,List<String>>, MultiValueMap<String,String>
```
public class StompHeaders
extends Object
implements MultiValueMap<String,String>, Serializable
```
Represents STOMP frame headers.
In addition to the normal methods defined by Map, this class offers the following convenience methods:
- getFirst(String) return the first value for a header name
- add(String, String) add to the list of values for a header name
- set(String, String) set a header name to a single string value
Since:

4.2

Author:

Rossen Stoyanchev

See Also:

https://stomp.github.io/stomp-specification-1.2.html#Frames_and_Headers, Serialized Form

Nested Class Summary
- Nested classes/interfaces inherited from interface java.util.Map
  Map.Entry<K,V>

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`ACK`
`static String`	`CONTENT_LENGTH`
`static String`	`CONTENT_TYPE`
`static String`	`DESTINATION`
`static String`	`HEARTBEAT`
`static String`	`HOST`
`static String`	`ID`
`static String`	`LOGIN`
`static String`	`MESSAGE_ID`
`static String`	`PASSCODE`
`static String`	`RECEIPT`
`static String`	`RECEIPT_ID`
`static String`	`SERVER`
`static String`	`SESSION`
`static String`	`SUBSCRIPTION`

Constructor Summary

Constructors
Constructor and Description

StompHeaders()
Create a new instance to be populated with new header values.

Constructors
Constructor and Description
`StompHeaders()` Create a new instance to be populated with new header values.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`add(String headerName, String headerValue)` Add the given, single header value under the given name.
`void`	`clear()`
`boolean`	`containsKey(Object key)`
`boolean`	`containsValue(Object value)`
`Set<Map.Entry<String,List<String>>>`	`entrySet()`
`boolean`	`equals(Object other)`
`List<String>`	`get(Object key)`
`String`	`getAck()` Get the ack header.
`long`	`getContentLength()` Return the content-length header or -1 if unknown.
`MimeType`	`getContentType()` Return the content-type header value.
`String`	`getDestination()` Get the destination header.
`String`	`getFirst(String headerName)` Return the first header value for the given header name, if any.
`long[]`	`getHeartbeat()` Get the heartbeat header.
`String`	`getHost()` Get the host header.
`String`	`getId()` Get the id header.
`String`	`getLogin()` Get the login header.
`String`	`getMessageId()` Get the message-id header.
`String`	`getPasscode()` Get the passcode header.
`String`	`getReceipt()` Get the receipt header.
`String`	`getReceiptId()` Get the receipt header.
`String`	`getServer()` Get the server header.
`String`	`getSession()` Get the session header.
`String`	`getSubscription()` Get the subscription header.
`int`	`hashCode()`
`boolean`	`isEmpty()`
`boolean`	`isHeartbeatEnabled()` Whether heartbeats are enabled.
`Set<String>`	`keySet()`
`List<String>`	`put(String key, List<String> value)`
`void`	`putAll(Map<? extends String,? extends List<String>> map)`
`static StompHeaders`	`readOnlyStompHeaders(Map<String,List<String>> headers)` Return a `StompHeaders` object that can only be read, not written to.
`List<String>`	`remove(Object key)`
`void`	`set(String headerName, String headerValue)` Set the given, single header value under the given name.
`void`	`setAck(String ack)` Set the ack header to one of "auto", "client", or "client-individual".
`void`	`setAll(Map<String,String> values)` Set the given values under.
`void`	`setContentLength(long contentLength)` Set the content-length header.
`void`	`setContentType(MimeType mimeType)` Set the content-type header.
`void`	`setDestination(String destination)` Set the destination header.
`void`	`setHeartbeat(long[] heartbeat)` Set the heartbeat header.
`void`	`setHost(String host)` Set the host header.
`void`	`setId(String id)` Set the id header.
`void`	`setLogin(String login)` Set the login header.
`void`	`setMessageId(String messageId)` Set the message-id header.
`void`	`setPasscode(String passcode)` Set the passcode header.
`void`	`setReceipt(String receipt)` Set the receipt header.
`void`	`setReceiptId(String receiptId)` Set the receipt-id header.
`void`	`setServer(String server)` Set the server header.
`void`	`setSession(String session)` Set the session header.
`void`	`setSubscription(String subscription)` Set the login header.
`int`	`size()`
`Map<String,String>`	`toSingleValueMap()` Return a `Map` with the first values contained in this `MultiValueMap`.
`String`	`toString()`
`Collection<List<String>>`	`values()`

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Map
compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll

- Field Detail
  - CONTENT_TYPE
```
public static final String CONTENT_TYPE
```
    See Also:
    
    Constant Field Values
  - CONTENT_LENGTH
```
public static final String CONTENT_LENGTH
```
    See Also:
    
    Constant Field Values
  - RECEIPT
```
public static final String RECEIPT
```
    See Also:
    
    Constant Field Values
  - HOST
```
public static final String HOST
```
    See Also:
    
    Constant Field Values
  - LOGIN
```
public static final String LOGIN
```
    See Also:
    
    Constant Field Values
  - PASSCODE
```
public static final String PASSCODE
```
    See Also:
    
    Constant Field Values
  - HEARTBEAT
```
public static final String HEARTBEAT
```
    See Also:
    
    Constant Field Values
  - SESSION
```
public static final String SESSION
```
    See Also:
    
    Constant Field Values
  - SERVER
```
public static final String SERVER
```
    See Also:
    
    Constant Field Values
  - DESTINATION
```
public static final String DESTINATION
```
    See Also:
    
    Constant Field Values
  - ID
```
public static final String ID
```
    See Also:
    
    Constant Field Values
  - ACK
```
public static final String ACK
```
    See Also:
    
    Constant Field Values
  - SUBSCRIPTION
```
public static final String SUBSCRIPTION
```
    See Also:
    
    Constant Field Values
  - MESSAGE_ID
```
public static final String MESSAGE_ID
```
    See Also:
    
    Constant Field Values
  - RECEIPT_ID
```
public static final String RECEIPT_ID
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - StompHeaders
```
public StompHeaders()
```
    Create a new instance to be populated with new header values.
- Method Detail
  - setContentType
```
public void setContentType(MimeType mimeType)
```
    Set the content-type header. Applies to the SEND, MESSAGE, and ERROR frames.
  - getContentType
```
public MimeType getContentType()
```
    Return the content-type header value.
  - setContentLength
```
public void setContentLength(long contentLength)
```
    Set the content-length header. Applies to the SEND, MESSAGE, and ERROR frames.
  - getContentLength
```
public long getContentLength()
```
    Return the content-length header or -1 if unknown.
  - setReceipt
```
public void setReceipt(String receipt)
```
    Set the receipt header. Applies to any client frame other than CONNECT.
  - getReceipt
```
public String getReceipt()
```
    Get the receipt header.
  - setHost
```
public void setHost(String host)
```
    Set the host header. Applies to the CONNECT frame.
  - getHost
```
public String getHost()
```
    Get the host header.
  - setLogin
```
public void setLogin(String login)
```
    Set the login header. Applies to the CONNECT frame.
  - getLogin
```
public String getLogin()
```
    Get the login header.
  - setPasscode
```
public void setPasscode(String passcode)
```
    Set the passcode header. Applies to the CONNECT frame.
  - getPasscode
```
public String getPasscode()
```
    Get the passcode header.
  - setHeartbeat
```
public void setHeartbeat(long[] heartbeat)
```
    Set the heartbeat header. Applies to the CONNECT and CONNECTED frames.
  - getHeartbeat
```
public long[] getHeartbeat()
```
    Get the heartbeat header.
  - isHeartbeatEnabled
```
public boolean isHeartbeatEnabled()
```
    Whether heartbeats are enabled. Returns false if setHeartbeat(long[]) is set to "0,0", and true otherwise.
  - setSession
```
public void setSession(String session)
```
    Set the session header. Applies to the CONNECTED frame.
  - getSession
```
public String getSession()
```
    Get the session header.
  - setServer
```
public void setServer(String server)
```
    Set the server header. Applies to the CONNECTED frame.
  - getServer
```
public String getServer()
```
    Get the server header. Applies to the CONNECTED frame.
  - setDestination
```
public void setDestination(String destination)
```
    Set the destination header.
  - getDestination
```
public String getDestination()
```
    Get the destination header. Applies to the SEND, SUBSCRIBE, and MESSAGE frames.
  - setId
```
public void setId(String id)
```
    Set the id header. Applies to the SUBSCR0BE, UNSUBSCRIBE, and ACK or NACK frames.
  - getId
```
public String getId()
```
    Get the id header.
  - setAck
```
public void setAck(String ack)
```
    Set the ack header to one of "auto", "client", or "client-individual". Applies to the SUBSCRIBE and MESSAGE frames.
  - getAck
```
public String getAck()
```
    Get the ack header.
  - setSubscription
```
public void setSubscription(String subscription)
```
    Set the login header. Applies to the MESSAGE frame.
  - getSubscription
```
public String getSubscription()
```
    Get the subscription header.
  - setMessageId
```
public void setMessageId(String messageId)
```
    Set the message-id header. Applies to the MESSAGE frame.
  - getMessageId
```
public String getMessageId()
```
    Get the message-id header.
  - setReceiptId
```
public void setReceiptId(String receiptId)
```
    Set the receipt-id header. Applies to the RECEIPT frame.
  - getReceiptId
```
public String getReceiptId()
```
    Get the receipt header.
  - getFirst
```
public String getFirst(String headerName)
```
    Return the first header value for the given header name, if any.
    
    Specified by:
    
    getFirst in interface MultiValueMap<String,String>
    
    Parameters:
    
    headerName - the header name
    
    Returns:
    
    the first header value, or null if none
  - add
```
public void add(String headerName,
                String headerValue)
```
    Add the given, single header value under the given name.
    
    Specified by:
    
    add in interface MultiValueMap<String,String>
    
    Parameters:
    
    headerName - the header name
    
    headerValue - the header value
    
    Throws:
    
    UnsupportedOperationException - if adding headers is not supported
    
    See Also:
    
    put(String, List), set(String, String)
  - set
```
public void set(String headerName,
                String headerValue)
```
    Set the given, single header value under the given name.
    
    Specified by:
    
    set in interface MultiValueMap<String,String>
    
    Parameters:
    
    headerName - the header name
    
    headerValue - the header value
    
    Throws:
    
    UnsupportedOperationException - if adding headers is not supported
    
    See Also:
    
    put(String, List), add(String, String)
  - setAll
```
public void setAll(Map<String,String> values)
```
    Description copied from interface: MultiValueMap
    
    Set the given values under.
    
    Specified by:
    
    setAll in interface MultiValueMap<String,String>
    
    Parameters:
    
    values - the values.
  - toSingleValueMap
```
public Map<String,String> toSingleValueMap()
```
    Description copied from interface: MultiValueMap
    
    Return a Map with the first values contained in this MultiValueMap.
    
    Specified by:
    
    toSingleValueMap in interface MultiValueMap<String,String>
    
    Returns:
    
    a single value representation of this map
  - size
```
public int size()
```
    Specified by:
    
    size in interface Map<String,List<String>>
  - isEmpty
```
public boolean isEmpty()
```
    Specified by:
    
    isEmpty in interface Map<String,List<String>>
  - containsKey
```
public boolean containsKey(Object key)
```
    Specified by:
    
    containsKey in interface Map<String,List<String>>
  - containsValue
```
public boolean containsValue(Object value)
```
    Specified by:
    
    containsValue in interface Map<String,List<String>>
  - get
```
public List<String> get(Object key)
```
    Specified by:
    
    get in interface Map<String,List<String>>
  - put
```
public List<String> put(String key,
                        List<String> value)
```
    Specified by:
    
    put in interface Map<String,List<String>>
  - remove
```
public List<String> remove(Object key)
```
    Specified by:
    
    remove in interface Map<String,List<String>>
  - putAll
```
public void putAll(Map<? extends String,? extends List<String>> map)
```
    Specified by:
    
    putAll in interface Map<String,List<String>>
  - clear
```
public void clear()
```
    Specified by:
    
    clear in interface Map<String,List<String>>
  - keySet
```
public Set<String> keySet()
```
    Specified by:
    
    keySet in interface Map<String,List<String>>
  - values
```
public Collection<List<String>> values()
```
    Specified by:
    
    values in interface Map<String,List<String>>
  - entrySet
```
public Set<Map.Entry<String,List<String>>> entrySet()
```
    Specified by:
    
    entrySet in interface Map<String,List<String>>
  - equals
```
public boolean equals(Object other)
```
    Specified by:
    
    equals in interface Map<String,List<String>>
    
    Overrides:
    
    equals in class Object
  - hashCode
```
public int hashCode()
```
    Specified by:
    
    hashCode in interface Map<String,List<String>>
    
    Overrides:
    
    hashCode in class Object
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object
  - readOnlyStompHeaders
```
public static StompHeaders readOnlyStompHeaders(Map<String,List<String>> headers)
```
    Return a StompHeaders object that can only be read, not written to.

Class StompHeaders

Nested Class Summary

Nested classes/interfaces inherited from interface java.util.Map

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface java.util.Map

Field Detail

CONTENT_TYPE

CONTENT_LENGTH

RECEIPT

HOST

LOGIN

PASSCODE

HEARTBEAT

SESSION

SERVER

DESTINATION

ID

ACK

SUBSCRIPTION

MESSAGE_ID

RECEIPT_ID

Constructor Detail

StompHeaders

Method Detail

setContentType

getContentType

setContentLength

getContentLength

setReceipt

getReceipt

setHost

getHost

setLogin

getLogin

setPasscode

getPasscode

setHeartbeat

getHeartbeat

isHeartbeatEnabled

setSession

getSession

setServer

getServer

setDestination

getDestination

setId

getId

setAck

getAck

setSubscription

getSubscription

setMessageId

getMessageId

setReceiptId

getReceiptId

getFirst

add

set

setAll

toSingleValueMap

size

isEmpty

containsKey

containsValue

get

put

remove

putAll

clear

keySet

values

entrySet

equals

hashCode

toString

readOnlyStompHeaders