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

INT-3670: JMS Conversion Error Handling

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

Exceptions during inbound message conversion are now routed to the error-channel (if present).

When there is no error-channel, the exception is thrown back to the container as before.

Add a note to the `jms.xml` about the `error-channel` usage changes
This commit is contained in:
Gary Russell
2015-03-03 17:34:04 -05:00
committed by Artem Bilan
parent 75ff56962a
commit e7534aa4b8
4 changed files with 125 additions and 42 deletions
Download Patch File Download Diff File Expand all files Collapse all files

13
src/reference/docbook/jms.xml
View File

@@ -144,6 +144,19 @@
'error-channel' should also be one-way. For example, it could simply send to a logging handler,
or it could be connected to a different JMS <outbound-channel-adapter> element.
</para>
<para>
Starting with <emphasis>version 4.2</emphasis> the 'error-channel' is used for the conversion errors, too.
Previously, if a JMS &lt;message-driven-channel-adapter&gt; or &lt;inbound gateway&gt; could
not deliver a message due to a conversion error, an exception would be thrown back to the
container. If the container was configured to use transactions, the message would be
rolled back and redelivered repeatedly. The conversion process occurs before and during
message construction so such errors were not sent to the 'error-channel'. Now such conversion exceptions
result in an <classname>ErrorMessage</classname> being sent to the 'error-channel', with the exception as
the <code>payload</code>. If you wish the transaction to be rolled back, and you have an 'error-channel'
defined, the integration flow on the 'error-channel' must re-throw the exception (or another). If the error
flow does not throw an exception, the transaction will be committed and the message removed.
If no 'error-channel' is defined, the exception is thrown back to the container, as before.
</para>
</section>
<section id="jms-outbound-channel-adapter">

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

@@ -108,5 +108,15 @@
gateway; the dependency was removed for those users who don't need it.
</para>
</section>
<section id="4.2-jms-changes">
<title>JMS Changes</title>
<para>
The <code>error-channel</code> now is used for the conversion errors, which have caused a transaction
rollback and message redelivery previously.
</para>
<para>
See <xref linkend="jms-message-driven-channel-adapter"/> for more information.
</para>
</section>
</section>
</chapter>