public class StompDecoder extends Object
ByteBuffer
.
An attempt is made to read all complete STOMP frames from the buffer, which could be zero, one, or more. If there is any left-over content, i.e. an incomplete STOMP frame, at the end the buffer is reset to point to the beginning of the partial content. The caller is then responsible for dealing with that incomplete content by buffering until there is more input available.
Constructor and Description |
---|
StompDecoder() |
Modifier and Type | Method and Description |
---|---|
List<Message<byte[]>> |
decode(ByteBuffer buffer)
Decodes one or more STOMP frames from the given
ByteBuffer into a
list of Message s. |
List<Message<byte[]>> |
decode(ByteBuffer buffer,
MultiValueMap<String,String> partialMessageHeaders)
Decodes one or more STOMP frames from the given
buffer and returns
a list of Message s. |
MessageHeaderInitializer |
getHeaderInitializer()
Return the configured
MessageHeaderInitializer , if any. |
void |
setHeaderInitializer(MessageHeaderInitializer headerInitializer)
Configure a
MessageHeaderInitializer to apply to the headers of
Message s from decoded STOMP frames. |
protected void |
skipLeadingEol(ByteBuffer buffer)
Skip one ore more EOL characters at the start of the given ByteBuffer.
|
public void setHeaderInitializer(MessageHeaderInitializer headerInitializer)
MessageHeaderInitializer
to apply to the headers of
Message
s from decoded STOMP frames.public MessageHeaderInitializer getHeaderInitializer()
MessageHeaderInitializer
, if any.public List<Message<byte[]>> decode(ByteBuffer buffer)
ByteBuffer
into a
list of Message
s. If the input buffer contains partial STOMP frame
content, or additional content with a partial STOMP frame, the buffer is
reset and null
is returned.buffer
- the buffer to decode the STOMP frame fromStompConversionException
- raised in case of decoding issuespublic List<Message<byte[]>> decode(ByteBuffer buffer, MultiValueMap<String,String> partialMessageHeaders)
buffer
and returns
a list of Message
s.
If the given ByteBuffer contains only partial STOMP frame content and no complete STOMP frames, an empty list is returned, and the buffer is reset to to where it was.
If the buffer contains one ore more STOMP frames, those are returned and the buffer reset to point to the beginning of the unused partial content.
The output partialMessageHeaders map is used to store successfully parsed headers in case of partial content. The caller can then check if a "content-length" header was read, which helps to determine how much more content is needed before the next attempt to decode.
buffer
- the buffer to decode the STOMP frame frompartialMessageHeaders
- an empty output map that will store the last
successfully parsed partialMessageHeaders in case of partial message content
in cases where the partial buffer ended with a partial STOMP frameStompConversionException
- raised in case of decoding issuesprotected void skipLeadingEol(ByteBuffer buffer)