Spring/spring-integration
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

INT-3519 Add Poll Skip Advice

Browse Source 
JIRA: https://jira.spring.io/browse/INT-3519

Add a mechanism to allow skipping polls, perhaps
because of some downstream condition.

INT-3519: Polishing
This commit is contained in:
Gary Russell
2014-10-21 16:30:08 +03:00
committed by Artem Bilan
parent 328bd68702
commit 176afcf807
5 changed files with 251 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
src/reference/docbook/polling-consumer.xml
View File

@@ -59,6 +59,15 @@
<listitem>Polling internal (pollable) Message Channels</listitem>
<listitem>Polling internal services (E.g. repeatedly execute methods on a Java class)</listitem>
</itemizedlist>
<note>
AOP Advice classes can be applied to pollers, in an <code>advice-chain</code>. An example being a
transaction advice to start a transaction. Starting with <emphasis>version 4.1</emphasis> a
<classname>PollSkipAdvice</classname> is provided. Pollers use triggers to determine the time
of the next poll. The <classname>PollSkipAdvice</classname> can be used to suppress (skip) a
poll, perhaps because there is some downstream condition that would prevent the message to
be processed properly. To use this advice, you have to provide it with an implementation
of a <interfacename>PollSkipStrategy</interfacename>.
</note>
<para>
This chapter is meant to only give a high-level overview regarding Polling Consumers
and how they fit into the concept of message channels - <xref linkend="channel"/> and

10
src/reference/docbook/whats-new.xml
View File

@@ -34,6 +34,16 @@
for the JSON transformers. See <xref linkend="transformer"/> for more information.
</para>
</section>
<section id="4.1-PollSkipAdvice">
<title>PollSkipAdvice</title>
<para>
The <classname>PollSkipAdvice</classname> is now provided to be used within
<code>&lt;advice-chain&gt;</code> of the <code>&lt;poller&gt;</code> to determine if the current
<emphasis>poll</emphasis> should be suppressed (skipped) by some condition implemented with
<interfacename>PollSkipStrategy</interfacename>.
See <xref linkend="polling-consumer"/> for more information.
</para>
</section>
</section>
<section id="4.1-general">
<title>General Changes</title>