org.springframework.cloud.stream.binder

Class AbstractBinderTests<B extends AbstractTestBinder<? extends org.springframework.cloud.stream.binder.AbstractBinder<org.springframework.messaging.MessageChannel,CP,PP>,CP,PP>,CP extends org.springframework.cloud.stream.binder.ConsumerProperties,PP extends org.springframework.cloud.stream.binder.ProducerProperties>

java.lang.Object

org.springframework.cloud.stream.binder.AbstractBinderTests<B,CP,PP>

Direct Known Subclasses:

PartitionCapableBinderTests

public abstract class AbstractBinderTests<B extends AbstractTestBinder<? extends org.springframework.cloud.stream.binder.AbstractBinder<org.springframework.messaging.MessageChannel,CP,PP>,CP,PP>,CP extends org.springframework.cloud.stream.binder.ConsumerProperties,PP extends org.springframework.cloud.stream.binder.ProducerProperties>
extends Object

Author:

Gary Russell, Ilayaperumal Gopinathan, David Turanski, Mark Fisher, Marius Bogoevici, Oleg Zhurakousky, Jacob Severson, Artem Bilan

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AbstractBinderTests.Station

Field Summary

Fields

Modifier and Type	Field and Description
protected org.apache.commons.logging.Log	logger
protected org.springframework.messaging.converter.SmartMessageConverter	messageConverter
protected B	testBinder
protected double	timeoutMultiplier Subclasses may override this default value to have tests wait longer for a message receive, for example if running in an environment that is known to be slow (e.g.

Constructor Summary

Constructors

Constructor and Description
AbstractBinderTests()

Method Summary

Modifier and Type	Method and Description
void	before()
protected void	binderBindUnbindLatency() If appropriate, let the binder middleware settle down a bit while binding/unbinding actually happens.
void	cleanup()
protected org.springframework.integration.channel.DirectChannel	createBindableChannel(String channelName, org.springframework.cloud.stream.config.BindingProperties bindingProperties)
protected org.springframework.integration.channel.DirectChannel	createBindableChannel(String channelName, org.springframework.cloud.stream.config.BindingProperties bindingProperties, boolean inputChannel)
protected org.springframework.cloud.stream.binder.DefaultPollableMessageSource	createBindableMessageSource(String bindingName, org.springframework.cloud.stream.config.BindingProperties bindingProperties)
protected org.springframework.cloud.stream.config.BindingProperties	createConsumerBindingProperties(CP consumerProperties)
protected abstract CP	createConsumerProperties()
protected org.springframework.cloud.stream.config.BindingProperties	createProducerBindingProperties(PP producerProperties)
protected abstract PP	createProducerProperties()
protected abstract B	getBinder()
protected String	getDestinationNameDelimiter() Set the delimiter that will be used in the message source/target name.
protected org.springframework.messaging.Message<?>	receive(org.springframework.messaging.PollableChannel channel) Attempt to receive a message on the given channel, waiting up to 1s (times the timeoutMultiplier).
protected org.springframework.messaging.Message<?>	receive(org.springframework.messaging.PollableChannel channel, int additionalMultiplier) Attempt to receive a message on the given channel, waiting up to 1s * additionalMultiplier * timeoutMultiplier).
abstract Spy	spyOn(String name) Create a new spy on the given 'queue'.
void	testClean()
void	testSendAndReceive()
void	testSendAndReceiveJavaSerialization()
void	testSendAndReceiveKryo()
void	testSendAndReceiveMultipleTopics()
void	testSendAndReceiveNoOriginalContentType()
void	testSendJsonReceiveJsonWithStreamListener()
void	testSendJsonReceivePojoWithStreamListener()
void	testSendPojoReceivePojoKryoWithStreamListener()
void	testSendPojoReceivePojoWithStreamListener()
void	testSendPojoReceivePojoWithStreamListenerDefaultContentType()
void	testStreamListenerJavaSerializationNonSerializable()

Methods inherited from class java.lang.Object

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

Field Detail

logger

protected final org.apache.commons.logging.Log logger

testBinder

protected B extends AbstractTestBinder<? extends org.springframework.cloud.stream.binder.AbstractBinder<org.springframework.messaging.MessageChannel,CP,PP>,CP,PP> testBinder

messageConverter

protected org.springframework.messaging.converter.SmartMessageConverter messageConverter

timeoutMultiplier

protected double timeoutMultiplier

Subclasses may override this default value to have tests wait longer for a message receive, for example if running in an environment that is known to be slow (e.g. travis).

Constructor Detail

AbstractBinderTests

public AbstractBinderTests()

Method Detail

before

public void before()

receive

protected org.springframework.messaging.Message<?> receive(org.springframework.messaging.PollableChannel channel)

Attempt to receive a message on the given channel, waiting up to 1s (times the timeoutMultiplier).

receive

protected org.springframework.messaging.Message<?> receive(org.springframework.messaging.PollableChannel channel,
                                                           int additionalMultiplier)

Attempt to receive a message on the given channel, waiting up to 1s * additionalMultiplier * timeoutMultiplier). Allows accomodating tests which are slower than normal (e.g. retry).

testClean

public void testClean()
               throws Exception

Throws:

Exception

testSendAndReceive

public void testSendAndReceive()
                        throws Exception

Throws:

Exception

testSendAndReceiveKryo

public void testSendAndReceiveKryo()
                            throws Exception

Throws:

Exception

testSendAndReceiveJavaSerialization

public void testSendAndReceiveJavaSerialization()
                                         throws Exception

Throws:

Exception

testSendAndReceiveMultipleTopics

public void testSendAndReceiveMultipleTopics()
                                      throws Exception

Throws:

Exception

testSendAndReceiveNoOriginalContentType

public void testSendAndReceiveNoOriginalContentType()
                                             throws Exception

Throws:

Exception

getBinder

protected abstract B getBinder()
                        throws Exception

Throws:

Exception

createConsumerProperties

protected abstract CP createConsumerProperties()

createProducerProperties

protected abstract PP createProducerProperties()

createConsumerBindingProperties

protected final org.springframework.cloud.stream.config.BindingProperties createConsumerBindingProperties(CP consumerProperties)

createProducerBindingProperties

protected org.springframework.cloud.stream.config.BindingProperties createProducerBindingProperties(PP producerProperties)

createBindableChannel

protected org.springframework.integration.channel.DirectChannel createBindableChannel(String channelName,
                                                                                      org.springframework.cloud.stream.config.BindingProperties bindingProperties)
                                                                               throws Exception

Throws:

Exception

createBindableChannel

protected org.springframework.integration.channel.DirectChannel createBindableChannel(String channelName,
                                                                                      org.springframework.cloud.stream.config.BindingProperties bindingProperties,
                                                                                      boolean inputChannel)
                                                                               throws Exception

Throws:

Exception

createBindableMessageSource

protected org.springframework.cloud.stream.binder.DefaultPollableMessageSource createBindableMessageSource(String bindingName,
                                                                                                           org.springframework.cloud.stream.config.BindingProperties bindingProperties)
                                                                                                    throws Exception

Throws:

Exception

cleanup

public void cleanup()

binderBindUnbindLatency

protected void binderBindUnbindLatency()
                                throws InterruptedException

If appropriate, let the binder middleware settle down a bit while binding/unbinding actually happens.

Throws:

InterruptedException

spyOn

public abstract Spy spyOn(String name)

Create a new spy on the given 'queue'. This allows de-correlating the creation of the 'connection' from its actual usage, which may be needed by some implementations to see messages sent after connection creation.

getDestinationNameDelimiter

protected String getDestinationNameDelimiter()

Set the delimiter that will be used in the message source/target name. Some brokers may have naming constraints (such as SQS), so this provides a way to override the character being used as a delimiter. The default is a period.

testSendPojoReceivePojoWithStreamListenerDefaultContentType

public void testSendPojoReceivePojoWithStreamListenerDefaultContentType()
                                                                 throws Exception

Throws:

Exception

testSendPojoReceivePojoKryoWithStreamListener

public void testSendPojoReceivePojoKryoWithStreamListener()
                                                   throws Exception

Throws:

Exception

testStreamListenerJavaSerializationNonSerializable

public void testStreamListenerJavaSerializationNonSerializable()
                                                        throws Exception

Throws:

Exception

testSendJsonReceivePojoWithStreamListener

public void testSendJsonReceivePojoWithStreamListener()
                                               throws Exception

Throws:

Exception

testSendJsonReceiveJsonWithStreamListener

public void testSendJsonReceiveJsonWithStreamListener()
                                               throws Exception

Throws:

Exception

testSendPojoReceivePojoWithStreamListener

public void testSendPojoReceivePojoWithStreamListener()
                                               throws Exception

Throws:

Exception