Add BufferingStompDecoder

Before this change the StompDecoder decoded and returned only the first
Message in the ByteBuffer passed to it. So to obtain all messages from
the buffer, one had to loop passing the same buffer in until no more
complete STOMP frames could be decoded.

This chage modifies StompDecoder to return List<Message> after
exhaustively decoding all available STOMP frames from the input buffer.
Also an overloaded decode method allows passing in Map that will be
populated with any headers successfully parsed, which is useful for
"peeking" at the "content-length" header.

This change also adds a BufferingStompDecoder sub-class which buffers
any content left in the input buffer after parsing one or more STOMP
frames. This sub-class can also deal with fragmented messages,
re-assembling them and parsing as a whole message.

Issue: SPR-11527
This commit is contained in:
Rossen Stoyanchev
2014-03-21 11:32:39 -04:00
parent 465ca24ab2
commit ebffd67b5e
7 changed files with 482 additions and 74 deletions

View File

@@ -0,0 +1,183 @@
/*
* Copyright 2002-2014 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.springframework.messaging.simp.stomp;
import org.junit.Test;
import org.springframework.messaging.Message;
import org.springframework.messaging.converter.MessageConversionException;
import java.nio.ByteBuffer;
import java.nio.charset.Charset;
import java.util.Arrays;
import java.util.List;
import static org.junit.Assert.assertEquals;
import static org.junit.Assert.assertNull;
import static org.junit.Assert.fail;
/**
* Unit tests for {@link BufferingStompDecoder}..
*
* @author Rossen Stoyanchev
* @since 4.0.3
*/
public class BufferingStompDecoderTests {
@Test
public void basic() throws InterruptedException {
BufferingStompDecoder stompDecoder = new BufferingStompDecoder(128);
String chunk = "SEND\na:alpha\n\nMessage body\0";
List<Message<byte[]>> messages = stompDecoder.decode(toByteBuffer(chunk));
assertEquals(1, messages.size());
assertEquals("Message body", new String(messages.get(0).getPayload()));
assertEquals(0, stompDecoder.getBufferSize());
assertNull(stompDecoder.getExpectedContentLength());
}
@Test
public void oneMessageInTwoChunks() throws InterruptedException {
BufferingStompDecoder stompDecoder = new BufferingStompDecoder(128);
String chunk1 = "SEND\na:alpha\n\nMessage";
String chunk2 = " body\0";
List<Message<byte[]>> messages = stompDecoder.decode(toByteBuffer(chunk1));
assertEquals(Arrays.asList(), messages);
messages = stompDecoder.decode(toByteBuffer(chunk2));
assertEquals(1, messages.size());
assertEquals("Message body", new String(messages.get(0).getPayload()));
assertEquals(0, stompDecoder.getBufferSize());
assertNull(stompDecoder.getExpectedContentLength());
}
@Test
public void twoMessagesInOneChunk() throws InterruptedException {
BufferingStompDecoder stompDecoder = new BufferingStompDecoder(128);
String chunk = "SEND\na:alpha\n\nPayload1\0" + "SEND\na:alpha\n\nPayload2\0";
List<Message<byte[]>> messages = stompDecoder.decode(toByteBuffer(chunk));
assertEquals(2, messages.size());
assertEquals("Payload1", new String(messages.get(0).getPayload()));
assertEquals("Payload2", new String(messages.get(1).getPayload()));
assertEquals(0, stompDecoder.getBufferSize());
assertNull(stompDecoder.getExpectedContentLength());
}
@Test
public void oneFullAndOneSplitMessageContentLength() throws InterruptedException {
int contentLength = "Payload2a-Payload2b".getBytes().length;
BufferingStompDecoder stompDecoder = new BufferingStompDecoder(128);
String chunk1 = "SEND\na:alpha\n\nPayload1\0SEND\ncontent-length:" + contentLength + "\n";
List<Message<byte[]>> messages = stompDecoder.decode(toByteBuffer(chunk1));
assertEquals(1, messages.size());
assertEquals("Payload1", new String(messages.get(0).getPayload()));
assertEquals(23, stompDecoder.getBufferSize());
assertEquals(contentLength, (int) stompDecoder.getExpectedContentLength());
String chunk2 = "\nPayload2a";
messages = stompDecoder.decode(toByteBuffer(chunk2));
assertEquals(0, messages.size());
assertEquals(33, stompDecoder.getBufferSize());
assertEquals(contentLength, (int) stompDecoder.getExpectedContentLength());
String chunk3 = "-Payload2b\0";
messages = stompDecoder.decode(toByteBuffer(chunk3));
assertEquals(1, messages.size());
assertEquals("Payload2a-Payload2b", new String(messages.get(0).getPayload()));
assertEquals(0, stompDecoder.getBufferSize());
assertNull(stompDecoder.getExpectedContentLength());
}
@Test
public void oneFullAndOneSplitMessageNoContentLength() throws InterruptedException {
BufferingStompDecoder stompDecoder = new BufferingStompDecoder(128);
String chunk1 = "SEND\na:alpha\n\nPayload1\0SEND\na:alpha\n";
List<Message<byte[]>> messages = stompDecoder.decode(toByteBuffer(chunk1));
assertEquals(1, messages.size());
assertEquals("Payload1", new String(messages.get(0).getPayload()));
assertEquals(13, stompDecoder.getBufferSize());
assertNull(stompDecoder.getExpectedContentLength());
String chunk2 = "\nPayload2a";
messages = stompDecoder.decode(toByteBuffer(chunk2));
assertEquals(0, messages.size());
assertEquals(23, stompDecoder.getBufferSize());
assertNull(stompDecoder.getExpectedContentLength());
String chunk3 = "-Payload2b\0";
messages = stompDecoder.decode(toByteBuffer(chunk3));
assertEquals(1, messages.size());
assertEquals("Payload2a-Payload2b", new String(messages.get(0).getPayload()));
assertEquals(0, stompDecoder.getBufferSize());
assertNull(stompDecoder.getExpectedContentLength());
}
@Test
public void oneFullAndOneSplitWithContentLengthExceedingBufferSize() throws InterruptedException {
BufferingStompDecoder stompDecoder = new BufferingStompDecoder(128);
String chunk1 = "SEND\na:alpha\n\nPayload1\0SEND\ncontent-length:129\n";
List<Message<byte[]>> messages = stompDecoder.decode(toByteBuffer(chunk1));
assertEquals("We should have gotten the 1st message", 1, messages.size());
assertEquals("Payload1", new String(messages.get(0).getPayload()));
assertEquals(24, stompDecoder.getBufferSize());
assertEquals(129, (int) stompDecoder.getExpectedContentLength());
try {
String chunk2 = "\nPayload2a";
stompDecoder.decode(toByteBuffer(chunk2));
fail("Expected exception");
}
catch (StompConversionException ex) {
}
}
@Test(expected = StompConversionException.class)
public void bufferSizeLimit() throws InterruptedException {
BufferingStompDecoder stompDecoder = new BufferingStompDecoder(10);
String payload = "SEND\na:alpha\n\nMessage body";
stompDecoder.decode(toByteBuffer(payload));
}
private ByteBuffer toByteBuffer(String chunk) {
return ByteBuffer.wrap(chunk.getBytes(Charset.forName("UTF-8")));
}
}