Reference Manual feedback please!

[aheusingfeld]

IMHO the section "B.4 Error Handling" has to be much more detailed.

There are so many requests in the forum asking for a best practice on error handling or exception handling and it is still not clear to me whether I can redirect the result of "MessagingException.getFailedMessage()" to a different channel just by configuration.

I think this rather complex topic should get a separate chapter in the reference manual not only a spot in the appendix.

Thanks guys.

Cheers
Alex

[exe]

I'am trying to create a prototype with pollable consumers and channels.
The informations about concurreny is very scattered. I don't know exactly what happend when the channel is full, and i need more deatiled information about auto generated gateway.

[rahulagrawal]

IMHO the section "B.4 Error Handling" has to be much more detailed.

There are so many requests in the forum asking for a best practice on error handling or exception handling and it is still not clear to me whether I can redirect the result of "MessagingException.getFailedMessage()" to a different channel just by configuration.

I think this rather complex topic should get a separate chapter in the reference manual not only a spot in the appendix.

Thanks guys.

Cheers
Alex

I too feel that exception handling is a topic that deserves attention. For new users this would not be easy to come up with the right approaches.

[whyBish]

Section 4.3
consumer.setTrigger(new IntervalTrigger(30, TimeUnit.SECONDS));

I can't find IntervalTrigger. I assume this should be PeriodicTrigger?

[bgargesh]

It would be helpful if we have small Hello-World like programs as demos which makes use of all the concepts,
like different types of Channels, Transformer, Splitter, Handler, Chain etc.

Another thing is to expose the JUnit Testing framework
which is used to test the SI.

[BobbyF]

It would be nice to include which tags use which XSDs and the dependency jars for that. It took a while for me to figure that out when I was implementing it in my project. Also, if certain tags require a specific Spring version, it be mentioned as well.
Thanks.

[christophergraz]

The Message Endpoints are summarized at the top of the doc under section 1.4.

It would be nice if there were a link from each summary to the more detailed explanations later in the doc.

For example, section 1.4.1 introduces the Transformer. It would be helpful for this section to include a link to section 9 where Transformers are described in more detail.

I am referring to this preview doc: http://static.springsource.org/sprin...reference.html

[ToomX]

It seems that the @Publisher annotation has changed. It requires an additional @Payload annotation to define the payload. How ever the text of Chapter 17 seems only valid for M5, but not for M6 anymore. Also the sample needs an update.

Regards Markus

[Mark Fisher]

We have created this issue to cover that particular documentation update:
https://jira.springsource.org/browse/INT-1246

Feel free to add any comments there.

Thanks,
Mark

[nicolas.loriente]

Spring Integration Reference Manual 2.0.0.RC1 outdated section

28.3 Mail Namespace Support

<mail:header-enricher subject="Example Mail"	
	              to="to@example.org"
	              cc="cc@example.org"
	              bcc="bcc@example.org"
	              from="from@example.org"
	              reply-to="replyTo@example.org"
	              overwrite="false"/>

When it should be something like:

<mail:header-enricher input-channel="mailOutputChannel" 
                      output-channel="enrichedMailOutputChannel">
    <mail:from value="test@email.com" />
    .....
</mail:header-enricher>

as the use of top-level attributes for headers was dropped.