From c5dba36865f10acbe8bcf009d63762589cb5a7ff Mon Sep 17 00:00:00 2001 From: Gary Russell Date: Thu, 18 Nov 2010 18:21:14 -0500 Subject: [PATCH] INT-1552 Add error-channel to other endpoint docs; schema doc polishing --- docs/src/reference/docbook/event.xml | 8 ++++++-- docs/src/reference/docbook/mail.xml | 6 ++++++ .../event/config/spring-integration-event-2.0.xsd | 4 ++-- .../integration/ip/config/spring-integration-ip-2.0.xsd | 6 +++--- .../integration/jms/config/spring-integration-jms-2.0.xsd | 4 ++-- .../mail/config/spring-integration-mail-2.0.xsd | 2 +- 6 files changed, 20 insertions(+), 10 deletions(-) diff --git a/docs/src/reference/docbook/event.xml b/docs/src/reference/docbook/event.xml index 9f759ef787..29aa0217fc 100644 --- a/docs/src/reference/docbook/event.xml +++ b/docs/src/reference/docbook/event.xml @@ -26,11 +26,15 @@ For convenience namespace support is provided to configure an ApplicationEventListeningMessageProducer via the inbound-channel-adapter element. - + ]]> In the above example, all Application Context events that match one of the types specified by the 'event-types' (optional) attribute will be -delivered as Spring Integration Messages to the Message Channel named 'eventChannel'. +delivered as Spring Integration Messages to the Message Channel named 'eventChannel'. If a downstream component throws +an exception, a MessagingException containing the failed message and exception will be sent to the channel named +'eventErrorChannel'. If no "error-channel" is specified, the exception will be propagated to the caller. diff --git a/docs/src/reference/docbook/mail.xml b/docs/src/reference/docbook/mail.xml index 7f501d369b..b4a5585574 100644 --- a/docs/src/reference/docbook/mail.xml +++ b/docs/src/reference/docbook/mail.xml @@ -156,6 +156,12 @@ reply-to="replyTo@example.org" overwrite="false"/>]]> + + Finally, the <imap-idle-channel-adapter/> also accepts the 'error-channel' attribute. + If a synchronous downstream exception is thrown and an 'error-channel' is specified, + the MessagingException containing the failed message and exception, will be sent to this channel. + Otherwise, any such exception will simply be logged as a warning by the channel adapter. + diff --git a/spring-integration-event/src/main/resources/org/springframework/integration/event/config/spring-integration-event-2.0.xsd b/spring-integration-event/src/main/resources/org/springframework/integration/event/config/spring-integration-event-2.0.xsd index 078d5011cc..29748ed275 100644 --- a/spring-integration-event/src/main/resources/org/springframework/integration/event/config/spring-integration-event-2.0.xsd +++ b/spring-integration-event/src/main/resources/org/springframework/integration/event/config/spring-integration-event-2.0.xsd @@ -48,8 +48,8 @@ If a (synchronous) downstream exception is thrown and an error-channel is specified, - the MessageHandlingException will be sent to this channel. Otherwise, any such exception - will be propagated to the calling thread. + the MessagingException will be sent to this channel. Otherwise, any such exception + will be propagated to the caller. diff --git a/spring-integration-ip/src/main/resources/org/springframework/integration/ip/config/spring-integration-ip-2.0.xsd b/spring-integration-ip/src/main/resources/org/springframework/integration/ip/config/spring-integration-ip-2.0.xsd index fa51d36b92..c6de636097 100644 --- a/spring-integration-ip/src/main/resources/org/springframework/integration/ip/config/spring-integration-ip-2.0.xsd +++ b/spring-integration-ip/src/main/resources/org/springframework/integration/ip/config/spring-integration-ip-2.0.xsd @@ -57,7 +57,7 @@ its configuration specifies the number of threads. If a (synchronous) downstream exception is thrown and an "error-channel" is specified, - the MessageHandlingException will be sent to this channel. Otherwise, any such exception + the MessagingException will be sent to this channel. Otherwise, any such exception will simply be logged by the channel adapter. @@ -133,7 +133,7 @@ adapter. If a (synchronous) downstream exception is thrown and an "error-channel" is specified, - the MessageHandlingException will be sent to this channel. Otherwise, any such exception + the MessagingException will be sent to this channel. Otherwise, any such exception will simply be logged by the channel adapter. @@ -214,7 +214,7 @@ A connection factory is needed by an inbound adapter. The connection factory mus If a (synchronous) downstream exception is thrown and an "error-channel" is specified, - the MessageHandlingException will be sent to this channel and the ultimate response + the MessagingException will be sent to this channel and the ultimate response of the error flow will be returned as a response by the gateway. If no "error-channel" is specified, any such exception will simply be logged by the gateway. In such a situation, no response is sent diff --git a/spring-integration-jms/src/main/resources/org/springframework/integration/jms/config/spring-integration-jms-2.0.xsd b/spring-integration-jms/src/main/resources/org/springframework/integration/jms/config/spring-integration-jms-2.0.xsd index 2c55e6687c..5c21dfeb1f 100644 --- a/spring-integration-jms/src/main/resources/org/springframework/integration/jms/config/spring-integration-jms-2.0.xsd +++ b/spring-integration-jms/src/main/resources/org/springframework/integration/jms/config/spring-integration-jms-2.0.xsd @@ -398,7 +398,7 @@ If a (synchronous) downstream exception is thrown and an error-channel is specified, - the MessageHandlingException will be sent to this channel. Otherwise, any such exception + the MessagingException will be sent to this channel. Otherwise, any such exception will be propagated to the listener container and any JMS transaction will be rolled back. Any synchronous downstream exceptions in the error flow will also cause any JMS transaction to be rolled back. @@ -559,7 +559,7 @@ If a (synchronous) downstream exception is thrown and an "error-channel" is specified, - the MessageHandlingException will be sent to this channel; any response from + the MessagingException will be sent to this channel; any response from which will be returned as a reply by the gateway. If an "error-channel" is not supplied, any such exception will be propagated to the listener container and any JMS transaction will be diff --git a/spring-integration-mail/src/main/resources/org/springframework/integration/mail/config/spring-integration-mail-2.0.xsd b/spring-integration-mail/src/main/resources/org/springframework/integration/mail/config/spring-integration-mail-2.0.xsd index 6f7629ec20..f773ba8316 100644 --- a/spring-integration-mail/src/main/resources/org/springframework/integration/mail/config/spring-integration-mail-2.0.xsd +++ b/spring-integration-mail/src/main/resources/org/springframework/integration/mail/config/spring-integration-mail-2.0.xsd @@ -118,7 +118,7 @@ If a (synchronous) downstream exception is thrown and an error-channel is specified, - the MessageHandlingException will be sent to this channel. Otherwise, any such exception + the MessagingException will be sent to this channel. Otherwise, any such exception will simply be logged as a warning by the channel adapter.