diff --git a/spring-integration-reference/src/channel.xml b/spring-integration-reference/src/channel.xml index bc2e24928d..16f7f6ed6a 100644 --- a/spring-integration-reference/src/channel.xml +++ b/spring-integration-reference/src/channel.xml @@ -299,10 +299,15 @@ public Message receive(final PollableChannel channel) { ... }]]>QueueChannel Configuration To create a QueueChannel, use the "queue" sub-element. - You must specify the channel's capacity: + You may specify the channel's capacity: <channel id="exampleChannel"> <queue capacity="25"/> </channel> + + If you do not provide a value for the 'capacity' attribute on this <queue/> sub-element, + the resulting queue will be unbounded. To avoid issues such as OutOfMemoryErrors, it's highly + recommended to set an explicit value for a bounded queue. +
@@ -312,6 +317,13 @@ public Message receive(final PollableChannel channel) { ... }]]><publish-subscribe-channel id="exampleChannel" task-executor="someTaskExecutor"/> + If you are providing a Resequencer or Aggregator downstream + from a PublishSubscribeChannel, then you can set the 'apply-sequence' property + for the channel. That will indicate that the channel should set the sequence-size and sequence-number + Message headers prior to passing the Messages along. For example, if there are 5 subscribers, the + sequence-size would be set to 5, and the Messages would have sequence-number header values ranging + from 1 to 5. This value is 'false' by default. + <publish-subscribe-channel id="exampleChannel" apply-sequence="true"/>
@@ -336,7 +348,8 @@ public Message receive(final PollableChannel channel) { ... }]]> RendezvousChannel Configuration - The RendezvousChannel does not provide any additional configuration options. + A RendezvousChannel is created when the queue sub-element is + a <rendezvous-queue>. It does not provide any additional configuration options.