From 677fca51a9bdb3c88aef7ce84126d164da7ad154 Mon Sep 17 00:00:00 2001 From: Chris Beams Date: Tue, 26 Oct 2010 18:43:14 -0400 Subject: [PATCH] Major progress on Gradle port Complete: -------- - src/* documentation resources moved to 'docs' subproject - docbook sources upgraded to Docbook 5 - formatted all docbook sources to strip tab characters and eliminate trailing whitespace - all projects compile and test successfully - all artifacts upload successfully to s3, static.sf.org, etc. Remaining: --------- - documentation L&F needs work. CSS, images, and highlighting aren't hooked up properly - spring-integration-jdbc codegen bits in Maven POM need to be transcribed into gradle - dependencies that were optional or provided scope in maven are currently 'compile' scope in Gradle. Need to figure out support in Gradle to fix this. - run through Eclipse classpath and project generation scenarios - delete all Maven artifacts --- .gitignore | 25 +- build.gradle | 22 +- docs/build.gradle | 231 +++++ .../src/api}/doc-files/th-background.png | Bin .../javadoc => docs/src/api}/overview.html | 0 .../src/api}/spring-javadoc.css | 0 .../resources => docs/src/info}/changelog.txt | 0 .../resources => docs/src/info}/license.txt | 0 .../resources => docs/src/info}/notice.txt | 0 .../resources => docs/src/info}/readme.txt | 0 .../src/reference}/aggregator.xml | 0 {src/docbkx => docs/src/reference}/bridge.xml | 0 {src/docbkx => docs/src/reference}/chain.xml | 0 .../src/reference}/channel-adapter.xml | 0 .../docbkx => docs/src/reference}/channel.xml | 0 .../src/reference}/configuration.xml | 0 .../docbkx => docs/src/reference}/delayer.xml | 0 docs/src/reference/docbook/.index.xml.swo | Bin 0 -> 12288 bytes docs/src/reference/docbook/aggregator.xml | 625 +++++++++++++ docs/src/reference/docbook/bridge.xml | 59 ++ docs/src/reference/docbook/chain.xml | 114 +++ .../src/reference/docbook/channel-adapter.xml | 78 ++ docs/src/reference/docbook/channel.xml | 602 ++++++++++++ docs/src/reference/docbook/configuration.xml | 463 +++++++++ docs/src/reference/docbook/delayer.xml | 61 ++ docs/src/reference/docbook/endpoint.xml | 349 +++++++ docs/src/reference/docbook/event.xml | 62 ++ docs/src/reference/docbook/file.xml | 228 +++++ docs/src/reference/docbook/filter.xml | 131 +++ docs/src/reference/docbook/gateway.xml | 254 +++++ docs/src/reference/docbook/groovy.xml | 72 ++ docs/src/reference/docbook/http.xml | 210 +++++ docs/src/reference/docbook/httpinvoker.xml | 101 ++ .../reference/docbook}/images/bank-router.png | Bin .../reference/docbook}/images/cafe-demo.png | Bin .../reference/docbook}/images/cafe-eip.png | Bin .../reference/docbook/images/callouts/1.gif | Bin 0 -> 889 bytes .../reference/docbook/images/callouts/1.png | Bin 0 -> 329 bytes .../reference/docbook/images/callouts/1.svg | 15 + .../reference/docbook/images/callouts/10.gif | Bin 0 -> 929 bytes .../reference/docbook/images/callouts/10.png | Bin 0 -> 361 bytes .../reference/docbook/images/callouts/10.svg | 18 + .../reference/docbook/images/callouts/11.gif | Bin 0 -> 202 bytes .../reference/docbook/images/callouts/11.png | Bin 0 -> 565 bytes .../reference/docbook/images/callouts/11.svg | 16 + .../reference/docbook/images/callouts/12.gif | Bin 0 -> 210 bytes .../reference/docbook/images/callouts/12.png | Bin 0 -> 617 bytes .../reference/docbook/images/callouts/12.svg | 18 + .../reference/docbook/images/callouts/13.gif | Bin 0 -> 209 bytes .../reference/docbook/images/callouts/13.png | Bin 0 -> 623 bytes .../reference/docbook/images/callouts/13.svg | 20 + .../reference/docbook/images/callouts/14.gif | Bin 0 -> 205 bytes .../reference/docbook/images/callouts/14.png | Bin 0 -> 411 bytes .../reference/docbook/images/callouts/14.svg | 17 + .../reference/docbook/images/callouts/15.gif | Bin 0 -> 210 bytes .../reference/docbook/images/callouts/15.png | Bin 0 -> 640 bytes .../reference/docbook/images/callouts/15.svg | 19 + .../reference/docbook/images/callouts/16.svg | 20 + .../reference/docbook/images/callouts/17.svg | 17 + .../reference/docbook/images/callouts/18.svg | 21 + .../reference/docbook/images/callouts/19.svg | 20 + .../reference/docbook/images/callouts/2.gif | Bin 0 -> 907 bytes .../reference/docbook/images/callouts/2.png | Bin 0 -> 353 bytes .../reference/docbook/images/callouts/2.svg | 17 + .../reference/docbook/images/callouts/20.svg | 20 + .../reference/docbook/images/callouts/21.svg | 18 + .../reference/docbook/images/callouts/22.svg | 20 + .../reference/docbook/images/callouts/23.svg | 22 + .../reference/docbook/images/callouts/24.svg | 19 + .../reference/docbook/images/callouts/25.svg | 21 + .../reference/docbook/images/callouts/26.svg | 22 + .../reference/docbook/images/callouts/27.svg | 19 + .../reference/docbook/images/callouts/28.svg | 23 + .../reference/docbook/images/callouts/29.svg | 22 + .../reference/docbook/images/callouts/3.gif | Bin 0 -> 914 bytes .../reference/docbook/images/callouts/3.png | Bin 0 -> 350 bytes .../reference/docbook/images/callouts/3.svg | 19 + .../reference/docbook/images/callouts/30.svg | 22 + .../reference/docbook/images/callouts/4.gif | Bin 0 -> 907 bytes .../reference/docbook/images/callouts/4.png | Bin 0 -> 345 bytes .../reference/docbook/images/callouts/4.svg | 16 + .../reference/docbook/images/callouts/5.gif | Bin 0 -> 916 bytes .../reference/docbook/images/callouts/5.png | Bin 0 -> 348 bytes .../reference/docbook/images/callouts/5.svg | 18 + .../reference/docbook/images/callouts/6.gif | Bin 0 -> 218 bytes .../reference/docbook/images/callouts/6.png | Bin 0 -> 355 bytes .../reference/docbook/images/callouts/6.svg | 19 + .../reference/docbook/images/callouts/7.gif | Bin 0 -> 907 bytes .../reference/docbook/images/callouts/7.png | Bin 0 -> 344 bytes .../reference/docbook/images/callouts/7.svg | 16 + .../reference/docbook/images/callouts/8.gif | Bin 0 -> 918 bytes .../reference/docbook/images/callouts/8.png | Bin 0 -> 357 bytes .../reference/docbook/images/callouts/8.svg | 20 + .../reference/docbook/images/callouts/9.gif | Bin 0 -> 923 bytes .../reference/docbook/images/callouts/9.png | Bin 0 -> 357 bytes .../reference/docbook/images/callouts/9.svg | 19 + .../src/reference/docbook}/images/chain.png | Bin .../src/reference/docbook}/images/channel.png | Bin .../src/reference/docbook}/images/gateway.png | Bin .../docbook}/images/handler-endpoint.png | Bin .../src/reference/docbook}/images/handler.png | Bin .../reference/docbook/images/important.png | Bin 0 -> 722 bytes .../docbook}/images/loan-broker-eip.png | Bin .../src/reference/docbook}/images/logo.png | Bin .../reference/docbook}/images/message-bus.png | Bin .../src/reference/docbook}/images/message.png | Bin docs/src/reference/docbook/images/note.png | Bin 0 -> 1178 bytes .../docbook}/images/quotes-aggregator.png | Bin .../src/reference/docbook}/images/router.png | Bin .../docbook}/images/source-endpoint.png | Bin .../src/reference/docbook}/images/source.png | Bin .../docbook}/images/target-endpoint.png | Bin .../src/reference/docbook}/images/target.png | Bin docs/src/reference/docbook/images/tip.png | Bin 0 -> 449 bytes .../docbook}/images/xdev-spring_logo.jpg | Bin docs/src/reference/docbook/index.xml | 98 ++ docs/src/reference/docbook/ip.xml | 881 ++++++++++++++++++ docs/src/reference/docbook/jdbc.xml | 224 +++++ docs/src/reference/docbook/jms.xml | 311 +++++++ docs/src/reference/docbook/jmx.xml | 190 ++++ docs/src/reference/docbook/mail.xml | 161 ++++ .../src/reference/docbook/message-history.xml | 64 ++ .../reference/docbook/message-publishing.xml | 371 ++++++++ docs/src/reference/docbook/message.xml | 222 +++++ docs/src/reference/docbook/overview.xml | 327 +++++++ .../src/reference/docbook}/resequencer.xml | 0 docs/src/reference/docbook/resources.xml | 17 + docs/src/reference/docbook/rmi.xml | 66 ++ docs/src/reference/docbook/router.xml | 405 ++++++++ docs/src/reference/docbook/samples.xml | 662 +++++++++++++ docs/src/reference/docbook/security.xml | 64 ++ .../reference/docbook/service-activator.xml | 71 ++ docs/src/reference/docbook/splitter.xml | 157 ++++ docs/src/reference/docbook/stream.xml | 91 ++ docs/src/reference/docbook/transactions.xml | 175 ++++ docs/src/reference/docbook/transformer.xml | 183 ++++ docs/src/reference/docbook/ws.xml | 134 +++ docs/src/reference/docbook/xml.xml | 505 ++++++++++ docs/src/reference/docbook/xmpp.xml | 442 +++++++++ .../src/reference}/endpoint.xml | 0 {src/docbkx => docs/src/reference}/event.xml | 0 {src/docbkx => docs/src/reference}/file.xml | 0 {src/docbkx => docs/src/reference}/filter.xml | 0 .../docbkx => docs/src/reference}/gateway.xml | 0 {src/docbkx => docs/src/reference}/groovy.xml | 0 {src/docbkx => docs/src/reference}/http.xml | 0 .../src/reference}/httpinvoker.xml | 0 {src/docbkx => docs/src/reference}/index.xml | 0 {src/docbkx => docs/src/reference}/ip.xml | 0 {src/docbkx => docs/src/reference}/jdbc.xml | 0 {src/docbkx => docs/src/reference}/jms.xml | 0 {src/docbkx => docs/src/reference}/jmx.xml | 0 {src/docbkx => docs/src/reference}/mail.xml | 0 .../src/reference}/message-history.xml | 0 .../src/reference}/message-publishing.xml | 0 .../docbkx => docs/src/reference}/message.xml | 0 .../src/reference}/overview.xml | 0 docs/src/reference/resequencer.xml | 127 +++ .../src/reference}/resources.xml | 0 .../reference}/resources/css/highlight.css | 0 .../src/reference}/resources/css/html.css | 0 docs/src/reference/resources/css/manual.css | 69 ++ .../reference}/resources/css/stylesheet.css | 0 .../resources/images/bank-router.png | Bin 0 -> 15480 bytes .../reference/resources/images/cafe-demo.png | Bin 0 -> 34876 bytes .../reference/resources/images/cafe-eip.png | Bin 0 -> 114763 bytes docs/src/reference/resources/images/chain.png | Bin 0 -> 41697 bytes .../reference/resources/images/channel.png | Bin 0 -> 23472 bytes .../reference/resources/images/gateway.png | Bin 0 -> 11559 bytes .../resources/images/handler-endpoint.png | Bin 0 -> 34981 bytes .../reference/resources/images/handler.png | Bin 0 -> 23782 bytes .../resources/images/loan-broker-eip.png | Bin 0 -> 104145 bytes docs/src/reference/resources/images/logo.png | Bin 0 -> 9627 bytes .../resources/images/message-bus.png | Bin 0 -> 42582 bytes .../reference/resources/images/message.png | Bin 0 -> 12788 bytes .../resources/images/quotes-aggregator.png | Bin 0 -> 14373 bytes .../src/reference/resources/images/router.png | Bin 0 -> 20766 bytes .../resources/images/source-endpoint.png | Bin 0 -> 25560 bytes .../src/reference/resources/images/source.png | Bin 0 -> 21241 bytes .../resources/images/target-endpoint.png | Bin 0 -> 25583 bytes .../src/reference/resources/images/target.png | Bin 0 -> 21981 bytes .../resources/images/xdev-spring_logo.jpg | Bin 0 -> 37376 bytes {src/docbkx => docs/src/reference}/rmi.xml | 0 {src/docbkx => docs/src/reference}/router.xml | 0 .../docbkx => docs/src/reference}/samples.xml | 0 .../src/reference}/security.xml | 0 .../src/reference}/service-activator.xml | 0 .../src/reference}/splitter.xml | 0 {src/docbkx => docs/src/reference}/stream.xml | 0 .../src/reference}/transactions.xml | 0 .../src/reference}/transformer.xml | 0 {src/docbkx => docs/src/reference}/ws.xml | 0 {src/docbkx => docs/src/reference}/xml.xml | 0 {src/docbkx => docs/src/reference}/xmpp.xml | 0 .../src/reference/xsl/html-custom.xsl | 57 +- docs/src/reference/xsl/html-single-custom.xsl | 142 +++ docs/src/reference/xsl/pdf-custom.xsl | 502 ++++++++++ gradle.properties | 1 - gradle/dist.gradle | 52 +- gradle/maven-deployment.gradle | 13 +- settings.gradle | 1 + src/docbkx/resources/xsl/fopdf.xsl | 418 --------- src/docbkx/resources/xsl/html.xsl | 91 -- src/docbkx/resources/xsl/html/titlepage.xml | 61 -- src/docbkx/resources/xsl/html_chunk.xsl | 208 ----- src/docbkx/resources/xsl/pdf/fopdf.xsl | 518 ---------- src/docbkx/resources/xsl/pdf/titlepage.xml | 101 -- 207 files changed, 10983 insertions(+), 1459 deletions(-) create mode 100644 docs/build.gradle rename {src/main/javadoc => docs/src/api}/doc-files/th-background.png (100%) rename {src/main/javadoc => docs/src/api}/overview.html (100%) rename {src/main/javadoc => docs/src/api}/spring-javadoc.css (100%) rename {src/main/resources => docs/src/info}/changelog.txt (100%) rename {src/main/resources => docs/src/info}/license.txt (100%) rename {src/main/resources => docs/src/info}/notice.txt (100%) rename {src/main/resources => docs/src/info}/readme.txt (100%) rename {src/docbkx => docs/src/reference}/aggregator.xml (100%) rename {src/docbkx => docs/src/reference}/bridge.xml (100%) rename {src/docbkx => docs/src/reference}/chain.xml (100%) rename {src/docbkx => docs/src/reference}/channel-adapter.xml (100%) rename {src/docbkx => docs/src/reference}/channel.xml (100%) rename {src/docbkx => docs/src/reference}/configuration.xml (100%) rename {src/docbkx => docs/src/reference}/delayer.xml (100%) create mode 100644 docs/src/reference/docbook/.index.xml.swo create mode 100644 docs/src/reference/docbook/aggregator.xml create mode 100644 docs/src/reference/docbook/bridge.xml create mode 100644 docs/src/reference/docbook/chain.xml create mode 100644 docs/src/reference/docbook/channel-adapter.xml create mode 100644 docs/src/reference/docbook/channel.xml create mode 100644 docs/src/reference/docbook/configuration.xml create mode 100644 docs/src/reference/docbook/delayer.xml create mode 100644 docs/src/reference/docbook/endpoint.xml create mode 100644 docs/src/reference/docbook/event.xml create mode 100644 docs/src/reference/docbook/file.xml create mode 100644 docs/src/reference/docbook/filter.xml create mode 100644 docs/src/reference/docbook/gateway.xml create mode 100644 docs/src/reference/docbook/groovy.xml create mode 100644 docs/src/reference/docbook/http.xml create mode 100644 docs/src/reference/docbook/httpinvoker.xml rename {src/docbkx/resources => docs/src/reference/docbook}/images/bank-router.png (100%) rename {src/docbkx/resources => docs/src/reference/docbook}/images/cafe-demo.png (100%) rename {src/docbkx/resources => docs/src/reference/docbook}/images/cafe-eip.png (100%) create mode 100644 docs/src/reference/docbook/images/callouts/1.gif create mode 100644 docs/src/reference/docbook/images/callouts/1.png create mode 100644 docs/src/reference/docbook/images/callouts/1.svg create mode 100644 docs/src/reference/docbook/images/callouts/10.gif create mode 100644 docs/src/reference/docbook/images/callouts/10.png create mode 100644 docs/src/reference/docbook/images/callouts/10.svg create mode 100644 docs/src/reference/docbook/images/callouts/11.gif create mode 100644 docs/src/reference/docbook/images/callouts/11.png create mode 100644 docs/src/reference/docbook/images/callouts/11.svg create mode 100644 docs/src/reference/docbook/images/callouts/12.gif create mode 100644 docs/src/reference/docbook/images/callouts/12.png create mode 100644 docs/src/reference/docbook/images/callouts/12.svg create mode 100644 docs/src/reference/docbook/images/callouts/13.gif create mode 100644 docs/src/reference/docbook/images/callouts/13.png create mode 100644 docs/src/reference/docbook/images/callouts/13.svg create mode 100644 docs/src/reference/docbook/images/callouts/14.gif create mode 100644 docs/src/reference/docbook/images/callouts/14.png create mode 100644 docs/src/reference/docbook/images/callouts/14.svg create mode 100644 docs/src/reference/docbook/images/callouts/15.gif create mode 100644 docs/src/reference/docbook/images/callouts/15.png create mode 100644 docs/src/reference/docbook/images/callouts/15.svg create mode 100644 docs/src/reference/docbook/images/callouts/16.svg create mode 100644 docs/src/reference/docbook/images/callouts/17.svg create mode 100644 docs/src/reference/docbook/images/callouts/18.svg create mode 100644 docs/src/reference/docbook/images/callouts/19.svg create mode 100644 docs/src/reference/docbook/images/callouts/2.gif create mode 100644 docs/src/reference/docbook/images/callouts/2.png create mode 100644 docs/src/reference/docbook/images/callouts/2.svg create mode 100644 docs/src/reference/docbook/images/callouts/20.svg create mode 100644 docs/src/reference/docbook/images/callouts/21.svg create mode 100644 docs/src/reference/docbook/images/callouts/22.svg create mode 100644 docs/src/reference/docbook/images/callouts/23.svg create mode 100644 docs/src/reference/docbook/images/callouts/24.svg create mode 100644 docs/src/reference/docbook/images/callouts/25.svg create mode 100644 docs/src/reference/docbook/images/callouts/26.svg create mode 100644 docs/src/reference/docbook/images/callouts/27.svg create mode 100644 docs/src/reference/docbook/images/callouts/28.svg create mode 100644 docs/src/reference/docbook/images/callouts/29.svg create mode 100644 docs/src/reference/docbook/images/callouts/3.gif create mode 100644 docs/src/reference/docbook/images/callouts/3.png create mode 100644 docs/src/reference/docbook/images/callouts/3.svg create mode 100644 docs/src/reference/docbook/images/callouts/30.svg create mode 100644 docs/src/reference/docbook/images/callouts/4.gif create mode 100644 docs/src/reference/docbook/images/callouts/4.png create mode 100644 docs/src/reference/docbook/images/callouts/4.svg create mode 100644 docs/src/reference/docbook/images/callouts/5.gif create mode 100644 docs/src/reference/docbook/images/callouts/5.png create mode 100644 docs/src/reference/docbook/images/callouts/5.svg create mode 100644 docs/src/reference/docbook/images/callouts/6.gif create mode 100644 docs/src/reference/docbook/images/callouts/6.png create mode 100644 docs/src/reference/docbook/images/callouts/6.svg create mode 100644 docs/src/reference/docbook/images/callouts/7.gif create mode 100644 docs/src/reference/docbook/images/callouts/7.png create mode 100644 docs/src/reference/docbook/images/callouts/7.svg create mode 100644 docs/src/reference/docbook/images/callouts/8.gif create mode 100644 docs/src/reference/docbook/images/callouts/8.png create mode 100644 docs/src/reference/docbook/images/callouts/8.svg create mode 100644 docs/src/reference/docbook/images/callouts/9.gif create mode 100644 docs/src/reference/docbook/images/callouts/9.png create mode 100644 docs/src/reference/docbook/images/callouts/9.svg rename {src/docbkx/resources => docs/src/reference/docbook}/images/chain.png (100%) rename {src/docbkx/resources => docs/src/reference/docbook}/images/channel.png (100%) rename {src/docbkx/resources => docs/src/reference/docbook}/images/gateway.png (100%) rename {src/docbkx/resources => docs/src/reference/docbook}/images/handler-endpoint.png (100%) rename {src/docbkx/resources => docs/src/reference/docbook}/images/handler.png (100%) create mode 100644 docs/src/reference/docbook/images/important.png rename {src/docbkx/resources => docs/src/reference/docbook}/images/loan-broker-eip.png (100%) rename {src/docbkx/resources => docs/src/reference/docbook}/images/logo.png (100%) rename {src/docbkx/resources => docs/src/reference/docbook}/images/message-bus.png (100%) rename {src/docbkx/resources => docs/src/reference/docbook}/images/message.png (100%) create mode 100644 docs/src/reference/docbook/images/note.png rename {src/docbkx/resources => docs/src/reference/docbook}/images/quotes-aggregator.png (100%) rename {src/docbkx/resources => docs/src/reference/docbook}/images/router.png (100%) rename {src/docbkx/resources => docs/src/reference/docbook}/images/source-endpoint.png (100%) rename {src/docbkx/resources => docs/src/reference/docbook}/images/source.png (100%) rename {src/docbkx/resources => docs/src/reference/docbook}/images/target-endpoint.png (100%) rename {src/docbkx/resources => docs/src/reference/docbook}/images/target.png (100%) create mode 100644 docs/src/reference/docbook/images/tip.png rename {src/docbkx/resources => docs/src/reference/docbook}/images/xdev-spring_logo.jpg (100%) create mode 100644 docs/src/reference/docbook/index.xml create mode 100644 docs/src/reference/docbook/ip.xml create mode 100644 docs/src/reference/docbook/jdbc.xml create mode 100644 docs/src/reference/docbook/jms.xml create mode 100644 docs/src/reference/docbook/jmx.xml create mode 100644 docs/src/reference/docbook/mail.xml create mode 100644 docs/src/reference/docbook/message-history.xml create mode 100644 docs/src/reference/docbook/message-publishing.xml create mode 100644 docs/src/reference/docbook/message.xml create mode 100644 docs/src/reference/docbook/overview.xml rename {src/docbkx => docs/src/reference/docbook}/resequencer.xml (100%) create mode 100644 docs/src/reference/docbook/resources.xml create mode 100644 docs/src/reference/docbook/rmi.xml create mode 100644 docs/src/reference/docbook/router.xml create mode 100644 docs/src/reference/docbook/samples.xml create mode 100644 docs/src/reference/docbook/security.xml create mode 100644 docs/src/reference/docbook/service-activator.xml create mode 100644 docs/src/reference/docbook/splitter.xml create mode 100644 docs/src/reference/docbook/stream.xml create mode 100644 docs/src/reference/docbook/transactions.xml create mode 100644 docs/src/reference/docbook/transformer.xml create mode 100644 docs/src/reference/docbook/ws.xml create mode 100644 docs/src/reference/docbook/xml.xml create mode 100644 docs/src/reference/docbook/xmpp.xml rename {src/docbkx => docs/src/reference}/endpoint.xml (100%) rename {src/docbkx => docs/src/reference}/event.xml (100%) rename {src/docbkx => docs/src/reference}/file.xml (100%) rename {src/docbkx => docs/src/reference}/filter.xml (100%) rename {src/docbkx => docs/src/reference}/gateway.xml (100%) rename {src/docbkx => docs/src/reference}/groovy.xml (100%) rename {src/docbkx => docs/src/reference}/http.xml (100%) rename {src/docbkx => docs/src/reference}/httpinvoker.xml (100%) rename {src/docbkx => docs/src/reference}/index.xml (100%) rename {src/docbkx => docs/src/reference}/ip.xml (100%) rename {src/docbkx => docs/src/reference}/jdbc.xml (100%) rename {src/docbkx => docs/src/reference}/jms.xml (100%) rename {src/docbkx => docs/src/reference}/jmx.xml (100%) rename {src/docbkx => docs/src/reference}/mail.xml (100%) rename {src/docbkx => docs/src/reference}/message-history.xml (100%) rename {src/docbkx => docs/src/reference}/message-publishing.xml (100%) rename {src/docbkx => docs/src/reference}/message.xml (100%) rename {src/docbkx => docs/src/reference}/overview.xml (100%) create mode 100644 docs/src/reference/resequencer.xml rename {src/docbkx => docs/src/reference}/resources.xml (100%) rename {src/docbkx => docs/src/reference}/resources/css/highlight.css (100%) rename {src/docbkx => docs/src/reference}/resources/css/html.css (100%) create mode 100644 docs/src/reference/resources/css/manual.css rename {src/docbkx => docs/src/reference}/resources/css/stylesheet.css (100%) create mode 100644 docs/src/reference/resources/images/bank-router.png create mode 100644 docs/src/reference/resources/images/cafe-demo.png create mode 100644 docs/src/reference/resources/images/cafe-eip.png create mode 100644 docs/src/reference/resources/images/chain.png create mode 100644 docs/src/reference/resources/images/channel.png create mode 100644 docs/src/reference/resources/images/gateway.png create mode 100644 docs/src/reference/resources/images/handler-endpoint.png create mode 100644 docs/src/reference/resources/images/handler.png create mode 100644 docs/src/reference/resources/images/loan-broker-eip.png create mode 100644 docs/src/reference/resources/images/logo.png create mode 100644 docs/src/reference/resources/images/message-bus.png create mode 100644 docs/src/reference/resources/images/message.png create mode 100644 docs/src/reference/resources/images/quotes-aggregator.png create mode 100644 docs/src/reference/resources/images/router.png create mode 100644 docs/src/reference/resources/images/source-endpoint.png create mode 100644 docs/src/reference/resources/images/source.png create mode 100644 docs/src/reference/resources/images/target-endpoint.png create mode 100644 docs/src/reference/resources/images/target.png create mode 100644 docs/src/reference/resources/images/xdev-spring_logo.jpg rename {src/docbkx => docs/src/reference}/rmi.xml (100%) rename {src/docbkx => docs/src/reference}/router.xml (100%) rename {src/docbkx => docs/src/reference}/samples.xml (100%) rename {src/docbkx => docs/src/reference}/security.xml (100%) rename {src/docbkx => docs/src/reference}/service-activator.xml (100%) rename {src/docbkx => docs/src/reference}/splitter.xml (100%) rename {src/docbkx => docs/src/reference}/stream.xml (100%) rename {src/docbkx => docs/src/reference}/transactions.xml (100%) rename {src/docbkx => docs/src/reference}/transformer.xml (100%) rename {src/docbkx => docs/src/reference}/ws.xml (100%) rename {src/docbkx => docs/src/reference}/xml.xml (100%) rename {src/docbkx => docs/src/reference}/xmpp.xml (100%) rename src/docbkx/resources/xsl/html/html_chunk.xsl => docs/src/reference/xsl/html-custom.xsl (67%) create mode 100644 docs/src/reference/xsl/html-single-custom.xsl create mode 100644 docs/src/reference/xsl/pdf-custom.xsl delete mode 100644 src/docbkx/resources/xsl/fopdf.xsl delete mode 100644 src/docbkx/resources/xsl/html.xsl delete mode 100644 src/docbkx/resources/xsl/html/titlepage.xml delete mode 100644 src/docbkx/resources/xsl/html_chunk.xsl delete mode 100644 src/docbkx/resources/xsl/pdf/fopdf.xsl delete mode 100644 src/docbkx/resources/xsl/pdf/titlepage.xml diff --git a/.gitignore b/.gitignore index 32f530c74e..be837c6196 100644 --- a/.gitignore +++ b/.gitignore @@ -1,16 +1,17 @@ +*.iml +*.sw? +*/src/main/java/META-INF +.gradle +.idea +.settings +.springBeans +build +derby.log +integration-repo lib logs -target -.springBeans -.settings -spring-integration-samples/loanshark/application.log* -integration-repo -spring-integration-jms/activemq-data/ si.java.hsp -*/src/main/java/META-INF +spring-integration-jms/activemq-data/ spring-integration-parent/.project -*.iml -.idea -derby.log -.gradle -build +spring-integration-samples/loanshark/application.log* +target diff --git a/build.gradle b/build.gradle index 60b4b15f85..e0c85da4b4 100644 --- a/build.gradle +++ b/build.gradle @@ -24,16 +24,21 @@ // ----------------------------------------------------------------------------- +// ----------------------------------------------------------------------------- +// Configuration for the root project +// ----------------------------------------------------------------------------- +apply from: "$rootDir/gradle/version.gradle" +apply plugin: 'idea' + +// used for artifact names, building doc upload urls, etc. +description = 'Spring Integration' +abbreviation = 'INT' + // ----------------------------------------------------------------------------- // Configuration for all projects including this one (the root project) // // @see settings.gradle for list of all subprojects // ----------------------------------------------------------------------------- - -apply from: "$rootDir/gradle/version.gradle" -apply plugin: 'idea' - - allprojects { // group will translate to groupId during pom generation and deployment group = 'org.springframework.integration' @@ -80,6 +85,11 @@ configure(javaprojects) { apply plugin: 'eclipse' // `gradle eclipse` to generate .classpath/.project apply plugin: 'idea' // `gradle idea` to generate .ipr/.iml + // set up dedicated directories for jars and source jars. + // this makes it easier when putting together the distribution + libsBinDir = new File(libsDir, 'bin') + libsSrcDir = new File(libsDir, 'src') + // all core projects should be OSGi-compliant bundles // add the bundlor task to ensure proper manifests apply from: "$rootDir/gradle/bundlor.gradle" @@ -405,7 +415,7 @@ project('spring-integration-xmpp') { apply plugin: 'base' // add tasks like 'distArchive' -//apply from: "$rootDir/gradle/dist.gradle" +apply from: "$rootDir/gradle/dist.gradle" // add tasks like 'snapshotDependencyCheck' apply from: "${rootDir}/gradle/checks.gradle" diff --git a/docs/build.gradle b/docs/build.gradle new file mode 100644 index 0000000000..19d398a825 --- /dev/null +++ b/docs/build.gradle @@ -0,0 +1,231 @@ +/* + * Copyright 2002-2010 the original author or authors. + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +apply plugin: 'base' +apply from: "$rootDir/gradle/docbook.gradle" + +description = "Spring Integration Documentation" + +task build(dependsOn: assemble) { + group = 'Build' + description = 'Builds reference and API documentation and archives' +} + + +/** + * Build aggregated JavaDoc HTML for all core project classes. Result is + * suitable for packaging into a distribution zip or viewing directly with + * a browser. + * + * @author cbeams + * @author ltaylor + * @see http://gradle.org/0.9-rc-1/docs/javadoc/org/gradle/api/tasks/javadoc/Javadoc.html + */ + task api(type: Javadoc) { + group = 'Documentation' + description = "Builds aggregated JavaDoc HTML for all core project classes." + + // this task is a bit ugly to configure. it was a user contribution, and + // Hans tells me it's on the roadmap to redesign it. + srcDir = file("${projectDir}/src/api") + destinationDir = file("${buildDir}/api") + tmpDir = file("${buildDir}/api-work") + optionsFile = file("${tmpDir}/apidocs/javadoc.options") + options.stylesheetFile = file("${srcDir}/spring-javadoc.css") + options.links = ["http://static.springframework.org/spring/docs/3.0.x/javadoc-api"] + options.overview = "${srcDir}/overview.html" + options.docFilesSubDirs = true + title = "Spring Integration ${version} API" + + // collect all the sources that will be included in the javadoc output + source javaprojects.collect {project -> + project.sourceSets.main.allJava + } + + // collect all main classpaths to be able to resolve @see refs, etc. + // this collection also determines the set of projects that this + // task dependsOn, thus the runtimeClasspath is used to ensure all + // projects are included, not just *dependencies* of all classes. + // this is awkward and took me a while to figure out. + classpath = files(javaprojects.collect {project -> + project.sourceSets.main.runtimeClasspath + }) + + // copy the images from the doc-files dir over to the target + doLast { task -> + copy { + from file("${task.srcDir}/doc-files") + into file("${task.destinationDir}/doc-files") + } + } +} + +/** + * Expand ${...} variables within docbook sources. This is a workaround + * accomodating the fact that the current docbook plugin has no way of + * parameterizing and replacing normal XML entities. + * + * Note that this task represents an implementation detail and it is + * unfortunate that it pollutes the listing of available tasks, e.g. + * during `gradle -t`. It's a good example of the need for 'task visibility' - + * a feature not yet implemented, but on the Gradle roadmap. + * + * @author Chris Beams + * @see http://jira.codehaus.org/browse/GRADLE-1026 + */ +task preprocessDocbookSources { + description = 'Expands ${...} variables within docbook sources.' + + doLast { + docbookSrcDir = file('src/reference/docbook') + docbookBuildDir = file('build/reference-work') + + // copy everything but index.xml + copy { + into(docbookBuildDir) + from(docbookSrcDir) { exclude '**/index.xml' } + } + // copy index.xml and expand ${...} variables along the way + // e.g.: ${version} needs to be replaced in the header + copy { + into(docbookBuildDir) + from(docbookSrcDir) { include '**/index.xml' } + expand(version: "$version") + } + } +} + +// ----------------------------------------------------------------------------- +// Configure the three docbook* tasks that are added to the project by the +// 'docbook' plugin. +// ----------------------------------------------------------------------------- +task reference(dependsOn: [docbookHtml, docbookHtmlSingle, docbookPdf]) { + group = 'Documentation' + description = 'Generates all HTML and PDF reference documentation.' +} + +[docbookHtml, docbookPdf, docbookHtmlSingle]*.sourceFileName = 'index.xml'; +[docbookHtml, docbookHtmlSingle, docbookPdf]*.dependsOn preprocessDocbookSources + +docbookHtml.stylesheet = file('src/reference/xsl/html-custom.xsl') +docbookHtmlSingle.stylesheet = file('src/reference/xsl/html-single-custom.xsl') +docbookPdf.stylesheet = file('src/reference/xsl/pdf-custom.xsl') +def imagesDir = file('src/reference/docbook/images'); +docbookPdf.admonGraphicsPath = "${imagesDir}/" + + +/** + * + * @see http://www.gradle.org/0.9-preview-3/docs/userguide/userguide_single.html#sec:copying_files + * @see http://www.gradle.org/0.9-preview-3/docs/javadoc/org/gradle/api/file/CopySpec.html + */ +docsSpec = copySpec { + into("${version}") { + from('src/info/changelog.txt') + } + + into("${version}/api") { + from(api.destinationDir) + } + + into("${version}/reference") { + from("${buildDir}/reference") + } + + // copy images and css into respective html dirs + ['html', 'htmlsingle'].each { dir -> + into("${version}/reference/${dir}/images") { + from "src/docbook/images" + } + into("${version}/reference/${dir}/css") { + from "src/resources/css" + } + } +} + +task archive(type: Zip, dependsOn: [api, reference]) { + group = "Documentation" + description = "Create a zip archive of reference and API documentation." + + baseName = rootProject.name + '-docs' + + // drop it right in the root of the build dir for simplicity + destinationDir = buildDir + + // use the copy spec above to specify the contents of the zip + with docsSpec +} + +configurations { archives } +artifacts { archives archive } + +configurations { scpAntTask } +dependencies { + scpAntTask("org.apache.ant:ant-jsch:1.8.1") +} + +checkForProps(taskPath: project.path + ':uploadArchives', requiredProps: ['sshHost', 'sshUsername']) + +uploadArchives { + def sshHost = project.properties.sshHost + def sshUsername = project.properties.sshUsername + def remoteSiteDir = '/var/www/domains/springframework.org/static/htdocs/' + rootProject.name + def docUrl = "http://${sshHost}/${rootProject.name}/docs/${version}" + def remoteDocsDir = "${remoteSiteDir}/docs/" + def fqRemoteDir = "${sshUsername}@${sshHost}:${remoteDocsDir}" + + group = 'Buildmaster' + description = "Uploads and unpacks documentation archive" + (sshHost ? " to ${docUrl}" : ": Host is not specified") + + uploadDescriptor = false + + repositories { + add(new org.apache.ivy.plugins.resolver.SshResolver()) { + name = 'sshHost: ' + sshHost // used for debugging + host = sshHost + user = sshUsername + if (project.hasProperty('remoteSiteDir')) { + keyFile = sshPrivateKey as File + } + addArtifactPattern "${remoteDocsDir}/${archive.archiveName}" + } + } + + configurations { scpAntTask } + dependencies { scpAntTask 'org.apache.ant:ant-jsch:1.8.1' } + + doFirst { + println "Uploading: ${archive.archivePath} to ${fqRemoteDir}" + } + + doLast { + project.ant { + taskdef(name: 'sshexec', + classname: 'org.apache.tools.ant.taskdefs.optional.ssh.SSHExec', + classpath: configurations.scpAntTask.asPath) + + // copy the archive, unpack it, then delete it + def unpackCommand = "cd ${remoteDocsDir} && unzip ${archive.archiveName}" + def deleteCommand = "rm ${remoteDocsDir}/${archive.archiveName}" + + println "sshexec ${unpackCommand}" + sshexec(host: sshHost, username: sshUsername, keyfile: sshPrivateKey, command: unpackCommand) + println "sshexec ${deleteCommand}" + sshexec(host: sshHost, username: sshUsername, keyfile: sshPrivateKey, command: deleteCommand) + println "UPLOAD SUCCESSFUL - validate by visiting ${docUrl}" + } + } +} diff --git a/src/main/javadoc/doc-files/th-background.png b/docs/src/api/doc-files/th-background.png similarity index 100% rename from src/main/javadoc/doc-files/th-background.png rename to docs/src/api/doc-files/th-background.png diff --git a/src/main/javadoc/overview.html b/docs/src/api/overview.html similarity index 100% rename from src/main/javadoc/overview.html rename to docs/src/api/overview.html diff --git a/src/main/javadoc/spring-javadoc.css b/docs/src/api/spring-javadoc.css similarity index 100% rename from src/main/javadoc/spring-javadoc.css rename to docs/src/api/spring-javadoc.css diff --git a/src/main/resources/changelog.txt b/docs/src/info/changelog.txt similarity index 100% rename from src/main/resources/changelog.txt rename to docs/src/info/changelog.txt diff --git a/src/main/resources/license.txt b/docs/src/info/license.txt similarity index 100% rename from src/main/resources/license.txt rename to docs/src/info/license.txt diff --git a/src/main/resources/notice.txt b/docs/src/info/notice.txt similarity index 100% rename from src/main/resources/notice.txt rename to docs/src/info/notice.txt diff --git a/src/main/resources/readme.txt b/docs/src/info/readme.txt similarity index 100% rename from src/main/resources/readme.txt rename to docs/src/info/readme.txt diff --git a/src/docbkx/aggregator.xml b/docs/src/reference/aggregator.xml similarity index 100% rename from src/docbkx/aggregator.xml rename to docs/src/reference/aggregator.xml diff --git a/src/docbkx/bridge.xml b/docs/src/reference/bridge.xml similarity index 100% rename from src/docbkx/bridge.xml rename to docs/src/reference/bridge.xml diff --git a/src/docbkx/chain.xml b/docs/src/reference/chain.xml similarity index 100% rename from src/docbkx/chain.xml rename to docs/src/reference/chain.xml diff --git a/src/docbkx/channel-adapter.xml b/docs/src/reference/channel-adapter.xml similarity index 100% rename from src/docbkx/channel-adapter.xml rename to docs/src/reference/channel-adapter.xml diff --git a/src/docbkx/channel.xml b/docs/src/reference/channel.xml similarity index 100% rename from src/docbkx/channel.xml rename to docs/src/reference/channel.xml diff --git a/src/docbkx/configuration.xml b/docs/src/reference/configuration.xml similarity index 100% rename from src/docbkx/configuration.xml rename to docs/src/reference/configuration.xml diff --git a/src/docbkx/delayer.xml b/docs/src/reference/delayer.xml similarity index 100% rename from src/docbkx/delayer.xml rename to docs/src/reference/delayer.xml diff --git a/docs/src/reference/docbook/.index.xml.swo b/docs/src/reference/docbook/.index.xml.swo new file mode 100644 index 0000000000000000000000000000000000000000..782ad922c7ef9bcfd62aaff35a6cbf56a1ca559a GIT binary patch literal 12288 zcmeI2O^n+_6vy52(Lz~31yKPP*MQ*A#M!M7-Ni|zQd;fOFZBaZFLYv0oN4SCGc!)I zpuz=ioH#+n0aPT!0VIyVsZc=N;DX=^5>(>A1tbnV@V6811~#!*>Iros{WkLW&3iNd z89z_7uibcd`KbLweZj)#Zp-?0>o-SMFJ0Ptxwggf+mysAyHWljob-q$^+@<6DlvU! zhz%>TCpsynrPbJpI4`9?PFhn(H^Jv-0bND7#_8U>63MggOMQNSo*6fg=H1#Wl+bh5>I z6)J2UE72Z*Z~4#n_|kkC1&jhl0i%FXz$jo8FbWt2i~>dhqkvJsDDXd2fCQGc3qSrp zzX^lK|No2M|3BSjS*u_LJOJjv4|iJD+aLr@;DMdM0zc1L*1KQ`eDDg{CO+C{m%qeLows zBu=6=pS9X7x1kiGzdGS>$_N$pQ^|CN6-Hm~hW07fV-tJEER~k1Wh(bGjFY6?;(VMJ z9L*LpCahwxtRh5L>rGfN-WNS8D<&;tRz9CW#ojm{R~ZCtzdS^TMYLj=F;$9$wAN)x z3t6!nv?N>+KdTq37+c{sN!t-qT@;&@k2EBj4oF4#wq!wAOlZbl^Sgxc@>l_l$m-hq z&G3Tw3W`JNGoli7w0spk$@zX z#)`^5^Jy*H0{!YKQywG&HHPKOF&;s=(Re?V8;O24J~}9@vK7<9Z+UL^H&4}h)@HmT zveb#&5tc6ELSt4fFCmh&zWC5Sl~+fe$`iP~%>DWvd!aGk@Z8+Mb0<4xUg5_jsqPAi z#G57~*XxbNHCj|EIf-fOh~S~;7FW58+)al`rE`lFp}L;Cem%DFMsW(4Mcm?gBE-p5 zDH=uPQ4SNidRiv9GlgZAm; z2ansM(@3`KV;V3b+UKdSi+$<2EXG^r-;J=%TLY9Y+u5rsKRe}3%8j5j8aXW5YG zrgP%hVaFyB3whJ=ap<6ObQH)RoC)`~6cKGYU5$fRMSOcx&ZmzvtBcO6p?kyi!`^6? z6N4|F+Kt2Oi1FaO4RYnWW|}V98n0!WDgLOoRaXq~8nx4;o@+f?0!brE6t*KW+QTm+ z|0%qiFL)Tzdi%&Sks?U_QF0k2IHb0<@^9p}iTk4-nrS#`w~C5B02%vB(f|Me literal 0 HcmV?d00001 diff --git a/docs/src/reference/docbook/aggregator.xml b/docs/src/reference/docbook/aggregator.xml new file mode 100644 index 0000000000..4503c52671 --- /dev/null +++ b/docs/src/reference/docbook/aggregator.xml @@ -0,0 +1,625 @@ + + + Aggregator + +
+ Introduction + + Basically a mirror-image of the Splitter, the Aggregator is a type + of Message Handler that receives multiple Messages and combines them into + a single Message. In fact, Aggregators are often downstream consumers in a + pipeline that includes a Splitter. + + Technically, the Aggregator is more complex than a Splitter, because + it is required to maintain state (the Messages to be aggregated), to + decide when the complete group of Messages is available. In order to do + this it requires a MessageStore +
+ +
+ Functionality + + The Aggregator combines a group of related messages, by correlating + and storing them, until the group is deemed complete. At that point, the + Aggregator will create a single message by processing the whole group, and + will send that aggregated message as output. + + An main aspect of implementing an Aggregator is providing the logic + that has to be executed when the aggregation (creation of a single message + out of many) takes place. The other two aspects are correlation and + release + + In Spring Integration, the grouping of the messages for aggregation + (correlation) is done by default based on their CORRELATION_ID message + header (i.e. the messages with the same CORRELATION_ID will be grouped + together). However, this can be customized, and the users can opt for + other ways of specifying how the messages should be grouped together, by + using a CorrelationStrategy (see below). + + To determine whether or not a group of messages may be processed, a + ReleaseStrategy is consulted. The default release strategy for aggregator + will release groups that have all messages from the sequence, but this can + be entirely customized +
+ +
+ Programming model + + The Aggregation API consists of a number of classes: + + + + The interface MessageGroupProcessor and related + base class AbstractAggregatingMessageGroupProcessor and + its subclass + MethodInvokingAggregatingMessageGroupProcessor + + + + The ReleaseStrategy interface and its default + implementation SequenceSizeReleaseStrategy + + + + The CorrelationStrategy interface and its default + implementation HeaderAttributeCorrelationStrategy + + + +
+ + + CorrelatingMessageHandler + + + + The CorrelatingMessageHandler is a + MessageHandler implementation, encapsulating the common + functionalities of an Aggregator (and other correlating use cases), + which are: + + correlating messages into a group to be aggregated + + + + maintaining those messages in a MessageStore until the group + may be released + + + + deciding when the group is in fact may be released + + + + processing the released group into a single aggregated + message + + + + recognizing and responding to an expired group + + The responsibility of deciding how the messages should + be grouped together is delegated to a CorrelationStrategy + instance. The responsibility of deciding whether the message group can + be released is delegated to a ReleaseStrategy + instance. + + + + Here is a brief highlight of the base + AbstractAggregatingMessageGroupProcessor (the + responsibility of implementing the aggregateMessages method is left to + the developer): + + + + aggregateHeaders(MessageGroup group) { + .... + } + + protected abstract Object aggregatePayloads(MessageGroup group); + +}]]> + + The CorrelationStrategy is owned by the + + CorrelatingMessageHandler + + and it has a default value based on the correlation ID message header: + + + + + + When appropriate, the simplest option is the + DefaultAggregatingMessageGroupProcessor. It creates a + single Message whose payload is a List of the payloads received for a + given group. It uses the default CorrelationStrategy and + CompletionStrategy as shown above. This works well for + simple Scatter Gather implementations with either a Splitter, Publish + Subscribe Channel, or Recipient List Router upstream. + + + + + When using a Publish Subscribe Channel or Recipient List Router + in this type of scenario, be sure to enable the flag to + apply-sequence. That will add the necessary + headers (correlation id, sequence number and sequence size). That + behavior is enabled by default for Splitters in Spring Integration, + but it is not enabled for the Publish Subscribe Channel or Recipient + List Router because those components may be used in a variety of + contexts where those headers are not necessary. + + + + + When implementing a specific aggregator object for an application, + a developer can extend + AbstractAggregatingMessageGroupProcessor and implement the + aggregatePayloads method. However, there are better suited + (which reads, less coupled to the API) solutions for implementing the + aggregation logic, which can be configured easily either through XML or + through annotations. + + + + In general, any ordinary Java class (i.e. POJO) can implement the + aggregation algorithm. For doing so, it must provide a method that + accepts as an argument a single java.util.List (parametrized lists are + supported as well). This method will be invoked for aggregating + messages, as follows: + + + + + + if the argument is a parametrized java.util.List, and the + parameter type is assignable to Message, then the whole list of + messages accumulated for aggregation will be sent to the + aggregator + + + + if the argument is a non-parametrized java.util.List or the + parameter type is not assignable to Message, then the method will + receive the payloads of the accumulated messages + + + + if the return type is not assignable to Message, then it will + be treated as the payload for a Message that will be created + automatically by the framework. + + + + + + + In the interest of code simplicity, and promoting best practices + such as low coupling, testability, etc., the preferred way of + implementing the aggregation logic is through a POJO, and using the + XML or annotation support for setting it up in the application. + + + +
+ +
+ ReleaseStrategy + + The ReleaseStrategy interface is defined as + follows: + + + + In general, any ordinary Java class (i.e. POJO) can implement the + completion decision mechanism. For doing so, it must provide a method + that accepts as an argument a single java.util.List (parametrized lists + are supported as well), and returns a boolean value. This method will be + invoked after the arrival of a new message, to decide whether the group + is complete or not, as follows: + + + + if the argument is a parametrized java.util.List, and the + parameter type is assignable to Message, then the whole list of + messages accumulated in the group will be sent to the method + + + + if the argument is a non-parametrized java.util.List or the + parameter type is not assignable to Message, then the method will + receive the payloads of the accumulated messages + + + + the method must return true if the message group is ready for + aggregation, and false otherwise. + + + + When the group is released for aggregation, all its unmarked + messages are processed and then marked so they will not be processed + again. If the group is also complete (i.e. if all messages from a + sequence have arrived or if there is no sequence defined) then the group + is removed from the message store. Partial sequences can be released, in + which case the next time the ReleaseStrategy is called it + will be presented with a group containing marked messages (already + processed) and unmarked messages (a potential new partial + sequence) + + Spring Integration provides an out-of-the box implementation for + ReleaseStrategy, the + SequenceSizerReleaseStrategy. This implementation uses the + SEQUENCE_NUMBER and SEQUENCE_SIZE of the arriving messages for deciding + when a message group is complete and ready to be aggregated. As shown + above, it is also the default strategy. +
+ +
+ CorrelationStrategy + + The CorrelationStrategy interface is defined as + follows: + + message); + +}]]> + + The method shall return an Object which represents the correlation + key used for grouping messages together. The key must satisfy the + criteria used for a key in a Map with respect to the implementation of + equals() and hashCode(). + + In general, any ordinary Java class (i.e. POJO) can implement the + correlation decision mechanism, and the rules for mapping a message to a + method's argument (or arguments) are the same as for a + ServiceActivator (including support for @Header + annotations). The method must return a value, and the value must not be + null. + + Spring Integration provides an out-of-the box implementation for + CorrelationStrategy, the + HeaderAttributeCorrelationStrategy. This implementation + returns the value of one of the message headers (whose name is specified + by a constructor argument) as the correlation key. By default, the + correlation strategy is a HeaderAttributeCorrelationStrategy returning + the value of the CORRELATION_ID header attribute. +
+
+ +
+ Configuring an Aggregator with XML + + Spring Integration supports the configuration of an aggregator via + XML through the <aggregator/> element. Below you can see an example + of an aggregator with all optional parameters defined. + + + + + + + + + + + +]]> + + + + The id of the aggregator is + optional. + + + + The input channel of the aggregator. + Required. + + + + The channel where the aggregator will send the aggregation + results. Optional (because incoming messages can specify a + reply channel themselves). + + + + The channel where the aggregator will send the messages that + timed out (if send-partial-results-on-timeout is + false). Optional. + + + + A reference to a bean defined in the application context. The + bean must implement the aggregation logic as described above. + Required. + + + + A method defined on the bean referenced by ref, + that implements the message aggregation + algorithm. Optional, with restrictions (see + above). + + + + A reference to a bean that implements the decision algorithm as + to whether a given message group is complete. The bean can be an + implementation of the CompletionStrategy interface or a POJO. In the + latter case the completion-strategy-method attribute must be defined + as well. Optional (by default, the aggregator will use + sequence size) . + + + + A method defined on the bean referenced by + release-strategy, that implements the + completion decision algorithm. Optional, with + restrictions (requires completion-strategy to be + present). + + + + A reference to a bean that implements the correlation strategy. + The bean can be an implementation of the CorrelationStrategy interface + or a POJO. In the latter case the correlation-strategy-method + attribute must be defined as well. Optional (by default, the + aggregator will use the correlation id header attribute) + . + + + + A method defined on the bean referenced by + correlation-strategy, that implements the + correlation key algorithm. Optional, with + restrictions (requires correlation-strategy to be + present). + + + + A reference to a MessageGroupStore that can be used + to store groups of messages under their correlation key until they are + complete. Optional with default a volatile + in-memory store. + + + + Whether upon the expiration of the message group, the aggregator + will try to aggregate the messages that have already arrived. + Optional (false by default). + + + + The timeout for sending the aggregated messages to the output or + reply channel. Optional. + + + + Using a "ref" attribute is generally recommended if a custom + aggregator handler implementation can be reused in other + <aggregator> definitions. However if a custom + aggregator handler implementation should be scoped to a concrete + definition of the <aggregator>, you can use an inner + bean definition (starting with version 1.0.3) for custom aggregator + handlers within the <aggregator> element: + + +]]> + + + Using both a "ref" attribute and an inner bean definition in the + same <aggregator> configuration is not allowed, as it + creates an ambiguous condition. In such cases, an Exception will be + thrown. + + + An example implementation of the aggregator bean looks as + follows: + + results) { + long total = 0l; + for (long partialResult: results) { + total += partialResult; + } + return total; + } + +}]]> + + An implementation of the completion strategy bean for the example + above may be as follows: + + numbers) { + int sum = 0; + for (long number: numbers) { + sum += number; + } + return sum >= maxValue; + } +}]]> + Wherever it makes sense, the release strategy method and the + aggregator method can be combined in a single bean. + + + An implementation of the correlation strategy bean for the example + above may be as follows: + + + + For example, this aggregator would group numbers by some criterion + (in our case the remainder after dividing by 10) and will hold the group + until the sum of the numbers which represents the payload exceeds a + certain value. + + + Wherever it makes sense, the release strategy method, correlation + strategy method and the aggregator method can be combined in a single + bean (all of them or any two). + +
+ +
+ Managing State in an Aggregator: + MessageGroupStore + + Aggregator (and some other patterns in Spring Integration) is a + stateful pattern that requires decisions to be made based on a group of + messages that have arrived over a period of time, all with the same + correlation key. The design of the interfaces in the stateful patterns + (e.g. ReleaseStrategy) is driven by the principle + that the components (framework and user) should be to remain stateless. + All state is carried by the MessageGroup and its + management is delegated to the + MessageGroupStore. + + The MessageGroupStore accumulates state + information in MessageGroups, potentially forever. + So to prevent stale state from hanging around, and for volatile stores to + provide a hook for cleaning up when the application shots down, the + MessageGroupStore allows the user to register + callbacks to apply to MessageGroups when they + expire. The interface is very straighforward: + + + + The callback has access directly to the store and the message group + so it can manage the persistent state (e.g. by removing the group from the + store entirely). + + The MessageGroupStore maintains a list of these callbacks which it + applies when asked to all messages whose timestamp is earlier than a time + supplied as a parameter: + + + + The expireMessageGroups method can be called with a timeout value: + any message older than the current time minus this value wiull be expired, + and have the callbacks applied. Thus it is the user of the store that + defines what is meant by message group "expiry". + + As a convenience for users, Spring Integration provides a wrapper + for the message expiry in the form of a + MessageGroupStoreReaper: + + + + + + + + +]]> + + The reaper is a Runnable, and all that is happening is that the + message group store's expire method is being called in the sample above + once every 10 seconds. In addition to the reaper, the expiry callbacks are + invoked when the application shuts down via a lifecycle callback in the + CorrelatingMessageHandler. + + The CorrelatingMessageHandler registers its + own expiry callback, and this is the link with the boolean flag + send-partial-result-on-expiry in the XML configuration of the + aggregator. If the flag is set to true, then when the expiry callback is + invoked then any unmarked messages in groups that are not yet released can + be sent on to the downstream channel. +
+ +
+ Configuring an Aggregator with Annotations + + An aggregator configured using annotations can look like + this. + + items) { + ... + } + + @ReleaseStrategy ]]>> messages) { + ... + } + + @CorrelationStrategy ]]> + + + + An annotation indicating that this method shall be used as an + aggregator. Must be specified if this class will be used as an + aggregator. + + + + An annotation indicating that this method shall be + used as the release strategy of an aggregator. If not present on any + method, the aggregator will use the + SequenceSizeCompletionStrategy. + + + + An annotation indicating that this method shall be + used as the correlation strategy of an aggregator. If no correlation + strategy is indicated, the aggregator will use the + HeaderAttributeCorrelationStrategy based on CORRELATION_ID. + + + + All of the configuration options provided by the xml element are + also available for the @Aggregator annotation. + + The aggregator can be either referenced explicitly from XML or, if + the @MessageEndpoint is defined on the class, detected automatically + through classpath scanning. +
+
diff --git a/docs/src/reference/docbook/bridge.xml b/docs/src/reference/docbook/bridge.xml new file mode 100644 index 0000000000..105cfc76e6 --- /dev/null +++ b/docs/src/reference/docbook/bridge.xml @@ -0,0 +1,59 @@ + + + Messaging Bridge + +
+ Introduction + + A Messaging Bridge is a relatively trivial endpoint that simply connects two Message Channels or Channel + Adapters. For example, you may want to connect a PollableChannel to a + SubscribableChannel so that the subscribing endpoints do not have to worry + about any polling configuration. Instead, the Messaging Bridge provides the polling configuration. + + + By providing an intermediary poller between two channels, a Messaging Bridge can be used to throttle inbound + Messages. The poller's trigger will determine the rate at which messages arrive on the second channel, and the + poller's "maxMessagesPerPoll" property will enforce a limit on the throughput. + + + Another valid use for a Messaging Bridge is to connect two different systems. In such a scenario, Spring + Integration's role would be limited to making the connection between these systems and managing a poller + if necessary. It is probably more common to have at least a Transformer between the + two systems to translate between their formats, and in that case, the channels would be provided as the + 'input-channel' and 'output-channel' of a Transformer endpoint. If data format translation is not required, + the Messaging Bridge may indeed be sufficient. + +
+ +
+ The <bridge> Element + + The <bridge> element is used to create a Messaging Bridge between two Message Channels or Channel Adapters. + Simply provide the "input-channel" and "output-channel" attributes: + ]]> + As mentioned above, a common use case for the Messaging Bridge is to connect a + PollableChannel to a SubscribableChannel, and when + performing this role, the Messaging Bridge may also serve as a throttler: + + + ]]> + + + Connecting Channel Adapters is just as easy. Here is a simple echo example between the "stdin" and "stdout" + adapters from Spring Integration's "stream" namespace. + + + + + ]]> + Of course, the configuration would be similar for other (potentially more useful) Channel Adapter bridges, such + as File to JMS, or Mail to File. The various Channel Adapters will be discussed in upcoming chapters. + + + If no 'output-channel' is defined on a bridge, the reply channel provided by the inbound Message will + be used, if available. If neither output or reply channel is available, an Exception will be thrown. + +
+ +
diff --git a/docs/src/reference/docbook/chain.xml b/docs/src/reference/docbook/chain.xml new file mode 100644 index 0000000000..c82a01577a --- /dev/null +++ b/docs/src/reference/docbook/chain.xml @@ -0,0 +1,114 @@ + + + Message Handler Chain + +
+ Introduction + + The MessageHandlerChain is an implementation of + MessageHandler that can be configured as a single Message Endpoint while + actually delegating to a chain of other handlers, such as Filters, Transformers, Splitters, and so on. + This can lead to a much simpler configuration when several handlers need to be connected in a fixed, linear + progression. For example, it is fairly common to provide a Transformer before other components. Similarly, when + providing a Filter before some other component in a chain, you are essentially creating a + Selective Consumer. In either case, the + chain only requires a single input-channel and a single output-channel as opposed to the configuration of + channels for each individual component. + + Spring Integration's Filter provides a boolean property 'throwExceptionOnRejection'. When + providing multiple Selective Consumers on the same point-to-point channel with different acceptance criteria, + this value should be set to 'true' (the default is false) so that the dispatcher will know that the Message was + rejected and as a result will attempt to pass the Message on to other subscribers. If the Exception were not + thrown, then it would appear to the dispatcher as if the Message had been passed on successfully even though + the Filter had dropped the Message to prevent further processing. + + + + The handler chain simplifies configuration while internally maintaining the same degree of loose coupling between + components, and it is trivial to modify the configuration if at some point a non-linear arrangement is required. + + + Internally, the chain will be expanded into a linear setup of the listed endpoints, separated by direct channels. + The reply channel header will not be taken into account within the chain: only after the last handler is invoked + will the resulting message be forwarded on to the reply channel or the chain's output channel. Because of this + setup all handlers except the last require a setOutputChannel implementation. The last + handler only needs an output channel if the outputChannel on the MessageHandlerChain is set. + + + As with other endpoints, the output-channel is optional. If there is a reply Message at the end of the + chain, the output-channel takes precedence, but if not available, the chain handler will check for a + reply channel header on the inbound Message. + + + + + In most cases there is no need to implement MessageHandlers yourself. The next section will focus on namespace + support for the chain element. Most Spring Integration endpoints, like Service Activators and Transformers, are + suitable for use within a MessageHandlerChain. + +
+ +
+ The <chain> Element + + The <chain> element provides an 'input-channel' attribute, and if the last element in the chain is capable + of producing reply messages (optional), it also supports an 'output-channel' attribute. The sub-elements are then + filters, transformers, splitters, and service-activators. The last element may also be a router. + + + +
+ + + ]]> + + + The <header-enricher> element used in the above example will set a message header with name "foo" and + value "bar" on the message. A header enricher is a specialization of Transformer that touches only header + values. You could obtain the same result by implementing a MessageHandler that did the header modifications + and wiring that as a bean. + + + + Some time you need to make a nested call to another chain from within the chain and then come + back and continue execution within the original chain. + To accomplish this you can utilize Messaging Gateway by including light-configuration via <gateway> element. + For example: + + + + + + + +   + + + + + +   + + + + + + + + + + + + ]]> + +In the above example the nested-chain-a will be called at the end of main-chain processing by the 'gateway' element +configured there. While in nested-chain-a a call to a nested-chain-b will be made after header enrichment and then it will +come back to finish execution in nested-chain-b finally getting back to the main-chain. +When light version of <gateway> element is defined in the chain SI will construct an instance SimpleMessagingGateway + (no need to provide 'service-interface' configuration) which will take the message in its current state and will place it on the channel defined via 'request-channel' attribute. + Upon processing Message will be returned to the gateway and continue its journey within the current chain. + +
+ +
diff --git a/docs/src/reference/docbook/channel-adapter.xml b/docs/src/reference/docbook/channel-adapter.xml new file mode 100644 index 0000000000..c14d6db69f --- /dev/null +++ b/docs/src/reference/docbook/channel-adapter.xml @@ -0,0 +1,78 @@ + + + + Channel Adapter + + A Channel Adapter is a Message Endpoint that enables connecting a single sender or receiver to a Message Channel. + Spring Integration provides a number of adapters out of the box to support various transports, such as JMS, File, + HTTP, Web Services, and Mail. Those will be discussed in upcoming chapters of this reference guide. However, this + chapter focuses on the simple but flexible Method-invoking Channel Adapter support. There are both inbound and + outbound adapters, and each may be configured with XML elements provided in the core namespace. + + +
+ The <inbound-channel-adapter> element + + An "inbound-channel-adapter" element can invoke any method on a Spring-managed Object and send a non-null return + value to a MessageChannel after converting it to a Message. + When the adapter's subscription is activated, a poller will attempt to receive messages from the source. The + poller will be scheduled with the TaskScheduler according to the provided + configuration. To configure the polling interval or cron expression for an individual channel-adapter, + provide a 'poller' element with either an 'interval-trigger' (in milliseconds) or 'cron-trigger' + sub-element. + + + + + + +]]> + + + + If no poller is provided, then a single default poller must be registered within the context. + See for more detail. + + +
+ +
+ The <outbound-channel-adapter/> element + + An "outbound-channel-adapter" element can also connect a MessageChannel to any POJO consumer + method that should be invoked with the payload of Messages sent to that channel. + ]]> + If the channel being adapted is a PollableChannel, provide a poller sub-element: + + ]]> +]]> + +]]> + + + Using a "ref" attribute is generally recommended if the POJO consumer implementation can be reused + in other <outbound-channel-adapter> definitions. However if the consumer implementation + should be scoped to a single definition of the <outbound-channel-adapter>, you can define it as inner bean: + + + ]]> +]]> + + + + Using both the "ref" attribute and an inner handler definition in the same <outbound-channel-adapter> + configuration is not allowed, as it creates an ambiguous condition and will result in an Exception being thrown. + + + + Any Channel Adapter can be created without a "channel" reference in which case it will implicitly create an + instance of DirectChannel. The created channel's name will match the "id" attribute + of the <inbound-channel-adapter/> or <outbound-channel-adapter>l; element. Therefore, if the "channel" + is not provided, the "id" is required. + +
+ +
\ No newline at end of file diff --git a/docs/src/reference/docbook/channel.xml b/docs/src/reference/docbook/channel.xml new file mode 100644 index 0000000000..c4babca116 --- /dev/null +++ b/docs/src/reference/docbook/channel.xml @@ -0,0 +1,602 @@ + + + Message Channels + + While the Message plays the crucial role of encapsulating data, it is the + MessageChannel that decouples message producers from message consumers. + + +
+ The MessageChannel Interface + + Spring Integration's top-level MessageChannel interface is defined as follows. + + When sending a message, the return value will be true if the message is sent successfully. + If the send call times out or is interrupted, then it will return false. + + +
+ PollableChannel + + Since Message Channels may or may not buffer Messages (as discussed in the overview), there are two + sub-interfaces defining the buffering (pollable) and non-buffering (subscribable) channel behavior. Here is the + definition of PollableChannel. + public interface PollableChannel extends MessageChannel { + + Message<?> receive(); + + Message<?> receive(long timeout); + + List<Message<?>> clear(); + + List<Message<?>> purge(MessageSelector selector); + +} + Similar to the send methods, when receiving a message, the return value will be null in the + case of a timeout or interrupt. + +
+ +
+ SubscribableChannel + + The SubscribableChannel base interface is implemented by channels that send + Messages directly to their subscribed MessageHandlers. Therefore, they do not + provide receive methods for polling, but instead define methods for managing those subscribers: + public interface SubscribableChannel extends MessageChannel { + + boolean subscribe(MessageHandler handler); + + boolean unsubscribe(MessageHandler handler); + +} + +
+
+ +
+ Message Channel Implementations + + Spring Integration provides several different Message Channel implementations. Each is briefly described in the + sections below. + +
+ PublishSubscribeChannel + + The PublishSubscribeChannel implementation broadcasts any Message + sent to it to all of its subscribed handlers. This is most often used for sending + Event Messages whose primary role is notification as opposed to + Document Messages which are generally intended to be processed by + a single handler. Note that the PublishSubscribeChannel is + intended for sending only. Since it broadcasts to its subscribers directly when its + send(Message) method is invoked, consumers cannot poll for + Messages (it does not implement PollableChannel and + therefore has no receive() method). Instead, any subscriber + must be a MessageHandler itself, and the subscriber's + handleMessage(Message) method will be invoked in turn. + +
+
+ QueueChannel + + The QueueChannel implementation wraps a queue. Unlike the + PublishSubscribeChannel, the QueueChannel has point-to-point + semantics. In other words, even if the channel has multiple consumers, only one of them should receive any + Message sent to that channel. It provides a default no-argument constructor (providing an essentially unbounded + capacity of Integer.MAX_VALUE) as well as a constructor that accepts the queue capacity: + public QueueChannel(int capacity) + A channel that has not reached its capacity limit will store messages in its internal queue, and the + send() method will return immediately even if no receiver is ready to handle the + message. If the queue has reached capacity, then the sender will block until room is available. Or, if using + the send call that accepts a timeout, it will block until either room is available or the timeout period + elapses, whichever occurs first. Likewise, a receive call will return immediately if a message is available + on the queue, but if the queue is empty, then a receive call may block until either a message is available + or the timeout elapses. In either case, it is possible to force an immediate return regardless of the + queue's state by passing a timeout value of 0. Note however, that calls to the no-arg versions of + send() and receive() will block indefinitely. + +
+
+ PriorityChannel + + Whereas the QueueChannel enforces first-in/first-out (FIFO) ordering, the + PriorityChannel is an alternative implementation that allows for messages + to be ordered within the channel based upon a priority. By default the priority is determined by the + 'priority' header within each message. However, for custom priority determination + logic, a comparator of type Comparator<Message<?>> can be provided + to the PriorityChannel's constructor. + +
+
+ RendezvousChannel + + The RendezvousChannel enables a "direct-handoff" scenario where a sender will block + until another party invokes the channel's receive() method or vice-versa. Internally, + this implementation is quite similar to the QueueChannel except that it uses a + SynchronousQueue (a zero-capacity implementation of + BlockingQueue). This works well in situations where the sender and receiver are + operating in different threads but simply dropping the message in a queue asynchronously is not appropriate. + In other words, with a RendezvousChannel at least the sender knows that some receiver + has accepted the message, whereas with a QueueChannel, the message would have been + stored to the internal queue and potentially never received. + + + + Keep in mind that all of these queue-based channels are storing messages in-memory only. When persistence + is required, you can either invoke a database operation within a handler or use Spring Integration's + support for JMS-based Channel Adapters. The latter option allows you to take advantage of any JMS provider's + implementation for message persistence, and it will be discussed in . However, when + buffering in a queue is not necessary, the simplest approach is to rely upon the + DirectChannel discussed next. + + + + The RendezvousChannel is also useful for implementing request-reply + operations. The sender can create a temporary, anonymous instance of RendezvousChannel + which it then sets as the 'replyChannel' header when building a Message. After sending that Message, the sender + can immediately call receive (optionally providing a timeout value) in order to block while waiting for a reply + Message. This is very similar to the implementation used internally by many of Spring Integration's + request-reply components. + +
+
+ DirectChannel + + The DirectChannel has point-to-point semantics but otherwise is more similar to the + PublishSubscribeChannel than any of the queue-based channel implementations described + above. It implements the SubscribableChannel interface instead of the + PollableChannel interface, so it dispatches Messages directly to a subscriber. + As a point-to-point channel, however, it differs from the PublishSubscribeChannel in + that it will only send each Message to a single subscribed + MessageHandler. + + + In addition to being the simplest point-to-point channel option, one of its most important features is that + it enables a single thread to perform the operations on "both sides" of the channel. For example, if a handler + is subscribed to a DirectChannel, then sending a Message to that channel will trigger + invocation of that handler's handleMessage(Message) method directly in the + sender's thread, before the send() method invocation can return. + + + The key motivation for providing a channel implementation with this behavior is to support transactions that + must span across the channel while still benefiting from the abstraction and loose coupling that the channel + provides. If the send call is invoked within the scope of a transaction, then the outcome of the handler's + invocation (e.g. updating a database record) will play a role in determining the ultimate result of that + transaction (commit or rollback). + + Since the DirectChannel is the simplest option and does not add any additional + overhead that would be required for scheduling and managing the threads of a poller, it is the default + channel type within Spring Integration. The general idea is to define the channels for an application and + then to consider which of those need to provide buffering or to throttle input, and then modify those to + be queue-based PollableChannels. Likewise, if a channel needs to broadcast + messages, it should not be a DirectChannel but rather a + PublishSubscribeChannel. Below you will see how each of these can be configured. + + + + The DirectChannel internally delegates to a Message Dispatcher to invoke its + subscribed Message Handlers, and that dispatcher can have a load-balancing strategy. The load-balancer + determines how invocations will be ordered in the case that there are multiple handlers subscribed to the + same channel. When using the namespace support described below, the default strategy is + "round-robin" which essentially load-balances across the handlers in rotation. + + The "round-robin" strategy is currently the only implementation available out-of-the-box in Spring + Integration. Other strategy implementations may be added in future versions. + + + + The load-balancer also works in combination with a boolean failover property. + If the "failover" value is true (the default), then the dispatcher will fall back to any subsequent + handlers as necessary when preceding handlers throw Exceptions. The order is determined by an optional + order value defined on the handlers themselves or, if no such value exists, the order in which the + handlers are subscribed. + + + If a certain situation requires that the dispatcher always try to invoke the first handler, then + fallback in the same fixed order sequence every time an error occurs, no load-balancing strategy should + be provided. In other words, the dispatcher still supports the failover boolean property even when no + load-balancing is enabled. Without load-balancing, however, the invocation of handlers will always begin + with the first according to their order. For example, this approach works well when there is a clear + definition of primary, secondary, tertiary, and so on. When using the namespace support, the "order" + attribute on any endpoint will determine that order. + + + Keep in mind that load-balancing and failover only apply when a channel has more than one + subscribed Message Handler. When using the namespace support, this means that more than one + endpoint shares the same channel reference in the "input-channel" attribute. + +
+
+ ExecutorChannel + + The ExecutorChannel is a point-to-point channel that supports + the same dispatcher configuration as DirectChannel (load-balancing strategy + and the failover boolean property). The key difference between these two dispatching channel types + is that the ExecutorChannel delegates to an instance of + TaskExecutor to perform the dispatch. This means that the send method + typically will not block, but it also means that the handler invocation may not occur in the sender's + thread. It therefore does not support transactions spanning the sender and receiving + handler. + + Note that there are occasions where the sender may block. For example, when using a + TaskExecutor with a rejection-policy that throttles back on the client (such as the + ThreadPoolExecutor.CallerRunsPolicy), the sender's thread will execute + the method directly anytime the thread pool is at its maximum capacity and the + executor's work queue is full. Since that situation would only occur in a non-predictable + way, that obviously cannot be relied upon for transactions. + + +
+
+ ThreadLocalChannel + + The final channel implementation type is ThreadLocalChannel. This channel also delegates + to a queue internally, but the queue is bound to the current thread. That way the thread that sends to the + channel will later be able to receive those same Messages, but no other thread would be able to access them. + While probably the least common type of channel, this is useful for situations where + DirectChannels are being used to enforce a single thread of operation but any reply + Messages should be sent to a "terminal" channel. If that terminal channel is a + ThreadLocalChannel, the original sending thread can collect its replies from it. + +
+
+ +
+ Channel Interceptors + + One of the advantages of a messaging architecture is the ability to provide common behavior and capture + meaningful information about the messages passing through the system in a non-invasive way. Since the + Messages are being sent to and received from + MessageChannels, those channels provide an opportunity for intercepting + the send and receive operations. The ChannelInterceptor strategy interface + provides methods for each of those operations: + preSend(Message message, MessageChannel channel); + + void postSend(Message message, MessageChannel channel, boolean sent); + + boolean preReceive(MessageChannel channel); + + Message postReceive(Message message, MessageChannel channel); +}]]> + After implementing the interface, registering the interceptor with a channel is just a matter of calling: + channel.addInterceptor(someChannelInterceptor); + The methods that return a Message instance can be used for transforming the Message or can return 'null' + to prevent further processing (of course, any of the methods can throw a RuntimeException). Also, the + preReceive method can return 'false' to prevent the receive + operation from proceeding. + + Keep in mind that receive() calls are only relevant for + PollableChannels. In fact the + SubscribableChannel interface does not even define a + receive() method. The reason for this is that when a Message is sent to a + SubscribableChannel it will be sent directly to one or more subscribers + depending on the type of channel (e.g. a PublishSubscribeChannel sends to all of its subscribers). Therefore, + the preReceive(..) and postReceive(..) interceptor methods + are only invoked when the interceptor is applied to a PollableChannel. + + Spring Integration also provides an implementation of the + Wire Tap pattern. + It is a simple interceptor that sends the Message to another channel without otherwise altering the + existing flow. It can be very useful for debugging and monitoring. An example is shown in + . + + + Because it is rarely necessary to implement all of the interceptor methods, a + ChannelInterceptorAdapter class is also available for sub-classing. It provides no-op + methods (the void method is empty, the Message returning methods + return the Message as-is, and the boolean method returns true). + Therefore, it is often easiest to extend that class and just implement the method(s) that you need as in the + following example. + preSend(Message message, MessageChannel channel) { + sendCount.incrementAndGet(); + return message; + } +}]]> + + The order of invocation for the interceptor methods depends on the type of channel. As described above, + the queue-based channels are the only ones where the receive method is intercepted in the first place. + Additionally, the relationship between send and receive interception depends on the timing of separate + sender and receiver threads. For example, if a receiver is already blocked while waiting for a message + the order could be: preSend, preReceive, postReceive, postSend. However, if a receiver polls after the + sender has placed a message on the channel and already returned, the order would be: preSend, postSend, + (some-time-elapses) preReceive, postReceive. The time that elapses in such a case depends on a number + of factors and is therefore generally unpredictable (in fact, the receive may never happen!). + Obviously, the type of queue also plays a role (e.g. rendezvous vs. priority). The bottom line is that + you cannot rely on the order beyond the fact that preSend will precede postSend and preReceive will + precede postReceive. + + +
+ +
+ MessagingTemplate + + As you will see when the endpoints and their various configuration options are introduced, Spring Integration + provides a foundation for messaging components that enables non-invasive invocation of your application code + from the messaging system. However, sometimes it is necessary to invoke the messaging system + from your application code. For convenience when implementing such use-cases, Spring + Integration provides a MessagingTemplate that supports a variety of operations across + the Message Channels, including request/reply scenarios. For example, it is possible to send a request + and wait for a reply. + MessagingTemplate template = new MessagingTemplate(); + +Message reply = template.sendAndReceive(new StringMessage("test"), someChannel); + In that example, a temporary anonymous channel would be created internally by the template. The + 'sendTimeout' and 'receiveTimeout' properties may also be set on the template, and other exchange + types are also supported. + message, final MessageChannel channel) { ... } + +public Message sendAndReceive(final Message request, final MessageChannel channel) { .. } + +public Message receive(final PollableChannel channel) { ... }]]> + + + + A less invasive approach that allows you to invoke simple interfaces with payload and/or header + values instead of Message instances is described in . + + +
+ +
+ Configuring Message Channels + + To create a Message Channel instance, you can use the 'channel' element: + <channel id="exampleChannel"/> + + + The default channel type is Point to Point. To create a + Publish Subscribe channel, use the "publish-subscribe-channel" element: + <publish-subscribe-channel id="exampleChannel"/> + + + To create a Datatype Channel that only + accepts messages containing a certain payload type, provide the fully-qualified class name in the + channel element's datatype attribute: + ]]> + Note that the type check passes for any type that is assignable to the channel's + datatype. In other words, the "numberChannel" above would accept messages whose payload is + java.lang.Integer or java.lang.Double. Multiple types can be + provided as a comma-delimited list: + ]]> + + + When using the "channel" element without any sub-elements, it will create a DirectChannel + instance (a SubscribableChannel). + + + However, you can alternatively provide a variety of "queue" sub-elements to create any of + the pollable channel types (as described in + ). Examples of each are shown below. + +
+ DirectChannel Configuration + + As mentioned above, DirectChannel is the default type. + ]]> + + + A default channel will have a round-robin load-balancer and will also have + failover enabled (See the discussion in + for more detail). To disable one or both of these, add a <dispatcher/> sub-element and + configure the attributes: + + + + + + + +]]> + +
+
+ QueueChannel Configuration + + To create a QueueChannel, use the "queue" sub-element. + You may specify the channel's capacity: + <channel id="queueChannel"> + <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 is highly + recommended to set an explicit value for a bounded queue. + + +
+
+ PublishSubscribeChannel Configuration + + To create a PublishSubscribeChannel, use the "publish-subscribe-channel" element. + When using this element, you can also specify the "task-executor" used for publishing + Messages (if none is specified it simply publishes in the sender's thread): + <publish-subscribe-channel id="pubsubChannel" task-executor="someExecutor"/> + If you are providing a Resequencer or Aggregator downstream + from a PublishSubscribeChannel, then you can set the 'apply-sequence' property + on the channel to true. That will indicate that the channel should set the sequence-size + and sequence-number Message headers as well as the correlation id 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. + <publish-subscribe-channel id="pubsubChannel" apply-sequence="true"/> + + The 'apply-sequence' value is false by default so that a Publish Subscribe Channel + can send the exact same Message instances to multiple outbound channels. Since Spring Integration + enforces immutability of the payload and header references, the channel creates new Message + instances with the same payload reference but different header values when the flag is set to + true. + + +
+
+ ExecutorChannel + + To create an ExecutorChannel, add the <dispatcher> sub-element along + with a 'task-executor' attribute. Its value can reference any TaskExecutor + within the context. For example, this enables configuration of a thread-pool for dispatching messages + to subscribed handlers. As mentioned above, this does break the "single-threaded" execution context + between sender and receiver so that any active transaction context will not be shared by the invocation + of the handler (i.e. the handler may throw an Exception, but the send invocation has already returned + successfully). + + +]]> + + + The "load-balancer" and "failover" options are also both available on the dispatcher sub-element + as described above in . The same defaults + apply as well. So, the channel will have a round-robin load-balancing strategy with failover + enabled unless explicit configuration is provided for one or both of those attributes. + + +]]> + +
+
+ PriorityChannel Configuration + + To create a PriorityChannel, use the "priority-queue" sub-element: + + +]]> + By default, the channel will consult the MessagePriority header of the + message. However, a custom Comparator reference may be + provided instead. Also, note that the PriorityChannel (like the other types) + does support the "datatype" attribute. As with the QueueChannel, it also supports a "capacity" attribute. + The following example demonstrates all of these: + + + +]]> + +
+
+ RendezvousChannel Configuration + + A RendezvousChannel is created when the queue sub-element is + a <rendezvous-queue>. It does not provide any additional configuration options to + those described above, and its queue does not accept any capacity value since it is a + 0-capacity direct handoff queue. + + + +]]> + +
+
+ ThreadLocalChannel Configuration + + The ThreadLocalChannel does not provide any additional configuration options. + ]]> + +
+ +
+ Channel Interceptor Configuration + + Message channels may also have interceptors as described in . The + <interceptors> sub-element can be added within <channel> (or the more specific element + types). Provide the "ref" attribute to reference any Spring-managed object that implements the + ChannelInterceptor interface: + + ]]> + + ]]>]]> + In general, it is a good idea to define the interceptor implementations in a separate location since they + usually provide common behavior that can be reused across multiple channels. + +
+ +
+ Global Channel Interceptor Configuration + + Channel Interceptors allow you for a clean and concise way of applying cross-cutting behavior per individual channel. + But what if the same behavior should be applied on multiple channels, configuring the same set of interceptors for + each channel would not be the most efficient way. The better way would be to configure interceptors globally and apply + them on multiple channels in one shot. Spring Integration provides capabilities to configure Global Interceptors + and apply them on multiple channels. + Look at the example below: + + +]]> + or + + +]]> + <channel-interceptor> element allows you to define a global interceptor which will be applied on all + channels that match patterns defined via pattern attribute. In the above case the global interceptor will be applied on + 'foo' channel and all other channels that begin with 'bar' and 'input'. + The order attribute allows you to manage the place where this interceptor will be injected. + For example, channel 'inputChannel' could have individual interceptors configured locally (see below): +   + +   + +]]> + The reasonable question would be how global interceptor will be injected in relation to other interceptors + configured locally or through other global interceptor definitions? Current implementation provides + a very simple and clever mechanism of handling this. Positive number in the order attribute will ensure interceptor injection + after existing interceptors and negative number will ensure that such interceptors injected before. + This means that in the above example global interceptor will be injected AFTER (since its order is greater then 0) + 'wire-tap' interceptor configured locally. If there was another global interceptor with matching pattern their + order would be determined based on who's got the higher or lower value in order attribute. + To inject global interceptor BEFORE the existing interceptors use negative value for the order attribute. + + + Note that order and pattern attributes are optional. The default value for order + will be 0 and for pattern is '*' + +
+ +
+ Wire Tap + + As mentioned above, Spring Integration provides a simple Wire Tap interceptor out of + the box. You can configure a Wire Tap on any channel within an 'interceptors' element. + This is especially useful for debugging, and can be used in conjunction with Spring Integration's logging + Channel Adapter as follows: + + + + + + ]]> + + The 'logging-channel-adapter' also accepts a boolean attribute: 'log-full-message'. + That is false by default so that only the payload is logged. Setting that to + true enables logging of all headers in addition to the payload. + + +
+ + + + If namespace support is enabled, there are also two special channels defined within the context by default: + errorChannel and nullChannel. The 'nullChannel' acts like /dev/null, + simply logging any Message sent to it at DEBUG level and returning immediately. Any time you face channel + resolution errors for a reply that you don't care about, you can set the affected component's 'output-channel' + to reference 'nullChannel' (the name 'nullChannel' is reserved within the context). The 'errorChannel' is + used internally for sending error messages, and it can be overridden with a custom configuration. It is + discussed in greater detail in . + + +
+ +
diff --git a/docs/src/reference/docbook/configuration.xml b/docs/src/reference/docbook/configuration.xml new file mode 100644 index 0000000000..54271bab9d --- /dev/null +++ b/docs/src/reference/docbook/configuration.xml @@ -0,0 +1,463 @@ + + + Configuration +
+ Introduction + + Spring Integration offers a number of configuration options. Which option you choose depends upon your particular + needs and at what level you prefer to work. As with the Spring framework in general, it is also possible to mix + and match the various techniques according to the particular problem at hand. For example, you may choose the + XSD-based namespace for the majority of configuration combined with a handful of objects that are configured with + annotations. As much as possible, the two provide consistent naming. XML elements defined by the XSD schema will + match the names of annotations, and the attributes of those XML elements will match the names of annotation + properties. Direct usage of the API is of course always an option, but we expect that most users will choose one + of the higher-level options, or a combination of the namespace-based and annotation-driven configuration. + +
+ +
+ Namespace Support + + Spring Integration components can be configured with XML elements that map directly to the terminology and + concepts of enterprise integration. In many cases, the element names match those of the + Enterprise Integration Patterns. + + + To enable Spring Integration's core namespace support within your Spring configuration files, add the following + namespace reference and schema mapping in your top-level 'beans' element: + xmlns:integration="http://www.springframework.org/schema/integration"http://www.springframework.org/schema/integration + http://www.springframework.org/schema/integration/spring-integration-2.0.xsd"> + + + You can choose any name after "xmlns:"; integration is used here for clarity, but you might + prefer a shorter abbreviation. Of course if you are using an XML-editor or IDE support, then the availability of + auto-completion may convince you to keep the longer name for clarity. Alternatively, you can create configuration + files that use the Spring Integration schema as the primary namespace: + <beans:beans xmlns="http://www.springframework.org/schema/integration"xmlns:beans="http://www.springframework.org/schema/beans"]]> + + + When using this alternative, no prefix is necessary for the Spring Integration elements. On the other hand, if + you want to define a generic Spring "bean" within the same configuration file, then a prefix would be required + for the bean element (<beans:bean ... />). Since it is generally a good idea to modularize the + configuration files themselves based on responsibility and/or architectural layer, you may find it appropriate to + use the latter approach in the integration-focused configuration files, since generic beans are seldom necessary + within those same files. For purposes of this documentation, we will assume the "integration" namespace is + primary. + + + Many other namespaces are provided within the Spring Integration distribution. In fact, each adapter type (JMS, + File, etc.) that provides namespace support defines its elements within a separate schema. In order to use these + elements, simply add the necessary namespaces with an "xmlns" entry and the corresponding "schemaLocation" mapping. + For example, the following root element shows several of these namespace declarations: + + + ... +]]> + The reference manual provides specific examples of the various elements in their corresponding chapters. Here, the + main thing to recognize is the consistency of the naming for each namespace URI and schema location. + +
+ +
+ Configuring the Task Scheduler + + In Spring Integration, the ApplicationContext plays the central role of a Message Bus, and there are only a + couple configuration options to be aware of. First, you may want to control the central TaskScheduler instance. + You can do so by providing a single bean with the name "taskScheduler". This is also defined as a constant: + + By default Spring Integration uses the SimpleTaskScheduler implementation. That in turn + just delegates to any instance of Spring's TaskExecutor abstraction. Therefore, + it's rather trivial to supply your own configuration. The "taskScheduler" bean is then responsible for managing + all pollers. The TaskScheduler will startup automatically by default. If you provide your own instance of + SimpleTaskScheduler however, you can set the 'autoStartup' property to false instead. + + + When Polling Consumers provide an explicit task-executor reference in their configuration, the invocation of + the handler methods will happen within that executor's thread pool and not the main scheduler pool. However, + when no task-executor is provided for an endpoint's poller, it will be invoked by one of the main scheduler's + threads. + + An endpoint is a Polling Consumer if its input channel is one of the queue-based + (i.e. pollable) channels. On the other hand, Event Driven Consumers are those whose + input channels have dispatchers instead of queues (i.e. they are subscribable). Such endpoints have no + poller configuration since their handlers will be invoked directly. + + + The next section will describe what happens if Exceptions occur within the asynchronous invocations. + + +
+ +
+ Error Handling + + As described in the overview at the very beginning of this manual, one of the main motivations behind a + Message-oriented framework like Spring Integration is to promote loose-coupling between components. The + Message Channel plays an important role in that producers and consumers do not have to know about each + other. However, the advantages also have some drawbacks. Some things become more complicated in a very + loosely coupled environment, and one example is error handling. + + + When sending a Message to a channel, the component that ultimately handles that Message may or may not + be operating within the same thread as the sender. If using a simple default DirectChannel (with the + <channel> element that has no <queue> sub-element and no 'task-executor' attribute), the + Message-handling will occur in the same thread as the Message-sending. In that case, if an Exception + is thrown, it can be caught by the sender (or it may propagate past the sender if it is an uncaught + RuntimeException). So far, everything is fine. This is the same behavior as an Exception-throwing + operation in a normal call stack. However, when adding the asynchronous aspect, things become much + more complicated. For instance, if the 'channel' element does provide a 'queue' + sub-element, then the component that handles the Message will be operating in a + different thread than the sender. The sender may have dropped the Message into the channel and moved + on to other things. There is no way for the Exception to be thrown directly back to that sender using + standard Exception throwing techniques. Instead, to handle errors for asynchronous processes requires + an asynchronous error-handling mechanism as well. + + + Spring Integration supports error handling for its components by publishing errors to a Message Channel. + Specifically, the Exception will become the payload of a Spring Integration Message. That Message will + then be sent to a Message Channel that is resolved in a way that is similar to the 'replyChannel' + resolution. First, if the request Message being handled at the time the Exception occurred contains + an 'errorChannel' header (the header name is defined in the constant: MessageHeaders.ERROR_CHANNEL), + the ErrorMessage will be sent to that channel. Otherwise, the error handler will send to a "global" + channel whose bean name is "errorChannel" (this is also defined as a constant: + IntegrationContextUtils.ERROR_CHANNEL_BEAN_NAME). + + + Whenever relying on Spring Integration's XML namespace support, a default "errorChannel" bean will be + created behind the scenes. However, you can just as easily define your own if you want to control the + settings. + + + ]]> + + The default "errorChannel" is a PublishSubscribeChannel. + + + + The most important thing to understand here is that the messaging-based error handling will only apply + to Exceptions that are thrown by a Spring Integration task that is executing within a TaskExecutor. + This does not apply to Exceptions thrown by a handler that is operating within + the same thread as the sender (e.g. through a DirectChannel as described above). + + + When Exceptions occur in a scheduled poller task's execution, those exceptions will be wrapped in + ErrorMessages and sent to the 'errorChannel' as well. + + + To enable global error handling, simply register a handler on that channel. For example, you can configure + Spring Integration's ErrorMessageExceptionTypeRouter as the handler of an endpoint + that is subscribed to the 'errorChannel'. That router can then spread the error messages across multiple + channels based on Exception type. + +
+ +
+ Annotation Support + + In addition to the XML namespace support for configuring Message Endpoints, it is also possible to use + annotations. First, Spring Integration provides the class-level @MessageEndpoint + as a stereotype annotation meaning that is itself annotated with Spring's @Component + annotation and therefore is recognized automatically as a bean definition when using Spring component-scanning. + + + Even more importantly are the various Method-level annotations that indicate the annotated method is capable of + handling a message. The following example demonstrates both: + @MessageEndpoint +public class FooService { + + @ServiceActivator + public void processMessage(Message message) { + ... + } +} + + + Exactly what it means for the method to "handle" the Message depends on the particular annotation. The following + are available with Spring Integration, and the behavior of each is described in its own chapter or section within + this reference: @Transformer, @Router, @Splitter, @Aggregator, @ServiceActivator, and @ChannelAdapter. + + + The @MessageEndpoint is not required if using XML configuration in combination with annotations. If you want to + configure a POJO reference from the "ref" attribute of a <service-activator/> element, it is sufficient to + provide the method-level annotations. In that case, the annotation prevents ambiguity even when no "method" + attribute exists on the <service-activator/> element. + + + In most cases, the annotated handler method should not require the Message type as its + parameter. Instead, the method parameter type can match the message's payload type. + public class FooService { + + @ServiceActivator + public void bar(Foo foo) { + ... + } + +} + + + When the method parameter should be mapped from a value in the MessageHeaders, another + option is to use the parameter-level @Header annotation. In general, methods + annotated with the Spring Integration annotations can either accept the Message itself, the + message payload, or a header value (with @Header) as the parameter. In fact, the method can accept a combination, + such as: + public class FooService { + + @ServiceActivator + public void bar(String payload, @Header("x") int valueX, @Header("y") int valueY) { + ... + } + +} + There is also a @Headers annotation that provides all of the Message headers as a Map: + public class FooService { + + @ServiceActivator + public void bar(String payload, @Headers Map<String, Object> headerMap) { + ... + } + +} + + + For several of these annotations, when a Message-handling method returns a non-null value, the endpoint will + attempt to send a reply. This is consistent across both configuration options (namespace and annotations) in + that such an endpoint's output channel will be used if available, and the REPLY_CHANNEL message header value + will be used as a fallback. + + + The combination of output channels on endpoints and the reply channel message header enables a pipeline approach + where multiple components have an output channel, and the final component simply allows the reply message to be + forwarded to the reply channel as specified in the original request message. In other words, the final component + depends on the information provided by the original sender and can dynamically support any number of clients as a + result. This is an example of Return Address. + + + In addition to the examples shown here, these annotations also support inputChannel and outputChannel properties. + public class FooService { + + @ServiceActivator(inputChannel="input", outputChannel="output") + public void bar(String payload, @Headers Map<String, Object> headerMap) { + ... + } + +} + That provides a pure annotation-driven alternative to the XML configuration. However, it is generally recommended + to use XML for the endpoints, since it is easier to keep track of the overall configuration in a single, external + location (and besides the namespace-based XML configuration is not very verbose). If you do prefer to provide + channels with the annotations however, you just need to enable a SI Annotations BeanPostProcessor. The following element should + be added: ]]> + + When configuring the "inputChannel" and "outputChannel" with annotations, the "inputChannel" + must be a reference to a SubscribableChannel instance. + Otherwise, it would be necessary to also provide the full poller configuration via annotations, and those + settings (e.g. the trigger for scheduling the poller) should be externalized rather than hard-coded within + an annotation. If the input channel that you want to receive Messages from is indeed a + PollableChannel instance, one option to consider is the Messaging Bridge. + Spring Integration's "bridge" element can be used to connect a PollableChannel directly to a + SubscribableChannel. Then, the polling metadata is externally configured, but the annotation option is + still available. For more detail see . + + +
+ +
+ Message Mapping rules and conventions + Spring Integration implements a flexible facility to map Messages to Methods and their arguments without + providing extra configuration by relying on some default rules as well as defining certain conventions. + +
+ Simple Scenarios + + + Single un-annotated parameter (object or primitive) which is not a Map/Properties with non-void return type; + + public String foo(Object o); + Details: + Input parameter is Message Payload. If parameter type is not compatible with Message Payload an + attempt will be made to convert it using Conversion Service provided by Spring 3.0. The return value + will be incorporated as a Payload of the returned Message + + + Single un-annotated parameter (object or primitive) which is not a Map/Properties with Message return type; + + public Message  foo(Object o); + Details: + Input parameter is Message Payload. If parameter type is not compatible with Message Payload an attempt + will be made to convert it using Conversion Service provided by Spring 3.0. The return value is a newly constructed + Message that will be sent to the next destination. + + + Single parameter which is a Message or its subclass with arbitrary object/primitive return type; + + public int foo(Message  msg); + Details: + Input parameter is Message itself. The return value will become a payload of the + Message that will be sent to the next destination. + + + Single parameter which is a Message or its subclass with Message or its subclass as a return type; + + public Message foo(Message msg); + Details: + Input parameter is Message itself. The return value is a newly constructed Message that will be sent to the next destination. + + + Single parameter which is of type Map or Properties with Message as a return type; + + public Message foo(Map m); + Details: + This one is a bit interesting. Although at first it might seem like an easy mapping straight to Message Headers, + the preference is always given to a Message Payload. This means that if Message Payload is of type Map, this input argument will + represent Message Payload. However if Message Payload is not of type Map, then no conversion via Conversion Service will be + attempted and the input argument will be mapped to Message Headers. + + + Two parameters where one of them is arbitrary non-Map/Properties type object/primitive and another is Map/Properties type object (regardless of the return) + + public Message foo(Map h, <T> t); + Details: + This combination contains two input parameters where one of them is of type Map. Naturally the non-Map parameters (regardless of the order) will + be mapped to a Message Payload and the Map/Properties (regardless of the order) will be mapped to  Message Headers giving you a nice POJO way + of interacting with Message structure. + + + No parameters (regardless of the return) + + public String foo(); + Details: + This Message Handler method will be invoked based on the Message sent to the input channel this handler is hooked up to, + however no Message data will be mapped, thus making Message act as event/trigger to invoke such handlerThe output will be + mapped according to the rules above + + + No parameters, void return + + public void foo(); + Details: + Same as above, but no output  + + + Annotation based mappings + + Annotation based mapping is the safest and least ambiguous approach to map Messages to Methods. There wil be many pointers to annotation + based mapping throughout this manual, however here are couple of examples: + + + public String foo(@Payload String s,  @Header("foo") String b)  + Very simple and explicite way of mapping Messages to method. As you'll see later on without annotation this signature + would result in the ambiguous condition, however by explicitly mapping first argument to a Message Payload and second argument to + a value of the 'foo' Message Header we have avoided ambiguity. + + public String foo(@Payload String s,  @RequestParam("foo") String b)  + Looks almost identical to the previous example, however @RequestMapping or any other non-SI mapping annotation + is irrelevant  and therefore will be ignored leaving the second parameter unmapped. And although the second parameters could + easily be mapped to a Payload, there can only be one Payload, therefore this method becomes ambiguous.  + + public String foo(String s,  @Header("foo") String b)  + The same as above. The only difference is that the first argument will be mapped to Message Payload implicitly. + + public String foo(@Headers Map m,  @Header("foo")Map f, @Header("bar") String bar) + Yet another signature that would definitely be treated as ambiguous because it has more then 2 arguments, + plus two of them are Maps, however with annotation-based mapping ambiguity is easily avoided. In this example + the first argument is mapped to all the Message Headers, while second and third argument map to the values of Message Headers 'foo' and 'bar'. +
+ +
+ Complex Scenarios + + Multiple parameters: + Multiple parameters could create a lot of ambiguity with regards to determining the appropriate mappings. The general advice is to annotate your method parameters with @Payload and/or @Header/@Headers +Below are some of the examples of ambiguous conditions which result in exception being raised. + + public String foo(String s, int i) + - the two parameters are equal in weight, therefore no way to determine which one is a payload and what to do with another. + + public String foo(String s, Map m, String b) + - almost the same as above. Although Map could be easily mapped to Message Headers, there is no way to determine what to do with two Strings. + + public String foo(Map m, Map f) + - although one might argue that one Map could be mapped to Message Payload and another one to Message Headers, it would be unreasonable to rely on the order (e.g., first is Payload, second Headers) + + + Basically any method signature with more then one method argument which is not (Map, <T>) and those parameters are not annotated will result in the ambiguous condition thus triggering an exception. + + + Multiple methods: + + Message Handlers with multiple methods are mapped based on the same rules that are described above, however some scenarios might still look confusing. + + Multiple methods (same or different name) with legal (mappable) signatures: + + public class Foo{ + public String foo(String str, Map m); + + public String foo(Map m) +} + As you can see, the Message could be mapped to either method. The first method would be invoked where Message Payload + could be mapped to 'str'  and Message Headers could be mapped to 'm'. The second method could easily also be a candidate where + only Message Headers are mapped to 'm'. To make meters worse both methods have the same name which at first might look very + ambiguous considering the following configuration: + + +]]> + At this point it would be important to understand Spring Integration mapping Conventions where at the very core, + mappings are based on Payload first and everything else next. In other words the method whose argument could be mapped + to a Payload will take precedence over all other methods. + + On the other hand let's look at slightly different example: + public class Foo{ + public String foo(String str, Map m); + + public String foo(String str) +} + + If you look at it you can probably see a truly an ambiguous condition. In this example since both methods have signatures that + could be mapped to a Message Payload. They also have the same name. Such handler will trigger an exception. +However if method names were different you could influence the mapping with 'method' attribute (see below): + public class Foo{ + public String foo(String str, Map m); + + public String bar(String str) +} + + +]]> + + Now there is no ambiguity since the configuration explicitly maps to 'bar' method which has no name conflicts. +
+
+ +
diff --git a/docs/src/reference/docbook/delayer.xml b/docs/src/reference/docbook/delayer.xml new file mode 100644 index 0000000000..3a41f4d63a --- /dev/null +++ b/docs/src/reference/docbook/delayer.xml @@ -0,0 +1,61 @@ + + + Delayer + +
+ Introduction + + A Delayer is a simple endpoint that allows a Message flow to be delayed by a certain interval. When + a Message is delayed, the original sender will not block. Instead, the delayed Messages will be + scheduled with an instance of java.util.concurrent.ScheduledExecutorService + to be sent to the output channel after the delay has passed. This approach is scalable even for + rather long delays, since it does not result in a large number of blocked sender Threads. On the + contrary, in the typical case a thread pool will be used for the actual execution of releasing the + Messages. Below you will find several examples of configuring a Delayer. + +
+ +
+ The <delayer> Element + + The <delayer> element is used to delay the Message flow between two Message Channels. + As with the other endpoints, you can provide the "input-channel" and "output-channel" attributes, + but the delayer also requires at least the 'default-delay' attribute with the number of milliseconds + that each Message should be delayed. + ]]> + If you need per-Message determination of the delay, then you can also provide the name of a header + within the 'delay-header-name' attribute: + ]]> + In the example above the 3 second delay would only apply in the case that the header value is + not present for a given inbound Message. If you only want to apply a delay to Messages that have + an explicit header value, then you can set the 'default-delay' to 0. For any Message that has a + delay of 0 (or less), the Message will be sent directly. In fact, if there is not a positive delay + value for a Message, it will be sent to the output channel on the calling Thread. + + The delay handler actually supports header values that represent an interval in milliseconds (any + Object whose toString() method produces a value that can be parsed into a + Long) as well as java.util.Date instances representing an absolute time. + In the former case, the milliseconds will be counted from the current time (e.g. a value of 5000 + would delay the Message for at least 5 seconds from the time it is received by the Delayer). In + the latter case, with an actual Date instance, the Message will not be released until that Date + occurs. In either case, a value that equates to a non-positive delay, or a Date in the past, will + not result in any delay. Instead, it will be sent directly to the output channel in the original + sender's Thread. + + + + The delayer delegates to an instance of Spring's TaskScheduler abstraction. + The default scheduler is a ThreadPoolTaskScheduler instance with a pool size of 1. + If you want to delegate to a different scheduler, you can provide a reference through the delayer element's + 'scheduler' attribute: + + + ]]> + +
+ +
diff --git a/docs/src/reference/docbook/endpoint.xml b/docs/src/reference/docbook/endpoint.xml new file mode 100644 index 0000000000..de74cbc352 --- /dev/null +++ b/docs/src/reference/docbook/endpoint.xml @@ -0,0 +1,349 @@ + + + Message Endpoints + + The first part of this chapter covers some background theory and reveals quite a bit about the underlying API + that drives Spring Integration's various messaging components. This information can be helpful if you want to + really understand what's going on behind the scenes. However, if you want to get up and running with the + simplified namespace-based configuration of the various elements, feel free to skip ahead to + for now. + + + As mentioned in the overview, Message Endpoints are responsible for connecting the various messaging components to + channels. Over the next several chapters, you will see a number of different components that consume Messages. Some + of these are also capable of sending reply Messages. Sending Messages is quite straightforward. As shown above in + , it's easy to send a Message to a Message Channel. However, + receiving is a bit more complicated. The main reason is that there are two types of consumers: + Polling Consumers and + Event Driven Consumers. + + + Of the two, Event Driven Consumers are much simpler. Without any need to manage and schedule a separate poller + thread, they are essentially just listeners with a callback method. When connecting to one of Spring Integration's + subscribable Message Channels, this simple option works great. However, when connecting to a buffering, pollable + Message Channel, some component has to schedule and manage the polling thread(s). Spring Integration provides + two different endpoint implementations to accommodate these two types of consumers. Therefore, the consumers + themselves can simply implement the callback interface. When polling is required, the endpoint acts as a + "container" for the consumer instance. The benefit is similar to that of using a container for hosting + Message Driven Beans, but since these consumers are simply Spring-managed Objects running within an + ApplicationContext, it more closely resembles Spring's own MessageListener containers. + + +
+ Message Handler + + Spring Integration's MessageHandler interface is implemented by many of the + components within the framework. In other words, this is not part of the public API, and a developer would not + typically implement MessageHandler directly. Nevertheless, it is used by a Message + Consumer for actually handling the consumed Messages, and so being aware of this strategy interface does help in + terms of understanding the overall role of a consumer. The interface is defined as follows: + public interface MessageHandler { + + void handleMessage(Message<?> message); + +} + Despite its simplicity, this provides the foundation for most of the components that will be covered in the + following chapters (Routers, Transformers, Splitters, Aggregators, Service Activators, etc). Those components + each perform very different functionality with the Messages they handle, but the requirements for actually + receiving a Message are the same, and the choice between polling and event-driven behavior is also the same. + Spring Integration provides two endpoint implementations that "host" these callback-based handlers and allow + them to be connected to Message Channels. + +
+ +
+ Event Driven Consumer + + Because it is the simpler of the two, we will cover the Event Driven Consumer endpoint first. You may recall that + the SubscribableChannel interface provides a subscribe() + method and that the method accepts a MessageHandler parameter (as shown in + ): + +subscribableChannel.subscribe(messageHandler); + + Since a handler that is subscribed to a channel does not have to actively poll that channel, this is an + Event Driven Consumer, and the implementation provided by Spring Integration accepts a + a SubscribableChannel and a MessageHandler: + SubscribableChannel channel = (SubscribableChannel) context.getBean("subscribableChannel"); + +EventDrivenConsumer consumer = new EventDrivenConsumer(channel, exampleHandler); + +
+ +
+ Polling Consumer + + Spring Integration also provides a PollingConsumer, and it can be instantiated in + the same way except that the channel must implement PollableChannel: + PollableChannel channel = (PollableChannel) context.getBean("pollableChannel"); + +PollingConsumer consumer = new PollingConsumer(channel, exampleHandler); + + + There are many other configuration options for the Polling Consumer. For example, the trigger is a required property: + +PollingConsumer consumer = new PollingConsumer(channel, handler); + +consumer.setTrigger(new IntervalTrigger(30, TimeUnit.SECONDS)); + Spring Integration currently provides two implementations of the Trigger + interface: IntervalTrigger and CronTrigger. The + IntervalTrigger is typically defined with a simple interval (in milliseconds), but + also supports an 'initialDelay' property and a boolean 'fixedRate' property (the default is false, i.e. + fixed delay): + IntervalTrigger trigger = new IntervalTrigger(1000); +trigger.setInitialDelay(5000); +trigger.setFixedRate(true); + The CronTrigger simply requires a valid cron expression (see the Javadoc for details): + CronTrigger trigger = new CronTrigger("*/10 * * * * MON-FRI"); + + + In addition to the trigger, several other polling-related configuration properties may be specified: + +PollingConsumer consumer = new PollingConsumer(channel, handler); + +consumer.setMaxMessagesPerPoll(10); + +consumer.setReceiveTimeout(5000); + + + The 'maxMessagesPerPoll' property specifies the maximum number of messages to receive within a given poll + operation. This means that the poller will continue calling receive() without waiting + until either null is returned or that max is reached. For example, if a poller has a 10 second + interval trigger and a 'maxMessagesPerPoll' setting of 25, and it is polling a channel that has 100 messages + in its queue, all 100 messages can be retrieved within 40 seconds. It grabs 25, waits 10 seconds, grabs the + next 25, and so on. + + + The 'receiveTimeout' property specifies the amount of time the poller should wait if no messages are + available when it invokes the receive operation. For example, consider two options that seem similar on + the surface but are actually quite different: the first has an interval trigger of 5 seconds and a receive + timeout of 50 milliseconds while the second has an interval trigger of 50 milliseconds and a receive timeout + of 5 seconds. The first one may receive a message up to 4950 milliseconds later than it arrived on the channel + (if that message arrived immediately after one of its poll calls returned). On the other hand, the second + configuration will never miss a message by more than 50 milliseconds. The difference is that the second + option requires a thread to wait, but as a result it is able to respond much more quickly to arriving messages. + This technique, known as "long polling", can be used to emulate event-driven behavior on a polled source. + + + A Polling Consumer may also delegate to a Spring TaskExecutor, and it can + be configured to participate in Spring-managed transactions. The following example shows the configuration of both: + +PollingConsumer consumer = new PollingConsumer(channel, handler); + +TaskExecutor taskExecutor = (TaskExecutor) context.getBean("exampleExecutor"); +consumer.setTaskExecutor(taskExecutor); + +PlatformTransactionManager txManager = (PlatformTransationManager) context.getBean("exampleTxManager"); +consumer.setTransactionManager(txManager); + The examples above show dependency lookups, but keep in mind that these consumers will most often be configured + as Spring bean definitions. In fact, Spring Integration also provides a + FactoryBean that creates the appropriate consumer type based on the type of + channel, and there is full XML namespace support to even further hide those details. The namespace-based + configuration will be featured as each component type is introduced. + + Many of the MessageHandler implementations are also capable of generating reply + Messages. As mentioned above, sending Messages is trivial when compared to the Message reception. Nevertheless, + when and how many reply Messages are sent depends on the handler + type. For example, an Aggregator waits for a number of Messages to arrive and is often + configured as a downstream consumer for a Splitter which may generate multiple + replies for each Message it handles. When using the namespace configuration, you do not strictly need to know + all of the details, but it still might be worth knowing that several of these components share a common base + class, the AbstractReplyProducingMessageHandler, and it provides a + setOutputChannel(..) method. + + +
+ +
+ Namespace Support + + Throughout the reference manual, you will see specific configuration examples for endpoint elements, such as + router, transformer, service-activator, and so on. Most of these will support an "input-channel" attribute and + many will support an "output-channel" attribute. After being parsed, these endpoint elements produce an instance + of either the PollingConsumer or the + EventDrivenConsumer depending on the type of the "input-channel" that is + referenced: PollableChannel or SubscribableChannel + respectively. When the channel is pollable, then the polling behavior is determined based on the endpoint + element's "poller" sub-element and its attributes. For example, a simple interval-based poller with a 1-second interval would be + configured like this: + +]]> + As an alternative to 'fixed-rate' you cna also use 'fixed-delay' attribute. + + + For a poller based on a Cron expression, use the "cron" attribute instead: + + + ]]> + + + If the input channel is a PollableChannel, then the poller configuration is + required. Specifically, as mentioned above, the 'trigger' is a required property of the PollingConsumer class. + Therefore, if you omit the "poller" sub-element for a Polling Consumer endpoint's configuration, an Exception + may be thrown. The exception will also be thrown if you attempt to configure a poller on the element that is + connected to a non-pollable channel. + + + It is also possible to create top-level pollers in which case only a "ref" is required: + + + + + ]]> + In fact, to simplify the configuration, you can define a global default poller. A single top-level poller within + an ApplicationContext may have the default attribute with a value of "true". In that case, any + endpoint with a PollableChannel for its input-channel that is defined within the same ApplicationContext and has + no explicitly configured 'poller' sub-element will use that default. + + + + ]]> + + + Spring Integration also provides transaction support for the pollers so that each receive-and-forward + operation can be performed as an atomic unit-of-work. To configure transactions for a poller, simply add the + <transactional/> sub-element. The attributes for this element should be familiar to anyone who has + experience with Spring's Transaction management: + + +]]> + + + + AOP Advice chains + + + Since Spring transaction support depends on the Proxy mechanism  with TransactionInterceptor (AOP Advice) handling transactional + behavior of the message flow initiated by the poler, some times there is a need to provide extra Advice(s) to handle other + cross cutting behavior associated with the poller. For that poller defines an 'advice-chain' element allowing you to add + more advices - class that  implements MethodInterceptor interface..  + + + + + + + + +]]> +For more information on how to implement MethodInterceptor please refer to AOP sections of Spring +reference manual (section 7 and 8). Advice chain can also be applied on the poller that does not have +any transaction configuration essentially allowing you to enhance the behavior of the message flow initiated by the poller. + + + The polling threads may be executed by any instance of Spring's TaskExecutor + abstraction. This enables concurrency for an endpoint or group of endpoints. As of Spring 3.0, there is a "task" + namespace in the core Spring Framework, and its <executor/> element supports the creation of a simple thread + pool executor. That element accepts attributes for common concurrency settings such as pool-size and queue-capacity. + Configuring a thread-pooling executor can make a substantial difference in how the endpoint performs under load. These + settings are available per-endpoint since the performance of an endpoint is one of the major factors to consider + (the other major factor being the expected volume on the channel to which the endpoint subscribes). To enable + concurrency for a polling endpoint that is configured with the XML namespace support, provide the 'task-executor' + reference on its <poller/> element and then provide one or more of the properties shown below: + + + ]]> + If no 'task-executor' is provided, the consumer's handler will be invoked in the caller's thread. Note that the + "caller" is usually the default TaskScheduler + (see ). Also, keep in mind that the 'task-executor' attribute can + provide a reference to any implementation of Spring's TaskExecutor interface by + specifying the bean name. The "executor" element above is simply provided for convenience. + + + As mentioned in the background section for Polling Consumers above, you can also configure a Polling Consumer + in such a way as to emulate event-driven behavior. With a long receive-timeout and a short interval-trigger, + you can ensure a very timely reaction to arriving messages even on a polled message source. Note that this + will only apply to sources that have a blocking wait call with a timeout. For example, the File poller does + not block, each receive() call returns immediately and either contains new files or not. Therefore, even if + a poller contains a long receive-timeout, that value would never be usable in such a scenario. On the other + hand when using Spring Integration's own queue-based channels, the timeout value does have a chance to + participate. The following example demonstrates how a Polling Consumer will receive Messages nearly + instantaneously. + + + + ]]> + Using this approach does not carry much overhead since internally it is nothing more then a timed-wait thread + which does not require nearly as much CPU resource usage as a thrashing, infinite while loop for example. + +
+ +
+ Payload Type Conversion + + Throughout the reference manual, you will also see specific configuration and implementation examples of various endpoints + which can accept a Message or any arbitrary Object as an input parameter. In the case of an Object, such parameter will + be mapped to a Message payload or part of the payload or header (when using Spring Expression Language). However there + are times when the type of input parameter of the endpoint method does not match the type of the payload or its part. + In this scenario we need to perform type conversion. Spring Integration provides a convenient way for registering type + converters (using Spring 3.x ConversionService) within its own instance of the conversion service bean named integrationConversionService + which is automatically created as soon as the first converter is defined. + + To register such converter all you need is to implement  org.springframework.core.convert.converter.Converter and register via + cionvinient namespace support: + + + ]]> + + or + + + ]]> + +
+
+ Asynchronous polling + + If you want the polling to be asynchronous, Poller can optionaly specify 'task-executor' attribute + pointing to an existing instance of TaskExecutor bean + (Spring 3.0 provides a convinient namespaces configuration via the task namespace). However, there are certain things + you must understand when configuring Poller with TaskExecutor.  + + + The problem is that there are two configurations in place. The Poller and the TaskExecutor + and they both have to be in tune with each other otherwise you might end up creating an artificial memory leak.  + + + Let's look at the following configuration provided by one of the users on the Spring's + forums (http://forum.springsource.org/showthread.php?t=94519): + + + + + +]]> + + The above configuration demonstrates one of those out of tune configurations. + + + The poller keeps scheduling new tasks even though all the threads are blocked waiting for either a new message to arrive, + or the timeout to expire. Given that there are 20 threads executing tasks with a 5 second timeout, they will be executed + at a rate of 4 per second (5000/20 = 250ms). But, new tasks are being scheduled at a rate of 20 per second, so the internal + queue in the task executor will grow at a rate of 16 per second (while the process is idle), so we essentially have a memory leak. + + + One of the ways to handle this is to set queue-capacity attribute of Task Executor to 0. You can also manage it by specifying what to do + with messages that can not be queued up by setting rejection-policy attribute of Task Executor (e.g., DISCARD). In other + words there are certain details you must understand with regard to configuring the TaskExecutor. Please refer + to - Section 25 - Task Execution and Scheduling of Spring reference manual. + +
+
diff --git a/docs/src/reference/docbook/event.xml b/docs/src/reference/docbook/event.xml new file mode 100644 index 0000000000..3a9546edbf --- /dev/null +++ b/docs/src/reference/docbook/event.xml @@ -0,0 +1,62 @@ + + + Spring ApplicationEvent Support + + + Spring Integration provides support for inbound and outbound ApplicationEvents + as defined by the underlying Spring Framework. For more information about the events and listeners, + refer to the Spring Reference Manual. + + +
+ Receiving Spring ApplicationEvents + + To receive events and send them to a channel, simply define an instance of Spring Integration's + ApplicationEventListeningChannelAdapter. This class is an implementation of + Spring's ApplicationListener interface. By default it will pass all + received events as Spring Integration Messages. To limit based on the type of event, configure the + list of event types that you want to receive with the 'eventTypes' property. + + + For convenience namespace support was provided to configure ApplicationEventListeningChannelAdapter via inbound-channel-adapter + + +]]> +In the above sample, all Application Context events that are of type specified by the 'event-types' (optional) attribute will be +delivered as Spring Integration Messages to 'sampleEventChannel'. + + + +
+ +
+ Sending Spring ApplicationEvents + + To send Spring ApplicationEvents, create an instance of the + ApplicationEventPublishingMessageHandler and register it within an endpoint. + This implementation of the MessageHandler interface also implements + Spring's ApplicationEventPublisherAware interface and thus acts as a + bridge between Spring Integration Messages and ApplicationEvents. + + + For convenience namespace support was provided to configure ApplicationEventPublishingMessageHandler via outbound-channel-adapter element + + +]]> +If you are using PollableChannel (e.g., Queue), you can also provide poller as sub-element of outbound-channel-adapter, optionally providing task-executor + + + + + + + + +]]> + +In the above sample, all messages sent to an 'input' channel will be published as ApplicationEvents to Spring Application sContext + +
+ +
diff --git a/docs/src/reference/docbook/file.xml b/docs/src/reference/docbook/file.xml new file mode 100644 index 0000000000..6c198c643c --- /dev/null +++ b/docs/src/reference/docbook/file.xml @@ -0,0 +1,228 @@ + + + File Support + +
+ Introduction + + Spring Integration's File support extends the Spring Integration Core with + a dedicated vocabulary to deal with reading, writing, and transforming files. + It provides a namespace that enables elements defining Channel Adapters dedicated + to files and support for Transformers that can read file contents into strings or + byte arrays. + + + This section will explain the workings of FileReadingMessageSource + and FileWritingMessageHandler and how to configure them as + beans. Also the support for dealing with files through file specific + implementations of Transformer will be discussed. Finally the + file specific namespace will be explained. + +
+ +
+ Reading Files + + A FileReadingMessageSource can be used to consume files from the filesystem. + This is an implementation of MessageSource that creates messages from + a file system directory. ]]> + + + To prevent creating messages for certain files, you may supply a + FileListFilter. By default, an + AcceptOnceFileListFilter is used. This filter + ensures files are picked up only once from the directory. + ]]> + + + A common problem with reading files is that a file may be detected before + it is ready. The default AcceptOnceFileListFilter + does not prevent this. In most cases, this can be prevented if the + file-writing process renames each file as soon as it is ready for + reading. A pattern-matching filter that accepts only files that are + ready (e.g. based on a known suffix), composed with the default + AcceptOnceFileListFilter allows for this. + The CompositeFileListFilter enables the + composition. + + + + + + + + + + +]]> + + + The configuration can be simplified using the file specific namespace. To do + this use the following template. + + +]]> + Within this namespace you can reduce the FileReadingMessageSource and wrap + it in an inbound Channel Adapter like this: + + + + + ]]> + The first channel adapter is relying on the default filter that just prevents + duplication, the second is using a custom filter, and the third is using the + filename-pattern attribute to add a AntPathMatcher + based filter to the FileReadingMessageSource. + The file-name-pattern and filter attributes are mutually exclusive, but + you can use a CompositeFileListFilter to use any combination of filters, including a + pattern based filter to fit your particular needs. + + + When multiple processes are reading from the same directory it can be desirable to lock files to prevent + them from being picked up concurrently. To do this you can use a FileLocker. + There is a java.nio based implementation available out of the box, but it is also possible to implement your + own locking scheme. The nio locker can be injected as follows + + + ]]> + + A custom locker you can configure like this: + + + ]]> + + + + When filtering and locking files is not enough it might be needed to control the way files are listed entirely. To + implement this type of requirement you can use an implementation of DirectoryScanner. + This scanner allows you to determine entirely what files are listed each poll. This is also the interface + that Spring Integration uses internally to wire FileListFilters FileLocker to the FileReadingMessageSource. + A custom DirectoryScanner can be injected into the <file:inbound-channel-adapter/> on the scanner + attribute. + ]]> + + This gives you full freedom to choose the ordering, listing and locking strategies. + +
+ +
+ Writing files + + To write messages to the file system you can use a + FileWritingMessageHandler. This class can deal with + File, String, or byte array payloads. In its simplest form the + FileWritingMessageHandler only requires a + destination directory for writing the files. The name of the file to be + written is determined by the handler's FileNameGenerator. + The default implementation looks for a Message header whose key matches + the constant defined as FileHeaders.FILENAME. + + + Additionally, you can configure the encoding and the charset that + will be used in case of a String payload. + + + To make things easier you can configure the FileWritingMessageHandler as + part of an outbound channel adapter using the namespace. + ]]> + + + The namespace based configuration also supports a delete-source-files attribute. + If set to true, it will trigger deletion of the original source files after writing + to a destination. The default value for that flag is false. + ]]> + + + The delete-source-files attribute will only have an effect if the inbound + Message has a File payload or if the FileHeaders.ORIGINAL_FILE header + value contains either the source File instance or a String representing the original file path. + + + + + In cases where you want to continue processing messages based on the written File you can use + the outbound-gateway instead. It plays a very similar role as the + outbound-channel-adapter. However after writing the File, it will also send it + to the reply channel as the payload of a Message. + ]]> + + + The 'outbound-gateway' works well in cases where you want to first move a File and then send it + through a processing pipeline. In such cases, you may connect the file namespace's + 'inbound-channel-adapter' element to the 'outbound-gateway' and then connect that gateway's + reply-channel to the beginning of the pipeline. + + + If you have more elaborate requirements or need to support additional payload types as input + to be converted to file content you could extend the FileWritingMessageHandler, but a much + better option is to rely on a Transformer. + +
+ +
+ File Transformers + + To transform data read from the file system to objects and the other way around you need + to do some work. Contrary to FileReadingMessageSource and to a + lesser extent FileWritingMessageHandler, it is very likely that you + will need your own mechanism to get the job done. For this you can implement the + Transformer interface. Or extend the + AbstractFilePayloadTransformer for inbound messages. Some obvious + implementations have been provided. + + + FileToByteArrayTransformer transforms Files into byte[]s using + Spring's FileCopyUtils. It is often better to use a sequence of + transformers than to put all transformations in a single class. In that case the File to + byte[] conversion might be a logical first step. + + + FileToStringTransformer will convert Files to Strings as the name + suggests. If nothing else, this can be useful for debugging (consider using with a Wire Tap). + + + To configure File specific transformers you can use the appropriate elements from the file namespace. + + + ]]> + The delete-files option signals to the transformer that it should delete + the inbound File after the transformation is complete. This is in no way a replacement for using the + AcceptOnceFileListFilter when the FileReadingMessageSource is being used in a + multi-threaded environment (e.g. Spring Integration in general). + +
+ +
diff --git a/docs/src/reference/docbook/filter.xml b/docs/src/reference/docbook/filter.xml new file mode 100644 index 0000000000..c9bd8aeb1d --- /dev/null +++ b/docs/src/reference/docbook/filter.xml @@ -0,0 +1,131 @@ + + + Filter + +
+ Introduction + + Message Filters are used to decide whether a Message should be passed along or dropped based on some criteria + such as a Message Header value or even content within the Message itself. Therefore, a Message Filter is similar + to a router, except that for each Message received from the filter's input channel, that same Message may or may + not be sent to the filter's output channel. Unlike the router, it makes no decision regarding + which Message Channel to send to but only decides whether to send. + + As you will see momentarily, the Filter does also support a discard channel, so in certain cases it + can play the role of a very simple router (or "switch") based on a boolean condition. + + + + In Spring Integration, a Message Filter may be configured as a Message Endpoint that delegates to some + implementation of the MessageSelector interface. That interface is itself quite + simple: message); + + }]]> + The MessageFilter constructor accepts a selector instance: + + + In combination with the namespace and SpEL very powerful filters can be configured with very little java code. +
+ +
+ The <filter> Element + + The <filter> element is used to create a Message-selecting endpoint. In addition to "input-channel" + and "output-channel" attributes, it requires a "ref". The "ref" may point to a MessageSelector implementation: + + + ]]> + + + Alternatively, the "method" attribute can be added at which point the "ref" may refer to any object. + The referenced method may expect either the Message type or the payload type of + inbound Messages. The return value of the method must be a boolean value. Any time the method returns 'true', + the Message will be passed along to the output-channel. + + + ]]> + + + If the selector or adapted POJO method returns false, there are a few settings that control the + fate of the rejected Message. By default (if configured like the example above), the rejected Messages will + be silently dropped. If rejection should instead indicate an error condition, then set the + 'throw-exception-on-rejection' flag to true: + ]]> + If you want the rejected messages to go to a specific channel, provide that reference as the 'discard-channel': + ]]> + + + A common usage for Message Filters is in conjunction with a Publish Subscribe Channel. Many filter endpoints may + be subscribed to the same channel, and they decide whether or not to pass the Message for the next endpoint which + could be any of the supported types (e.g. Service Activator). This provides a reactive + alternative to the more proactive approach of using a Message Router with a single + Point-to-Point input channel and multiple output channels. + + + Using a "ref" attribute is generally recommended if the custom filter implementation can be reused in other + <filter> definitions. However if the custom filter implementation should be scoped to a + single <filter> element, provide an inner bean definition: + + +]]> + + + + Using both the "ref" attribute and an inner handler definition in the same <filter> configuration + is not allowed, as it creates an ambiguous condition, and it will therefore result in an Exception being thrown. + + + + With the introduction of SpEL Spring Integration has added the expression attribute to the filter + element. It can be used to avoid Java entirely for simple filters. + + ]]> + + The string passed as the expression attribute will be evaluated as a SpEL expression in the context of the message. + If it is needed to include the result of an expression in the scope of the application context you can use the + #{} notation as defined in the SpEL reference documentation + + SpEL reference documentation + . + + ]]> + + If the Expression itself needs to be dynamic, then an 'expression' sub-element may be used. That provides a level of + indirection for resolving the Expression by its key from an ExpressionSource. That is a strategy interface that you + can implement directly, or you can rely upon a version available in Spring Integration that loads Expressions from + a "resource bundle" and can check for modifications after a given number of seconds. All of this is demonstrated in + the following configuration sample where the Expression could be reloaded within one minute if the underlying file + had been modified. If the ExpressionSource bean is named "expressionSource", then it is not necessary to provide the + "source" attribute on the <expression> element, but in this case it's shown for completeness. + + + + + + + + + +]]> + + Then, the 'config/integration/expressions.properties' file (or any more specific version with a locale extension + to be resolved in the typical way that resource-bundles are loaded) would contain a key/value pair: + + 100 +]]> + + All of the examples that use "expression" as an attribute or sub-element can also be applied within + transformer, router, splitter, service-activator, and header-enricher elements. Of course, the semantics/role + of the given component type would affect the interpretation of the evaluation result in the same way that the + return or a method-invocation would be interpreted. For example, an expression can return Strings that are + to be treated as Message Channel names by a router component. + +
+
diff --git a/docs/src/reference/docbook/gateway.xml b/docs/src/reference/docbook/gateway.xml new file mode 100644 index 0000000000..12a88b2f27 --- /dev/null +++ b/docs/src/reference/docbook/gateway.xml @@ -0,0 +1,254 @@ + + + Inbound Messaging Gateways + +
+ GatewayProxyFactoryBean + + Working with Objects instead of Messages is an improvement. However, it would be even better to have no + dependency on the Spring Integration API at all - including the gateway class. For that reason, Spring + Integration also provides a GatewayProxyFactoryBean that generates a proxy for + any interface and internally invokes the gateway methods shown above. Namespace support is also + provided as demonstrated by the following example. + ]]> + Then, the "fooService" can be injected into other beans, and the code that invokes the methods on that + proxied instance of the FooService interface has no awareness of the Spring Integration API. The general + approach is similar to that of Spring Remoting (RMI, HttpInvoker, etc.). See the "Samples" Appendix for + an example that uses this "gateway" element (in the Cafe demo). + + + The reason that the attributes on the 'gateway' element are named 'default-request-channel' and + 'default-reply-channel' is that you may also provide per-method channel references by using the + @Gateway annotation. + + ... as well as method sub element if yuo prefer XML configuration (see next paragraph) + + + It is also possible to pass values to be interpreted as Message headers on the Message + that is created and sent to the request channel by using the @Header annotation: + + + + + If you prefer XML way of configuring Gateway methods, you can provide method sub-elements + to the gateway configuration (see below) + + + + +]]> + + + You can also provide individual headers per method invocation via XML. + This could be very useful if the headers you want to set are static in nature and you don't want + to embed them in the gateway's method signature via @Header annotations. + For example, in the Loan Broker example we want to influence how aggregation of the Loan quotes + will be done based on what type of request was initiated (single quote or all quotes). Determining the + type of the request by evaluating what gateway method was invoked, although possible would + violate the separation of concerns paradigm (method is a java artifact),  but expressing your + intention (meta information) via Message headers is natural in a Messaging architecture. + + + + + + + + +]]> + In the above case you can clearly see how a different header value will be set for the 'RESPONSE_TYPE' + header based on the gateway's method. + + + As with anything else, Gateway invocation might result in errors. + By default any error that has occurred downstream will be re-thrown as a MessagingExeption (RuntimeException) + upon the Gateway's method invocation. However there are times when you may want to treat an Exception as a valid reply, + by mapping it to a Message. To accomplish this our Gateway provides support for Exception mappers via the + exception-mapper attribute. + + + + + + + ]]> + + foo.bar.SampleExceptionMapper is the implementation of + org.springframework.integration.message.InboundMessageMapper which only defines one method: toMessage(Object object). +{ + public Message toMessage(Throwable object) throws Exception { + MessageHandlingException ex = (MessageHandlingException) object; + return MessageBuilder.withPayload("Error happened in message: " + + ex.getFailedMessage().getPayload()).build(); + } + +} + ]]> + + + + + Exposing messaging system via POJO Gateway is obviously a great benefit, but it does come at the price so there + are certain things you must be aware of. + + We want our Java method to return as quick as possible and not hang for infinite amount of time until they can + return (void , exception or return value). When regular methods are used as a proxies in front of the Messaging + system we have to take into account the asynchronous nature of the Messaging Systems. This means that there might + be a chance that a Message hat was initiated by a Gateway could be dropped by a Filter, thus never reaching a + component that is responsible to produce a reply. Some Service Activator method might result in the Exception, + thus resulting in no-reply (as we don't generate Null messages).So as you can see there are multiple scenarios + where reply message might not be coming which is perfectly natural in messaging systems. However think about the + implication on the gateway method.  The Gateway's method input arguments  were incorporated into a Message and + sent downstream. The reply Message would be converted to a return value of the Gateway's method. So you can see + how ugly it could get if you can not guarantee that for each Gateway call there will alway be a reply Message. + Basically your Gateway method will never return and will hang infinitely. (work in progress!!!!) +One of the ways of handling this situation is via AsyncGateway (explained later in this section). Another way of handling it is to explicitly set the reply-timeout attribute. This way gateway will not hang for more then the time that was specified by the reply-timout and will return 'null'.  + + +
+
+ Asynchronous Gateway + + As a pattern the Messaging Gateway is a very nice way to hide messaging-specific code while still exposing the full capabilities of the + messaging system. And GatewayProxyFactoryBean provides a convenient way to expose a Proxy over a service-interface + thus giving you a POJO-based access to a messaging system (based on objects in your own domain, or primitives/Strings, etc).  But when a + gateway is exposed via simple POJO methods which return values it does imply that for each Request message (generated when the method is invoked) + there must be a Reply message (generated when the method has returned). Since Messaging systems naturally are asynchronous you may not always be + able to guarantee the contract where "for each request there will always be be a reply".  + With Spring Integration 2.0 we are introducing support for an Asynchronous Gateway which is a convenient way to initiate + flows where you may not know if a reply is expected or how long will it take for it to arrive. + + + A natural way to handle these types of scenarios in Java would be relying upon java.util.concurrent.Future instances, and + that is exactly what Spring Integration uses to support an Asynchronous Gateway. + + + From the XML configuration, there is nothing different and you still define Asynchronous Gateway the same way as a regular Gateway. + ]]> + However the Gateway Interface (service-interface) is a bit different. + + public interface MathServiceGateway { + Future<Integer> multiplyByTwo(int i); +} + + + As you can see from the example above the return type for the gateway method is Future. When + GatewayProxyFactoryBean sees that the + return type of the gateway method is Future, it immediately switches to the async mode by utilizing + an AsyncTaskExecutor. That is all. The call to a method always returns immediately with Future + encapsulating  the interaction with the framework. + Now you can interact with the Future at your own pace to get the result, timeout, get the exception etc... + MathServiceGateway mathService = ac.getBean("mathService", MathServiceGateway.class); +Future<Integer> result = mathService.multiplyByTwo(number); +// do something else here since the reply might take a moment +int finalResult =  result.get(1000, TimeUnit.SECONDS); +For a more detailed example, please refer to the async-gateway sample distributed within the Spring Integration samples. + + +
+
+ Gateway behavior when no response is coming + + As it was explained earlier, Gateway provides a convenient way of interacting with Messaging system via POJO method + invocations, but realizing that a typical method invocation, which is generally expected to always return (even with Exception), + might not always map one-to-one to message exchanges (e.g., reply message might not be coming which is equivalent to + method not returning), it is important to go over several scenarios especially in the Sync Gateway case and understand + what the default behavior of the Gateway and how to deal with these scenarios to make Sync Gateway behavior more + predictable regardless of the outcome of the message flow that was initialed from such Gateway. + + + There are certain attributes that could be configured to make Sync Gateway behavior more predictable, + but some of them might not always work as you might have expected. One of them is reply-timeout. + So, lets look at the reply-timeout attribute and see how it can/can't influence the behavior + of the Sync Gateway in various scenarios. We will look at single-theraded scenario + (all components downstream are connected via Direct Channel) and multi-theraded scenarios + (e.g., somewhere downstream you may have Pollable or Executor Channel which breaks single-thread boundary) + + + Long running process downstream + + + Sync Gateway - single-threaded. + If a component downstream is still running (e.g., infinite loop or a very slow service), then setting reply-timeout + has no effect and Gateway method call will not return until such downstream service exits (e.g., return or exception). + Sync Gateway - multi-threaded. + If a component downstream is still running (e.g., infinite loop or a very slow service), in a multi-threaded message + flow setting reply-timeout will have an effect by allowing gateway method invocation to + return once the timeout has been reached, since GatewayProxyFactoryBean  will simply + poll on the reply channel waiting for a message untill the timeout expires. However it could result in the 'null' return + from the Gateway method if the timeout has been reached before the actual reply was produced. It is also important to understand that + the reply message (if produced) will be sent to a reply channel after Gateway method invocation might have returned, so you must be aware of that + and design your flow with this in mind. + + + Downstream component returns 'null' + + + Sync Gateway - single-threaded. + If a component downstream returns 'null' and no reply-timeout has been configured, the Gateway + method call will hang indefinitely unless: a) reply-timeout has been configured or b) + requires-reply attribute has been set on the downstream component (e.g., service-activator) + that might return 'null'. In this case, the exception will be thrown and propagated to the Gateway. + Sync Gateway - multi-threaded. Behavior is the same as above. + + + Downstream component return signature is 'void' while Gateway method signature is non-void + + + Sync Gateway - single-threaded. + If a component downstream returns 'void' and no reply-timeout has been configured, + the Gateway method call will hang indefinitely unless reply-timeout has been configured  + Sync Gateway - multi-threaded Behavior is the same as above. + + + Downstream component results in Runtime Exception (regardless of the method signature) + + + Sync Gateway - single-threaded. + If a component downstream throws a Runtime Exception, such exception will be propagated via Error Message back to + the gateway and re-thrown. + Sync Gateway - multi-threaded Behavior is the same as above. + + + + It is also important to understand that by default reply-timout is unbounded which means that + if not explicitly set there are several scenarios (described above) where your Gateway method invocation might + hang indefinitely, so make sure you analyze your flow and if there is even a remote possibility of one of these + scenarios to occur, set the reply-timout attribute to a 'safe' value or better off + set the requires-reply attribute of the downstream component to 'true' to ensure a timely response. + But also, realize that there are some scenarios (see the very first one) + where reply-timout will not help which means it is also important to analyze your message + flow and decide when to use Sync Gateway vs Async Gateway where Gateway method invocation is always guaranteed + to return while giving you a more granular control over the results of the invocation via Java Futures. + + Also, when dealing with Router you should remember that seeting resolution-required attribute to 'true' + will result in the exception thrown by the router if it can not resolve a particular chanel. And when dealing with the filter + you can also set throw-exception-on-rejection attribute. Both of these will help to ensure a timely response + from the Gateway method invocation. + + + +
+ +
diff --git a/docs/src/reference/docbook/groovy.xml b/docs/src/reference/docbook/groovy.xml new file mode 100644 index 0000000000..d23bd712ba --- /dev/null +++ b/docs/src/reference/docbook/groovy.xml @@ -0,0 +1,72 @@ + + + Groovy support + + With Spring Integration 2.0 we've added Groovy support allowing you to use Groovy scripting language to provide + integration and business logic  for various integration components similar to the way Spring Expression Language (SpEL) + is use to implement routing, transformation and other integration concerns. + + For more information about Groovy please refer to Groovy documentation which you can find here: http://groovy.codehaus.org/ + + +
+ Groovy configuration + + Depending on the complexity of your integration requirements Groovy scripts could be provided inline as CDATA in XML + configuration or as a reference to a file containing Groovy script. + + To enable Groovy support Spring Integration defines GroovyScriptExecutingMessageProcessor which will + create a groovy Binding object identifying Message Payload as payload variable and Message Headers as + headers variable. All that is left for you to do is write script that uses these variables. + Below are couple of sample configurations: + + + + Filter + <filter input-channel="referencedScriptInput"> + <groovy:script location="some/path/to/groovy/file/GroovyFilterTests.groovy"/> +</filter> + +<filter input-channel="inlineScriptInput"> + <groovy:script><![CDATA[ + return payload == 'good' + ]]></groovy:script> +</filter> +You see that script could be included inline or via location attribute using the groovy namespace sport.  + + + + Other supported elements are router, service-activator, transformer, splitter + + + + Another interesting aspect of using Groovy support is framework's ability to update (reload) scripts  + without restarting the Application Context. + To accomplish this all you need is specify refresh-check-delay attribute on script + element. The reason for this attribute is to make reloading of the script more efficient.  + + ]]> + + In the above example for the next 5 seconds after you update the script you'll still be using the old script and + after 5 seconds the context will be updated with the new script. This is a good example where  'near real time' + is acceptable. + + ]]> + + In the above example the context will be updated with the new script every time the script is modified. Basically this is the example of the + 'real-time' and might not be the most efficient way. + + ]]> + + + Any negative number value means the script will never be refreshed after initial initialization of application context. + DEFAULT BEHAVIOR + + Inline defined script can not be reloaded. + + + +
+ +
diff --git a/docs/src/reference/docbook/http.xml b/docs/src/reference/docbook/http.xml new file mode 100644 index 0000000000..e25a5671e3 --- /dev/null +++ b/docs/src/reference/docbook/http.xml @@ -0,0 +1,210 @@ + + + HTTP Support + +
+ Introduction + + The HTTP support allows for the execution of HTTP requests and the processing of inbound HTTP requests. Because interaction over HTTP is always synchronous, even if all that is returned is a 200 status code, the HTTP support consists of two gateway implementations: + HttpInboundEndpoint and HttpRequestExecutingMessageHandler. + +
+ +
+ Http Inbound Gateway + + To receive messages over HTTP you need to use an HTTP inbound Channel Adapter or Gateway. In common with the HttpInvoker + support the HTTP inbound adapters need to be deployed within a servlet container. The easiest way to do this is to provide a servlet + definition in web.xml, see + for further details. Below is an example bean definition for a simple HTTP inbound endpoint. + + + +]]> + The HttpRequestHandlingMessagingGateway accepts a list of HttpMessageConverter instances or else + relies on a default list. The converters allow + customization of the mapping from HttpServletRequest to Message. The default converters + encapsulate simple strategies, which for + example will create a String message for a POST request where the content type starts with "text", see the Javadoc for + full details. + + Starting with this release MultiPart File support was implemented. If the request has been wrapped as a + MultipartHttpServletRequest, when using the default converters, that request will be converted + to a Message payload that is a MultiValueMap containing values that may be byte arrays, Strings, or instances of + Spring's MultipartFile depending on the content type of the individual parts. + + The HTTP inbound Endpoint will locate a MultipartResolver in the context if one exists with the bean name + "multipartResolver" (the same name expected by Spring's DispatcherServlet). If it does in fact locate that + bean, then the support for MultipartFiles will be enabled on the inbound request mapper. Otherwise, it will + fail when trying to map a multipart-file request to a Spring Integration Message. For more on Spring's + support for MultipartResolvers, refer to the Spring Reference Manual. + + + + In sending a response to the client there are a number of ways to customize the behavior of the gateway. By default the gateway will + simply acknowledge that the request was received by sending a 200 status code back. It is possible to customize this response by providing a + 'viewName' to be resolved by the Spring MVC ViewResolver. + In the case that the gateway should expect a reply to the Message then setting the expectReply flag + (constructor argument) will cause + the gateway to wait for a reply Message before creating an HTTP response. Below is an example of a gateway + configured to serve as a Spring MVC Controller with a view name. Because of the constructor arg value of TRUE, it wait for a reply. This also shows + how to customize the HTTP methods accepted by the gateway, which + are POST and GET by default. + + + + + + + + GET + DELETE + + + +]]> + The reply message will be available in the Model map. The key that is used + for that map entry by default is 'reply', but this can be overridden by setting the + 'replyKey' property on the endpoint's configuration. + +
+ +
+ Http Outbound Gateway + + + To configure the HttpRequestExecutingMessageHandler write a bean definition like this: + + + +]]> + This bean definition will execute HTTP requests by delegating to a RestTemplate. That template in turn delegates + to a list of HttpMessageConverters to generate the HTTP request body from the Message payload. You can configure those converters as well + as the ClientHttpRequestFactory instance to use: + + + + + +]]> +By default the HTTP request will be generated using an instance of SimpleClientHttpRequestFactory which uses the JDK + HttpURLConnection. Use of the Apache Commons HTTP Client is also supported through the provided + CommonsClientHttpRequestFactory which can be injected as shown above. + +
+ +
+ HTTP Namespace Support + + Spring Integration provides an "http" namespace and schema definition. To include it in your + configuration, simply provide the following URI within a namespace declaration: + 'http://www.springframework.org/schema/integration/http'. The schema location should then map to + 'http://www.springframework.org/schema/integration/http/spring-integration-http.xsd'. + + + To configure an inbound http channel adapter which is an instance of HttpInboundEndpoint configured + not to expect a response. + ]]> + + + To configure an inbound http gateway which expects a response. + ]]> + + + To configure the outbound gateway you can use the namespace support as well. The following code snippet shows the different configuration options for an outbound Http gateway. Most importantly, notice that the 'http-method' and 'expected-response-type' are provided. Those are two of the most commonly configured values. The + default http-method is POST, and the default response type is null. With a null response type, the payload of the reply Message would only + contain the status code (e.g. 200) as long as it's a successful status (non-successful status codes will throw Exceptions). If you are expecting a different + type, such as a String, then provide that fully-qualified class name as shown below. + ]]> + + If your outbound adapter is to be used in a unidirectional way, then you can use an outbound-channel-adapter instead. This means that + a successful response will simply execute without sending any Messages to a reply channel. In the case of any non-successful response + status code, it will throw an exception. The configuration looks very similar to the gateway: + ]]> + +
+
+ HTTP Samples +
+ Multipart HTTP request - RestTemplate (client) and Http Inbound Gateway (server) + + This example demonstrates how simple it is to send a Multipart HTTP request via Spring's RestTemplate and receive it by Spring Integration HTTP Inbound Adapter. +All we are doing is creating MultiValueMap and populating it with multi-part data. RestTemplate will take care of the rest +by converting it to MultipartHttpServletRequest   +THis particular client will send a multipart Http Request which contains the name of the company as well as the image file with company logo. + httpResponse = template.exchange(uri, HttpMethod.POST, request, null);]]> + + +That is all for the client. + + +On the server side we have the following configuration: + + + + + + + + + +]]> + + +The 'httpInboundAdapter' will receive the request, convert it to a Message with a payload as LinkedMultiValueMap which +we are parsing in the 'multipartReceiver' service-activator; + multipartRequest){ + System.out.println("### Successfully recieved multipart request ###"); + for (String elementName : multipartRequest.keySet()) { + if (elementName.equals("company")){ + System.out.println("\t" + elementName + " - " + + ((String[]) multipartRequest.getFirst("company"))[0]); + } else if (elementName.equals("company-logo")){ + System.out.println("\t" + elementName + " - as UploadedMultipartFile: " + + ((UploadedMultipartFile) multipartRequest.getFirst("company-logo")).getOriginalFilename()); + } + } +} + +]]> +You should see the following output: + + +
+
+
diff --git a/docs/src/reference/docbook/httpinvoker.xml b/docs/src/reference/docbook/httpinvoker.xml new file mode 100644 index 0000000000..a28f86d6f8 --- /dev/null +++ b/docs/src/reference/docbook/httpinvoker.xml @@ -0,0 +1,101 @@ + + + HttpInvoker Support + +
+ Introduction + + HttpInvoker is a Spring-specific remoting option that essentially enables Remote Procedure Calls (RPC) over HTTP. + In order to accomplish this, an outbound representation of a method invocation is serialized using standard Java + serialization and then passed within an HTTP POST request. After being invoked on the target system, the method's + return value is then serialized and written to the HTTP response. There are two main requirements. First, you + must be using Spring on both sides since the marshalling to and from HTTP requests and responses is handled by + the client-side invoker and server-side exporter. Second, the Objects that you are passing must implement + Serializable and be available on both the client and server. + + + While traditional RPC provides physical decoupling, it does not offer nearly the same degree + of logical decoupling as a messaging-based system. In other words, both participants in an + RPC-based invocation must be aware of a specific interface and specific argument types. Interestingly, in Spring + Integration, the "parameter" being sent is a Spring Integration Message, and the interface is an internal detail + of Spring Integration's implementation. Therefore, the RPC mechanism is being used as a + transport so that from the end user's perspective, it is not necessary to consider the + interface and argument types. It's just another adapter to enable messaging between two systems. + +
+ +
+ HttpInvoker Inbound Gateway + + To receive messages over http you can use an HttpInvokerInboundGateway. Here is an + example bean definition: + + + + + +]]> + Because the inbound gateway must be able to receive HTTP requests, it must be configured within a Servlet + container. The easiest way to do this is to provide a servlet definition in web.xml: + + inboundGateway + org.springframework.web.context.support.HttpRequestHandlerServlet +]]> + Notice that the servlet name matches the bean name. + + If you are running within a Spring MVC application and using the BeanNameHandlerMapping, then the servlet + definition is not necessary. In that case, the bean name for your gateway can be matched against the URL + path just like a Spring MVC Controller bean. + + +
+ +
+ HttpInvoker Outbound Gateway + + + + To configure the HttpInvokerOutboundGateway write a bean definition like this: + + +]]> + The outbound gateway is a MessageHandler and can therefore be registered with + either a PollingConsumer or EventDrivenConsumer. + The URL must match that defined by an inbound HttpInvoker Gateway as described in the previous section. + +
+ +
+ HttpInvoker Namespace Support + + Spring Integration provides an "httpinvoker" namespace and schema definition. To include it in your + configuration, simply provide the following URI within a namespace declaration: + 'http://www.springframework.org/schema/integration/httpinvoker'. The schema location should then map to + 'http://www.springframework.org/schema/integration/httpinvoker/spring-integration-httpinvoker-2.0.xsd'. + + + To configure the inbound gateway you can choose to use the namespace support for it. The following code snippet shows the different configuration options that are supported. + ]]> + + A 'reply-channel' may also be provided, but it is recommended to rely on the temporary anonymous channel + that will be created automatically for handling replies. + + + + To configure the outbound gateway you can use the namespace support as well. The following code snippet shows the different configuration for an outbound HttpInvoker gateway. Only the 'url' and 'request-channel' are required. + ]]> + +
+
diff --git a/src/docbkx/resources/images/bank-router.png b/docs/src/reference/docbook/images/bank-router.png similarity index 100% rename from src/docbkx/resources/images/bank-router.png rename to docs/src/reference/docbook/images/bank-router.png diff --git a/src/docbkx/resources/images/cafe-demo.png b/docs/src/reference/docbook/images/cafe-demo.png similarity index 100% rename from src/docbkx/resources/images/cafe-demo.png rename to docs/src/reference/docbook/images/cafe-demo.png diff --git a/src/docbkx/resources/images/cafe-eip.png b/docs/src/reference/docbook/images/cafe-eip.png similarity index 100% rename from src/docbkx/resources/images/cafe-eip.png rename to docs/src/reference/docbook/images/cafe-eip.png diff --git a/docs/src/reference/docbook/images/callouts/1.gif b/docs/src/reference/docbook/images/callouts/1.gif new file mode 100644 index 0000000000000000000000000000000000000000..9e7a87f75461ce41cc91ee68246c7bfb47d37ca3 GIT binary patch literal 889 zcmV-<1BU!ZNk%w1VGIBa0O$Vz000010RaL60s{jB1Ox;H1qB8M1_uWR2nYxX2?+`c z3JVJh3=9kn4Gj(s4i66x5D*X%5fKs+5)%^>6ciK{6%`g178e&67#J8C85tTH8XFrM z92^`S9UUGX9v>ecARr(iAt53nA|oRsBqSsyB_$>%CMPE+C@3f?DJd!{Dl021EG#T7 zEiEoCE-x=HFfcGNF)=bSGBYzXG&D3dH8nOiHa9mnI5;>tIXOByIy*Z%JUl!-Jv}}? zK0iM{KtMo2K|w-7LPJACL_|bIMMXwNMn^|SNJvOYNl8jdN=r*iOiWBoO-)WtPESuy zP*6}&QBhJ-Qd3h?R8&+|RaI72R##V7SXfwDSy@_IT3cINTwGjTU0q&YUSD5dU|?Wj zVPRroVq;@tWMpJzWo2e&W@l$-XlQ6@X=!R|YHMq2Y;0_8ZEbFDZf|dIaBy&OadC2T za&vQYbaZreb#-=jc6WDoczAeud3kzzdV70&e0+R;eSLm@et&;|fPjF3fq{a8f`fyD zgoK2Jg@uNOhKGlTh=_=ZiHVAeii?YjjEszpjg5|uj*pLzkdTm(k&%*;l9Q8@l$4Z} zm6ev3mY0{8n3$NEnVFiJnwy)OoSdAUot>VZo}ZteprD|kp`oIpqNAguq@<*!rKP5( zrl+T;sHmu^si~@}s;jH3tgNi9t*x%EuCK4Ju&}VPv9YqUva_?Zw6wIfwY9dkwzs#p zxVX5vxw*Q!y1To(yu7@dCU$jHda z$;ryf%FD~k%*@Qq&CSlv&d<-!(9qD)(b3Y<($mw^)YR0~)z#M4*4Nk9*x1lt)=I7_<=;-L_>FMg~>g((4 z?Ck9A?d|UF?(gsK@bK{Q@$vHV^7Hfa^z`)g_4W4l_V@Sq`1ttw`T6?#`uqF){QUg= z{r&#_{{R2~A^8LW0RaC1EC2ui01N;O000P90RIW3lmh~U9GnCyi~#@uf)ov7ENlpX zku!=C88uXL?%qX;j2KcZ^)Vs>iU2s3ba;}YN|XphHhhUuqsx_y{>fxi3!_4aC;>=R P_%9>^1UV=v3C}X^4DKU-G|w_t}fLBA)Suv#nrW z!^h2QnY_`l!BOq-UXEX{m2up>JTQkX)2m zTvF+fTUlI^nXH#utd~++ke^qgmzgTe~DWM4ffP81J literal 0 HcmV?d00001 diff --git a/docs/src/reference/docbook/images/callouts/1.svg b/docs/src/reference/docbook/images/callouts/1.svg new file mode 100644 index 0000000000..e2e87dc526 --- /dev/null +++ b/docs/src/reference/docbook/images/callouts/1.svg @@ -0,0 +1,15 @@ + + + + +]> + + + + + + + + diff --git a/docs/src/reference/docbook/images/callouts/10.gif b/docs/src/reference/docbook/images/callouts/10.gif new file mode 100644 index 0000000000000000000000000000000000000000..e80f7f8e632e72463866c08beba2bfb3b17221e9 GIT binary patch literal 929 zcmV;S177?`Nk%w1VGIBa0O$Vz000010RaL60s{jB1Ox;H1qB8M1_uWR2nYxX2?+`c z3JVJh3=9kn4Gj(s4i66x5D*X%5fKs+5)%^>6ciK{6%`g178e&67#J8C85tTH8XFrM z92^`S9UUGX9v>ecARr(iAt53nA|oRsBqSsyB_$>%CMPE+C@3f?DJd!{Dl021EG#T7 zEiEoCE-x=HFfcGNF)=bSGBYzXG&D3dH8nOiHa9mnI5;>tIXOByIy*Z%JUl!-Jv}}? zK0iM{KtMo2K|w-7LPJACL_|bIMMXwNMn^|SNJvOYNl8jdN=r*iOiWBoO-)WtPESuy zP*6}&QBhJ-Qd3h?R8&+|RaI72R##V7SXfwDSy@_IT3cINTwGjTU0q&YUSD5dU|?Wj zVPRroVq;@tWMpJzWo2e&W@l$-XlQ6@X=!R|YHMq2Y;0_8ZEbFDZf|dIaBy&OadC2T za&vQYbaZreb#-=jc6WDoczAeud3kzzdV70&e0+R;eSLm@et&;|fPjF3fq{a8f`fyD zgoK2Jg@uNOhKGlTh=_=ZiHVAeii?YjjEszpjg5|uj*pLzkdTm(k&%*;l9Q8@l$4Z} zm6ev3mY0{8n3$NEnVFiJnwy)OoSdAUot>VZo}ZteprD|kp`oIpqNAguq@<*!rKP5( zrl+T;sHmu^si~@}s;jH3tgNi9t*x%EuCK4Ju&}VPv9YqUva_?Zw6wIfwY9dkwzs#p zxVX5vxw*Q!y1To(yu7@dCU$jHda z$;ryf%FD~k%*@Qq&CSlv&d<-!(9qD)(b3Y<($mw^)YR0~)z#M4*4Nk9*x1lt)=I7_<=;-L_>FMg~>g((4 z?Ck9A?d|UF?(gsK@bK{Q@$vHV^7Hfa^z`)g_4W4l_V@Sq`1ttw`T6?#`uqF){QUg= z{r&#_{{R2~A^8LW0Ra90EC2ui01N;O000Pn0R0K%lmi2V9E=1i%mD!d00b!@#8`-+ zR;?7?dYzM!!e6Nn@BUe=1z?Uh0F0D8bXLpS8~`!?g^1x00Ly!00ATo+13^ue?{bFV z2|%UITFwXo$ng(Dj8XuOGO`ANk~5V4ascSX2|}-X)?#!Ns5RIspO!hirf Dy0E(c literal 0 HcmV?d00001 diff --git a/docs/src/reference/docbook/images/callouts/10.png b/docs/src/reference/docbook/images/callouts/10.png new file mode 100644 index 0000000000000000000000000000000000000000..997bbc8246a316e040e0804174ba260e219d7d33 GIT binary patch literal 361 zcmeAS@N?(olHy`uVBq!ia0vp^JRr;gBp8b2n5}^nQWtZ~+OvdJMW|Y+^UT?O-M{rKJsmzxdayJ{ zDCQA!%%@7Jj$q%-wf8e0_jRx8Dqi$}^?K=?6FriQFLv>>oc^CE+aVHhW3=nZ+fQ4!M=ZC7H>3sl|FJr3LwU zC3?yExf6FO?f@F61vV}-Juk7O6lk8Yg;}bFaZ-|HQc7Azopr01?u8M*si- literal 0 HcmV?d00001 diff --git a/docs/src/reference/docbook/images/callouts/10.svg b/docs/src/reference/docbook/images/callouts/10.svg new file mode 100644 index 0000000000..4740f587bd --- /dev/null +++ b/docs/src/reference/docbook/images/callouts/10.svg @@ -0,0 +1,18 @@ + + + + +]> + + + + + + + + + diff --git a/docs/src/reference/docbook/images/callouts/11.gif b/docs/src/reference/docbook/images/callouts/11.gif new file mode 100644 index 0000000000000000000000000000000000000000..67f91a239d66d622f8d254539b6fd580efa42b02 GIT binary patch literal 202 zcmZ?wbhEHb%*^WQ z>bADF{{H^y)2Gj!J9p8dMeEkB+q`-6jvYIW9656K?Ac3~F5SL;`|;z)Z{EE5@ZrP1 zfB*i&fZ|UUMn(pC1|5)1AUhdY-5;oT-OT9fVPH5?qIP(rnuCecF;(8lY%CHJA0|%J x(XwN3776fTXisr6DR7$1b@7l?>`pt$t64n;p&ZEvzI<6|A|t-7MudsM8UU#vRD1vc literal 0 HcmV?d00001 diff --git a/docs/src/reference/docbook/images/callouts/11.png b/docs/src/reference/docbook/images/callouts/11.png new file mode 100644 index 0000000000000000000000000000000000000000..ce47dac3f52ac49017749a3fea53db57d006993c GIT binary patch literal 565 zcmeAS@N?(olHy`uVBq!ia0vp^JRr=$1SD^YpWXnZI14-?iy0V%N{XE z)7O>#600DeuDZ?5tOl@ql94%{~0TwC?8m~C^ZqJRG}m@H-L1 z5L@scq?{XUcxG{OP9jig5ySQaTl#^*93bKF#G<^+ymW>G($Cs~V(bw8rA5i93}62@ zzlJGu&d<$F%`0K}c4pdspcorSSx9C{PAbEScbC)|7#JBmT^vIy=9KoYUDZ+`aP)jU z&ny=ErrK^#Gw!AcR}pdfMERuV^@&0$@(#^6b8c@rn^6RWX3pUb z4*6@PZ+H0#u=rjsXzS?6n6*sBGbHqGTU%mCsH?n#%j;eD^2}qe=iX*J@VQ3BRpz+u z{PX#N(^9X${`$90+;!pWs>o@z_n8G)7Uo7PJz`jrS+)QE@=PWHmc~UIw=WmUe73o7 z>^bR(M752aYoNg~ozu7U7&{(U>{s!;bn#f?ItjL^o`e{*EOQHqO;ccnz9hLK5@2cAyw@AaPFL~Cp#02|E|4xeQteNtB7waMs QVCXP-y85}Sb4q9e0GRUFb^rhX literal 0 HcmV?d00001 diff --git a/docs/src/reference/docbook/images/callouts/11.svg b/docs/src/reference/docbook/images/callouts/11.svg new file mode 100644 index 0000000000..09a0b2cf71 --- /dev/null +++ b/docs/src/reference/docbook/images/callouts/11.svg @@ -0,0 +1,16 @@ + + + + +]> + + + + + + + + + diff --git a/docs/src/reference/docbook/images/callouts/12.gif b/docs/src/reference/docbook/images/callouts/12.gif new file mode 100644 index 0000000000000000000000000000000000000000..54c4b42f1901629a81924c2f0f59338104adeedd GIT binary patch literal 210 zcmZ?wbhEHb(-#rlzKzo}S5*C(oKSYw6OZn>TOXy?ghOBS+4hIdl8=?Z=NFfBN+4-@kwVQGw!5 z7Dh$}c?KP@O+Y&tSp6TUNBM5@Ncv^za9iq?NB~b`s?Q`L(SI(T+y_1#WZ*J!SfIpc y)1^D>K$0MX%p%4Hwu?TqL@qKHD9DJsXySU9#jCf<|A~QyiNVJ`b^kdT8LR=FrC4|X literal 0 HcmV?d00001 diff --git a/docs/src/reference/docbook/images/callouts/12.png b/docs/src/reference/docbook/images/callouts/12.png new file mode 100644 index 0000000000000000000000000000000000000000..31daf4e2f25b6712499ee32de9c2e3b050b691ca GIT binary patch literal 617 zcmeAS@N?(olHy`uVBq!ia0vp^JRr=$1SD^YpWXnZI14-?iy0V%N{XE z)7O>#600De9$%>2LVd81Yeb1-X-P(Y5yQ%LXFPyHJS9LOm(=3qqRfJl%=|nCVNOM5 zpg0#u+&RCXvM4h>ql94%{~0TwC?8m~C^ZqJRG}m@H-L1 z5L@scq?{XUcxG{OP9jig5ySQaTl#^*93bKF#G<^+ymW>G($Cs~V(bw8rA5i93}62@ zzlJGu&d<$F%`0K}c4pdspcorSSx9C{PAbEScbC)|7#JBmT^vIy=Cn>wTzx1(qV@bS z0hYvspf(--lM>otrqbK$7p{3DzJ|+KN8%5ows)AI?zWk_n>jwEHXrTJecpEW_0xL= z?}N`*R`T~d2{AN${y8T#GEn4hUb&52^}Op@TW4{oc)A6)%$5=G}h# z?O{QLj@aRcAIf&y&OiUN=H2gq=_}V|pWfuReDV|{jwXw~>#w)I|9$ + + + +]> + + + + + + + + + diff --git a/docs/src/reference/docbook/images/callouts/13.gif b/docs/src/reference/docbook/images/callouts/13.gif new file mode 100644 index 0000000000000000000000000000000000000000..dd5d7d9b6439affca376bcd60785d528a24ce425 GIT binary patch literal 209 zcmZ?wbhEHbB&V9x4V*B03xgoIf)x xP}6;KaKZ)#6?t!lhL!-83*8xv4m?aeZ4A@2c0{pEJ&`E!{XE z)7O>#600Dep5bGK9wD%hYeb1-X-P(Y5yQ%LXFPyHJS9LOm(=3qqRfJl%=|nCVNOM5 zpg0#u+&RCXvM4h>ql94%{~0TwC?8m~C^ZqJRG}m@H-L1 z5L@scq?{XUcxG{OP9jig5ySQaTl#^*93bKF#G<^+ymW>G($Cs~V(bw8rA5i93}62@ zzlJGu&d<$F%`0K}c4pdspcorSSx9C{PAbEScbC)|7#JBmT^vIy=Cn>w>~AWNX^a2R zbkveVY|45D7UnZ&JtjPwvdCCscZp0EA*0()#GOw)UH4-^&)y^E*4%UC)*|J}q_Ss;tN`nd8$>x9$_Xb^O2EpX&@C ZI46EzbLxq-voTO7gQu&X%Q~loCIF_C`w;*D literal 0 HcmV?d00001 diff --git a/docs/src/reference/docbook/images/callouts/13.svg b/docs/src/reference/docbook/images/callouts/13.svg new file mode 100644 index 0000000000..64268bb4fa --- /dev/null +++ b/docs/src/reference/docbook/images/callouts/13.svg @@ -0,0 +1,20 @@ + + + + +]> + + + + + + + + + diff --git a/docs/src/reference/docbook/images/callouts/14.gif b/docs/src/reference/docbook/images/callouts/14.gif new file mode 100644 index 0000000000000000000000000000000000000000..3d7a952a310523200521c1fa87b943637b5d1347 GIT binary patch literal 205 zcmZ?wbhEHbgwv|=H~A1 z?x|C!&Y3f3>C&Z}Hf`Fwcki)d$4;F(b@l4iTeogKe*F0D+qWM-e*E|E-+v6C_>+Z^ zkwKn82V@h-P6k%52kLdAD!mz@3~xRxVRG8g@v!IkBvpn+%|^iofu1ZH;zuVO=~9sr r<5W2yU@F+%-l|kl%h$jrvB98Ei)orw&!RI?aaY=tCf$Ck$Y2cs9-Uok literal 0 HcmV?d00001 diff --git a/docs/src/reference/docbook/images/callouts/14.png b/docs/src/reference/docbook/images/callouts/14.png new file mode 100644 index 0000000000000000000000000000000000000000..64014b75fe2e84d45ed861974c72462727979360 GIT binary patch literal 411 zcmV;M0c8G(P)!ax*-PXaQ9e~6^e1gu=a6a&KSz}bR`+prYG9ayB$BDjWGfIE;t#wl!+ zR3S(jA%y#i_@eOOedXoc%RQe%L;wH~k+s%ZI~)!<=dD%?4MaplaU9QPGski2q3`>r z(}{j@0a$CLl+)={2vLWml*i-oa5#J}DW$gCZB~Z!(!M#)2St|1_V^0qpmCrBof=Y&NUas@LmfSw=)4B4f;8Fu)(eFsv24 zJzXxBrayquXcR?J + + + +]> + + + + + + + + + diff --git a/docs/src/reference/docbook/images/callouts/15.gif b/docs/src/reference/docbook/images/callouts/15.gif new file mode 100644 index 0000000000000000000000000000000000000000..1c9183d5bb619eb608a5b7543f042ae7fd18684b GIT binary patch literal 210 zcmZ?wbhEHbi7h7121rhDKRRXS|PKBUy%7g1c%!6qXjM*TZ@!<7MXS&a1%XU+t0{XE z)7O>#600De0j~t#c`vY#Yeb1-X-P(Y5yQ%LXFPyHJS9LOm(=3qqRfJl%=|nCVNOM5 zpg0#u+&RCXvM4h>ql94%{~0TwC?8m~C^ZqJRG}m@H-L1 z5L@scq?{XUcxG{OP9jig5ySQaTl#^*93bKF#G<^+ymW>G($Cs~V(bw8rA5i93}62@ zzlJGu&d<$F%`0K}c4pdspcorSSx9C{PAbEScbC)|7#JBmT^vIy=9Eq_Jl&Ka(%QdX zh{H8O%#_7)Tc@t$mM`p4(Ne7omR*~(>gd8_8AZH{=3ms$Fmzm^yL@_+(#aQQ5>7QW z>3g2fIsH(ugM)!V$x4Rr_+!J_XU%4xbz0aE;^N{m@42Z|@0S@TQ=WbP`TMV5Ok;<| z^Ihv+@6tQ{sciRF9dD7Nr=KobwJJ68zJK$<1Pd9rz%4O)*;}Jzj&~nTGMecz>B%lV zK|`fmIc8mp-h8iSXiGFW=C(L+XH4DRxZQX87^-dLuD>odo6YLT@Sw)dfBEIG)v2@6 zR)%mL7GRj1x-&v&+2q@A%a&h0`Lw7|#(w_!tgT!PoJ|+re`l + + + +]> + + + + + + + + + diff --git a/docs/src/reference/docbook/images/callouts/16.svg b/docs/src/reference/docbook/images/callouts/16.svg new file mode 100644 index 0000000000..01d6bf8164 --- /dev/null +++ b/docs/src/reference/docbook/images/callouts/16.svg @@ -0,0 +1,20 @@ + + + + +]> + + + + + + + + + diff --git a/docs/src/reference/docbook/images/callouts/17.svg b/docs/src/reference/docbook/images/callouts/17.svg new file mode 100644 index 0000000000..0a04c5560e --- /dev/null +++ b/docs/src/reference/docbook/images/callouts/17.svg @@ -0,0 +1,17 @@ + + + + +]> + + + + + + + + + diff --git a/docs/src/reference/docbook/images/callouts/18.svg b/docs/src/reference/docbook/images/callouts/18.svg new file mode 100644 index 0000000000..1cb891b34d --- /dev/null +++ b/docs/src/reference/docbook/images/callouts/18.svg @@ -0,0 +1,21 @@ + + + + +]> + + + + + + + + + diff --git a/docs/src/reference/docbook/images/callouts/19.svg b/docs/src/reference/docbook/images/callouts/19.svg new file mode 100644 index 0000000000..e6fbb179fc --- /dev/null +++ b/docs/src/reference/docbook/images/callouts/19.svg @@ -0,0 +1,20 @@ + + + + +]> + + + + + + + + + diff --git a/docs/src/reference/docbook/images/callouts/2.gif b/docs/src/reference/docbook/images/callouts/2.gif new file mode 100644 index 0000000000000000000000000000000000000000..94d42a30f99b87314127dcd44e6162c2fdf26e6e GIT binary patch literal 907 zcmV;619bdHNk%w1VGIBa0O$Vz000010RaL60s{jB1Ox;H1qB8M1_uWR2nYxX2?+`c z3JVJh3=9kn4Gj(s4i66x5D*X%5fKs+5)%^>6ciK{6%`g178e&67#J8C85tTH8XFrM z92^`S9UUGX9v>ecARr(iAt53nA|oRsBqSsyB_$>%CMPE+C@3f?DJd!{Dl021EG#T7 zEiEoCE-x=HFfcGNF)=bSGBYzXG&D3dH8nOiHa9mnI5;>tIXOByIy*Z%JUl!-Jv}}? zK0iM{KtMo2K|w-7LPJACL_|bIMMXwNMn^|SNJvOYNl8jdN=r*iOiWBoO-)WtPESuy zP*6}&QBhJ-Qd3h?R8&+|RaI72R##V7SXfwDSy@_IT3cINTwGjTU0q&YUSD5dU|?Wj zVPRroVq;@tWMpJzWo2e&W@l$-XlQ6@X=!R|YHMq2Y;0_8ZEbFDZf|dIaBy&OadC2T za&vQYbaZreb#-=jc6WDoczAeud3kzzdV70&e0+R;eSLm@et&;|fPjF3fq{a8f`fyD zgoK2Jg@uNOhKGlTh=_=ZiHVAeii?YjjEszpjg5|uj*pLzkdTm(k&%*;l9Q8@l$4Z} zm6ev3mY0{8n3$NEnVFiJnwy)OoSdAUot>VZo}ZteprD|kp`oIpqNAguq@<*!rKP5( zrl+T;sHmu^si~@}s;jH3tgNi9t*x%EuCK4Ju&}VPv9YqUva_?Zw6wIfwY9dkwzs#p zxVX5vxw*Q!y1To(yu7@dCU$jHda z$;ryf%FD~k%*@Qq&CSlv&d<-!(9qD)(b3Y<($mw^)YR0~)z#M4*4Nk9*x1lt)=I7_<=;-L_>FMg~>g((4 z?Ck9A?d|UF?(gsK@bK{Q@$vHV^7Hfa^z`)g_4W4l_V@Sq`1ttw`T6?#`uqF){QUg= z{r&#_{{R2~A^8LW0RaC1EC2ui01N;O000PR0RIW3lmh~U9GnCyi~#^ZiVzKBECdk3 z+PQbeAOMias9`B<6z_Eez=$EqJq^9piin`0%NY0OG(^zSrIK^CY9cU6@*c{UBiGy; h6C(zOhK&9(xaY7e*=hH)_rZeB4|imU1$R#1`!P>&$poQl;nzm}mD5ZFopaX|GsS%q*{P~< z;WtmO%lhToBL0i}yfkaOt?EN=nkLNGuU`ywhI5H)L`iUdT1k0gQ7VIjhO(w-Zen_> zZ(@38a<+nro{^q~f~BRtfrY+-p+a&|W^qZSLvCepNoKNMYO!8QX+eHoiC%Jk?!;Y+ zJAlS%fsM;d&r2*R1)67JkeZlkYGj#gX_9E3W@4U_nw*@Ln38B@k(iuhnUeN2e + + + +]> + + + + + + + + diff --git a/docs/src/reference/docbook/images/callouts/20.svg b/docs/src/reference/docbook/images/callouts/20.svg new file mode 100644 index 0000000000..ccbfd40319 --- /dev/null +++ b/docs/src/reference/docbook/images/callouts/20.svg @@ -0,0 +1,20 @@ + + + + +]> + + + + + + + + + diff --git a/docs/src/reference/docbook/images/callouts/21.svg b/docs/src/reference/docbook/images/callouts/21.svg new file mode 100644 index 0000000000..93ec53fdd9 --- /dev/null +++ b/docs/src/reference/docbook/images/callouts/21.svg @@ -0,0 +1,18 @@ + + + + +]> + + + + + + + + + diff --git a/docs/src/reference/docbook/images/callouts/22.svg b/docs/src/reference/docbook/images/callouts/22.svg new file mode 100644 index 0000000000..f48c5f3fd1 --- /dev/null +++ b/docs/src/reference/docbook/images/callouts/22.svg @@ -0,0 +1,20 @@ + + + + +]> + + + + + + + + + diff --git a/docs/src/reference/docbook/images/callouts/23.svg b/docs/src/reference/docbook/images/callouts/23.svg new file mode 100644 index 0000000000..6624212957 --- /dev/null +++ b/docs/src/reference/docbook/images/callouts/23.svg @@ -0,0 +1,22 @@ + + + + +]> + + + + + + + + + diff --git a/docs/src/reference/docbook/images/callouts/24.svg b/docs/src/reference/docbook/images/callouts/24.svg new file mode 100644 index 0000000000..a3d552535f --- /dev/null +++ b/docs/src/reference/docbook/images/callouts/24.svg @@ -0,0 +1,19 @@ + + + + +]> + + + + + + + + + diff --git a/docs/src/reference/docbook/images/callouts/25.svg b/docs/src/reference/docbook/images/callouts/25.svg new file mode 100644 index 0000000000..56614a979a --- /dev/null +++ b/docs/src/reference/docbook/images/callouts/25.svg @@ -0,0 +1,21 @@ + + + + +]> + + + + + + + + + diff --git a/docs/src/reference/docbook/images/callouts/26.svg b/docs/src/reference/docbook/images/callouts/26.svg new file mode 100644 index 0000000000..56faeaca30 --- /dev/null +++ b/docs/src/reference/docbook/images/callouts/26.svg @@ -0,0 +1,22 @@ + + + + +]> + + + + + + + + + diff --git a/docs/src/reference/docbook/images/callouts/27.svg b/docs/src/reference/docbook/images/callouts/27.svg new file mode 100644 index 0000000000..a75c812159 --- /dev/null +++ b/docs/src/reference/docbook/images/callouts/27.svg @@ -0,0 +1,19 @@ + + + + +]> + + + + + + + + + diff --git a/docs/src/reference/docbook/images/callouts/28.svg b/docs/src/reference/docbook/images/callouts/28.svg new file mode 100644 index 0000000000..7f8cf1a350 --- /dev/null +++ b/docs/src/reference/docbook/images/callouts/28.svg @@ -0,0 +1,23 @@ + + + + +]> + + + + + + + + + diff --git a/docs/src/reference/docbook/images/callouts/29.svg b/docs/src/reference/docbook/images/callouts/29.svg new file mode 100644 index 0000000000..cb63adf1fe --- /dev/null +++ b/docs/src/reference/docbook/images/callouts/29.svg @@ -0,0 +1,22 @@ + + + + +]> + + + + + + + + + diff --git a/docs/src/reference/docbook/images/callouts/3.gif b/docs/src/reference/docbook/images/callouts/3.gif new file mode 100644 index 0000000000000000000000000000000000000000..dd3541a1bc25307e41416082525903a2337a2a43 GIT binary patch literal 914 zcmV;D18w|ANk%w1VGIBa0O$Vz000010RaL60s{jB1Ox;H1qB8M1_uWR2nYxX2?+`c z3JVJh3=9kn4Gj(s4i66x5D*X%5fKs+5)%^>6ciK{6%`g178e&67#J8C85tTH8XFrM z92^`S9UUGX9v>ecARr(iAt53nA|oRsBqSsyB_$>%CMPE+C@3f?DJd!{Dl021EG#T7 zEiEoCE-x=HFfcGNF)=bSGBYzXG&D3dH8nOiHa9mnI5;>tIXOByIy*Z%JUl!-Jv}}? zK0iM{KtMo2K|w-7LPJACL_|bIMMXwNMn^|SNJvOYNl8jdN=r*iOiWBoO-)WtPESuy zP*6}&QBhJ-Qd3h?R8&+|RaI72R##V7SXfwDSy@_IT3cINTwGjTU0q&YUSD5dU|?Wj zVPRroVq;@tWMpJzWo2e&W@l$-XlQ6@X=!R|YHMq2Y;0_8ZEbFDZf|dIaBy&OadC2T za&vQYbaZreb#-=jc6WDoczAeud3kzzdV70&e0+R;eSLm@et&;|fPjF3fq{a8f`fyD zgoK2Jg@uNOhKGlTh=_=ZiHVAeii?YjjEszpjg5|uj*pLzkdTm(k&%*;l9Q8@l$4Z} zm6ev3mY0{8n3$NEnVFiJnwy)OoSdAUot>VZo}ZteprD|kp`oIpqNAguq@<*!rKP5( zrl+T;sHmu^si~@}s;jH3tgNi9t*x%EuCK4Ju&}VPv9YqUva_?Zw6wIfwY9dkwzs#p zxVX5vxw*Q!y1To(yu7@dCU$jHda z$;ryf%FD~k%*@Qq&CSlv&d<-!(9qD)(b3Y<($mw^)YR0~)z#M4*4Nk9*x1lt)=I7_<=;-L_>FMg~>g((4 z?Ck9A?d|UF?(gsK@bK{Q@$vHV^7Hfa^z`)g_4W4l_V@Sq`1ttw`T6?#`uqF){QUg= z{r&#_{{R2~A^8LW0Ra90EC2ui01N;O000PY0R0K1lmh~U9GnCyi~#^ajvNR8#8?Ob zf;Vg4oI#N2j}ZU>bIu`v@NdmWMhq*as95r2jEElrv^r-ECIXlrbBwuXvSCUs9sxM3 o+a%2oj3IhTFJI8abOaK4? literal 0 HcmV?d00001 diff --git a/docs/src/reference/docbook/images/callouts/3.png b/docs/src/reference/docbook/images/callouts/3.png new file mode 100644 index 0000000000000000000000000000000000000000..ef7b70047158970cf4e09f1bab2954d39c2d596b GIT binary patch literal 350 zcmeAS@N?(olHy`uVBq!ia0vp^JRr;gBp8b2n5}^nQF0kK0(Y1u|9Rc(19XFPiEBhjaDG}zd16s2gM)^$re|(qda7?? zdS-IAf{C7yo`r&?rM`iMzJZ}aa#3b+Nu@(>WpPPnvR-PjUP@^}eqM=Qa(?c_U5Yz^ z#%Y0#%S_KpEGY$=XJL?(l#*ybuErX#^g`ttQfwn + + + +]> + + + + + + + + diff --git a/docs/src/reference/docbook/images/callouts/30.svg b/docs/src/reference/docbook/images/callouts/30.svg new file mode 100644 index 0000000000..dc43ba1e3c --- /dev/null +++ b/docs/src/reference/docbook/images/callouts/30.svg @@ -0,0 +1,22 @@ + + + + +]> + + + + + + + + + diff --git a/docs/src/reference/docbook/images/callouts/4.gif b/docs/src/reference/docbook/images/callouts/4.gif new file mode 100644 index 0000000000000000000000000000000000000000..4bcbf7e31a17497e65fa0ccc9756961130be6ac7 GIT binary patch literal 907 zcmV;619bdHNk%w1VGIBa0O$Vz000010RaL60s{jB1Ox;H1qB8M1_uWR2nYxX2?+`c z3JVJh3=9kn4Gj(s4i66x5D*X%5fKs+5)%^>6ciK{6%`g178e&67#J8C85tTH8XFrM z92^`S9UUGX9v>ecARr(iAt53nA|oRsBqSsyB_$>%CMPE+C@3f?DJd!{Dl021EG#T7 zEiEoCE-x=HFfcGNF)=bSGBYzXG&D3dH8nOiHa9mnI5;>tIXOByIy*Z%JUl!-Jv}}? zK0iM{KtMo2K|w-7LPJACL_|bIMMXwNMn^|SNJvOYNl8jdN=r*iOiWBoO-)WtPESuy zP*6}&QBhJ-Qd3h?R8&+|RaI72R##V7SXfwDSy@_IT3cINTwGjTU0q&YUSD5dU|?Wj zVPRroVq;@tWMpJzWo2e&W@l$-XlQ6@X=!R|YHMq2Y;0_8ZEbFDZf|dIaBy&OadC2T za&vQYbaZreb#-=jc6WDoczAeud3kzzdV70&e0+R;eSLm@et&;|fPjF3fq{a8f`fyD zgoK2Jg@uNOhKGlTh=_=ZiHVAeii?YjjEszpjg5|uj*pLzkdTm(k&%*;l9Q8@l$4Z} zm6ev3mY0{8n3$NEnVFiJnwy)OoSdAUot>VZo}ZteprD|kp`oIpqNAguq@<*!rKP5( zrl+T;sHmu^si~@}s;jH3tgNi9t*x%EuCK4Ju&}VPv9YqUva_?Zw6wIfwY9dkwzs#p zxVX5vxw*Q!y1To(yu7@dCU$jHda z$;ryf%FD~k%*@Qq&CSlv&d<-!(9qD)(b3Y<($mw^)YR0~)z#M4*4Nk9*x1lt)=I7_<=;-L_>FMg~>g((4 z?Ck9A?d|UF?(gsK@bK{Q@$vHV^7Hfa^z`)g_4W4l_V@Sq`1ttw`T6?#`uqF){QUg= z{r&#_{{R2~A^8LW0Ra90EC2ui01N;O000PR0R0JUB_%})C8Y!^R05!33J3slENlos z$-g-bCAOjn;oL=vlo&Q_Rq7qahA}WS)N&5Oy^{bCs0?8;#XUwUV=^4`uV>FvD1lN0 h@RA}Ue>sMFTjNk+(xCuSC=|#k1_T5#jtUG206WA?slNaK literal 0 HcmV?d00001 diff --git a/docs/src/reference/docbook/images/callouts/4.png b/docs/src/reference/docbook/images/callouts/4.png new file mode 100644 index 0000000000000000000000000000000000000000..adb8364eb5d21ecdd4086e16110b62ddcb42aa4a GIT binary patch literal 345 zcmeAS@N?(olHy`uVBq!ia0vp^JRr;gBp8b2n5}^nQ3r>K)tuC)r#2`iJ>Prt42#Ndx#Uc~1)>aw z3jE@Q4|!9Z%lVv}- zc=48cF7H)t`(Ck`^+mtha~Np7bBSw2NpOBzNqJ&XDuaWDvZiNlVtT4?VtQtBwt|VC zk)DNurKP@sg}#BILUK`NaY>~^Ze?*vX0l#tv0h4PL4IC|UUGi!#9fLzfW~Qojmu2W zODrh`nrE42VU(7fm~5G9U~HM3l#*m_WNcxOXkuz + + + +]> + + + + + + + + diff --git a/docs/src/reference/docbook/images/callouts/5.gif b/docs/src/reference/docbook/images/callouts/5.gif new file mode 100644 index 0000000000000000000000000000000000000000..1c62b4f920936c063c93d8551158a80500dfefbe GIT binary patch literal 916 zcmV;F18e+8Nk%w1VGIBa0O$Vz000010RaL60s{jB1Ox;H1qB8M1_uWR2nYxX2?+`c z3JVJh3=9kn4Gj(s4i66x5D*X%5fKs+5)%^>6ciK{6%`g178e&67#J8C85tTH8XFrM z92^`S9UUGX9v>ecARr(iAt53nA|oRsBqSsyB_$>%CMPE+C@3f?DJd!{Dl021EG#T7 zEiEoCE-x=HFfcGNF)=bSGBYzXG&D3dH8nOiHa9mnI5;>tIXOByIy*Z%JUl!-Jv}}? zK0iM{KtMo2K|w-7LPJACL_|bIMMXwNMn^|SNJvOYNl8jdN=r*iOiWBoO-)WtPESuy zP*6}&QBhJ-Qd3h?R8&+|RaI72R##V7SXfwDSy@_IT3cINTwGjTU0q&YUSD5dU|?Wj zVPRroVq;@tWMpJzWo2e&W@l$-XlQ6@X=!R|YHMq2Y;0_8ZEbFDZf|dIaBy&OadC2T za&vQYbaZreb#-=jc6WDoczAeud3kzzdV70&e0+R;eSLm@et&;|fPjF3fq{a8f`fyD zgoK2Jg@uNOhKGlTh=_=ZiHVAeii?YjjEszpjg5|uj*pLzkdTm(k&%*;l9Q8@l$4Z} zm6ev3mY0{8n3$NEnVFiJnwy)OoSdAUot>VZo}ZteprD|kp`oIpqNAguq@<*!rKP5( zrl+T;sHmu^si~@}s;jH3tgNi9t*x%EuCK4Ju&}VPv9YqUva_?Zw6wIfwY9dkwzs#p zxVX5vxw*Q!y1To(yu7@dCU$jHda z$;ryf%FD~k%*@Qq&CSlv&d<-!(9qD)(b3Y<($mw^)YR0~)z#M4*4Nk9*x1lt)=I7_<=;-L_>FMg~>g((4 z?Ck9A?d|UF?(gsK@bK{Q@$vHV^7Hfa^z`)g_4W4l_V@Sq`1ttw`T6?#`uqF){QUg= z{r&#_{{R2~A^8LW0Ra90EC2ui01N;O000Pa0R0K%lmi2V9E=1i%z+?9iV!If#8?O* z$G>+Nl>kWLuM~ia{}6l}$w(u}R?Y~C1P}wmM~j4%oa6KnflB}(2z_MquBJ%{T0T-b q_c4Y?mj9H5@J4B;zZ@S4y}MTm!bXY!5Uk{=&>tm+5)%px2mm_@=(0fo literal 0 HcmV?d00001 diff --git a/docs/src/reference/docbook/images/callouts/5.png b/docs/src/reference/docbook/images/callouts/5.png new file mode 100644 index 0000000000000000000000000000000000000000..4d7eb460021e845981861d77614539314f553993 GIT binary patch literal 348 zcmeAS@N?(olHy`uVBq!ia0vp^JRr;gBp8b2n5}^nQEX4g z+-vfUhb0A>b04=Im{6XiQd1v%r%>h0$G8U7E1If8OQ!N~xOYY5h0NDT$p9(iZ?Q&e z18-(+l~J8O`)kc}e&uL$eW&>P-#`~Qm$*ih1m~xflqVLYGB{``YkKA;rl!p+yCFkc(+@-h!Xq*<< zxXkpt#FA2=d1VEBsYynrsitN|Y01eJ$;p;U#>wWX2KP5v&I9V=1L+C? fTFYQ)RAFeOZJ=$?lDoSWD8u0C>gTe~DWM4f^}upZ literal 0 HcmV?d00001 diff --git a/docs/src/reference/docbook/images/callouts/5.svg b/docs/src/reference/docbook/images/callouts/5.svg new file mode 100644 index 0000000000..ca7a9f22f6 --- /dev/null +++ b/docs/src/reference/docbook/images/callouts/5.svg @@ -0,0 +1,18 @@ + + + + +]> + + + + + + + + diff --git a/docs/src/reference/docbook/images/callouts/6.gif b/docs/src/reference/docbook/images/callouts/6.gif new file mode 100644 index 0000000000000000000000000000000000000000..23bc5555d2a467d6c3025d7f334a2b5546bd4fd9 GIT binary patch literal 218 zcmZ?wbhEHbqb0L)3{T$ zGFay|aIp&P&{^Zgxx_WmLz?s!{{N9Xg1xktx)&MH` BUFZM+ literal 0 HcmV?d00001 diff --git a/docs/src/reference/docbook/images/callouts/6.png b/docs/src/reference/docbook/images/callouts/6.png new file mode 100644 index 0000000000000000000000000000000000000000..0ba694af6c07d947d219b45a629bd32c60a0f5fe GIT binary patch literal 355 zcmeAS@N?(olHy`uVBq!ia0vp^JRr;gBp8b2n5}^nQ*)Bra@SU# zmiz#bR~{$s2si{S(aY|Z}Vd7tb ouUmn-_&~Y>fYve?8dVq?X&Y!8wB+ut1 + + + +]> + + + + + + + + diff --git a/docs/src/reference/docbook/images/callouts/7.gif b/docs/src/reference/docbook/images/callouts/7.gif new file mode 100644 index 0000000000000000000000000000000000000000..e55ce89585a8d5f80cc1a83df537578983a4d8e5 GIT binary patch literal 907 zcmV;619bdHNk%w1VGIBa0O$Vz000010RaL60s{jB1Ox;H1qB8M1_uWR2nYxX2?+`c z3JVJh3=9kn4Gj(s4i66x5D*X%5fKs+5)%^>6ciK{6%`g178e&67#J8C85tTH8XFrM z92^`S9UUGX9v>ecARr(iAt53nA|oRsBqSsyB_$>%CMPE+C@3f?DJd!{Dl021EG#T7 zEiEoCE-x=HFfcGNF)=bSGBYzXG&D3dH8nOiHa9mnI5;>tIXOByIy*Z%JUl!-Jv}}? zK0iM{KtMo2K|w-7LPJACL_|bIMMXwNMn^|SNJvOYNl8jdN=r*iOiWBoO-)WtPESuy zP*6}&QBhJ-Qd3h?R8&+|RaI72R##V7SXfwDSy@_IT3cINTwGjTU0q&YUSD5dU|?Wj zVPRroVq;@tWMpJzWo2e&W@l$-XlQ6@X=!R|YHMq2Y;0_8ZEbFDZf|dIaBy&OadC2T za&vQYbaZreb#-=jc6WDoczAeud3kzzdV70&e0+R;eSLm@et&;|fPjF3fq{a8f`fyD zgoK2Jg@uNOhKGlTh=_=ZiHVAeii?YjjEszpjg5|uj*pLzkdTm(k&%*;l9Q8@l$4Z} zm6ev3mY0{8n3$NEnVFiJnwy)OoSdAUot>VZo}ZteprD|kp`oIpqNAguq@<*!rKP5( zrl+T;sHmu^si~@}s;jH3tgNi9t*x%EuCK4Ju&}VPv9YqUva_?Zw6wIfwY9dkwzs#p zxVX5vxw*Q!y1To(yu7@dCU$jHda z$;ryf%FD~k%*@Qq&CSlv&d<-!(9qD)(b3Y<($mw^)YR0~)z#M4*4Nk9*x1lt)=I7_<=;-L_>FMg~>g((4 z?Ck9A?d|UF?(gsK@bK{Q@$vHV^7Hfa^z`)g_4W4l_V@Sq`1ttw`T6?#`uqF){QUg= z{r&#_{{R2~A^8LW0Ra90EC2ui01N;O000PR0R0K9B_%})C9MQ1lmY=mLkJLZDAWR= z)xV4XtO1DOuNQ!iA2FPx2!IkvkhMI1%n<`504eucencSiqqSNt5uD8NPm0SJI6pGF hhrlHxe@Z^q3i>gHLLn}jDip{m2Lc2sjtUG206SSyt84%O literal 0 HcmV?d00001 diff --git a/docs/src/reference/docbook/images/callouts/7.png b/docs/src/reference/docbook/images/callouts/7.png new file mode 100644 index 0000000000000000000000000000000000000000..472e96f8ac36862c5645732f2fff19d06ee11a8e GIT binary patch literal 344 zcmeAS@N?(olHy`uVBq!ia0vp^JRr;gBp8b2n5}^nQu%w%U~xZhnMEEs6JbBSw2NpOBzNqJ&XDuaWDvZiNlVtT4?VtQtBwt|VC zk)DNurKP@sg}#BILUK`NaY>~^Ze?*vX0l#tv0h4PL4IC|UUGi!#9fLzfW~Qojmu2W zODrh`nrCEbVQgk$XkwI@Y+{_8nv`N>YGIaQkz#0QY@Te9lBQ<)awbq0A4pdK&{_sV bqY6VKZ3AtCmfYR7Kp6&4S3j3^P6 + + + +]> + + + + + + + + diff --git a/docs/src/reference/docbook/images/callouts/8.gif b/docs/src/reference/docbook/images/callouts/8.gif new file mode 100644 index 0000000000000000000000000000000000000000..49375e09f4cc6397837fbb494c6c3cb1bca7091b GIT binary patch literal 918 zcmV;H18Mw6Nk%w1VGIBa0O$Vz000010RaL60s{jB1Ox;H1qB8M1_uWR2nYxX2?+`c z3JVJh3=9kn4Gj(s4i66x5D*X%5fKs+5)%^>6ciK{6%`g178e&67#J8C85tTH8XFrM z92^`S9UUGX9v>ecARr(iAt53nA|oRsBqSsyB_$>%CMPE+C@3f?DJd!{Dl021EG#T7 zEiEoCE-x=HFfcGNF)=bSGBYzXG&D3dH8nOiHa9mnI5;>tIXOByIy*Z%JUl!-Jv}}? zK0iM{KtMo2K|w-7LPJACL_|bIMMXwNMn^|SNJvOYNl8jdN=r*iOiWBoO-)WtPESuy zP*6}&QBhJ-Qd3h?R8&+|RaI72R##V7SXfwDSy@_IT3cINTwGjTU0q&YUSD5dU|?Wj zVPRroVq;@tWMpJzWo2e&W@l$-XlQ6@X=!R|YHMq2Y;0_8ZEbFDZf|dIaBy&OadC2T za&vQYbaZreb#-=jc6WDoczAeud3kzzdV70&e0+R;eSLm@et&;|fPjF3fq{a8f`fyD zgoK2Jg@uNOhKGlTh=_=ZiHVAeii?YjjEszpjg5|uj*pLzkdTm(k&%*;l9Q8@l$4Z} zm6ev3mY0{8n3$NEnVFiJnwy)OoSdAUot>VZo}ZteprD|kp`oIpqNAguq@<*!rKP5( zrl+T;sHmu^si~@}s;jH3tgNi9t*x%EuCK4Ju&}VPv9YqUva_?Zw6wIfwY9dkwzs#p zxVX5vxw*Q!y1To(yu7@dCU$jHda z$;ryf%FD~k%*@Qq&CSlv&d<-!(9qD)(b3Y<($mw^)YR0~)z#M4*4Nk9*x1lt)=I7_<=;-L_>FMg~>g((4 z?Ck9A?d|UF?(gsK@bK{Q@$vHV^7Hfa^z`)g_4W4l_V@Sq`1ttw`T6?#`uqF){QUg= z{r&#_{{R2~A^8LW0Ra90EC2ui01N;O000Pc0R0JUB_%}&DWwD|R0041gb)pLC=}AL zls9X=AOMKruT(=N_cWfH(~uHF0760{c(%ZJL2W6v;Y7A literal 0 HcmV?d00001 diff --git a/docs/src/reference/docbook/images/callouts/8.png b/docs/src/reference/docbook/images/callouts/8.png new file mode 100644 index 0000000000000000000000000000000000000000..5e60973c213b37df93666c5a00724f34493974ae GIT binary patch literal 357 zcmeAS@N?(olHy`uVBq!ia0vp^JRr;gBp8b2n5}^nQu&S`V$cAh@R~F=4@V4jxkzlaQrcFYWK{)(`o5XZnut z=nE4SU2g1ZW%;@@I$>_e3F8a=8WK~|CVXt1DqisQxtIX|`YW_n&?Nh#1gQ}d)$LrYTw(_{nVG)tp2V+#}WG*e^KRLdkoLz7g? qn(IA84Qgo42`r6v<+Hvch>@C7(8A5T-G@yGywn*$#_oy literal 0 HcmV?d00001 diff --git a/docs/src/reference/docbook/images/callouts/8.svg b/docs/src/reference/docbook/images/callouts/8.svg new file mode 100644 index 0000000000..c1803a3c0d --- /dev/null +++ b/docs/src/reference/docbook/images/callouts/8.svg @@ -0,0 +1,20 @@ + + + + +]> + + + + + + + + diff --git a/docs/src/reference/docbook/images/callouts/9.gif b/docs/src/reference/docbook/images/callouts/9.gif new file mode 100644 index 0000000000000000000000000000000000000000..da12a4fe2825716c78f2d23c2f87afde98d3dd3e GIT binary patch literal 923 zcmV;M17!S1Nk%w1VGIBa0O$Vz000010RaL60s{jB1Ox;H1qB8M1_uWR2nYxX2?+`c z3JVJh3=9kn4Gj(s4i66x5D*X%5fKs+5)%^>6ciK{6%`g178e&67#J8C85tTH8XFrM z92^`S9UUGX9v>ecARr(iAt53nA|oRsBqSsyB_$>%CMPE+C@3f?DJd!{Dl021EG#T7 zEiEoCE-x=HFfcGNF)=bSGBYzXG&D3dH8nOiHa9mnI5;>tIXOByIy*Z%JUl!-Jv}}? zK0iM{KtMo2K|w-7LPJACL_|bIMMXwNMn^|SNJvOYNl8jdN=r*iOiWBoO-)WtPESuy zP*6}&QBhJ-Qd3h?R8&+|RaI72R##V7SXfwDSy@_IT3cINTwGjTU0q&YUSD5dU|?Wj zVPRroVq;@tWMpJzWo2e&W@l$-XlQ6@X=!R|YHMq2Y;0_8ZEbFDZf|dIaBy&OadC2T za&vQYbaZreb#-=jc6WDoczAeud3kzzdV70&e0+R;eSLm@et&;|fPjF3fq{a8f`fyD zgoK2Jg@uNOhKGlTh=_=ZiHVAeii?YjjEszpjg5|uj*pLzkdTm(k&%*;l9Q8@l$4Z} zm6ev3mY0{8n3$NEnVFiJnwy)OoSdAUot>VZo}ZteprD|kp`oIpqNAguq@<*!rKP5( zrl+T;sHmu^si~@}s;jH3tgNi9t*x%EuCK4Ju&}VPv9YqUva_?Zw6wIfwY9dkwzs#p zxVX5vxw*Q!y1To(yu7@dCU$jHda z$;ryf%FD~k%*@Qq&CSlv&d<-!(9qD)(b3Y<($mw^)YR0~)z#M4*4Nk9*x1lt)=I7_<=;-L_>FMg~>g((4 z?Ck9A?d|UF?(gsK@bK{Q@$vHV^7Hfa^z`)g_4W4l_V@Sq`1ttw`T6?#`uqF){QUg= z{r&#_{{R2~A^8LW0Ra90EC2ui01N;O000Ph0R0JUB_%}&DXj!56aoMM1PBdtC{zLf zK`U$LN=5Y7s^J`O2r%5!(vT8G0Hrztu%;0}4h#+VfE3xQVaSFMdc8Y$u9i)PHW47O xMyX+pmO}1@Q1UNFLq`6b0%-N`-I|6e6vnXG5I_uX3jI-v0Rce_r~(5506VSIvSt7P literal 0 HcmV?d00001 diff --git a/docs/src/reference/docbook/images/callouts/9.png b/docs/src/reference/docbook/images/callouts/9.png new file mode 100644 index 0000000000000000000000000000000000000000..a0676d26cc2ff1de12c4ecdeefb44a0d71bc6bde GIT binary patch literal 357 zcmeAS@N?(olHy`uVBq!ia0vp^JRr;gBp8b2n5}^nQNRqa;^5&H%t0&v*|C|wdb9$wI zR@+N9#RIowg@Uqn&z-__Tzhhz!sG|vTxA7?=O|Y?u(d4T{!RM9c7chr6d%1?R=i16 z?@Ic{f32YJFJnVhX)qGzOMplv!L->5yAlT#}irms+fsQd*FoSE84k zpF44v;trs3T43Wc)AJHbN`dAXo0u6Hr<$gkq?lM38ycjV7+5A5Sr{ayr5c%-n;95g pF*H#D>f!_G3IJNmU}#ifXryhRZP1dtyA~+J;OXk;vd$@?2>@J{cB%jX literal 0 HcmV?d00001 diff --git a/docs/src/reference/docbook/images/callouts/9.svg b/docs/src/reference/docbook/images/callouts/9.svg new file mode 100644 index 0000000000..bc149d3cb2 --- /dev/null +++ b/docs/src/reference/docbook/images/callouts/9.svg @@ -0,0 +1,19 @@ + + + + +]> + + + + + + + + diff --git a/src/docbkx/resources/images/chain.png b/docs/src/reference/docbook/images/chain.png similarity index 100% rename from src/docbkx/resources/images/chain.png rename to docs/src/reference/docbook/images/chain.png diff --git a/src/docbkx/resources/images/channel.png b/docs/src/reference/docbook/images/channel.png similarity index 100% rename from src/docbkx/resources/images/channel.png rename to docs/src/reference/docbook/images/channel.png diff --git a/src/docbkx/resources/images/gateway.png b/docs/src/reference/docbook/images/gateway.png similarity index 100% rename from src/docbkx/resources/images/gateway.png rename to docs/src/reference/docbook/images/gateway.png diff --git a/src/docbkx/resources/images/handler-endpoint.png b/docs/src/reference/docbook/images/handler-endpoint.png similarity index 100% rename from src/docbkx/resources/images/handler-endpoint.png rename to docs/src/reference/docbook/images/handler-endpoint.png diff --git a/src/docbkx/resources/images/handler.png b/docs/src/reference/docbook/images/handler.png similarity index 100% rename from src/docbkx/resources/images/handler.png rename to docs/src/reference/docbook/images/handler.png diff --git a/docs/src/reference/docbook/images/important.png b/docs/src/reference/docbook/images/important.png new file mode 100644 index 0000000000000000000000000000000000000000..12c90f607a1b27ddde0a7d922ae255e8c90e883e GIT binary patch literal 722 zcmV;@0xkWCP)Gdz_qOoSb{LwMwNgp7=gl$4aErG%}mjHRWNrKOy`y@b8JoTa6ut*xc4t*y1SwY|N)#>U3Z&d%1> z*52OU=jZ3|@9+2b_y7O@tTMkk%M`~Kg@u8&dg_P^_0l3yQb639!jLZt^Lx<-O17UeeJ z-|=!77W(jGx&e#?FOku-gKofoU0$~4M+dhLFueEauP`}l7LV=;lsOdn%WHure=x;k`m0(bF&MU#) z-qv#^n8(MjB|ykioqII#+`g4no-MU=BK|Sahu_3M_-d*=7hq=~t?^}A)G7 zbairN0An*{V`DL9V>K}|HDobmIW;*pIW=W9HaTQ6F*7kTGI9=S@Bjb+07*qoM6N<$ Ef=i}M4FCWD literal 0 HcmV?d00001 diff --git a/src/docbkx/resources/images/loan-broker-eip.png b/docs/src/reference/docbook/images/loan-broker-eip.png similarity index 100% rename from src/docbkx/resources/images/loan-broker-eip.png rename to docs/src/reference/docbook/images/loan-broker-eip.png diff --git a/src/docbkx/resources/images/logo.png b/docs/src/reference/docbook/images/logo.png similarity index 100% rename from src/docbkx/resources/images/logo.png rename to docs/src/reference/docbook/images/logo.png diff --git a/src/docbkx/resources/images/message-bus.png b/docs/src/reference/docbook/images/message-bus.png similarity index 100% rename from src/docbkx/resources/images/message-bus.png rename to docs/src/reference/docbook/images/message-bus.png diff --git a/src/docbkx/resources/images/message.png b/docs/src/reference/docbook/images/message.png similarity index 100% rename from src/docbkx/resources/images/message.png rename to docs/src/reference/docbook/images/message.png diff --git a/docs/src/reference/docbook/images/note.png b/docs/src/reference/docbook/images/note.png new file mode 100644 index 0000000000000000000000000000000000000000..ad57f6f72e2c4ecf45f1443887956132174516b5 GIT binary patch literal 1178 zcmV;L1ZDe)P)moeK~^j3|1ZFhpMb?+WF}Ff9N7 zmErhobEp9j5E&T>5I`t;kO9cfTd$9u{p)!4mdSYr_oELMKxO`8fExuu`}Xa_X%s*J z;k5%RU^)9_1HbrEAnW_@&$?VY5IT%y0zUnF^O@-#d^ z;BG^A?vn+{PTFEX1{PN_GJ*uLxC){aAb@cC1E)8D`1jwRbIx0;O9}pC`Tg?kSGIp< zKB_&OY}`0CurjlYiG39lllaN_k5hz2i0S#$-wFT!|K4`;dcMU?>>(H|ck|bajPDf_+bTg z9%3_tgdnDq97;?KBm#f{qP-0yYXC*uuG?Mj|F0AjX8-!(|L1QU8UmSSvSIlAu=cKj zft)Ik{gLSn|38s`tUu4+xosx6OhMQHyOWrHdNZ*8{mAqd7%Lx{-+cQ2*+^dNDRk(nWU|nV9%kgwK6Q#22j7&lq?ctN;4*_ZRE0Uz={R|6yke zQkMELkC#ILdnjd^T)1_|=EBpfoPXH_ef2r?CH`jZX8HMLU>HeX6b8fym`sd4= z%V{i6<|iS`5=eaieto~1!*jh@!qUoy*wp&!-sMH10>A)SzI-{csg;q5nc@GxKY#u( zGcymu#0L;yBs+=bE+QxUz*ETMkC*SgJMtHp!dZa9&iL);Pf0#K32t>EE_rqq4)QF3 z2GNN}%g?_pcF{3rW8nk}{ABp~mFd0ke+i)MufM+@e|`A;&DUR_6;uTxO=TiDSh+~H z;N$nVt8RH1>2fgsXJP)&%EG|P@}K=H(+5TdM*e@opP4=~{%7Q2;A3HCeEi|*@!L;b zWv1y%d6E{%pMSnzbivnLlTDOI{O{kt{}}%LVfgif`TMuO9|i7mewF;q%`Xbfvfmg! zv9d6K`tbGKZI*b04V{+d%EvDF`_CUx+%WwA%le<`)en|+&lrFG z|K=yiq#(%6!2SO7>udMKWAv5*>raxC>7(~ow%@7b=f9<RrvN?@N=6_W$>fXUp?HoLmA7B{mTyQNIQz6=yDPUS?({d<7(_ z;Lo>@5Bl65mWsTpk!*AZH8Uh6B%VEcMnY{)5PbdqOG-`|ly8}!5q{vn0f-be%c31S scAPwUQdCqlK0cnCn|rtvb~LvD06A7<`Vr(<>Hq)$07*qoM6N<$fll{>(OzfJ4N{OX={Q&zNgO}j31DC;|ya^r9Fjd348&p+!^cT+^sws+=& zCu*T*mRNK3PE;$BNx$Fa_9(Y=&DoXLMFRd#U31O)<`W^F&-o=xbIqK-c?mr!bmn>! zky6TW;ML~4nXw$T{yra=OteL6G!=B;0=?;6;u=vBoS#-wo>-L1;Gm(b>6x3Dp6Z*J zo|&AjV4`QFXQ5zesc&GRZ(yj9T$EW{Qt6OeSzMBtte0A>mr`1gpI4%noS!>!m*Ngk zP=bxiOwUU!DFvFBnrfM1VQy}0X_lO7WM-b2nq**TZkb|inr2~`WR#dJWc*7VsEZGz hD*$LMgOO>4k%_i}w!yxSoa=!y44$rjF6*2UngF(YpwIvS literal 0 HcmV?d00001 diff --git a/src/docbkx/resources/images/xdev-spring_logo.jpg b/docs/src/reference/docbook/images/xdev-spring_logo.jpg similarity index 100% rename from src/docbkx/resources/images/xdev-spring_logo.jpg rename to docs/src/reference/docbook/images/xdev-spring_logo.jpg diff --git a/docs/src/reference/docbook/index.xml b/docs/src/reference/docbook/index.xml new file mode 100644 index 0000000000..3317238c14 --- /dev/null +++ b/docs/src/reference/docbook/index.xml @@ -0,0 +1,98 @@ + + + + Spring Integration Reference Manual + Spring Integration ${version} + Spring Integration + ${version} + + + + + + + + + + + + + + + Mark + Fisher + + + Marius + Bogoevici + + + Iwein + Fuld + + + Jonas + Partner + + + Oleg + Zhurakousky + + + Gary + Russell + + + Josh + Long + + + + © SpringSource Inc., 2010 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/docs/src/reference/docbook/ip.xml b/docs/src/reference/docbook/ip.xml new file mode 100644 index 0000000000..9f3dd98307 --- /dev/null +++ b/docs/src/reference/docbook/ip.xml @@ -0,0 +1,881 @@ + + + TCP and UDP Support + + Spring Integration provides Channel Adapters for receiving and sending messages over internet protocols. Both UDP + (User Datagram Protocol) + and TCP (Transmission Control Protocol) adapters are provided. Each adapter provides for one-way communication + over the underlying protocol. + In addition, simple inbound and outbound tcp gateways are provided. These are used when two-way communication is + needed. + +
+ Introduction + + Two flavors each of UDP inbound and outbound adapters are provided UnicastSendingMessageHandler + sends a datagram packet to a single destination. UnicastReceivingChannelAdapter receives + incoming datagram packets. MulticastSendingMessageHandler sends (broadcasts) datagram packets to + a multicast address. MulticastReceivingChannelAdapter receives incoming datagram packets + by joining to a multicast address. + + + TCP inbound and outbound adapters are provided TcpSendingMessageHandler + sends messages over TCP. TcpReceivingChannelAdapter receives messages over TCP. + + + An inbound TCP gateway is provided; this allows for simple request/response processing. While + the gateway can support any number of connections, each connection can only process serially. The thread + that reads from the socket waits for, and sends, the response before reading again. If the connection factory + is configured for single use connections, the connection is closed after the socket times out. + + + An outbound TCP gateway is provided; this allows for simple request/response processing. + If the associated connection factory is configured for single use connections, a new connection is + immediately created for each new request. Otherwise, if the connection is in use, + the calling thread blocks on the connection until either a response is received or a timeout + or I/O error occurs. + +
+
+ UDP Adapters + + ]]> + A simple UDP outbound channel adapter. + + When setting multicast to true, provide the multicast address in the host + attribute. + + + + UDP is an efficient, but unreliable protocol. Two attributes are added to improve reliability. When check-length is + set to true, the adapter precedes the message data with a length field (4 bytes in network byte order). This enables + the receiving side to verify the length of the packet received. If a receiving system uses a buffer that is too + short the contain the packet, the packet can be truncated. The length header provides a mechanism to detect this. + + + ]]> + An outbound channel adapter that adds length checking to the datagram packets. + + The recipient of the packet must also be configured to expect a length to precede the + actual data. For a Spring Integration UDP inbound channel adapter, set its + check-length attribute. + + + + The second reliability improvement allows an application-level acknowledgment protocol to be used. The receiver + must send an acknowledgment to the sender within a specified time. + + + ]]> + An outbound channel adapter that adds length checking to the datagram packets and waits for an acknowledgment. + + Setting acknowledge to true implies the recipient of the packet can interpret the header added to the packet + containing acknowledgment data (host and port). Most likely, the recipient will be a Spring Integration inbound + channel adapter. + + + When multicast is true, an additional attribute min-acks-for-success specifies + how many acknowledgments must be received within the ack-timeout. + + + + For even more reliable networking, TCP can be used. + + + ]]> + A basic unicast inbound udp channel adapter. + + + ]]> + A basic multicast inbound udp channel adapter. + +
+
+ TCP Connection Factories + + For TCP, the configuration of the underlying connection is provided using a + Connection Factory. Two types of connection factory are provided; a + client connection factory and a server connection factory. Client connection + factories are used to establish outgoing connections; Server connection factories + listen for incoming connections. + + + A client connection factory is used + by an outbound channel adapter but a reference to a client connection factory + can also be provided to an inbound channel adapter and that adapter will receive + any incoming messages received on connections created by the outbound adapter. + + + A server connection factory is used by an inbound channel adapter or gateway (in fact + the connection factory will not function without one). A reference to a server + connection factory can also be provided to an outbound adapter; that adapter + can then be used to send replies to incoming messages to the same connection. + Reply messages will only be routed to the connection if the reply contains + the header $ip_connection_id that was inserted into the original message by + the connection factory. + This is the extent of message correlation performed when sharing connection + factories between inbound and outbound adapters. Such sharing allows for + asynchronous two-way communication over TCP. Only payload information is + transferred using TCP; therefore any message correlation must be performed + by downstream components such as aggregators or other endpoints. + + + A maximum of one adapter of each type may be given a reference to a connection + factory. + + + Connection factories using java.net.Socket and + java.nio.channel.SocketChannel are provided. + + + ]]> + A simple server connection factory that uses java.net.Socket + connections. + + + ]]> + A simple server connection factory that uses java.nio.channel.SocketChannel + connections. + + + ]]> + A client connection factory that uses java.net.Socket + connections and creates a new connection for each message. + + + ]]> + A client connection factory that uses java.nio.channel.Socket + connections and creates a new connection for each message. + + + TCP is a streaming protocol; this means that some structure has to be provided to data + transported over TCP, so the receiver can demarcate the data into discrete messages. + Connection factories are configured to use (de)serializers to convert between the message + payload and the bits that are sent over TCP. This is accomplished by providing a + deserializer and serializer for inbound and outbound messages respectively. + Four standard (de)serializers are provided; the first is ByteArrayCrlfSerializer, + which can convert a byte array to a stream of bytes followed by carriage + return and linefeed characters (\r\n). This is the default (de)serializer and can be used with + telnet as a client, for example. The second is is ByteArrayStxEtxSerializer, + which can convert a byte array to a stream of bytes preceded by an STX (0x02) and + followed by an ETX (0x03). The third is ByteArrayLengthHeaderSerializer, + which can convert a byte array to a stream of bytes preceded by a 4 byte binary + length in network byte order. Each of these is a subclass of + AbstractByteArraySerializer which implements both + org.springframework.core.serializer.Serializer and + org.springframework.core.serializer.Deserializer. + For backwards compatibility, connections using any subclass of + AbstractByteArraySerializer for serialization + will also accept a String which will be converted to a byte array first. + Each of these (de)serializers converts an input stream containing the + corresponding format to a byte array payload. The fourth standard serializer is + org.springframework.core.serializer.DefaultSerializer which can be + used to convert Serializable objects using java serialization. + org.springframework.core.serializer.DefaultDeserializer is provided for + inbound deserialization of streams containing Serializable objects. + To implement a custom (de)serializer pair, implement the + org.springframework.core.serializer.Deserializer and + org.springframework.core.serializer.Serializer interfaces. If you do not wish to use + the default (de)serializer (ByteArrayCrLfSerializer), you must supply + serializer and + deserializer attributes on the connection factory (example below). + + + + + + ]]> + A server connection factory that uses java.net.Socket + connections and uses Java serialization on the wire. + + + For full details of the attributes available on connection factories, see the + reference at the end of this section. + +
+
+ Tcp Connection Interceptors + + Connection factories can be configured with a reference to a + TcpConnectionInterceptorFactoryChain. Interceptors can be used + to add behavior to connections, such as negotiation, security, and other setup. + No interceptors are currently provided by the framework but, for an example, + see the InterceptedSharedConnectionTests in the source + repository. + + + The HelloWorldInterceptor used in the test case works as follows: + + + When configured with a client connection factory, + when the first message is sent over a connection that is intercepted, the interceptor + sends 'Hello' over the connection, and expects to receive 'world!'. When that occurs, + the negotiation is complete and the original message is sent; further messages + that use the same connection are sent without any additional negotiation. + + + When configured with a server connection factory, the interceptor requires the first + message to be 'Hello' and, if it is, returns 'world!'. Otherwise it throws an exception causing + the connection to be closed. + + + All TcpConnection methods are intercepted. + Interceptor instances are created for each connection by an interceptor factory. + If an interceptor is stateful, the factory should create a new instance for each connection. + Interceptor + factories are added to the configuration of an interceptor factory chain, which is provided + to a connection factory using the interceptor-factory attribute. + Interceptors must implement the TcpConnectionInterceptor interface; + factories + must implement the TcpConnectionInterceptorFactory interface. A + convenience class AbstractTcpConnectionInterceptor is provided + with passthrough methods; by extending this class, you only need to implement those + methods you wish to intercept. + + + + + + + + + + + + +]]> + Configuring a connection interceptor factory chain. + +
+
+ TCP Adapters + + TCP inbound and outbound channel adapters that utilize the above connection + factories are provided. These adapters have just 2 attributes + connection-factory and channel. + The channel attribute specifies the channel on which messages arrive at an + outbound adapter and on which messages are placed by an inbound adapter. + The connection-factory attribute indicates which connection factory is to be used to + manage connections for the adapter. While both inbound and outbound adapters + can share a connection factory, server connection factories are always 'owned' + by an inbound adapter; client connection factories are always 'owned' by an + outbound adapter. One, and only one, adapter of each type may get a reference + to a connection factory. + + + + + + + + + + + + + + + + + + + + + + + + ]]> + In this configuration, messages arriving in channel 'input' + are serialized over connections created by 'client' received + at the server and placed on channel 'loop'. Since 'loop' is + the input channel for 'outboundServer' the message is simply + looped back over the same connection and received by + 'inboundClient' and deposited in channel 'replies'. Java + serialization is used on the wire. + +
+
+ TCP Gateways + + The inbound TCP gateway TcpInboundGateway + and oubound TCP gateway TcpOutboundGateway + use a server and client connection factory respectively. Each connection + can process a single request/response at a time. + + + The intbound gateway, after constructing a message with the incoming payload and sending + it to the requestChannel, waits for a response and sends the payload + from the response message by writing it to the connection. + + + The outbound gateway, after sending a message over the connection, waits for a response and + constructs a response message and puts in on the reply channel. + Communications over the connections are single-threaded. Users should be aware that only one + message can be handled at a time and, if another thread attempts to send + a message before the current response has been received, it will block until + any previous requests are complete (or time out). + If, however, the client connection factory is configured for single-use connections + each new request gets its own connection and is processed immediately. + + + ]]> + A simple inbound TCP gateway; if a connection factory configured with the default + (de)serializer is used, messages will be \r\n delimited data and the gateway can be + used by a simple client such as telnet. + + + ]]> + A simple oubound TCP gateway. + +
+
+ IP Configuration Attributes + + + Connection Factory Attributes + + + + + + + + + + Attribute Name + Client? + Server? + Allowed Values + Attribute Description + + + + + type + Y + Y + client, server + Determines whether the connection factory is a client or server. + + + host + Y + N + + The host name or ip address of the destination. + + + port + Y + Y + + The port. + + + serializer + Y + Y + + An implementation of Serializer used to serialize + the payload. Defaults to ByteArrayCrLfSerializer + + + deserializer + Y + Y + + An implementation of Deserializer used to deserialize + the payload. Defaults to ByteArrayCrLfSerializer + + + using-nio + Y + Y + true, false + Whether or not the tcp adapter is using NIO. Refer to the java.nio + package for more information. Default false. + + + using-direct-buffers + Y + N + true, false + When using NIO, whether or not the tcp adapter uses direct buffers. + Refer to java.nio.ByteBuffer documentation for + more information. Must be false if using-nio is false. + + + so-timeout + Y + Y + + See java.net.Socket + setSoTimeout() methods for more information. + + + so-send-buffer-size + Y + Y + + See java.net.Socket + setSendBufferSize() methods for more information. + + + so-receive-buffer- size + Y + Y + + See java.net.Socket + setReceiveBufferSize() methods for more information. + + + so-keep-alive + Y + Y + true, false + See java.net.Socket. setKeepAlive(). + + + so-linger + Y + Y + + Sets linger to true with supplied value. + See java.net.Socket. setSoLinger(). + + + so-tcp-no-delay + Y + Y + true, false + See java.net.Socket. setTcpNoDelay(). + + + so-traffic-class + Y + Y + + See java.net.Socket. setTrafficClass(). + + + local-address + N + Y + + On a multi-homed system, specifies an IP address + for the interface to which the socket will be bound. + + + + task-executor + Y + Y + + + Specifies a specific Executor to be used for socket handling. If not supplied, an internal + pooled executor will be used. Needed on some platforms that require the use of specific + task executors such as a WorkManagerTaskExecutor. See pool-size for thread + requirements, depending on other options. + + + single-use + Y + Y + true, false + Specifies whether a connection can be used for multiple messages. + If true, a new connection will be used for each message. + + + pool-size + Y + Y + + Specifies the concurrency. For tcp, not using nio, specifies the + number of concurrent connections supported by the adapter. For tcp, + using nio, specifies the number of tcp fragments that are concurrently + reassembled into complete messages. + It only applies in this sense if task-executor is not configured. + However, pool-size is also used for the server socket backlog, + regardless of whether an external task executor is used. Defaults to 5. + + + interceptor-factory-chain + Y + Y + + Documentation to be supplied. + + + +
+ + UDP Outbound Channel Adapter Attributes + + + + + + + + Attribute Name + Allowed Values + Attribute Description + + + + + host + + The host name or ip address of the destination. For multicast udp + adapters, the multicast address. + + + port + + The port on the destination. + + + multicast + true, false + Whether or not the udp adapter uses multicast. + + + acknowledge + true, false + Whether or not a udp adapter requires an acknowledgment from the destination. + when enabled, requires setting the following 4 attributes. + + + ack-host + + When acknowledge is true, indicates the host or ip address to which the + acknowledgment should be sent. Usually the current host, but may be + different, for example when Network Address Transation (NAT) is + being used. + + + ack-port + + When acknowledge is true, indicates the port to which the + acknowledgment should be sent. The adapter listens on this port for + acknowledgments. + + + ack-timeout + + When acknowledge is true, indicates the time in milliseconds that the + adapter will wait for an acknowlegment. If an acknowlegment is not + received in time, the adapter will throw an exception. + + + min-acks-for- success + + Defaults to 1. For multicast adapters, you can set this to a larger + value, requiring acknowlegments from multiple destinations. + + + check-length + true, false + Whether or not a udp adapter includes a data length field in the + packet sent to the destination. + + + time-to-live + + For multicast adapters, specifies the time to live attribute for + the MulticastSocket; controls the scope + of the multicasts. Refer to the Java API + documentation for more information. + + + so-timeout + + See java.net.DatagramSocket + setSoTimeout() methods for more information. + + + so-send-buffer-size + + See java.net.DatagramSocket + setSendBufferSize() methods for more information. + + + so-receive-buffer- size + + Used for udp acknowlegment packets. See java.net.DatagramSocket + setReceiveBufferSize() methods for more information. + + + local-address + + On a multi-homed system, for the UDP adapter, specifies an IP address + for the interface to which the socket will be bound for reply messages. + For a multicast adapter it is also used to determine which interface + the multicast packets will be sent over. + + + task-executor + + + Specifies a specific Executor to be used for acknowledgment handling. If not supplied, an internal + single threaded executor will be used. Needed on some platforms that require the use of specific + task executors such as a WorkManagerTaskExecutor. One thread will be dedicated to handling + acknowledgments (if the acknowledge option is true). + + + +
+ + UDP Inbound Channel Adapter Attributes + + + + + + + + Attribute Name + Allowed Values + Attribute Description + + + + + port + + The port on which the adapter listens. + + + multicast + true, false + Whether or not the udp adapter uses multicast. + + + multicast-address + + When multicast is true, the multicast address to which the adapter + joins. + + + pool-size + + Specifies the concurrency. Specifies how many packets can + be handled concurrently. + It only applies if task-executor is not configured. + Defaults to 5. + + + task-executor + + + Specifies a specific Executor to be used for socket handling. If not supplied, an internal + pooled executor will be used. Needed on some platforms that require the use of specific + task executors such as a WorkManagerTaskExecutor. See pool-size for thread + requirements. + + + receive-buffer-size + + The size of the buffer used to receive DatagramPackets. + Usually set to the MTU size. If a smaller buffer is used than the + size of the sent packet, truncation can occur. This can be detected + by means of the check-length attribute.. + + + check-length + true, false + Whether or not a udp adapter expects a data length field in the + packet received. Used to detect packet truncation. + + + so-timeout + + See java.net.DatagramSocket + setSoTimeout() methods for more information. + + + so-send-buffer-size + + Used for udp acknowlegment packets. See java.net.DatagramSocket + setSendBufferSize() methods for more information. + + + so-receive-buffer- size + + See java.net.DatagramSocket + setReceiveBufferSize() for more information. + + + local-address + + On a multi-homed system, specifies an IP address + for the interface to which the socket will be bound. + + + +
+ + TCP Inbound Gateway Attributes + + + + + + + + Attribute Name + Allowed Values + Attribute Description + + + + + port + + The port on which the gateway listens. + + + +
+ + TCP Outbound Gateway Attributes + + + + + + + + Attribute Name + Allowed Values + Attribute Description + + + + + host + + The host name or ip address of the destination. + + + +
+
+
+
diff --git a/docs/src/reference/docbook/jdbc.xml b/docs/src/reference/docbook/jdbc.xml new file mode 100644 index 0000000000..1a1b498625 --- /dev/null +++ b/docs/src/reference/docbook/jdbc.xml @@ -0,0 +1,224 @@ + + + JDBC Support + + Spring Integration provides Channel Adapters for receiving and sending + messages via database queries. + +
+ Inbound Channel Adapter + + The main function of an inbound Channel Adapter is to execute a SQL + SELECT query and turn the result set into a message. The + message payload is the whole result set, expressed as a + List, and the types of the items in the list + depends on the row-mapping strategy that is used. The default strategy is + a generic mapper that just returns a Map for each + row i nthe query. Optionally this can be changed by adding a reference to + requires a reference to a RowMapper instance (see + the Spring + JDBC documentation for more detailed information about row + mapping). + If you want to convert rows in the SELECT query result to + individual messages you can use a downstream splitter. + + + The inbound adapter also requires a reference to either + JdbcTemplate instance or + DataSource. + + As well as the SELECT statement to generate the + messages, the adapter above also has an UPDATE statement that + is being used to mark the records as processed, so they don't show up in + the next poll. The update can be parameterised by the list of ids from the + original select. This is done through a naming convention by default (a + column in the input result set called "id" is translated into a list in + the parameter map for the update called "id"). The following example + defines an inbound Channel Adapter with an update query and a + DataSource reference. <jdbc:inbound-channel-adapter query="select * from item where status=2" + channel="target" data-source="dataSource" + update="update item set status=10 where id in (:id)" /> + + The parameters in the update query are specified with a colon (:) prefix to the name of a parameter (which in this case is an expression to be applied to each of the rows in the polled result set). This is a standard feature of the named parameter JDBC support in Spring JDBC combined with a convention (projection onto the polled result list) adopted in Spring Integration. The underlying Spring JDBC features limit the available expressions (e.g. most special characters other than period are disallowed), but since the target is usually a list of or an individual object addressable by simple bean paths this isn't unduly restrictive. + To change the parameter generation strategy you can inject a + SqlParameterSourceFactory into the adapter to + override the default behaviour (the adapter has a + sql-parameter-source-factory attribute). + +
+ Polling and Transactions + + The inbound adapter accepts a regular Spring Integration poller as + a sub element, so for instance the frequency of the polling can be + controlled. A very important feature of the poller for JDBC usage is the + option to wrap the poll operation in a transaction, for example: + + <jdbc:inbound-channel-adapter query="..." + channel="target" data-source="dataSource" + update="..."> + <poller fixed-rate"1000"> + <transactional/> + </poller> +</jdbc:inbound-channel-adapter> + + + If a poller is not explicitly specified a default value will be used (and as per normal with Spring Integration can be defined as a top level bean) + In this example the database is polled every 1000 + milliseconds, and the update and select queries are both executed in the + same transaction. The transaction manager configuration is not shown, + but as long as it is aware of the data source then the poll is + transactional. A common use case is for the downstream channels to be + direct channels (the default), so that the endpoints are invoked in the + same thread, and hence the same transaction. then if any of them fails, + the transaction rolls back and the input data are reverted to their + original state. +
+
+ +
+ Outbound Channel Adapter + + The outbound Channel Adapter is the inverse of the inbound: its role + is to handle a message and use it to execute a SQL query. The message + payload and headers are available by default as input parameters to the + query, for instance: <jdbc:outbound-channel-adapter + query="insert into foos (id, status, name) values (:headers[$id], 0, :payload[foo])" + channel="input" data-source="dataSource"/> In the + example above, messages arriving on the channel "input" have a payload of + a map with key "foo", so the [] operator dereferences that + value from the map. The headers are also accessed as a map. + The parameters in the query above are bean property expressions on the incoming message (not Spring EL expressions). This behaviour is part of the + + SqlParameterSource + + which is the default source created by the outbound adapter. Other behaviour is possible in the adapter, and requires the user to inject a different + + SqlParameterSourceFactory + + . + + + The outbound adapter requires a reference to either a DataSource or + a JdbcTemplate. It can also have a + SqlParameterSourceFactory injected to control the + binding of incoming message to the query. + + If the input channel is a direct channel then the outbound adapter + runs its query in the same thread, and therefor ethe same transaction (if + there is one) as the sender of the message. +
+ +
+ Outbound Gateway + + The outbound Gateway is like a combination of the outbound and + inbound adapters: its role is to handle a message and use it to execute a + SQL query and then respond with the result sending it to a reply channel. + The message payload and headers are available by default as input + parameters to the query, for instance: <jdbc:outbound-gateway + update="insert into foos (id, status, name) values (:headers[$id], 0, :payload[foo])" + request-channel="input" reply-channel="output" data-source="dataSource" /> + + The result of the above would be to insert a record into the "foos" + table and return a message to the output channel indicating the number of + rows affected (the payload is a map {UPDATED=1}. + + If the update query is an insert with auto-generated keys, the reply + message can be populated with the generated keys by adding + keys-generated="true" to the above example (this is not + the default because it is not supported by some database platforms). For + example: + + <jdbc:outbound-gateway + update="insert into foos (status, name) values (0, :payload[foo])" + request-channel="input" reply-channel="output" data-source="dataSource" + keys-generated="true"/> + + Instead of the update count or the generated keys, you can also + provide a select query to execute and generate a reply message that way + (like the inbound adapter), e.g: + + <jdbc:outbound-gateway + update="insert into foos (id, status, name) values (:headers[$id], 0, :payload[foo])" + query="select * from foos where id=:headers[$id]" + request-channel="input" reply-channel="output" data-source="dataSource" /> + + Like with the adapters there is also the option to provide + SqlParameterSourceFactory instances for request and + reply. The default is the same as for the outbound adapter, so the request + message is available as the root of an expression. If + keys-generated="true" then the root of the expression is the generated + keys (a map if there is only one or a list of maps if + multi-valued). + + The outbound gateway requires a reference to either a DataSource or + a JdbcTemplate. It can also have a + SqlParameterSourceFactory injected to control the + binding of incoming message to the query. +
+ +
+ Message Store + + The JDBC module provides an implementation of the Spring Integration + MessageStore (important in the Claim Check pattern) + and MessageGroupStore (important in stateful + patterns like Aggregator) backed by a database. Both interfaces are + implemented by the JdbcMessageStore and there is also support for + configuring store instances in XML. For example: + + <jdbc:message-store id="messageStore" data-source="dataSource"/> + + A JdbcTemplate can be specified instead of a + DataSource. + + Other optional attributes are show in the next example: + + <jdbc:message-store id="messageStore" data-source="dataSource" + lob-handler="lobHandler" table-prefix="MY_INT_"/>Here we + have specified a LobHandler for dealing with + messages as large objects (e.g. often necessary if using Oracle) and a + prefix for the table names in the queries generated by the store. The + table name prefix defaults to "INT_". + +
+ Initializing the Database + + Spring Integration ships with some sample scripts that can be used + to initialize a database. In the spring-integration-jdbc JAR file you + will find scripts in the + org.springframework.integration.jdbc package: + there is a create and a drop script example for a range of common + database platforms. A common way to use these scripts is to reference + them in a Spring + JDBC data source initializer. Note that the scripts are provided + as samples or specifications of the the required table and column names. + You may find that you need to enhance them for production use (e.g. with + index declarations). +
+ +
+ Partitioning a Message Store + + It is common to use a JdbcMessageStore as a + global store for a group of applications, or nodes in the same + application. To provide some portection against name clashes, and to + give control over the database meta-data configuration, the message + store allows the tables to be partitioned in two ways. One is to use + separate table names, by changing the prefix as described above, and the + other is to specify a "region" name for partitioning data within a + single table. An important use case for this is using the store to + manage persistent queues backing a Spring Integration channel. The + message data for a persistent channel is keyed in the store on the + channel name, so if the channel names are not globally unique then there + is the danger of channels picking up data that was not intended for + them. To avoid this the message store region can be used to keep data + separate for different physical channels that happen to have the same + logical name. +
+
+
diff --git a/docs/src/reference/docbook/jms.xml b/docs/src/reference/docbook/jms.xml new file mode 100644 index 0000000000..98f875935b --- /dev/null +++ b/docs/src/reference/docbook/jms.xml @@ -0,0 +1,311 @@ + + + JMS Support + + Spring Integration provides Channel Adapters for receiving and sending JMS messages. There are actually two + JMS-based inbound Channel Adapters. The first uses Spring's JmsTemplate to receive based on + a polling period. The second is "message-driven" and relies upon a Spring MessageListener container. There is also + an outbound Channel Adapter which uses the JmsTemplate to convert and send a JMS Message on + demand. + + + Whereas the JMS Channel Adapters are intended for unidirectional Messaging (send-only or receive-only), Spring + Integration also provides inbound and outbound JMS Gateways for request/reply operations. The inbound gateway + relies on one of Spring's MessageListener container implementations for Message-driven reception that is also + capable of sending a return value to the "reply-to" Destination as provided by the received Message. The outbound + Gateway sends a JMS Message to a "request-destination" and then receives a reply Message. The "reply-destination" + reference (or "reply-destination-name") can be configured explicitly or else the outbound gateway will use a + JMS TemporaryQueue. + + +
+ Inbound Channel Adapter + + The inbound Channel Adapter requires a reference to either a single JmsTemplate + instance or both ConnectionFactory and Destination + (a 'destinationName' can be provided in place of the 'destination' reference). The following example defines an + inbound Channel Adapter with a Destination reference. + + + ]]> + + Notice from the configuration that the inbound-channel-adapter is a Polling Consumer. That means that + it invokes receive() when triggered. This should only be used in situations where polling is done relatively + infrequently and timeliness is not important. For all other situations (a vast majority of JMS-based use-cases), + the message-driven-channel-adapter described below is a better option. + + + All of the JMS adapters that require a reference to the ConnectionFactory will automatically look for + a bean named "connectionFactory" by default. That is why you don't see a "connection-factory" attribute + in many of the examples. However, if your JMS ConnectionFactory has a different bean name, then you will + need to provide that attribute. + + + + If 'extract-payload' is set to true (which is the default), the received JMS Message will be passed through + the MessageConverter. When relying on the default SimpleMessageConverter, this means that the resulting Spring + Integration Message will have the JMS Message's body as its payload. A JMS TextMessage will produce a + String-based payload, a JMS BytesMessage will produce a byte array payload, and a JMS ObjectMessage's + Serializable instance will become the Spring Integration Message's payload. If instead you prefer to have + the raw JMS Message as the Spring Integration Message's payload, then set 'extract-payload' to false. + + + ]]> + +
+ +
+ Message-Driven Channel Adapter + + The "message-driven-channel-adapter" requires a reference to either an instance of a Spring MessageListener + container (any subclass of AbstractMessageListenerContainer) or both + ConnectionFactory and Destination + (a 'destinationName' can be provided in place of the 'destination' reference). The following example defines a + message-driven Channel Adapter with a Destination reference. + ]]> + + The Message-Driven adapter also accepts several properties that pertain to the MessageListener container. + These values are only considered if you do not provide an actual 'container' reference. In that case, + an instance of DefaultMessageListenerContainer will be created and configured based on these properties. + For example, you can specify the "transaction-manager" reference, the "concurrent-consumers" value, and + several other property references and values. Refer to the JavaDoc and Spring Integration's JMS Schema + (spring-integration-jms-2.0.xsd) for more detail. + + + + The 'extract-payload' property has the same effect as described above, and once again its default value + is 'true'. The poller sub-element is not applicable for a message-driven + Channel Adapter, as it will be actively invoked. For most usage scenarios, the message-driven approach is better since the Messages will + be passed along to the MessageChannel as soon as they are received from the underlying + JMS consumer. + +
+ +
+ Outbound Channel Adapter + + The JmsSendingMessageHandler implements the MessageHandler + interface and is capable of converting Spring Integration Messages to JMS messages + and then sending to a JMS destination. It requires either a 'jmsTemplate' reference or both 'connectionFactory' and + 'destination' references (again, the 'destinationName' may be provided in place of the 'destination'). As with the + inbound Channel Adapter, the easiest way to configure this adapter is with the namespace support. The following + configuration will produce an adapter that receives Spring Integration Messages from the "exampleChannel" and then + converts those into JMS Messages and sends them to the JMS Destination reference whose bean name is "outQueue". + ]]> + + + As with the inbound Channel Adapters, there is an 'extract-payload' property. However, the meaning is reversed + for the outbound adapter. Rather than applying to the JMS Message, the boolean property applies to the Spring + Integration Message payload. In other words, the decision is whether to pass the Spring Integration Message + itself as the JMS Message body or whether to pass the Spring Integration Message's + payload as the JMS Message body. The default value is once again 'true'. Therefore, if you pass a Spring + Integration Message whose payload is a String, a JMS TextMessage will be created. If on the other hand you + want to send the actual Spring Integration Message to another system via JMS, then simply set this to 'false'. + + Regardless of the boolean value for payload extraction, the Spring Integration MessageHeaders will map to + JMS properties as long as you are relying on the default converter or provide a reference to another + instance of HeaderMappingMessageConverter (the same holds true for 'inbound' adapters except that in + those cases, it's the JMS properties mapping to Spring Integration MessageHeaders). + + +
+ +
+ Inbound Gateway + + Spring Integration's message-driven JMS inbound-gateway delegates to a + MessageListener container, supports dynamically adjusting concurrent consumers, + and can also handle replies. The inbound gateway requires references to a + ConnectionFactory, and a request Destination (or + 'requestDestinationName'). The following example defines a JMS "inbound-gateway" that receives from the JMS + queue referenced by the bean id "inQueue" and sends to the Spring Integration channel named "exampleChannel". + ]]> + + + Since the gateways provide request/reply behavior instead of unidirectional send or + receive, they also have two distinct properties for the "payload extraction" (as discussed above for the + Channel Adapters' 'extract-payload' setting). For an inbound-gateway, the 'extract-request-payload' property + determines whether the received JMS Message body will be extracted. If 'false', the JMS Message itself will + become the Spring Integration Message payload. The default is 'true'. + + + Similarly, for an inbound-gateway the 'extract-reply-payload' property applies to the Spring Integration Message + that is going to be converted into a reply JMS Message. If you want to pass the whole Spring Integration Message + (as the body of a JMS ObjectMessage) then set this to 'false'. By default, it is also 'true' such that the Spring + Integration Message payload will be converted into a JMS Message (e.g. String payload + becomes a JMS TextMessage). + + + As with anything else, Gateway invocation might result in error. + By default Producer will not be notified of the errors thta might have occurredon ythe consumer side and will time out waiting for + the reply. However there might be times when you to communicate error condition back to the consumer, + in other words treat the Exception as a valid reply valid reply by mapping it to a Message. To accomplish this + JMS Inbound Gateway provides support for Exception mappers via exception-mapper + attribute. + + + + + + + ]]> + + foo.bar.SampleExceptionMapper is the implementation of + org.springframework.integration.message.InboundMessageMapper which only defines one method toMessage(Object object). +{ + public Message toMessage(Throwable object) throws Exception { + MessageHandlingException ex = (MessageHandlingException) object; + return MessageBuilder.withPayload("Error happened in message: " + + ex.getFailedMessage().getPayload()).build(); + } + +} + ]]> + +
+ +
+ Outbound Gateway + + The outbound Gateway creates JMS Messages from Spring Integration Messages and then sends to a + 'request-destination'. It will then handle the JMS reply Message either by using a selector to + receive from the 'reply-destination' that you configure, or if no 'reply-destination' is provided, + it will create JMS TemporaryQueues. Notice that the "reply-channel" is also provided. + ]]> + + + The 'outbound-gateway' payload extraction properties are inversely related to those of the + 'inbound-gateway' (see the discussion above). That means that the 'extract-request-payload' property value + applies to the Spring Integration Message that is being converted into a JMS Message to be + sent as a request, and the 'extract-reply-payload' property value applies to the + JMS Message that is received as a reply and then converted into a Spring Integration + Message to be subsequently sent to the 'reply-channel' as shown in the example configuration above. + +
+
+ Message Conversion, Marshalling and Unmarshalling + + If you need to convert the message, all JMS adapters and gateways, allow you to + provide a MessageConverter via message-converter attribute. Simply provide the + bean name of an instance of MessageConverter that is available within the same + ApplicationContext. + Also, to provide some consistency with Marshaller and Unmarshaller interfaces Spring provides MarshallingMessageConverter + which you can configure with your own custom Marshallers and Unmarshallers + + + + + + + + + + + + ]]> + + + + Note, however, that when you provide your own MessageConverter instance, it will still + be wrapped within the HeaderMappingMessageConverter. This means that the 'extract-request-payload' + and 'extract-reply-payload' properties may effect what actual objects are passed to your converter. The + HeaderMappingMessageConverter itself simply delegates to a target MessageConverter while also mapping the + Spring Integration MessageHeaders to JMS Message properties and vice-versa. + + +
+ +
+ JMS Backed Message Channels + + The Channel Adapters and Gateways featured above are all intended for applications that are integrating + with other external systems. The inbound options assume that some other system is sending JMS Messages + to the JMS Destination and the outbound options assume that some other system is receiving from the + Destination. The other system may or may not be a Spring Integration application. Of course, when sending + the Spring Integration Message instance as the body of the JMS Message itself (with the 'extract-payload' + value set to false), it is assumed that the other system is based on Spring Integration. However, + that is by no means a requirement. That flexibility is one of the benefits of using a Message-based + integration option with the abstraction of "channels" or Destinations in the case of JMS. + + + There are cases where both the producer and consumer for a given JMS Destination are intended to be + part of the same application, running within the same process. This could be accomplished by using a + pair of inbound and outbound Channel Adapters. The problem with that approach is that two adapters are + required even though conceptually the goal is to have a single Message Channel. A better option is + supported as of Spring Integration version 2.0. Now it is possible to define a single "channel" when + using the JMS namespace. + ]]> + + + The channel in the above example will behave much like a normal <channel/> element from the main + Spring Integration namespace. It can be referenced by both "input-channel" and "output-channel" attributes + of any endpoint. The difference is that this channel is backed by a JMS Queue instance named "exampleQueue". + This means that asynchronous messaging is possible between the producing and consuming endpoints, but + unlike the simpler asynchronous Message Channels created by adding a <queue/> sub-element within a + non-JMS <channel/> element, the Messages are not just stored in an in-memory queue. Instead those + Messages are passed within a JMS Message body, and the full power of the underlying JMS provider is then + available for that channel. Probably the most common rationale for using this alternative would be to + take advantage of the persistence made available by the store and forward approach + of JMS messaging. If configured properly, the JMS-backed Message Channel also supports transactions. + In other words, a producer would not actually write to a transactional JMS-backed channel if its send + operation is part of a transaction that rolls back. Likewise, a consumer would not physically remove a + JMS Message from the channel if the reception of that Message is part of a transaction that rolls back. + Note that the producer and consumer transactions are separate in such a scenario. This is significantly + different than the propagation of a transactional context across the simple, synchronous <channel/> + element that has no <queue/> sub-element. + + + Since the example above is referencing a JMS Queue instance, it will act as a point-to-point channel. If + on the other hand, publish/subscribe behavior is needed, then a separate element can be used, and a JMS + Topic can be referenced instead. + ]]> + + + For either type of JMS-backed channel, the name of the destination may be provided instead of a reference. + + + ]]> + + + In the examples above, the Destination names would be resolved by Spring's default + DynamicDestinationResolver implementation, but any implementation of the + DestinationResolver interface could be provided. Also, the JMS + ConnectionFactory is a required property of the channel, but by default + the expected bean name would be "connectionFactory". The example below provides both a custom instance + for resolution of the JMS Destination names and a different name for the ConnectionFactory. + ]]> + +
+ +
+ JMS Samples + + To experiment with these JMS adapters, check out the samples available within the "samples/jms" directory in + the distribution. There are two samples included. One provides inbound and outbound Channel Adapters, and the + other provides inbound and outbound Gateways. They are configured to run with an embedded ActiveMQ process, but + the "common.xml" file can easily be modified to support either a different JMS provider or a standalone + ActiveMQ process. In other words, you can split the configuration so that the inbound and outbound adapters are + running in separate JVMs. If you have ActiveMQ installed, simply modify the "brokerURL" property within the + configuration to use "tcp://localhost:61616" for example (instead of "vm://localhost"). Both of the samples + accept input via stdin and then echo back to stdout. Look at the configuration to see how these messages are + routed over JMS. + +
+ +
diff --git a/docs/src/reference/docbook/jmx.xml b/docs/src/reference/docbook/jmx.xml new file mode 100644 index 0000000000..d9802cd296 --- /dev/null +++ b/docs/src/reference/docbook/jmx.xml @@ -0,0 +1,190 @@ + + + JMX Support + + Spring Integration provides Channel Adapters for receiving and + publishing JMX Notifications. There is also an inbound Channel Adapter for + polling JMX MBean attribute values, and an outbound Channel Adapter for + invoking JMX MBean operations. + +
+ Notification Listening Channel Adapter + + The Notification-listening Channel Adapter requires a JMX ObjectName + for the MBean that publishes Notifications to which this listener should + be registered. A very simple configuration might look like this: + <jmx:notification-listening-channel-adapter id="adapter" + channel="channel" + object-name="example.domain:name=publisher"/> + + The + + notification-listening-channel-adapter + + registers with an MBeanServer at startup, and the default bean name is "mbeanServer" which happens to be the same bean name generated when using Spring's <context:mbean-server/> element. If you need to use a different name be sure to include the "mbean-server" attribute. + The adapter can also accept a reference to a NotificationFilter + and a "handback" Object to provide some context that is passed back with + each Notification. Both of those attributes are optional. Extending the + above example to include those attributes as well as an explicit + MBeanServer bean name would produce the following: <jmx:notification-listening-channel-adapter id="adapter" + channel="channel" + mbean-server="someServer" + object-name="example.domain:name=somePublisher" + notification-fliter="notificationFilter" + handback="myHandback"/> + Since the notification-listening adapter is registered with + the MBeanServer directly, it is event-driven and does not require any + poller configuration. +
+ +
+ Notification Publishing Channel Adapter + + The Notification-publishing Channel Adapter is relatively simple. It + only requires a JMX ObjectName in its configuration as shown below. + <context:mbean:export/> + + <jmx:notification-publishing-channel-adapter id="adapter" + channel="channel" + object-name="example.domain:name=publisher"/> + It does also require that an MBeanExporter be present in the + context. That is why the <context:mbean-export/> element is shown + above as well. + + When Messages are sent to the channel for this adapter, the + Notification is created from the Message content. If the payload is a + String it will be passed as the "message" text for the Notification. Any + other payload type will be passed as the "userData" of the + Notification. + + JMX Notifications also have a "type", and it should be a + dot-delimited String. There are two ways to provide the type. Precedence + will always be given to a Message header value associated with the + JmxHeaders.NOTIFICATION_TYPE key. On the other hand, you can rely on a + fallback "default-notification-type" attribute provided in the + configuration. <context:mbean:export/> + + <jmx:notification-publishing-channel-adapter id="adapter" + channel="channel" + object-name="example.domain:name=publisher" + default-notification-type="some.default.type"/> + +
+ +
+ Attribute Polling Channel Adapter + + The attribute polling adapter is useful when you have a requirement + to periodically check on some value that is available through an MBean as + a managed attribute. The poller can be configured in the same way as any + other polling adapter in Spring Integration (or it's possible to rely on + the default poller). The "object-name" and "attribute-name" are required. + An MBeanServer reference is also required, but it will automatically check + for a bean named "mbeanServer" by default just like the + notification-listening-channel-adapter described above. <jmx:attribute-polling-channel-adapter id="adapter" + channel="channel" + object-name="example.domain:name=someService" + attribute-name="InvocationCount"> + <si:poller max-messages-per-poll="1" fixed-rate="5000"/> + </jmx:attribute-polling-channel-adapter> + +
+ +
+ Operation Invoking Channel Adapter + + The operation-invoking-channel-adapter enables + Message-driven invocation of any managed operation exposed by an MBean. + Each invocation requires the operation name to be invoked and the + ObjectName of the target MBean. Both of these must be explicitly provided + via adapter configuration: <jmx:operation-invoking-channel-adapter id="adapter" + object-name="example.domain:name=TestBean" + operation-name="ping"/> + Then the adapter only needs to be able to discover the + "mbeanServer" bean. If a different bean name is required, then provide the + "mbean-server" attribute with a reference. + + The payload of the Message will be mapped to the parameters of the + operation, if any. A Map-typed payload with String keys is treated as + name/value pairs whereas a List or array would be passed as a simple + argument list (with no explicit parameter names). If the operation + requires a single parameter value, then the payload can represent that + single value, and if the operation requires no parameters, then the + payload would be ignored. + + If you want to expose a channel for a single common operation to be + invoked by Messages that need not contain headers, then that option works + well. +
+ +
+ Operation Invoking outbound Gateway + + Similar to operation-invoking-channel-adapter + Spring Integration also provides + operation-invoking-outbound-gateway which could be + used when dealing with non-void operations and return value is required. + Such return value will be sent as message payload to the 'reply-channel' + specified by this Gateway. <jmx:operation-invoking-outbound-gateway request-channel="requestChannel" + reply-channel="replyChannel" + object-name="org.springframework.integration.jmx.config:type=TestBean,name=testBeanGateway" + operation-name="testWithReturn"/> Another way of + provideing the 'reply-channel' is by setting + MessageHeaders.REPLY_CHANNEL Message + Header +
+ +
+ MBean Exporter + + Spring Integration components themselves may be exposed as MBeans + when the IntegrationMBeanExporter is configured. To + create an instance of the IntegrationMBeanExporter, + define a bean and provide a reference to an MBeanServer and a domain name + (if desired). The domain can be left out in which case the default domain + is "spring.application". <jmx:mbean-exporter domain="my.company.domain" mbean-server="mbeanServer"/> + + <bean id="mbeanServer" class="org.springframework.jmx.support.MBeanServerFactoryBean"> + <property name="locateExistingServerIfPossible" value="true"/> + </bean> + + The MBean exporter is orthogonal to the one provided in Spring core + - it registers message channels and message handlers, but not itself (you + can expose the exporter itself using the standard + <context:mbean-export/> tag). +
+ +
+ Control Bus + + As described in (EIP), the idea + behind the Control Bus is that the same messaging system can be used for + monitoring and managing the components within the framework as is used for + "application-level" messaging. In Spring Integration we build upon the + adapters described above so that it's possible to send Messages as a means + of invoking exposed operations. Internally, the Control Bus uses a Spring + MBeanExporter instance to expose the various endpoints and channels. To + create an instance of the Control Bus, define a bean and provide a + reference to an MBeanServer and a domain name. <jmx:control-bus mbean-exporter="mbeanExporter" operation-channel="operationChannel"/> + + <jmx:mbean-exporter id="mbeanExporter" mbean-server="mbeanServer"/> + + + The Control Bus has an "operationChannel" that can be accessed for + invoking operations on the MBeans that it has exported. This will also be + covered by namespace support soon to make it easier to configure + references to that channel for other producers. We will likely add some + other channels for notifications and attribute polling as well. + + The Control Bus functionality is a work in progress. At this time, + one can perform some basic monitoring of Message Channels and/or invoke + Lifecycle operations (start/stop) on Message Endpoints. Now that the + foundation is available, however, we will be able to extend the attributes + and operations that are being exposed. +
+
diff --git a/docs/src/reference/docbook/mail.xml b/docs/src/reference/docbook/mail.xml new file mode 100644 index 0000000000..842224a0eb --- /dev/null +++ b/docs/src/reference/docbook/mail.xml @@ -0,0 +1,161 @@ + + + Mail Support + +
+ Mail-Sending Channel Adapter + + Spring Integration provides support for outbound email with the + MailSendingMessageHandler. It delegates to a configured instance of Spring's + JavaMailSender: + JavaMailSender mailSender = (JavaMailSender) context.getBean("mailSender"); + + MailSendingMessageHandler mailSendingHandler = new MailSendingMessageHandler(mailSender); + MailSendingMessageHandler has various mapping strategies that use Spring's + MailMessage abstraction. If the received Message's payload is already + a MailMessage instance, it will be sent directly. + Therefore, it is generally recommended to precede this + consumer with a Transformer for non-trivial MailMessage construction requirements. However, a few simple + Message mapping strategies are supported out-of-the-box. For example, if the message payload is a byte array, + then that will be mapped to an attachment. For simple text-based emails, you can provide a String-based + Message payload. In that case, a MailMessage will be created with that String as the text content. If you + are working with a Message payload type whose toString() method returns appropriate mail text content, then + consider adding Spring Integration's ObjectToStringTransformer prior to the outbound + Mail adapter (see the example within for more detail). + + + The outbound MailMessage may also be configured with certain values from the + MessageHeaders. If available, values will be mapped to the outbound mail's + properties, such as the recipients (TO, CC, and BCC), the from/reply-to, and the subject. The header names are + defined by the following constants: + MailHeaders.SUBJECT + MailHeaders.TO + MailHeaders.CC + MailHeaders.BCC + MailHeaders.FROM + MailHeaders.REPLY_TO + + + MailHeaders also allows you to override corresponding MailMessage values. + For example: If MailMessage.to is set to 'foo@bar.com' and MailHeaders.TO + Message header is provided it will take precedence and override the corresponding value in MailMessage + +
+ +
+ Mail-Receiving Channel Adapter + + Spring Integration also provides support for inbound email with the + MailReceivingMessageSource. It delegates to a configured instance of Spring + Integration's own MailReceiver interface, and there are two implementations: + Pop3MailReceiver and ImapMailReceiver. The easiest way to + instantiate either of these is by passing the 'uri' for a Mail store to the receiver's constructor. For example: + + + + Another option for receiving mail is the IMAP "idle" command (if supported by the mail server you are using). + Spring Integration provides the ImapIdleChannelAdapter which is itself a Message-producing + endpoint. It delegates to an instance of the ImapMailReceiver but enables asynchronous + reception of Mail Messages. There are examples in the next section of configuring both types of inbound Channel + Adapter with Spring Integration's namespace support in the 'mail' schema. + +
+ +
+ Mail Namespace Support + + Spring Integration provides a namespace for mail-related configuration. To use it, configure the following schema + locations. +]]> + + + To configure an outbound Channel Adapter, provide the channel to receive from, and the MailSender: + ]]> + Alternatively, provide the host, username, and password: + ]]> + + Keep in mind, as with any outbound Channel Adapter, if the referenced channel is a PollableChannel, a + <poller> sub-element should be provided with either an interval-trigger or cron-trigger. + + + + To configure an inbound Channel Adapter, you have the choice between polling or event-driven (assuming your + mail server supports IMAP IDLE - if not, then polling is the only option). A polling Channel Adapter simply + requires the store URI and the channel to send inbound Messages to. The URI may begin with "pop3" or "imap": + + +]]> + If you do have IMAP idle support, then you may want to configure the "imap-idle-channel-adapter" element instead. + Since the "idle" command enables event-driven notifications, no poller is necessary for this adapter. It will + send a Message to the specified channel as soon as it receives the notification that new mail is available: + ]]> + ... where javaMailProperties could be provided by creating and populating + a regular java.utils.Properties object. For example via util namespace + provided by Spring. + + javax.net.ssl.SSLSocketFactory + false + imaps + false +]]> + + + + In both configurations channel and should-delete-messages are the REQUIRED +    attributes. The important thing to understand is why should-delete-messages is required? +    The issue is with POP3 protocol, which does NOT have any knowlege of messages that were READ. It can only know what's been read  +    within a single session. This means that when your POP3 mail adapter is running emails are successfully consumed as as they become available during each poll +    and no single email message will be delivered more then once. However, as soon as you restart your adapter and begin a new session +    all the email messages that might have been retreeved in the previous session will be retrieved again. That is the nature of POP3. Some might argue +    that why not set should-delete-messages to TRUE by default? Becouse there are two valid amd mutually exclusive use cases  +    which makes it very hard pick the right default. You may want to configure your adapter as the only email receiever in which +    case you want to be able to restart such adapter without fear that messages that were delivered before will not be redelivered again.  +    In this case setting should-delete-messages to TRUE would make most sence. However, you may have anoher use case where  +    you may want to have multiple adapters that simply monitor email servers and their content. In other words you just want to 'peek but not touch'.  +    Then setting should-delete-messages to FALSE would be much more appropriate. So since it is hard to choose what should be +    the right default value for should-delete-messages attribute we simply made it required to be set - leaving it up to you +    while also not letting you to forget that you must set it. + + + When configuring a polling adapter (e.g., inbound-channel-adapter) should-mark-messages-as-read + be aware of the protocol you are configuring to retrieve messages. For example POP3 does not support this flag + which means setting it to either value will have no effect as messages will NOT be marked as read + + + + When using the namespace support, a header-enricher Message Transformer is also available. + This simplifies the application of the headers mentioned above to any Message prior to sending to the + Mail-sending Channel Adapter. + ]]> + +
+ +
diff --git a/docs/src/reference/docbook/message-history.xml b/docs/src/reference/docbook/message-history.xml new file mode 100644 index 0000000000..63857a403f --- /dev/null +++ b/docs/src/reference/docbook/message-history.xml @@ -0,0 +1,64 @@ + + + Message History + + The key benefit of messaging architecture is loose coupling where participating components do not maintain any awareness about one another. This fact + alone makes you architecture extremely flexible  allowing you to change components without affecting the rest of the flow, change messaging routs,   + message consuming styles (polling vs event driven) etc... + However, this unassuming style of architecture could prove to be problematic when things go wrong. For example, if something happened + you would probably like to get as much information about the message as you can (its origin, where it was etc.) + + + Message History is one of those patterns that could help by giving you an option to maintain some level of awareness of a + message path either for debugging purposes or to maintain an audit trail. + Spring integration provides a simple way to configure your message flows to maintain Message History by adding Message History header to a + Message every time a message goes through a tracked component. + +
+ Message History Configuration + + To enable Message History all you need is define message-history element in your configuration. + ]]> + + + Now every named component (component that has an 'id' defined) will be tracked. + The framework will set the '$history' header in your Message who's value is  very simple - List<Properties>. + The need for this simple structure is mandated by the loosely coupled architecture of messaging systems where the framework + must not require you to share any dependencies outside of Java itself.  + + + + + + + + +]]> +The above configuration will produce a very simple Message History structure: + + To get access to Message History all you need is access the MessageHistory header. For example: + historyIterator = + message.getHeaders().get(MessageHistory.HEADER_NAME, MessageHistory.class).iterator(); +assertTrue(historyIterator.hasNext()); +Properties gatewayHistory = historyIterator.next(); +assertEquals("sampleGateway", gatewayHistory.get("name")); +assertTrue(historyIterator.hasNext()); +Properties chainHistory = historyIterator.next(); +assertEquals("sampleChain", chainHistory.get("name"));]]> + + + Some times you might not want to track all of the components. To accomplish this all you need is provide tracked-components attribute where you can specify + comma delimited list of component names and/or patterns you want to track. + ]]> + In the above example, Message History will only be maintained for all of the components that end with 'Gateway', all components that start with 'sample' and 'foo' component. + + + Remember, that by definition History is immutable (you can't re-write history,although some try), therefore Message History can not + be changed once written. Every attempt will end in exception. + +
+
diff --git a/docs/src/reference/docbook/message-publishing.xml b/docs/src/reference/docbook/message-publishing.xml new file mode 100644 index 0000000000..f599808dfc --- /dev/null +++ b/docs/src/reference/docbook/message-publishing.xml @@ -0,0 +1,371 @@ + + + Message Publishing + + The AOP Message Publishing feature allows you to construct and send a message as a by-product of method invocation. For example, imagine you + have a component and every time the state of this component changes you would like to be notified via a Message. The easiest + way to send such notifications would be to send a message to a dedicated channel, but how would you connect the method invocation that + changes the state of the object to a message sending process, and how should the notification Message be structured? + The AOP Message Publishing feature handles these responsibilities with a configuration-driven approach. + +
+ Message Publishing Configuration + + Spring Integration provides two approaches: XML and Annotation-driven. + +
+ Annotation-driven approach via @Publisher annotation + + The annotation-driven approach allows you to annotate any method with the @Publisher annotation, specifying 'channel' attribute. + The Message will be constructed from the return value of method invocation and sent to a channel specified by 'channel' attribute. + To further manage message structure you can also use a combination of both @Payload and @Header annotations. + + + Internally message publishing feature of Spring Integration uses both Spring AOP by defining PublisherAnnotationAdvisor and + Spring 3.0 Expression Language (SpEL) support, giving you considerable flexibility and control over the structure of the Message it will build. + + + PublisherAnnotationAdvisor defines and binds the following variables: + + + #return - will bind to a return value allowing you to reference it or its + attributes (e.g., #return.foo where 'foo' is an attribute of the object bound to + #return) + + + #exception - will bind to an exception if one is thrown by the method invocation. + + + #args - will bind to method arguments, so individual arguments could be extracted by name + (e.g., #args.fname as in the above method) + + + + + + Let's look at couple of examples: + + +@Publisher +public String defaultPayload(String fname, String lname) { + return fname + " " + lname; +} + + + In the above example the Message will be constructed with the following structure: + + + Message payload - will be the return type and value of the method. This is the default. + + + A newly constructed message will be sent to a default publisher channel configured with annotation post processor (see the end of this section). + + + + +@Publisher(channel="testChannel") +public String defaultPayload(String fname, @Header("last") String lname) { + return fname + " " + lname; +} + + + In this example everything is the same as above, however we are not using default publishing channel. Instead we are specifying + the publishing channel via 'channel' attribute of @Publisher annotation. + We are also adding @Header annotation which results in the Message header with the name 'last' and the value of 'lname' input parameter + to be added to the newly constructed Message. + + + +@Publisher(channel="testChannel") +@Payload +public String defaultPayloadButExplicitAnnotation(String fname, @Header String lname) { + return fname + " " + lname; +} + + + The above example is almost identical to the previous one. The only difference here is that we are using @Payload annotation + on the method, thus explicitly specifying that the return value of the method should be used as a payload of the Message. + + + +@Publisher(channel="testChannel") +@Payload("#return + #args.lname") +public String setName(String fname, String lname, @Header("x") int num) { + return fname + " " + lname; +} + + + Here we are expending on the previous configuration by using Spring Expression language in the @Payload annotation further instructing + the framework on how the message should be constructed. In this particular case the message will be a concatenation of the return value of the method invocation and + 'lname' input argument. Message header 'x' with value of 'num' input argument will be added to the newly constructed Message. + + + +@Publisher(channel="testChannel") +public String argumentAsPayload(@Payload String fname, @Header String lname) { + return fname + " " + lname; +} + + + In the above example you see another usage of @Payload annotation. Here we are annotating method argument + which will become a payload of newly constructed message. + + + + + As with most other annotation-driven features in Spring, you will need to register a post-processor + (PublisherAnnotationBeanPostProcessor). + <bean class="org.springframework.integration.aop.PublisherAnnotationBeanPostProcessor"/> + You can also use namespace support for added convenience: + +<si:annotation-config default-publisher-channel="defaultChannel"/> + + + + Similar to other Spring annotations (e.g., @Controller), @Publisher is a meta-annotation, which means you can define your own annotations + that will be treated as @Publisher + +Here we defined @Audit annotation which itself is a @Publisher. Also note that you can define channel +attribute on the meta-annotation thus encapsulating the behavior of where messages will be sent inside of this annotation. + +Now you can annotate any method: + + +In the above example every invocation of test() method will result in Message with payload which is the return value of the method +invocation to be sent to auditChannel + +You can also annotate the class which would mean that the properties of this annotation will be applied on every public method of this class + + + + +
+ +
+ XML-based approach via <publishing-interceptor> element + + The XML-based approach allows you to configure the same AOP-based Message Publishing functionality with + simple namespace-based configuration of a MessagePublishingInterceptor. + It certainly has some benefits over the annotation-driven approach since it + allows you to use AOP pointcut expressions, thus possibly intercepting multiple methods at once or + intercepting and publishing methods to which you don't have the source code. + + + To configure Message Publishing via XML, you only need to do the following two things: + + + Provide configuration for MessagePublishingInterceptor + via the <publishing-interceptor> XML element. + + + Provide AOP configuration to apply the MessagePublishingInterceptor to managed objects. + + + + + + + + + +
+ + +
+ + +]]> + + + As you can see the <publishing-interceptor> configuration look rather similar to Annotation-based approach + and it also utilizes the power of the Spring 3.0 Expression Language. + + + In the above example the execution of the echo method of a testBean will + render a Message with the following structure: + + + The Message payload will be of type String and value of "Echoing: [value]" where value is the value + returned by an executed method. + + + The Message will have header with the key "foo" value "bar". + + + The Message will be sent to echoChannel. + + + + + + The second method is very similar to the first. Here every method that begins with 'repl' will render a Message with the following structure: + + + The Message payload will be the same as in the above sample + + + The Message will have header with the key "foo" and value that is the result of the SpEL expression 'bar'.toUpperCase() . + + + The Message will be sent to echoChannel. + + + + + + The second method, mapping the execution of any method that begins with echoDef of testBean, will produce a + Message with the following structure. + + + The Message payload will be the value returned by an executed method. + + + Since the channel attribute is not provided explicitly, the Message will be sent to the + defaultChannel defined by the publisher. + + + + + + For simple mapping rules you can rely on the publisher defaults. For example: + +<publishing-interceptor id="anotherInterceptor"/> + + This will map the return value of every method that matches the pointcut expression to a payload and will be sent to a default-channel. + If the defaultChannelis not specified (as above) the messages will be sent to the global nullChannel. + + + Async Publishing + + + One important thing to understand is that publishing occurs in the same thread as your component's execution. So by default in is synchronous. + This means that the entire message flow would have to wait until he publisher flow completes.  + However, quite often you want the complete opposite and that is to use Message publishing feature to initiate asynchronous sub-flows. + For example, you might host a service (HTTP, WS etc.) which receives a remote request.You may want to send this request internally into a + process that might take a while. However you may also want to reply to the user right away. So, instead of sending inbound + request for processing via the output channel (the conventional way), you can simply use ''outout-channel or $replyChannel'' header + to send simple acknowledgment-like reply back to the caller while using Message publisher feature to initiate a complex flow. + + + EXAMPLE: + Here is the simple service that receives a complex payload, which needs to be sent further for processing, but it + also need to reply to the caller with a simple acknowledgment. + + So instead of hooking up the complex flow to the output channel we use Message publishing feature instead configuring it to create a + new Message using the input argument of the service method (above) and sending it to the 'localProcessChannel'. And to make sure this sub-flow + is asynchronous all we need to do is make sure that we send it to any type of async channel (ExecutorChannel in this example). + + + + + + + + + + + + + + + + + +]]> + + + Another way of handling thi type of scenario is through wire-tap + +
+ +
+ Producing and publishing messages based on a scheduled trigger + + In the above sections we looked at the Message publishing feature of Spring Integration which constructs and publishes messages as by-products of Method invocations. + However in that case, you are still responsible for invoking the method. + In Spring Integration 2.0 we've added another related useful feature: support for scheduled Message producers/publishers via the new "expression" attribute + on the 'inbound-channel-adapter' element. Scheduling could be based on several triggers, any one of which may be configured on the 'poller' sub-element. + Currently we support cron, fixed-rate, fixed-delay as well as any custom trigger implemented by you. + + + As mentioned above, support for scheduled producers/publishers is provided via the <inbound-channel-adapter> xml element. + Let's look at couple of examples: + + + + + +]]> + + In the above example an inbound Channel Adapter will be created which will construct a Message with its payload being the result of the expression  + defined in the expression attribute. Such message will be created and sent every time after the delay specified by the fixed-delay attribute. + + + +]]> + + This example is very similar to the previous one, except that we are using the fixed-rate attribute which will allow us to send messages at a fixed rate (measuring from the start time of each task). + + + +]]> + + This example demonstrates how you can apply a Cron trigger with a value specified in the cron attribute. + + + + +
+
+]]> + + Here you can see that in a way very similar to the Message publishing feature we are enriching a newly constructed Message with + extra Message headers which could take scalar values as well as the results of evaluating Spring expressions. + + + + If you need to implement your own custom trigger you can use the trigger attribute to provide a reference to any spring configured + bean which implements the org.springframework.scheduling.Trigger interface. + + + + + + + +]]> + + +
+
+
diff --git a/docs/src/reference/docbook/message.xml b/docs/src/reference/docbook/message.xml new file mode 100644 index 0000000000..7656b0b030 --- /dev/null +++ b/docs/src/reference/docbook/message.xml @@ -0,0 +1,222 @@ + + + Message Construction + + The Spring Integration Message is a generic container for data. Any object can + be provided as the payload, and each Message also includes headers containing + user-extensible properties as key-value pairs. + + +
+ The Message Interface + Here is the definition of the Message interface: + public interface Message<T> { + + T getPayload(); + + MessageHeaders getHeaders(); + +} + + + The Message is obviously a very important part of the API. By encapsulating the + data in a generic wrapper, the messaging system can pass it around without any knowledge of the data's type. As + an application evolves to support new types, or when the types themselves are modified and/or extended, the + messaging system will not be affected by such changes. On the other hand, when some component in the messaging + system does require access to information about the Message, + such metadata can typically be stored to and retrieved from the metadata in the Message Headers. + +
+ +
+ Message Headers + + Just as Spring Integration allows any Object to be used as the payload of a Message, it also supports any Object + types as header values. In fact, the MessageHeaders class implements the + java.util.Map interface: + public final class MessageHeaders implements Map<String, Object>, Serializable { + ... +} + + Even though the MessageHeaders implements Map, it is effectively a read-only implementation. Any attempt to + put a value in the Map will result in an UnsupportedOperationException. + The same applies for remove and clear. Since Messages may be passed to + multiple consumers, the structure of the Map cannot be modified. Likewise, the Message's payload Object can not + be set after the initial creation. However, the mutability of the header values themselves + (or the payload Object) is intentionally left as a decision for the framework user. + + + + As an implementation of Map, the headers can obviously be retrieved by calling get(..) + with the name of the header. Alternatively, you can provide the expected Class as an + additional parameter. Even better, when retrieving one of the pre-defined values, convenient getters are + available. Here is an example of each of these three options: + Object someValue = message.getHeaders().get("someKey"); + + CustomerId customerId = message.getHeaders().get("customerId", CustomerId.class); + + Long timestamp = message.getHeaders().getTimestamp(); + + + + The following Message headers are pre-defined: + + Pre-defined Message Headers + + + + + Header Name + Header Type + + + + + ID + java.util.UUID + + + TIMESTAMP + java.lang.Long + + + EXPIRATION_DATE + java.lang.Long + + + CORRELATION_ID + java.lang.Object + + + REPLY_CHANNEL + java.lang.Object (can be a String or MessageChannel) + + + ERROR_CHANNEL + java.lang.Object (can be a String or MessageChannel) + + + SEQUENCE_NUMBER + java.lang.Integer + + + SEQUENCE_SIZE + java.lang.Integer + + + PRIORITY + MessagePriority (an enum) + + + +
+
+ + Many inbound and outbound adapter implementations will also provide and/or expect certain headers, and additional + user-defined headers can also be configured. + +
+ +
+ Message Implementations + + The base implementation of the Message interface is + GenericMessage<T>, and it provides two constructors: + new GenericMessage<T>(T payload); + +new GenericMessage<T>(T payload, Map<String, Object> headers) + When a Message is created, a random unique id will be generated. The constructor that accepts a Map of headers + will copy the provided headers to the newly created Message. + + + There are also two convenient subclasses available: StringMessage and + ErrorMessage. The former accepts a String as its payload: + StringMessage message = new StringMessage("hello world"); + +String s = message.getPayload(); + And, the latter accepts any Throwable object as its payload: + ErrorMessage message = new ErrorMessage(someThrowable); + +Throwable t = message.getPayload(); + Notice that these implementations take advantage of the fact that the GenericMessage + base class is parameterized. Therefore, as shown in both examples, no casting is necessary when retrieving + the Message payload Object. + +
+ +
+ The MessageBuilder Helper Class + + You may notice that the Message interface defines retrieval methods for its payload and headers but no setters. + The reason for this is that a Message cannot be modified after its initial creation. Therefore, when a Message + instance is sent to multiple consumers (e.g. through a Publish Subscribe Channel), if one of those consumers + needs to send a reply with a different payload type, it will need to create a new Message. As a result, the + other consumers are not affected by those changes. Keep in mind, that multiple consumers may access the same + payload instance or header value, and whether such an instance is itself immutable is a decision left to the + developer. In other words, the contract for Messages is similar to that of an + unmodifiable Collection, and the MessageHeaders' map further exemplifies that; even though + the MessageHeaders class implements java.util.Map, any attempt to invoke a + put operation (or 'remove' or 'clear') on the MessageHeaders will result in an + UnsupportedOperationException. + + + Rather than requiring the creation and population of a Map to pass into the GenericMessage constructor, Spring + Integration does provide a far more convenient way to construct Messages: MessageBuilder. + The MessageBuilder provides two factory methods for creating Messages from either an existing Message or with a + payload Object. When building from an existing Message, the headers and payload of that + Message will be copied to the new Message: + Message<String> message1 = MessageBuilder.withPayload("test") + .setHeader("foo", "bar") + .build(); + +Message<String> message2 = MessageBuilder.fromMessage(message1).build(); + +assertEquals("test", message2.getPayload()); +assertEquals("bar", message2.getHeaders().get("foo")); + + + If you need to create a Message with a new payload but still want to copy the + headers from an existing Message, you can use one of the 'copy' methods. + Message<String> message3 = MessageBuilder.withPayload("test3") + .copyHeaders(message1.getHeaders()) + .build(); + +Message<String> message4 = MessageBuilder.withPayload("test4") + .setHeader("foo", 123) + .copyHeadersIfAbsent(message1.getHeaders()) + .build(); + +assertEquals("bar", message3.getHeaders().get("foo")); +assertEquals(123, message4.getHeaders().get("foo")); + Notice that the copyHeadersIfAbsent does not overwrite existing values. Also, in the + second example above, you can see how to set any user-defined header with setHeader. + Finally, there are set methods available for the predefined headers as well as a non-destructive method for + setting any header (MessageHeaders also defines constants for the pre-defined header names). + Message<Integer> importantMessage = MessageBuilder.withPayload(99) + .setPriority(MessagePriority.HIGHEST) + .build(); + +assertEquals(MessagePriority.HIGHEST, importantMessage.getHeaders().getPriority()); + +Message<Integer> anotherMessage = MessageBuilder.fromMessage(importantMessage) + .setHeaderIfAbsent(MessageHeaders.PRIORITY, MessagePriority.LOW) + .build(); + +assertEquals(MessagePriority.HIGHEST, anotherMessage.getHeaders().getPriority()); + + + + The MessagePriority is only considered when using a PriorityChannel + (as described in the next chapter). It is defined as an enum with five possible values: + public enum MessagePriority { + HIGHEST, + HIGH, + NORMAL, + LOW, + LOWEST +} + +
+ +
diff --git a/docs/src/reference/docbook/overview.xml b/docs/src/reference/docbook/overview.xml new file mode 100644 index 0000000000..6241073c9f --- /dev/null +++ b/docs/src/reference/docbook/overview.xml @@ -0,0 +1,327 @@ + + + Spring Integration Overview + +
+ Background + + One of the key themes of the Spring Framework is inversion of control. In its broadest + sense, this means that the framework handles responsibilities on behalf of the components that are managed within + its context. The components themselves are simplified since they are relieved of those responsibilities. For + example, dependency injection relieves the components of the responsibility of locating or + creating their dependencies. Likewise, aspect-oriented programming relieves business + components of generic cross-cutting concerns by modularizing them into reusable aspects. In each case, the end + result is a system that is easier to test, understand, maintain, and extend. + + + Furthermore, the Spring framework and portfolio provide a comprehensive programming model for building + enterprise applications. Developers benefit from the consistency of this model and especially the fact that it is + based upon well-established best practices such as programming to interfaces and favoring composition over + inheritance. Spring's simplified abstractions and powerful support libraries boost developer productivity while + simultaneously increasing the level of testability and portability. + + + Spring Integration is a new member of the Spring portfolio motivated by these same goals and principles. It + extends the Spring programming model into the messaging domain and builds upon Spring's existing enterprise + integration support to provide an even higher level of abstraction. It supports message-driven architectures + where inversion of control applies to runtime concerns, such as when certain business logic + should execute and where the response should be sent. It supports routing and transformation + of messages so that different transports and different data formats can be integrated without impacting + testability. In other words, the messaging and integration concerns are handled by the framework, so business + components are further isolated from the infrastructure and developers are relieved of complex integration + responsibilities. + + + As an extension of the Spring programming model, Spring Integration provides a wide variety of configuration + options including annotations, XML with namespace support, XML with generic "bean" elements, and of course direct + usage of the underlying API. That API is based upon well-defined strategy interfaces and non-invasive, delegating + adapters. Spring Integration's design is inspired by the recognition of a strong affinity between common patterns + within Spring and the well-known Enterprise Integration Patterns + as described in the book of the same name by Gregor Hohpe and Bobby Woolf (Addison Wesley, 2004). Developers who + have read that book should be immediately comfortable with the Spring Integration concepts and terminology. + +
+ +
+ Goals and Principles + Spring Integration is motivated by the following goals: + + + Provide a simple model for implementing complex enterprise integration solutions. + + + Facilitate asynchronous, message-driven behavior within a Spring-based application. + + + Promote intuitive, incremental adoption for existing Spring users. + + + + Spring Integration is guided by the following principles: + + + Components should be loosely coupled for modularity and testability. + + + The framework should enforce separation of concerns between business logic and + integration logic. + + + Extension points should be abstract in nature but within well-defined boundaries to promote + reuse and portability. + + + +
+ +
+ Main Components + + From the vertical perspective, a layered architecture facilitates separation of concerns, + and interface-based contracts between layers promote loose coupling. Spring-based applications are typically + designed this way, and the Spring framework and portfolio provide a strong foundation for following this best + practice for the full-stack of an enterprise application. Message-driven architectures add a + horizontal perspective, yet these same goals are still relevant. Just as "layered + architecture" is an extremely generic and abstract paradigm, messaging systems typically follow the similarly + abstract "pipes-and-filters" model. The "filters" represent any component that is capable of producing and/or + consuming messages, and the "pipes" transport the messages between filters so that the components themselves + remain loosely-coupled. It is important to note that these two high-level paradigms are not mutually exclusive. + The underlying messaging infrastructure that supports the "pipes" should still be encapsulated in a layer whose + contracts are defined as interfaces. Likewise, the "filters" themselves would typically be managed within a layer + that is logically above the application's service layer, interacting with those services through interfaces much + in the same way that a web-tier would. + + +
+ Message + + In Spring Integration, a Message is a generic wrapper for any Java object combined with metadata used by the + framework while handling that object. It consists of a payload and headers. The payload can be of any type and + the headers hold commonly required information such as id, timestamp, expiration, and return address. Headers + are also used for passing values to and from connected transports. For example, when creating a Message from a + received File, the file name may be stored in a header to be accessed by downstream components. Likewise, if a + Message's content is ultimately going to be sent by an outbound Mail adapter, the various properties (to, from, + cc, subject, etc.) may be configured as Message header values by an upstream component. Developers can also + store any arbitrary key-value pairs in the headers. + + + + + + + + + +
+ +
+ Message Channel + + A Message Channel represents the "pipe" of a pipes-and-filters architecture. Producers send Messages to + a channel, and consumers receive Messages from a channel. The Message Channel therefore decouples the + messaging components, and also provides a convenient point for interception and monitoring of Messages. + + + + + + + + + A Message Channel may follow either Point-to-Point or Publish/Subscribe semantics. With a Point-to-Point + channel, at most one consumer can receive each Message sent to the channel. Publish/Subscribe channels, on the + other hand, will attempt to broadcast each Message to all of its subscribers. Spring Integration supports + both of these. + + + Whereas "Point-to-Point" and "Publish/Subscribe" define the two options for how many + consumers will ultimately receive each Message, there is another important consideration: should the channel + buffer messages? In Spring Integration, Pollable Channels are capable of buffering + Messages within a queue. The advantage of buffering is that it allows for throttling the inbound Messages and + thereby prevents overloading a consumer. However, as the name suggests, this also adds some complexity, since a + consumer can only receive the Messages from such a channel if a poller is configured. On + the other hand, a consumer connected to a Subscribable Channel is simply Message-driven. + The variety of channel implementations available in Spring Integration will be discussed in detail in + . + +
+ +
+ Message Endpoint + + One of the primary goals of Spring Integration is to simplify the development of enterprise integration + solutions through inversion of control. This means that you should not have to implement + consumers and producers directly, and you should not even have to build Messages and invoke send or receive + operations on a Message Channel. Instead, you should be able to focus on your specific domain model with an + implementation based on plain Objects. Then, by providing declarative configuration, you can "connect" + your domain-specific code to the messaging infrastructure provided by Spring Integration. The components + responsible for these connections are Message Endpoints. This does not mean that you will necessarily connect + your existing application code directly. Any real-world enterprise integration solution will require some + amount of code focused upon integration concerns such as routing and + transformation. The important thing is to achieve separation of concerns between such + integration logic and business logic. In other words, as with the Model-View-Controller paradigm for web + applications, the goal should be to provide a thin but dedicated layer that translates inbound requests into + service layer invocations, and then translates service layer return values into outbound replies. The next + section will provide an overview of the Message Endpoint types that handle these responsibilities, and in + upcoming chapters, you will see how Spring Integration's declarative configuration options provide a + non-invasive way to use each of these. + +
+
+ +
+ Message Endpoints + + A Message Endpoint represents the "filter" of a pipes-and-filters architecture. As mentioned above, the + endpoint's primary role is to connect application code to the messaging framework and to do so in a non-invasive + manner. In other words, the application code should ideally have no awareness of the Message objects or the + Message Channels. This is similar to the role of a Controller in the MVC paradigm. Just as a Controller handles + HTTP requests, the Message Endpoint handles Messages. Just as Controllers are mapped to URL patterns, Message + Endpoints are mapped to Message Channels. The goal is the same in both cases: isolate application code from the + infrastructure. These concepts are discussed at length along with all of the patterns that follow in the + Enterprise Integration Patterns book. Here, we provide only a + high-level description of the main endpoint types supported by Spring Integration and their roles. The chapters + that follow will elaborate and provide sample code as well as configuration examples. + + +
+ Transformer + + A Message Transformer is responsible for converting a Message's content or structure and returning the modified + Message. Probably the most common type of transformer is one that converts the payload of the Message from one + format to another (e.g. from XML Document to java.lang.String). Similarly, a transformer may be used to add, + remove, or modify the Message's header values. + +
+ +
+ Filter + + A Message Filter determines whether a Message should be passed to an output channel at all. This simply + requires a boolean test method that may check for a particular payload content type, a property value, the + presence of a header, etc. If the Message is accepted, it is sent to the output channel, but if not it will be + dropped (or for a more severe implementation, an Exception could be thrown). Message Filters are often used in + conjunction with a Publish Subscribe channel, where multiple consumers may receive the same Message and use the + filter to narrow down the set of Messages to be processed based on some criteria. + + Be careful not to confuse the generic use of "filter" within the Pipes-and-Filters architectural pattern with + this specific endpoint type that selectively narrows down the Messages flowing between two channels. The + Pipes-and-Filters concept of "filter" matches more closely with Spring Integration's Message Endpoint: any + component that can be connected to Message Channel(s) in order to send and/or receive Messages. + + +
+ +
+ Router + + A Message Router is responsible for deciding what channel or channels should receive the Message next (if any). + Typically the decision is based upon the Message's content and/or metadata available in the Message Headers. + A Message Router is often used as a dynamic alternative to a statically configured output channel on + a Service Activator or other endpoint capable of sending reply Messages. Likewise, a Message Router provides a + proactive alternative to the reactive Message Filters used by multiple subscribers as described above. + + + + + + + + + +
+ +
+ Splitter + + A Splitter is another type of Message Endpoint whose responsibility is to accept a Message from its input + channel, split that Message into multiple Messages, and then send each of those to its output channel. This + is typically used for dividing a "composite" payload object into a group of Messages containing the + sub-divided payloads. + +
+ +
+ Aggregator + + Basically a mirror-image of the Splitter, the Aggregator is a type of Message Endpoint that receives multiple + Messages and combines them into a single Message. In fact, Aggregators are often downstream consumers in a + pipeline that includes a Splitter. Technically, the Aggregator is more complex than a Splitter, because it + is required to maintain state (the Messages to-be-aggregated), to decide when the complete group of Messages + is available, and to timeout if necessary. Furthermore, in case of a timeout, the Aggregator needs to know + whether to send the partial results or to discard them to a separate channel. Spring Integration provides + a CompletionStrategy as well as configurable settings for timeout, whether + to send partial results upon timeout, and the discard channel. + +
+ +
+ Service Activator + + A Service Activator is a generic endpoint for connecting a service instance to the messaging system. The + input Message Channel must be configured, and if the service method to be invoked is capable of returning a + value, an output Message Channel may also be provided. + + The output channel is optional, since each Message may also provide its own 'Return Address' header. This + same rule applies for all consumer endpoints. + + The Service Activator invokes an operation on some service object to process the request Message, extracting + the request Message's payload and converting if necessary (if the method does not expect a Message-typed + parameter). Whenever the service object's method returns a value, that return value will likewise be converted + to a reply Message if necessary (if it's not already a Message). That reply Message is sent to the output + channel. If no output channel has been configured, then the reply will be sent to the channel specified in the + Message's "return address" if available. + + + + + + + + + A request-reply "Service Activator" endpoint connects a target object's method to input and output + Message Channels. + + + +
+ +
+ Channel Adapter + + A Channel Adapter is an endpoint that connects a Message Channel to some other system or transport. Channel + Adapters may be either inbound or outbound. Typically, the Channel Adapter will do some mapping between the + Message and whatever object or resource is received-from or sent-to the other system (File, HTTP Request, JMS + Message, etc). Depending on the transport, the Channel Adapter may also populate or extract Message header + values. Spring Integration provides a number of Channel Adapters, and they will be described in upcoming + chapters. + + + + + + + + An inbound "Channel Adapter" endpoint connects a source system to a MessageChannel. + + + + + + + + + An outbound "Channel Adapter" endpoint connects a MessageChannel to a target system. + + +
+
+ +
diff --git a/src/docbkx/resequencer.xml b/docs/src/reference/docbook/resequencer.xml similarity index 100% rename from src/docbkx/resequencer.xml rename to docs/src/reference/docbook/resequencer.xml diff --git a/docs/src/reference/docbook/resources.xml b/docs/src/reference/docbook/resources.xml new file mode 100644 index 0000000000..109faa9b53 --- /dev/null +++ b/docs/src/reference/docbook/resources.xml @@ -0,0 +1,17 @@ + + + Additional Resources + +
+ Spring Integration Home + + The definitive source of information about Spring Integration is the + Spring Integration Home at + http://www.springsource.org. That site serves as a hub of + information and is the best place to find up-to-date announcements about the project as well as links to + articles, blogs, and new sample applications. + +
+ +
diff --git a/docs/src/reference/docbook/rmi.xml b/docs/src/reference/docbook/rmi.xml new file mode 100644 index 0000000000..ec642fe05c --- /dev/null +++ b/docs/src/reference/docbook/rmi.xml @@ -0,0 +1,66 @@ + + + RMI Support + +
+ Introduction + + This Chapter explains how to use RMI specific channel adapters to distribute a system over multiple JVMs. The first section will deal with sending messages over RMI. The second section shows how to receive messages over RMI. The last section shows how to define rmi channel adapters through the namespace support. + +
+ +
+ Outbound RMI + + To send messages from a channel over RMI, simply define an RmiOutboundGateway. This gateway will use Spring's RmiProxyFactoryBean internally to create a proxy for a remote gateway. Note that to invoke a remote interface that doesn't use Spring Integration you should use a service activator in combination with Spring's RmiProxyFactoryBean. + + + To configure the outbound gateway write a bean definition like this: + + + + ]]> + + +
+ +
+ Inbound RMI + + To receive messages over RMI you need to use a RmiInboundGateway. This gateway can be configured like this + + + ]]> + + +
+ +
+ RMI namespace support + + To configure the inbound gateway you can choose to use the namespace support for it. The following code snippet shows the different configuration options that are supported. + + + + + + + + + ]]> + + + To configure the outbound gateway you can use the namespace support as well. The following code snippet shows the different configuration for an outbound rmi gateway. + ]]> + +
+ +
diff --git a/docs/src/reference/docbook/router.xml b/docs/src/reference/docbook/router.xml new file mode 100644 index 0000000000..1fcc281e77 --- /dev/null +++ b/docs/src/reference/docbook/router.xml @@ -0,0 +1,405 @@ + + + Router + +
+ Router Implementations + + Since content-based routing often requires some domain-specific logic, most use-cases will require + Spring Integration's options for delegating to POJOs using the XML namespace support and/or Annotations. + Both of these are discussed below, but first we present a couple implementations that are available + out-of-the-box since they fulfill generic, but common, requirements. + +
+ PayloadTypeRouter + + A PayloadTypeRouter will send Messages to the channel as defined by payload-type + mappings. + + + + + + + +]]> + + + Configuration of PayloadTypeRouter is also supported via the namespace provided by Spring Integration (see ), + which essentially simplifies configuration by combining <router/> configuration and its corresponding implementation defined using <bean/> element + into a single and more concise configuration element. + The example below demonstrates PayloadTypeRouter configuration which is equivalent to the one above using Spring Integration's namespace support: + + + + + +]]> + +
+
+ HeaderValueRouter + + A HeaderValueRouter will send Messages to the channel based on the individual header value mappings. + When HeaderValueRouter is created it is initialized with the name of the header to be evaluated, using constructor-arg. + The value of the header could be one of two things: + + 1. Arbitrary value + + + 2. Channel name + + + If arbitrary value, then a channelResolver should be provided to map header values to channel names. + The example below uses MapBasedChannelResolver to set up a map of header values to channel names. + + + + + + + + + + + + + +]]> + If channelResolver is not specified, then the header value will be treated as a channel name + making configuration much simpler, where no channelResolver needs to be specified. + + + +]]> + + + Similar to the PayloadTypeRouter, configuration of HeaderValueRouter is also supported via namespace support provided by Spring Integration (see ). + The example below demonstrates two types of namespace-based configuration of HeaderValueRouter which are equivalent to the ones above using Spring Integration namespace support: + + 1. Configuration where mapping of header values to channels is required + + + + +]]> + + 2. Configuration where mapping of header values is not required if header values themselves represent the channel names + + ]]> + + + The two router implementations shown above share some common properties, such as "defaultOutputChannel" and "resolutionRequired". + If "resolutionRequired" is set to "true", and the router is unable to determine a target channel (e.g. there is + no matching payload for a PayloadTypeRouter and no "defaultOutputChannel" has been specified), then an Exception + will be thrown. + +
+
+ RecipientListRouter + + A RecipientListRouter will send each received Message to a statically-defined + list of Message Channels: + + + + + + + + +]]> + +
+ + Configuration for RecipientListRouter is also supported via namespace support provided by Spring Integration (see ). + The example below demonstrates namespace-based configuration of RecipientListRouter and all the supported attributes using Spring Integration namespace support: + + + + + +]]> + + + The 'apply-sequence' flag here has the same affect as it does for a publish-subscribe-channel, + and like publish-subscribe-channel it is disabled by default on the recipient-list-router. Refer to + for more information. + +
+ +
+ The <router> element + + The "router" element provides a simple way to connect a router to an input channel, and also accepts the + optional default output channel. The "ref" may provide the bean name of a custom Router implementation + (extending AbstractMessageRouter): + + + + + + +]]> + + Alternatively, the "ref" may point to a simple Object that contains the @Router annotation (see below), or the + "ref" may be combined with an explicit "method" name. When specifying a "method", the same behavior applies as + described in the @Router annotation section below. + ]]> + Using a "ref" attribute is generally recommended if the custom router implementation can be reused in other + <router> definitions. However if the custom router implementation should be scoped to a + concrete definition of the <router>, you can provide an inner bean definition: + + +]]> + + + + Using both the "ref" attribute and an inner handler definition in the same <router> configuration + is not allowed, as it creates an ambiguous condition and will result in an Exception being thrown. + + +
+ +
+ The @Router Annotation + + When using the @Router annotation, the annotated method can return either the + MessageChannel or String type. In the case of the latter, + the endpoint will resolve the channel name as it does for the default output. Additionally, the method can return + either a single value or a collection. When a collection is returned, the reply message will be sent to multiple + channels. To summarize, the following method signatures are all valid. + @Router +public MessageChannel route(Message message) {...} + +@Router +public List<MessageChannel> route(Message message) {...} + +@Router +public String route(Foo payload) {...} + +@Router +public List<String> route(Foo payload) {...} + + + In addition to payload-based routing, a common requirement is to route based on metadata available within the + message header as either a property or attribute. Rather than requiring use of the + Message type as the method parameter, the @Router + annotation may also use the @Header parameter annotation that is documented in . + @Router +public List<String> route(@Header("orderStatus") OrderStatus status) + +
+ + For routing of XML-based Messages, including XPath support, see . + + +
+ Dynamic Routers + + So as you can see, Spring Integration provides quite a few different router configurations for most common + content-based routing use cases as well as the option of implementing custom routers as POJOs. + For example; Payload Type Router provides a simple way to configure a router which computes channels + based on the payload type of the incoming Message while Header Value Router provides the + same convenience in configuring a router which computes channels based on evaluating the value + of a particular Message Header. There is also an expression-based (SpEL) routers where the channel + is determined based on evaluating an expression which gives these type of routers some dynamic characteristics. + + + However these routers share one common attribute - static configuration. Even in the case of + expression-based routers, the expression itself is defined as part of the router configuration which means that + the same expression operating on the same value will always result in the computation of the same channel. + This is good in most cases since such routes are well defined and therefore predictable. But there are times when we + need to change router configurations dynamically so message flows could be routed to a different channel. + + For example: + + You might want to bring down some part of your system for maintenance. So, temporarily you want to re-reroute + messages to a different message flow. Or you may want to introduce more granularity to your message flow by adding another + route to handle a more concrete type of java.lang.Number (in cases of Payload Type Router). + + + Unfortunately with static router configuration to accomplish this you'd have to bring down your entire application, + change the configuration of the router (change routes) and bring it back up. This is obviously not the solution. + + + + Dynamic Router + + pattern describes the mechanisms by which one can change/configure routers dynamically without + bringing down your system or individual routers.  + + + Before we get into the specifics of how it is accomplished in Spring Integration lets quickly summarize the + typical flow of the router, which consists of 3 simple steps: + + + Step 1 - Compute channel identifier which is a value calculated by the + router once it receives the Message. Typically it is a String or and instance of the actual + MessageChannel. + + + Step 2 - Resolve channel identifier to channel name. We'll describe + specifics of this process in a moment. + + + Step 3 - Resolve channel name to the actual MessageChannel + + + + + + There is not much that could be done with regard to router dynamics if Step 1 results in the actual instance of the + MessageChannel simply because MessageChannel is the final product of any + router's job. However, if Step 1 results in channel identifier that is not and instance of MessageChannel, + then there are quite a few possibilities to influence the process of calculating what will be the final instance of the Message Channel. + Lets look at couple of the examples in the context of the 3 steps mentioned above:  + + + Payload Type Router + + + + + +]]> + + + Within the context of the Payload Type Router the 3 steps mentioned above would be realized as: + + + Step 1 - Compute channel identifier which is the fully qualified name of the payload type + (e.g., java.lang.String). + + + Step 2 - Resolve channel identifier to channel name where + the result of the previous step is used to select the appropriate value from the payload type mapping + defined via mapping element. + + + Step 3 - Resolve channel name to the actual instance of the + MessageChannel where using ChannelResolver router will obtain a + reference to a bean (which is hopefully a MessageChannel) identified by the result of the + previous step. + + + In other words each step feeds the next step until thr process completes. + + + Header Value Router + + + + + +]]> + + + Similar to the PayloadTypeRouter: + + + Step 1 - Compute channel identifier which is the value of the header identified by the + header-name attribute. + + + Step 2 - Resolve channel identifier to channel name where + the result of the previous step is used to select the appropriate value from the general mapping + defined via mapping element. + + + Step 3 - Resolve channel name to the actual instance of the + MessageChannel where using ChannelResolver router will obtain a + reference to a bean (which is hopefully a MessageChannel) identified by the result of the + previous step. + + + + + The above two configurations of two different router types look almost identical. + However if we look at the different configuration of the HeaderValueRouter we clearly see that + there is no mapping sub element: + ]]> + But configuration is still perfectly valid. So the natural question is what about the maping in the Step 2? + + + What this means is that Step 2 is now an optional step. If mapping is not defined then the channel identifier + value computed in Step 1 will automatically be treated as the channel name which will now be resolved to the + actual MessageChannel in the Step 3. What it also means is that Step 2 is one of the key steps to + provide dynamic characteristics to the routers, since it introduces a process which + allows you to change the way 'channel identifier' resolves to 'channel name', + thus influencing the process of determining the final instance of the MessageChannel from the initial + channel identifier.  + + For Example: + + In the above configuration lets assume that the testHeader value is 'kermit' which is now a channel identifier + (Step 1). Since there is no mapping in this router, resolving this channel identifier to a channel name + (Step 2) is impossible and this channel identifier is now treated as channel name. However what if + there was mapping but for a different value, the end result would still be the same and that is: + if new value can not be determined through the process of resolving 'channel identifier' to a 'channel name', + such 'channel identifier' becomes 'channel name' + + + So all that is left is for Step 3 to resolve channel name ('kermit') to an actual instance of the + MessageChannel identified by this name. That will be done via default + ChannelResolver implementation which is BeanFactoryChannelResolver which + basically does a bean lookup by the name provided. So now all messages which contain the header/value pair as testHeader=kermit + are going to be routed to a 'kermit' MessageChannel. + + + But what if you want to route these messages to 'simpson' channel? Obviously changing static configuration would work, + but would also require bringing your system down. However if you had access to channel identifier map, then you + could just introduce a new mapping where header/value pair is now kermit=simpson, thus allowing Step 2 to treat + 'kermit' as channel identifier while resolving it to 'simpson' as channel name . + + + The same obviously applies for PayloadTypeRouter where you can now remap or remove a particular payload type + mapping, and every other router including expression-based routers since their computed value + will now have a chance to go through Step 2 to be aditionally resolved to the actual channel name. + + + In Spring Integration 2.0 routers hierarchy underwent major refactoring and now any router that is a subclass of the + AbstractMessageRouter (all framework defined routers) is a Dynamic Router simply because + channelIdentiferMap is defined at the AbstractMessageRouter with convenient accessors + and modifiers exposed as public methods allowing you to change/add/remove router mapping at runtime via JMX (see section section 29) or + ControlBus (see section section 29.7) functionality.  + + + + Control Bus + + + One of the way to manage the router mappings is through the Control Bus + which exposes a Control Channel where you can send + control messages to manage and monitor Spring Integration components which includes routers. + For more information about the Control Bus see section 29.7. Typically you would send a control message asking to invoke a + particular JMX operation on a particular managed component (e.g., router). The two managed operations (methods) that are + specific to changing router resolution process are: + + + public void setChannelMapping(String channelIdentifier, String channelName) - + will allow you to add new or modify existing mapping of channel identifier to channel name + + + public void removeChannelMapping(String channelIdentifier) - + will allow you to remove a particular channel mapping, thus disconnecting the relationship between + channel identifier and channel name + + + There are obviously other managed operations, so please refer to an AbstractMessageRouter for more detail + + + You can also use your favorite JMX client (e.g., JConsole) and use those operations (methods) to change + router configuration. For more information on Spring Integration management and monitoring please visit + section 29 of this manual. + +
+ +
diff --git a/docs/src/reference/docbook/samples.xml b/docs/src/reference/docbook/samples.xml new file mode 100644 index 0000000000..b2ca7d18fe --- /dev/null +++ b/docs/src/reference/docbook/samples.xml @@ -0,0 +1,662 @@ + + + Spring Integration Samples + +
+ Introduction + + Starting with the current release of Spring Integration the samples are no longer included with + Spring Integration distribution. Instead we've switched to a much simpler collaborative model that should promote + better community participation and community contributions. Samples now have a dedicated Git SCM repository and a + dedicated JIRA Issue Tracking system. Sample development will also have its own lifecycle which is not dependent on the + lifecycle of the framework releases although the repository will still be tagged with each major release for compatibility + reasons. + + + The great benefit to the community is that we can now add more samples and make them available to you right away + without waiting for the release to get them out to you. Having its own JIRA that is not tied up to the the actual + framework is also a great benefit. You now have a dedicated place to suggest samples as well as report issues with existing + samples. Or you may want to submit a sample to us as an attachment through the JIRA and if we believe your sample adds value we + would be more then glad to add it to a samples repository properly crediting the author. + +
+ +
+ Where to get Samples + + To monitor samples development and to get more information on the repository you can visit the following + URL: http://git.springsource.org/spring-integration/samples + Since we are using Git SCM we should use the proper terminology as well when it comes to the tasks you need to perform to make + samples available locally on your machine. For more information on Git SCM please visit their + website: http://git-scm.com/ + + + CLONE samples repository. (For those unfamiliar with Git, this is somewhat the equivalent of a checkout.) + + + This is the first step you should go through. You must have Git installed on your machine. There are many GUI-based products + available for many platforms. Simple Google search will let you find them. + To clone samples repository from command line: + mkdir spring-itegration-samples +> cd spring-itegration-samples +> git clone git://git.springsource.org/spring-integration/samples.git]]> + + + That is all you need to do. Now you have cloned the entire samples repository. Since samples repository is a live + repository, you might want to perform periodic updates to get new samples as well as updates to the existing samples. + To get the updates use git PULL command: + git pull]]> + + + Submit samples or sample requests + + + As mentioned earlier, Spring Integration samples have a dedicated JIRA Issue tracking system. + To submit new sample request or to submit the actual sample (as an attachment) please visit our JIRA Issue Tracking system: + https://jira.springframework.org/browse/INTSAMPLES  + +
+
+ Samples structure + + The structure of the samples changed as well. With plans for more samples we realized that some + samples have different goals then others. While they all share the common  goal of showing you how to apply and work with + Spring Integration framework, they also defer in areas where some samples were meant to concentrate on a technical + use case while others on the business use case and some samples are all about showcasing various techniques that + could be applied to address certain scenarios (both technical and business). Categorization of samples will allow us + better organize them based on the problem each sample addresses while giving you a simpler way of finding the right sample + + + Currently there are 4 categories. Within the samples repository each category has its own directory which is named after the + category name: + + + + BASIC (samples/basic) + + + This is a good place to get started. The samples here are technically motivated and demonstrate the bare + minimum with regard to configuration and code, to help you to get started quickly by introducing you to the basic concepts, + API and configuration of Spring Integration as well as Enterprise Integration Patterns (EIP). For example; If your are + looking for an answer on how to implement and wire Service Activator to a Channel + or how to use Messaging Gateway to your message exchange or how to get started with using MAIL or + TCP/UDP modules etc., this would be the right place to find a good sample. The bottom line is this is a good place + to get started. + + + + INTERMEDIATE (samples/intermediate) + + + This category targets developers who are already familiar with Spring Integration framework (past getting started), + but need some more guidance while resolving a more advanced technical problems one might deal with + once switch to a Messaging architecture. + For example; If you are looking for an answer on how to handle errors in various message exchange + scenarios or how to properly configure the Aggregator for the situations where some messages + might not ever arrive for aggregation etc,. and any other issue that goes beyond a basic implementation and configuration + of a particular component and addresses "what else you can do with it" type of problem this + would be the right place to find these type of samples. + + + + ADVANCED (samples/advanced) + + + This category targets develoopers who are very familiar with Spring Integration framework but looking to + extend it to address a specific custom need by using Spring Integration public API. + For example; if you are looking for samples showing you how to implement a custom Channel or + Consumer (event-based or polling-based), or you trying to figure out what is the most appropriate + way to implement custom Bean parser on top of Spring Integration Bean parsers hierarchy when implementing custom name space + for a custom component, this would be the right place to look. + Here you can also find samples that will help you with Adapter development. Spring Integration comes + with an extensive library of adapters to allow you to connect remote systems with Spring Integration messaging framework. + However you might have a need to integrate with system for which the core framework does not provide an adapter. + So you have to implement your own. This category would include samples showing you how to do it. + + + + + APPLICATIONS (samples/applications) + + + This category targets developers and architects who have a good understanding of the Messaging architecture, + EIP and above average understanding of Spring and Spring Integration frameworks and are looking for samples that + address a particular business problem. In other words the emphasis of samples in this category + is business use cases and how it could be solved via Messaging Architecture and Spring Integration + in particular. + For example; If you are interested to see how a Loan Broker or Travel Agent + process could be implemented and automated via Spring Integration this would be the right place to find these types of samples. + + + + + Remember! Spring Integration is a community driven framework, therefore community participation is IMPORTANT. +That includes Samples, so if you can't find what you are looking for let us know. + + +
+ +
+ Samples + + Currently Spring Integration comes with quite a few samples and you can only expect more. + To help you better navigate through them, each sample comes with its own readme.txt file which coveres + sevaral details about the sample (e.g., what EIP patterns it addresses, what problem it is trying to solve, how to run sample etc.). + However, certain samples require a more detailed and some times graphical explanation. In these section you'll + find details on samples that we believe require special attention. + +
+ Loan Broker + + In this section, we will review a Loan Broker sample application that is included in the + Spring Integration samples. This sample is inspired by one of the samples featured in Gregor + Hohpe's Ramblings. + + The diagram below represents the entire process + + + + + + + + + + + Now lets look at this process in more details + + At the core of EIP architecture are the very simple yet powerful concepts of Pipes and Filters and Message. Endpoints (Filters) are + connected with one another via Channels (Pipes). The producing endpoint sends Message to the Channel and the Message is retrieved + by the Consuming endpoint. This architecture is meant to define various mechanisms that describe How information is exchanged between + the endpoints, without any awareness of What those endpoints are or What information they are exchanging, thus providing for a very loosely + coupled and flexible collaboration model while also, decoupling Integration concerns from Business concerns. EIP extends this architecture + by further defining: + + + The types of pipes (Point-to-Point Channel, Publish-Subscribe Channel, Channel Adapter, etc.) + + + + The core filters and patterns around how filters collaborate with pipes + (Message Router, Splitters and Aggregators, various Message Transformation patterns, etc.) + + + + + The details and variations of this use case are very nicely described in Chapter 9 of the EIP Book, but here is the brief summary; + A Consumer while shopping for the best Loan Quote(s) subscribes to the services of a Loan Broker, which handles details such as: + + + Consumer pre-screening (e.g., obtain and review the consumer's Credit history) + + + + Determine the most appropriate Banks (e.g., based on consumer's credit history/score) + + + + Send a Loan quote request to each selected Bank + + + Collect responses from each Bank + + + Filter responses and determine the best quote(s), based on consumer's requirements. + + + Pass the Loan quote(s) back to the consumer. + + + + + Obviously the real process of obtaining a loan quote is a bit more complex, but since our goal here is to demonstrate how + Enterprise Integration Patterns are realized and implemented within SI, the use case has been simplified to concentrate only on + the Integration aspects of the process. It is not an attempt to give you an advice in consumer finances. + + + As you can see, by hiring a Loan Broker, the consumer is isolated from the details of the Loan Broker's operations, and each Loan Broker's + operations may defer from one another to maintain competitive advantage, so whatever we assemble/implement must be flexible so any changes + could be introduced quickly and painlessly. + Speaking of change, the Loan Broker sample does not actually talk to any 'imaginary' Banks or Credit bureaus. Those services are stubbed out. + Our goal here is to assemble, orchestrate and test the integration aspect of the process as a whole. Only then can we start thinking about + wiring such process to the real services. At that time the assembled process and its configuration will not change regardless of the number + of Banks a particular Loan Broker is dealing with, or the type of communication media (or protocols) used (JMS, WS, TCP, etc.) + to communicate with these Banks. + + DESIGN + + As you analyze the 6 requirements above you'll quickly see that they all fall into the category of Integration concerns. + For example, in the consumer pre-screening step we need to gather additional information about the consumer and the consumer's desires + and enrich the loan request with additional meta information. We then have to filter such information to select the most appropriate list of + Banks, and so on. Enrich, filter, select – these are all integration concerns for which EIP defines a solution in the form of patterns. + SI provides an implementation of these patterns. + + Messaging Gateway + + + + + + + + + + + The Messaging Gateway pattern provides a simple mechanism to access messaging systems, including our Loan Broker. + In SI you define the Gateway as a Plain Old Java Interface (no need to provide an implementation), configure it via the + XML <gateway&gr; element or via annotation and use it as any other Spring bean. SI will take care of + delegating and mapping method invocations to the Messaging infrastructure by generating a Message (payload is mapped to an + input parameter of the method) and sending it to the designated channel. + + +
+ +]]> + + + Our current Gateway provides two methods that could be invoked. One that will return the best single quote and another one that + will return all quotes. Somehow downstream we need to know what type of reply the caller is looking for. The best way to achieve + this in Messaging architecture is to enrich the content of the message with some meta-data describing your intentions. + Content Enricher is one of the patterns that addresses this and although Spring Integration does provide a + separate configuration element to enrich Message Headers with arbitrary data (we'll see it later), as a convenience, since + Gateway element is responsible to construct the initial Message it provides embedded + capability to enrich the newly created Message with arbitrary Message Headers. In our + example we are adding header RESPONSE_TYPE with value 'BEST'' whenever the getBestQuote() method is invoked. For other method + we are not adding any header. Now we can check downstream for an existence of this header and based on its presence and its value + we can determine what type of reply the caller is looking for. + + + + Based on the use case we also know there are some pre-screening steps that needs to be performed such as getting and evaluating the consumer's + credit score, simply because some premiere Banks will only typically accept quote requests from consumers that meet a minimum credit + score requirement. So it would be nice if the Message would be enriched with such information before it is forwarded + to the Banks. It would also be nice if when several processes needs to be completed to provide such meta-information, those + processes could be grouped in a single unit. In our use case we need to determine credit score and based on the credit score and some + rule select a list of Message Channels (Bank Channels) we will sent quote request to. + + Composed Message Processor + + The Composed Message Processor pattern describes rules around building endpoints that maintain control over message flow which + consists of multiple message processors. In Sprig Integration Composed Message Processor pattern is implemented via + <chain> element. + + + + + + + + + + + As you can see from the above configuration we have a chain with inner header-enricher element which will further enrich the + content of the Message with the header CREDIT_SCORE and value that will be determined by the call to a + credit service (simple POJO spring bean identified by 'creditBureau' name) and then it will delegate to the Message Router + + Message Router + + + + + + + + + + + There are several implementation of Message Routing pattern available in Spring Integration. Here we are using + router that will determine a list of channels based on evaluating an expression (Spring Expression Language) which will look at + the credit score that was determined is the previous step and will select the list of channels from the Map bean with id 'banks' + whose values are 'premier' or 'secondary' based o the value of credit score. Once the list of Channels is selected, the + Message will be routed to those Channels. + + + Now, one last thing the Loan Broker needs to to is to receive the loan quotes form the banks, aggregate them by consumer + (we don't want to show quotes from one consumer to another), assemble the response based on the consumer's selection criteria + (single best quote or all quotes) and reply back to the consumer. + + Message Aggregator + + + + + + + + + + + + An Aggregator pattern describes an endpoint which groups related Messages into a single + Message. Criteria and rules can be provided to determine an aggregation and correlation strategy. + SI provides several implementations of the Aggregator pattern as well as a convenient name-space based configuration. + + +]]> + + + + Our Loan Broker defines a 'quotesAggregator' bean via the <aggregator> element which provides a default + aggregation and correlation strategy. The default correlation strategy correlates messages based on the $corelationId header + (see Correlation Identifier pattern). What's interesting is that we never provided the value for this header. + It was set earlier by the router automatically, when it generated a separate Message for each Bank channel. + + + Once the Messages are correlated they are released to the actual Aggregator implementation. + Although default Aggregator is provided by SI, its strategy (gather the list of payloads from all + Messages and construct a new Message with this List as payload) does not satisfy our + requirement. The reason is that our consumer might require a single best quote or all quotes. To communicate the consumer's + intention, earlier in the process we set the RESPONSE_TYPE header. Now we have to evaluate this header and return either + all the quotes (the default aggregation strategy would work) or the best quote (the default aggregation strategy will not work + because we have to determine which loan quote is the best). + + + + Obviously selecting the best quote could be based on complex criteria and would influence the complexity of the aggregator implementation and + configuration, but for now we are making it simple. If consumer wants the best quote we will select a quote with the lowest interest + rate. To accomplish that the LoanQuoteAggregator.java will sort all the quotes and return the first one. + The LoanQuote.java implements Comparable which compares quotes based on the rate attribute. + Once the response Message is created it is sent to the default-reply-channel of the Messaging Gateway + (thus the consumer) which started the process. Our consumer got the Loan Quote! + + Conclusion + + As you can see a rather complex process was assembled based on POJO (read existing, legacy), light weight, embeddable messaging + framework (Sprig Integration) with a loosely coupled programming model intended to simplify integration of heterogeneous systems + without requiring a heavy-weight ESB-like engine or proprietary development and deployment environment, becouse as a developer you + should not be porting your Swing or console-based application to an ESB-like server or implementing proprietary interfaces just + because you have an integration concern. + + + This and other samples in this section are build on top of Enterprise Integration Patterns that meant to describe "building blocks" + for YOUR solution but not to be solutions in of themselves. Integration concerns exist in all types of applications (server based and not) + and should not require change in design, testing and deployment strategy if such applications need to integrate with one another. + +
+ + + + +
+ The Cafe Sample + + In this section, we will review a Cafe sample application that is included in the + Spring Integration samples. This sample is inspired by another sample featured in Gregor + Hohpe's Ramblings. + + + The domain is that of a Cafe, and the basic flow is depicted in the following diagram: + + + + + + + + + + + + + The Order object may contain multiple OrderItems. Once the order + is placed, a Splitter will break the composite order message into a single message per + drink. Each of these is then processed by a Router that determines whether the drink is hot + or cold (checking the OrderItem object's 'isIced' property). The + Barista prepares each drink, but hot and cold drink preparation are handled by two + distinct methods: 'prepareHotDrink' and 'prepareColdDrink'. The prepared drinks are then sent to the Waiter where + they are aggregated into a Delivery object. + + + Here is the XML configuration: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ]]> + As you can see, each Message Endpoint is connected to input and/or output channels. Each endpoint will manage + its own Lifecycle (by default endpoints start automatically upon initialization - to prevent that add the + "auto-startup" attribute with a value of "false"). Most importantly, notice that the objects are simple POJOs + with strongly typed method arguments. For example, here is the Splitter: + split(Order order) { + return order.getItems(); + } + }]]> + In the case of the Router, the return value does not have to be a MessageChannel + instance (although it can be). As you see in this example, a String-value representing the channel name is + returned instead. + + + + Now turning back to the XML, you see that there are two <service-activator> elements. Each of these + is delegating to the same Barista instance but different methods: 'prepareHotDrink' + or 'prepareColdDrink' corresponding to the two channels where order items have been routed. + + + + As you can see from the code excerpt above, the barista methods have different delays (the hot drinks take 5 + times as long to prepare). This simulates work being completed at different rates. When the + CafeDemo 'main' method runs, it will loop 100 times sending a single hot drink and a + single cold drink each time. It actually sends the messages by invoking the 'placeOrder' method on the Cafe + interface. Above, you will see that the <gateway> element is specified in the configuration file. This + triggers the creation of a proxy that implements the given 'service-interface' and connects it to a channel. + The channel name is provided on the @Gateway annotation of the Cafe interface. + public interface Cafe { + + @Gateway(requestChannel="orders") + void placeOrder(Order order); + + } + Finally, have a look at the main() method of the CafeDemo itself. + 0) { + context = new FileSystemXmlApplicationContext(args); + } + else { + context = new ClassPathXmlApplicationContext("cafeDemo.xml", CafeDemo.class); + } + Cafe cafe = (Cafe) context.getBean("cafe"); + for (int i = 1; i <= 100; i++) { + Order order = new Order(i); + order.addItem(DrinkType.LATTE, 2, false); + order.addItem(DrinkType.MOCHA, 3, true); + cafe.placeOrder(order); + } + }]]> + + + To run this sample as well as 8 others, refer to the README.txt within the "samples" directory + of the main distribution as described at the beginning of this chapter. + + + When you run cafeDemo, you will see that the cold drinks are initially prepared more quickly than the hot drinks. + Because there is an aggregator, the cold drinks are effectively limited by the rate of the hot drink preparation. + This is to be expected based on their respective delays of 1000 and 5000 milliseconds. However, by configuring a + poller with a concurrent task executor, you can dramatically change the results. For example, you could use a + thread pool executor with 5 workers for the hot drink barista while keeping the cold drink barista as it is: + + + + ]]> + ]]> + + ]]>]]> + + + Also, notice that the worker thread name is displayed with each invocation. You will see that the hot drinks are + prepared by the task-executor threads. If you provide a much shorter poller interval (such as 100 milliseconds), + then you will notice that occasionally it throttles the input by forcing the task-scheduler (the caller) to invoke + the operation. + + + In addition to experimenting with the poller's concurrency settings, you can also add the 'transactional' + sub-element and then refer to any PlatformTransactionManager instance within the context. + +
+ +
+ The XML Messaging Sample + + The xml messaging sample in the org.springframework.integration.samples.xml illustrates how to use + some of the provided components which deal with xml payloads. The sample uses the idea of processing an order for books + represented as xml. + + + First the order is split into a number of messages, each one representing a single order item using + the XPath splitter component. + + + + ]]> + + + A service activator is then used to pass the message into a stock checker POJO. The order item document is enriched with information + from the stock checker about order item stock level. This enriched order item message is then used to route the message. In the + case where the order item is in stock the message is routed to the warehouse. The XPath router makes use of a + MapBasedChannelResolver which maps the XPath evaluation result to a channel reference. + + + + + + + + + + + + + ]]> + + + Where the order item is not in stock the message is transformed using + xslt into a format suitable for sending to the supplier. + + ]]> + +
+
+ + +
diff --git a/docs/src/reference/docbook/security.xml b/docs/src/reference/docbook/security.xml new file mode 100644 index 0000000000..1d17fb6ed6 --- /dev/null +++ b/docs/src/reference/docbook/security.xml @@ -0,0 +1,64 @@ + + + Security in Spring Integration + +
+ Introduction + + Spring Integration provides integration with the + Spring Security project + to allow role based security checks to be applied to channel send and receive invocations. + +
+ +
+ Securing channels + + Spring Integration provides the interceptor ChannelSecurityInterceptor, which extends + AbstractSecurityInterceptor and intercepts send and receive calls on the channel. Access decisions + are then made with reference to ChannelInvocationDefinitionSource which provides the definition of + the send and receive security constraints. The interceptor requires that a valid SecurityContext + has been established by authenticating with Spring Security, see the Spring Security reference documentation for details. + + + Namespace support is provided to allow easy configuration of security constraints. This consists of the secured channels tag which allows + definition of one or more channel name patterns in conjunction with a definition of the security configuration for send and receive. The pattern + is a java.util.regexp.Pattern. + + + + + + +]]> + + + By default the secured-channels namespace element expects a bean named authenticationManager which implements + AuthenticationManager and a bean named accessDecisionManager which implements + AccessDecisionManager. Where this is not the case references to the appropriate beans can be configured + as attributes of the secured-channels element as below. + + + +]]> + + + +
+ + +
diff --git a/docs/src/reference/docbook/service-activator.xml b/docs/src/reference/docbook/service-activator.xml new file mode 100644 index 0000000000..2325d17e54 --- /dev/null +++ b/docs/src/reference/docbook/service-activator.xml @@ -0,0 +1,71 @@ + + + Service Activator + +
+ Introduction + + The Service Activator is the endpoint type for connecting any Spring-managed Object to an input channel so that + it may play the role of a service. If the service produces output, it may also be connected to an output channel. + Alternatively, an output producing service may be located at the end of a processing pipeline or message flow in + which case, the inbound Message's "replyChannel" header can be used. This is the default behavior if no output + channel is defined, and as with most of the configuration options you'll see here, the same behavior actually + applies for most of the other components we have seen. + +
+ +
+ The <service-activator/> Element + + To create a Service Activator, use the 'service-activator' element with the 'input-channel' and 'ref' attributes: + <service-activator input-channel="exampleChannel" ref="exampleHandler"/> + + + The configuration above assumes that "exampleHandler" either contains a single method annotated with the + @ServiceActivator annotation or that it contains only one public method at all. To delegate to an explicitly + defined method of any object, simply add the "method" attribute. + <service-activator input-channel="exampleChannel" ref="somePojo" method="someMethod"/> + + + In either case, when the service method returns a non-null value, the endpoint will attempt to send the reply + message to an appropriate reply channel. To determine the reply channel, it will first check if an + "output-channel" was provided in the endpoint configuration: + <service-activator input-channel="exampleChannel" output-channel="replyChannel" + ref="somePojo" method="someMethod"/> + If no "output-channel" is available, it will then check the Message's REPLY_CHANNEL header + value. If that value is available, it will then check its type. If it is a + MessageChannel, the reply message will be sent to that channel. If it is a + String, then the endpoint will attempt to resolve the channel name to a channel instance. + If the channel cannot be resolved, then a ChannelResolutionException will be thrown. + + + The argument in the service method could be either a Message or an arbitrary type. If the latter, then it will + be assumed that it is a Message payload, which will be extracted from the message and injected into such service + method. This is generally the recommended approach as it follows and promotes a POJO model when working with Spring + Integration. Arguments may also have @Header, @Headers annotations as described in + + + Since v1.0.3 of Spring Integration, the service method is not required to have an argument at all, which means you + can now implement event-style Service Activators, where all you care about is an invocation of the service method, + not worrying about the contents of the message. Think of it as a NULL JMS message. An example use-case for such an + implementation could be a simple counter/monitor of messages deposited on the input channel. + + + Using a "ref" attribute is generally recommended if the custom Service Activator handler implementation can be reused + in other <service-activator> definitions. However if the custom Service Activator handler implementation + should be scoped to a single definition of the <service-activator>, you can use an inner bean definition: + + +]]> + + + + Using both the "ref" attribute and an inner handler definition in the same <service-activator> + configuration is not allowed, as it creates an ambiguous condition and will result in an Exception being thrown. + + +
+ +
diff --git a/docs/src/reference/docbook/splitter.xml b/docs/src/reference/docbook/splitter.xml new file mode 100644 index 0000000000..b22ffe64b8 --- /dev/null +++ b/docs/src/reference/docbook/splitter.xml @@ -0,0 +1,157 @@ + + + Splitter + +
+ Introduction + + The Splitter is a component whose role is to partition a message in + several parts, and send the resulting messages to be processed + independently. Very often, they are upstream producers in a pipeline that + includes an Aggregator. +
+ +
+ Programming model + + The API for performing splitting consists from one base class, + AbstractMessageSplitter, which is a MessageHandler implementation, + encapsulating features which are common to splitters, such as filling in + the appropriate message headers CORRELATION_ID, SEQUENCE_SIZE, and + SEQUENCE_NUMBER on the messages that are produced. This allows to track + down the messages and the results of their processing (in a typical + scenario, these headers would be copied over to the messages that are + produced by the various transforming endpoints), and use them, for + example, in a Composed Message Processor scenario. + + An excerpt from AbstractMessageSplitter can be seen below: + + public abstract class AbstractMessageSplitter + extends AbstractReplyProducingMessageConsumer { + ... + protected abstract Object splitMessage(Message<?> message); + +} + + For implementing a specific Splitter in an application, a developer + can extend AbstractMessageSplitter and implement the splitMessage method, + thus defining the actual logic for splitting the messages. The return + value can be one of the following: + + + + a Collection (or subclass thereof) or an array of Message + objects - in this case the messages will be sent as such (after the + CORRELATION_ID, SEQUENCE_SIZE and SEQUENCE_NUMBER are populated). + Using this approach gives more control to the developer, for example + for populating custom message headers as part of the splitting + process. + + + + a Collection (or subclass thereof) or an array of non-Message + objects - works like the prior case, except that each collection + element will be used as a Message payload. Using this approach allows + developers to focus on the domain objects without having to consider + the Messaging system and produces code that is easier to test. + + + + a Message or non-Message object (but not a Collection or an + Array) - it works like the previous cases, except that there is a + single message to be sent out. + + + + In Spring Integration, any POJO can implement the splitting + algorithm, provided that it defines a method that accepts a single + argument and has a return value. In this case, the return value of the + method will be interpreted as described above. The input argument might + either be a Message or a simple POJO. In the latter case, the splitter + will receive the payload of the incoming message. Since this decouples + the code from the Spring Integration API and will typically be easier + to test, it is the recommended approach. +
+ +
+ Configuring a Splitter using XML + + A splitter can be configured through XML as follows:<channel id="inputChannel"/> + +<splitter id="splitter" + ref="splitterBean" + method="split" + input-channel="inputChannel" + output-channel="outputChannel" /> + +<channel id="outputChannel"/> + +<beans:bean id="splitterBean" class="sample.PojoSplitter"/> + + The id of the splitter is + optional. + + + + A reference to a bean defined in the application context. The + bean must implement the splitting logic as described in the section + above. Optional. + If reference to a bean is not provided, then it is assumed that the payload of the Message that arrived on the input-channel is + an implementation of java.util.Collection and the default splitting logic will be applied on such Collection, + incorporating each individual element into a Message and depositing it on the output-channel. + + + + + The method (defined on the bean specified above) that + implements the splitting logic. + Optional. + + + + The input channel of the splitter. + Required. + + + + The channel where the splitter will send the results of + splitting the incoming message. Optional (because incoming + messages can specify a reply channel themselves). + + + + Using a "ref" attribute is generally recommended if the custom splitter handler implementation can be reused in other + <splitter> definitions. However if the custom splitter handler implementation should be scoped to a + single definition of the <splitter>, you can configure an inner bean definition: + + +]]> + + + + Using both a "ref" attribute and an inner handler definition in the same <splitter> + configuration is not allowed, as it creates an ambiguous condition and will result in an Exception being thrown. + + +
+ +
+ Configuring a Splitter with Annotations + + The @Splitter annotation is + applicable to methods that expect either the + Message type or the message payload type, + and the return values of the method should be a collection of any type. If + the returned values are not actual Message + objects, then each of them will be sent as the payload of a message. Those + messages will be sent to the output channel as designated for the endpoint + on which the @Splitter is defined. + @Splitter +List<LineItem> extractItems(Order order) { + return order.getItems() +} +
+ +
diff --git a/docs/src/reference/docbook/stream.xml b/docs/src/reference/docbook/stream.xml new file mode 100644 index 0000000000..f4b1c35d8e --- /dev/null +++ b/docs/src/reference/docbook/stream.xml @@ -0,0 +1,91 @@ + + + Stream Support + +
+ Introduction + + In many cases application data is obtained from a stream. It is not recommended to send a reference to a Stream as a message payload to a consumer. Instead messages are created from data that is read from an input stream and message payloads are written to an output stream one by one. + +
+ +
+ Reading from streams + + Spring Integration provides two adapters for streams. Both ByteStreamReadingMessageSource and + CharacterStreamReadingMessageSource implement MessageSource. + By configuring one of these within a channel-adapter element, the polling period can be configured, + and the Message Bus can automatically detect and schedule them. The byte stream version requires an + InputStream, and the character stream version requires a Reader as + the single constructor argument. The ByteStreamReadingMessageSource also accepts the 'bytesPerMessage' + property to determine how many bytes it will attempt to read into each Message. The + default value is 1024 + + + + + + + +]]> + + +
+ +
+ Writing to streams + + For target streams, there are also two implementations: ByteStreamWritingMessageHandler and + CharacterStreamWritingMessageHandler. Each requires a single constructor argument - + OutputStream for byte streams or Writer for character streams, + and each provides a second constructor that adds the optional 'bufferSize'. Since both of these + ultimately implement the MessageHandler interface, they can be referenced from a + channel-adapter configuration as described in more detail in + . + + + + + + + +]]> + + +
+ + + +
+ Stream namespace support + + To reduce the configuration needed for stream related channel adapters there is a namespace defined. The following schema locations are needed to use it. + +]]> + + + To configure the inbound channel adapter the following code snippet shows the different configuration options that are supported. + + +]]> + + + To configure the outbound channel adapter you can use the namespace support as well. The following code snippet shows the different configuration for an outbound channel adapters. + + + + + + + + ]]> + +
+
diff --git a/docs/src/reference/docbook/transactions.xml b/docs/src/reference/docbook/transactions.xml new file mode 100644 index 0000000000..99c173f65e --- /dev/null +++ b/docs/src/reference/docbook/transactions.xml @@ -0,0 +1,175 @@ + + + Transaction Support + +
+ Understanding Transactions in Message flows + + Spring Integration exposes several hooks to address transactional needs of you message flows. + But to better understand these hooks and how you can benefit from them we must first revisit the 6 mechanisms + that could be used to initiate Message flows and see how transactional needs of these flows + could be addressed within each of these mechanisms. + + + Here are the 6 mechanisms to initiate a Message flow and their short summary (details for each are provided throughout this manual): + + + Gateway Proxy - Your basic Messaging Gateway + + + MessageChannel - Direct interactions with MessageChannel methods (e.g., channel.send(message)) + + + Message Publisher - the way to initiate message flow as a bi-product of method invocations on Spring beans + + + Inbound Channel Adapters/Gateways - the way to initiate message flow based on connecting third-party + system with Spring Integration messaging system(e.g., [JmsMessage] -> Jms Inbound Adapter[SI Message] -> SI Channel) + + + Scheduler - the way to initiate message flow based on scheduling events distributed + by a pre-configured Scheduler + + + Poller - similar to the Scheduler and is the way to initiate message flow based on scheduling + or interval-based events distributed by a pre-configured Poller + + + + + These 6 cold be split in 2 general categories: + + + Message flows initiated by a USER process - Example scenarios in this category + would be invoking a Gateway method or explicitly sending a Message to a MessageChannel. In other words these message flows depend on third + party process (e.g., some code that we wrote) to be initiated + + + Message flows initiated by the DAEMON process - Example scenarios in this category would be a Poller + polling for a Message queue to initiate a new Message flow with the polled Message or a Scheduler scheduling the + process, by creating a new Message and initiating a message flow at a predefined time + + + + + Clearly the Gateway Proxy, MessageChannel.send(..) and MessagePublisher are + all belong to the 1st category and Inbound Adapters/Gateways, Scheduler and Poller belong to the 2nd. + + + So, how do we address transactional needs in various scenarios within each category and is there a need for Spring Integration + to provide something explicitly with regard to transaction for a particular scenario or Spring's Transaction Support could be leveraged instead?. + + + + First of all, the first and obvious goal is NOT to re-invent something that has already been invented unless you can provide a beter solution. + In our case Spring itself provides a first class support for transaction management. So our goal here is not to provide something new but rather + delegate/use Spring to benefit from the existing support for transactions. In other words as a framework we must expose hooks to the Transaction management functionality + provided by Spring. But since Spring Integration configuration is based on Spring Configuration it is not always neccessery to expose these hooks as they already + expposed via Spring natively. Remeber every Spring Integration component is a Spring Bean after all. + + + With this goal in mind let's look at the two scenarios.  + + + If you think about it, Message flows that are initiated by the USER process (Category 1) and obviously configured in Spring Application Context, + are subject to transactional configuration of such process and therefore don't need to be explicitly configured by Spring Integration to support transactions. + The transaction could and should be initiated by such process through standard Transaction support provided by Spring and Spring Integration message flow will honor + transactional semantics of the components naturally because it is Spring configured. For example; A Gateway or ServiceActivator methods could + be annotated with @Transactional or TransactionInterceptor could be configured in XML configuration + with point-cut expression pointing to specific methods that should be transactional. + The bottom line you have full control over transaction configuration and boundaries in these scenarios. + + + + However, things are a bit different when it comes to Message flows initiated by the DAEMON process (Category 2). + Although configured by the developer these flows do not directly involve human or some other process to be initiated. These are trigger-based flows + that are initiated by a trigger process (DAEMON process) based on the configuration of such process. For example, we could have a Scheduler + initiating a message flow every Friday night of every week. We can also configure a trigger that initiates a Message flow every second, etc. + So, we obviously need the same way to let these trigger-based processes know of our intention to make these Message flows transactional so + Transaction context could be created whenever a new Message flow is initiated. In other words we need to expose some Transaction configuration, but ONLY enough + to delegate to Transaction support already provided by Spring (as we do in other scenarios). + + + + Spring Integration provides transactional support for Pollers. Pollers are a special case comoponents becouse + we can call receive() within that poller task against a resource that is itself transactional thus including receive() + call in the the boundaries of the Transaction allowing it to be rolled back in case of a task failure. If we were to add the same support + for channels, the added transactions would affect all downstream components starting with that send() call. That is + providing a rather wide scope for transaction demarcation without any strong reason especially when Spring already provides several way to + address transactional needs of any component downstream. However the receive() method being included in a transaction + boundary is the "strong reason" for pollers.  + + + + +
+ Poller Transaction Support + + Any time you configure a Poller you can provide transactional configuration via transactional element and its attributes: + + +]]> + As you can see this configuration looks evry similar to native Spring transaction configuration. You must still provide reference to Transaction manager and specify + transaction attributes or rely on defauls (e.g., if 'transaction-manager'' attribute is not specified then it will default to the bean with the name 'transactionManager'). + Internally the process would be wrapped in the Spring's native Transaction where TransactionInterceptor is responsible to handle transactions. + For more information on how to configure Transaction Manager, the types of Transaction Managers (e.g., JTA, Datasource etc.) and other details related to + transaction configuration please refer to Spring's Reference manual (Chapter 10 - Transaction Management). + + + With the above configuration all Message flows initiated by this poller will be transactional. For more information and details on + Poller's transactional configuration please refer to section - 21.1.1. Polling and Transactions. + + + + There times when besides transaction several more cross cutting concerns needs to be addressed when running Poller. To help with that, + Poller element defines <advice-chain> sub-element which allows you to define a custom chain of Advices + to be applied on the Poller. (see section 4.4 for more details) + In Spring Integration 2.0 Poller went through the major  refactoring effort and is now using proxy mechanism to address transactional + concerns as well as other cross cutting concerns, one of the significant changes evolving from this effort is that we + made <transactional> and <advice-chain> elements mutually exclusive. + The rational behind this is; If you need more then one advice, and one of them is Transaction advice, then you can simply + include it in the <advice-chain> with the same convenience as before but with much more control + since you now have an option to position any advice in the desired order.  + + + + + + + + + + + + + + +]]> + +As yo can see from the example above, we have provided a very basic XML-based configuration of Spring Transaction advice  - "txAdvice" and +included it within the <advice-chain> defined by the Poller. + +And if you only need to address transactional concerns of the Poller, then you can still use <transactional> element +as a convinience. + +
+
+
+ Transaction Boundaries + + Another important factor that needs to be understood is the boundaries of the Transactions within the Message flow. + When transaction is started, transaction context is bound to the current thread. So regardless of how many endpoints and channels you have in your + Message flow you transaction context will be preserved as long as you are ensuring that the flow continues on the same thread. + As soon as you break it by introducing a Pollable Channel or Executor Channel or initiate a new thread manually in some + service, the Transactional boundary will be broken as well. Essentially the Transaction will END right there and if + successfull hand of happened between the threads, the flow would be considered a success and COMMIT signal would be sent + even though the flow might still result in the exception somewhere downstream. If such flow was synchronous the exception would be thrown back to the + initiator of the Message flow who is also the initiator of the transactional context and transaction would result in a ROLLBACK. + +
+
diff --git a/docs/src/reference/docbook/transformer.xml b/docs/src/reference/docbook/transformer.xml new file mode 100644 index 0000000000..42014c7e67 --- /dev/null +++ b/docs/src/reference/docbook/transformer.xml @@ -0,0 +1,183 @@ + + + Transformer + +
+ Introduction + + Message Transformers play a very important role in enabling the loose-coupling of Message Producers and Message + Consumers. Rather than requiring every Message-producing component to know what type is expected by the next + consumer, Transformers can be added between those components. Generic transformers, such as one that converts a + String to an XML Document, are also highly reusable. + + + For some systems, it may be best to provide a + Canonical Data Model, but Spring + Integration's general philosophy is not to require any particular format. Rather, for maximum flexibility, Spring + Integration aims to provide the simplest possible model for extension. As with the other endpoint types, the use + of declarative configuration in XML and/or Annotations enables simple POJOs to be adapted for the role of Message + Transformers. These configuration options will be described below. + + For the same reason of maximizing flexibility, Spring does not require XML-based Message payloads. + Nevertheless, the framework does provide some convenient Transformers for dealing with XML-based payloads if + that is indeed the right choice for your application. For more information on those transformers, see + . + + +
+ +
+ The <transformer> Element + + The <transformer> element is used to create a Message-transforming endpoint. In addition to "input-channel" + and "output-channel" attributes, it requires a "ref". The "ref" may either point to an Object that contains the + @Transformer annotation on a single method (see below) or it may be combined with an explicit method name value + provided via the "method" attribute. + +]]> + + + Using a "ref" attribute is generally recommended if the custom transformer handler implementation can be reused in + other <transformer> definitions. However if the custom transformer handler implementation should + be scoped to a single definition of the <transformer>, you can define an inner bean definition: + + +]]> + + + + Using both the "ref" attribute and an inner handler definition in the same <transformer> + configuration is not allowed, as it creates an ambiguous condition and will result in an Exception being thrown. + + + + The method that is used for transformation may expect either the Message type or + the payload type of inbound Messages. It may also accept Message header values either individually or as a full + map by using the @Header and @Headers parameter annotations respectively. The return value of the method can be + any type. If the return value is itself a Message, that will be passed along to + the transformer's output channel. If the return type is a Map, and the original Message payload was + not a Map, the entries in that Map will be added to the Message headers of the original + Message (the keys must be Strings). If the return value is null, then no reply Message will + be sent (effectively the same behavior as a Message Filter returning false). Otherwise, the return value will be + sent as the payload of an outbound reply Message. + + + There are a also a few Transformer implementations available out of the box. Because, it is fairly common + to use the toString() representation of an Object, Spring Integration provides an + ObjectToStringTransformer whose output is a Message with a String payload. That String + is the result of invoking the toString operation on the inbound Message's payload. + ]]> + A potential example for this would be sending some arbitrary object to the 'outbound-channel-adapter' in the + file namespace. Whereas that Channel Adapter only supports String, byte-array, or + java.io.File payloads by default, adding this transformer immediately before the + adapter will handle the necessary conversion. Of course, that works fine as long as the result of the + toString() call is what you want to be written to the File. Otherwise, you can + just provide a custom POJO-based Transformer via the generic 'transformer' element shown previously. + + When debugging, this transformer is not typically necessary since the 'logging-channel-adapter' is capable + of logging the Message payload. Refer to for more detail. + + + + If you need to serialize an Object to a byte array or deserialize a byte array back into an Object, + Spring Integration provides symmetrical serialization transformers. + + + ]]> + + + If you only need to add headers to a Message, and they are not dynamically determined by Message content, + then referencing a custom implementation may be overkill. For that reason, Spring Integration provides the + 'header-enricher' element. +
+
+ ]]> + + + As added convenience, Spring Integration also provides Object-to-Map and Map-to-Object transformers which + utilize Spring Expression Language (SpEL) to serialize and de-serialize the object graphs. Object hierarchy is introspected + to the most primitive types (e.g., String, int etc.). The path to this type is described via SpEL, which becomes the keykey in the + transformed Map with primitive type being the value. + + + For example: + nickNames; +   // setters and getters are omitted +}]]> +... will be transformed to a Map which looks like this: +{person.name=George, person.child.name=Jenna, person.child.nickNames[0]=Bimbo . . . etc} + + + SpEL-based Map allows you to describe the object structure without sharing the actual types allowing + you to restore/rebuild the object graph into a differently typed Object graph as long as you maintain the structure. + + + For example: + The above structure could be easily restored back to the following Object graph via Map-to-Object transformer: + nickNames; +   // setters and getters are omitted +}]]> + + + To configure these transformers, Spring Integration provides namespace support + Object-to-Map: +]]> + Map-to-Object +]]> + or + + +]]> + + + + NOTE: 'ref' and 'type' attributes are mutually exclusive. You can only use either one. + Also, if using 'ref' attribute you must point to a 'prototype' scoped bean, otherwise + BeanCreationException will be thrown.  + +
+ +
+ The @Transformer Annotation + + The @Transformer annotation can also be added to methods that expect either the + Message type or the message payload type. The return value will be handled in the + exact same way as described above in the section describing the <transformer> element. + @Transformer +Order generateOrder(String productId) { + return new Order(productId); +} + + + Transformer methods may also accept the @Header and @Headers annotations that is documented in + @Transformer +Order generateOrder(String productId, @Header("customerName") String customer) { + return new Order(productId, customer); +} + +
+ +
diff --git a/docs/src/reference/docbook/ws.xml b/docs/src/reference/docbook/ws.xml new file mode 100644 index 0000000000..254bae2b17 --- /dev/null +++ b/docs/src/reference/docbook/ws.xml @@ -0,0 +1,134 @@ + + + Web Services Support + +
+ Outbound Web Service Gateways + + To invoke a Web Service upon sending a message to a channel, there are two options - both of which build + upon the Spring Web Services + project: SimpleWebServiceOutboundGateway and + MarshallingWebServiceOutboundGateway. The former will accept either a + String or javax.xml.transform.Source as the message + payload. The latter provides support for any implementation of the Marshaller + and Unmarshaller interfaces. Both require a Spring Web Services + DestinationProvider for determining the URI of the Web Service to be + called. simpleGateway = new SimpleWebServiceOutboundGateway(destinationProvider); + + marshallingGateway = new MarshallingWebServiceOutboundGateway(destinationProvider, marshaller); + + + When using the namespace support described below, you will only need to set a URI. Internally, the parser + will configure a fixed URI DestinationProvider implementation. If you do need dynamic resolution of the + URI at runtime, however, then the DestinationProvider can provide such behavior as looking up the URI from + a registry. See the Spring Web Services + javadoc for + more information about the DestinationProvider strategy. + + + + For more detail on the inner workings, see the Spring Web Services reference guide's chapter covering + client access + as well as the chapter covering + Object/XML mapping. + +
+ +
+ Inbound Web Service Gateways + + To send a message to a channel upon receiving a Web Service invocation, there are two options again: SimpleWebServiceInboundGateway and + MarshallingWebServiceInboundGateway. The former will extract a javax.xml.transform.Source + from the WebServiceMessage and set it as the message + payload. The latter provides support for implementation of the Marshaller + and Unmarshaller interfaces. + If the incoming web service message is a SOAP message the SOAP Action header will be added to the headers of the + Message that is forwarded onto the request channel. + + simpleGateway = new SimpleWebServiceInboundGateway(); + simpleGateway.setRequestChannel(forwardOntoThisChannel); + simpleGateway.setReplyChannel(listenForResponseHere); //Optional + + marshallingGateway = new MarshallingWebServiceInboundGateway(marshaller); + //set request and optionally reply channel + +Both gateways implement the Spring Web Services MessageEndpoint +interface, so they can be configured with a MessageDispatcherServlet +as per standard Spring Web Services configuration. + + + For more detail on how to use these components, see the Spring Web Services reference guide's chapter covering + creating a Web Service. + The chapter covering + Object/XML mapping is also applicable again. + +
+
+ Web Service Namespace Support + + To configure an outbound Web Service Gateway, use the "outbound-gateway" element from the "ws" namespace: + ]]> + + Notice that this example does not provide a 'reply-channel'. If the Web Service were to + return a non-empty response, the Message containing that response would be sent to the + reply channel provided in the request Message's REPLY_CHANNEL header, and if that were + not available a channel resolution Exception would be thrown. If you want to send the + reply to another channel instead, then provide a 'reply-channel' attribute on the + 'outbound-gateway' element. + + + When invoking a Web Service that returns an empty response after using a String payload + for the request Message, no reply Message will be sent by default. + Therefore you don't need to set a 'reply-channel' or have a REPLY_CHANNEL header in the + request Message. If for any reason you actually do want to receive + the empty response as a Message, then provide the 'ignore-empty-responses' attribute with + a value of false (this only applies for Strings, because using a + Source or Document object simply leads to a NULL response and will therefore + never generate a reply Message). + + + To set up an inbound Web Service Gateway, use the "inbound-gateway": + ]]> + + To use Spring OXM Marshallers and/or Unmarshallers, provide bean references. For outbound: + ]]> + And for inbound: + ]]> + + + Most Marshaller implementations also implement the + Unmarshaller interface. When using such a + Marshaller, only the "marshaller" + attribute is necessary. Even when using a Marshaller, + you may also provide a reference for the "request-callback" on the outbound gateways. + + + + For either outbound gateway type, a "destination-provider" attribute can be specified instead of the "uri" + (exactly one of them is required). You can then reference any Spring Web Services DestinationProvider + implementation (e.g. to lookup the URI at runtime from a registry). + + + For either outbound gateway type, the "message-factory" attribute can also be configured with a reference to any + Spring Web Services WebServiceMessageFactory implementation. + + + For the simple inbound gateway type, the "extract-payload" attribute can be set to false to forward + the entire WebServiceMessage instead of just its payload as a + Message to the request channel. This might be useful, for example, + when a custom Transformer works against the WebServiceMessage directly. + +
+ +
diff --git a/docs/src/reference/docbook/xml.xml b/docs/src/reference/docbook/xml.xml new file mode 100644 index 0000000000..f466fc7014 --- /dev/null +++ b/docs/src/reference/docbook/xml.xml @@ -0,0 +1,505 @@ + + + XML Support - Dealing with XML Payloads + +
+ Introduction + + Spring Integration's XML support extends the Spring Integration Core with + implementations of splitter, transformer, selector and router designed + to make working with xml messages in Spring Integration simple. The provided messaging + components are designed to work with xml represented in a range of formats including + instances of + java.lang.String, org.w3c.dom.Document + and javax.xml.transform.Source. It should be noted however that + where a DOM representation is required, for example in order to evaluate an XPath expression, + the String payload will be converted into the required type and then + converted back again to String. Components that require an instance of + DocumentBuilder will create a namespace aware instance if one is + not provided. Where greater control of the document being created is required an appropriately + configured instance of DocumentBuilder should be provided. + +
+
+ Transforming xml payloads + + This section will explain the workings of + UnmarshallingTransformer, + MarshallingTransformer, + XsltPayloadTransformer + and how to configure them as + beans. All of the provided xml transformers extend + AbstractTransformer or AbstractPayloadTransformer + and therefore implement Transformer. When configuring xml + transformers as beans in Spring Integration you would normally configure the transformer + in conjunction with either a MessageTransformingChannelInterceptor or a + MessageTransformingHandler. This allows the transformer to be used as either an interceptor, + which transforms the message as it is sent or received to the channel, or as an endpoint. Finally the + namespace support will be discussed which allows for the simple configuration of the transformers as + elements in XML. + + + UnmarshallingTransformer allows an xml Source + to be unmarshalled using implementations of Spring OXM Unmarshaller. + Spring OXM provides several implementations supporting marshalling and unmarshalling using JAXB, + Castor and JiBX amongst others. Since the unmarshaller requires an instance of + Source where the message payload is not currently an instance of + Source, conversion will be attempted. Currently String + and org.w3c.dom.Document payloads are supported. Custom conversion to a + Source is also supported by injecting an implementation of + SourceFactory. + + + + + + +]]> + + + The MarshallingTransformer allows an object graph to be converted + into xml using a Spring OXM Marshaller. By default the + MarshallingTransformer will return a DomResult. + However the type of result can be controlled by configuring an alternative ResultFactory + such as StringResultFactory. In many cases it will be more convenient to transform + the payload into an alternative xml format. To achieve this configure a + ResultTransformer. Two implementations are provided, one which converts to + String and another which converts to Document. + + + + + + + + + +]]> + + + By default, the MarshallingTransformer will pass the payload Object + to the Marshaller, but if its boolean "extractPayload" property + is set to "false", the entire Message instance will be passed + to the Marshaller instead. That may be useful for certain custom + implementations of the Marshaller interface, but typically the + payload is the appropriate source Object for marshalling when delegating to any of the various + out-of-the-box Marshaller implementations. + + + XsltPayloadTransformer transforms xml payloads using xsl. + The transformer requires an instance of either Resource or + Templates. Passing in a Templates instance + allows for greater configuration of the TransformerFactory used to create + the template instance. As in the case of XmlPayloadMarshallingTransformer + by default XsltPayloadTransformer will create a message with a + Result payload. This can be customised by providing a + ResultFactory and/or a ResultTransformer. + + + + + +]]> + +
+
+ + Namespace support for xml transformers + + Namespace support for all xml transformers is provided in the Spring Integration xml namespace, + a template for which can be seen below. The namespace support for transformers creates an instance of either + EventDrivenConsumer or PollingConsumer + according to the type of the provided input channel. The namespace support is designed + to reduce the amount of xml configuration by allowing the creation of an endpoint and transformer + using one element. + + +]]> + The namespace support for UnmarshallingTransformer is shown below. + Since the namespace is now creating an endpoint instance rather than a transformer, + a poller can also be nested within the element to control the polling of the input channel. + + + + + + ]]> + + + + The namespace support for the marshalling transformer requires an input channel, output channel and a + reference to a marshaller. The optional result-type attribute can be used to control the type of result created, + valid values are StringResult or DomResult (the default). Where the provided result types are not sufficient a + reference to a custom implementation of ResultFactory can be provided as an alternative + to setting the result-type attribute using the result-factory attribute. An optional result-transformer can also be + specified in order to convert the created Result after marshalling. + + + + +]]> + + + + Namespace support for the XsltPayloadTransformer allows either a resource to be passed in in order to create the + Templates instance or alternatively a precreated Templates + instance can be passed in as a reference. In common with the marshalling transformer the type of the result output can + be controlled by specifying either the result-factory or result-type attribute. A result-transfomer attribute can also + be used to reference an implementation of ResultTransfomer where conversion of the result + is required before sending. + +]]> + + + Very often to assist with transformation you may need to have access to Message data (e.g., Message Headers). For example; you may need to get access to certain Message Headers + and pass them on as parameters to a transformer (e.g., transformer.setParameter(..)).  + Spring Integration provides two convenient ways to accomplish this. Just look at the following XML snippet. + + + + +]]> + If message header names match 1:1 to parameter names, you can simply use xslt-param-headers attribute. There you can also use wildcards for + simple pattern matching which supports the following simple pattern styles: "xxx*", "*xxx", "*xxx*" and "xxx*yyy". + + + You can also configure individual xslt parameters via xslt-param sub element. There you can use expression or value attribute. + The expression attribute should be any valid SpEL expression with Message being the root object of the expression evaluation context. + The value attribute just like any value in Spring beans allows you to specify simple scalar vallue. YOu can also use property placeholders (e.g., ${some.value}) + So as you can see, with the expression and value attribute xslt parameters could now be mapped to any accessible part of the Message as well as any literal value. + +
+ +
+ Splitting xml messages + + XPathMessageSplitter supports messages with either + String or Document payloads. + The splitter uses the provided XPath expression to split the payload into a number of + nodes. By default this will result in each Node instance + becoming the payload of a new message. Where it is preferred that each message be a Document + the createDocuments flag can be set. Where a String payload is passed + in the payload will be converted then split before being converted back to a number of String + messages. The XPath splitter implements MessageHandler and should + therefore be configured in conjunction with an appropriate endpoint (see the namespace support below + for a simpler configuration alternative). + + + + + + + + + +]]> + + +
+ +
+ Routing xml messages using XPath + + Two Router implementations based on XPath are provided XPathSingleChannelRouter and + XPathMultiChannelRouter. The implementations differ in respect to how many channels + any given message may be routed to, exactly one in the case of the single channel version + or zero or more in the case of the multichannel router. Both evaluate an XPath + expression against the xml payload of the message, supported payload types by default + are Node, Document and + String. For other payload types a custom implementation + of XmlPayloadConverter can be provided. The router + implementations use ChannelResolver to convert the + result(s) of the XPath expression to a channel name. By default a + BeanFactoryChannelResolver strategy will be used, this means that the string returned by the XPath + evaluation should correspond directly to the name of a channel. Where this is not the case + an alternative implementation of ChannelResolver can + be used. Where there is a simple mapping from Xpath result to channel name + the provided MapBasedChannelResolver can be used. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +]]> + +
+ +
+ Selecting xml messages using XPath + + Two MessageSelector implementations are provided, + BooleanTestXPathMessageSelector and StringValueTestXPathMessageSelector. + BooleanTestXPathMessageSelector requires an XPathExpression which evaluates to a boolean, + for example boolean(/one/two) which will only select messages which have an element named + two which is a child of a root element named one. StringValueTestXPathMessageSelector + evaluates any XPath expression as a String and compares the result with the provided value. + + + + + + + + + + + + + + + + + + + + +]]> +
+ +
+ Transforming xml messages using XPath + + When it comes to message transformation XPath is a great way to transform Messages that have XML + payloads by defining XPath transformers via xpath-transformer element. + + + Simple XPath transformation + + + Let's look at the following transformer configuration: + ]]> + + . . . and Message + message = + MessageBuilder.withPayload("").build();]]> + After sending this message to the 'inputChannel' the XPath transformer configured above will transform + this XML Message to a simple Message with payload of 'John Doe' all based on + the simple XPath Expression specified in the xpath-expression attribute. + + + XPath also has capability to perform simple conversion of extracted elements + to a desired type. Valid return types are defined in XPathConstants and follows + the conversion rules specified by the XPath. + + + The following constants are defined by the XPathConstants: BOOLEAN, DOM_OBJECT_MODEL, NODE, NODESET, NUMBER, STRING + + + You can configure the desired type by simply using evaluation-type + attribute of the xpath-transformer element. + + + +]]> + + + Node Mappers + + + If you need to provide custom mapping for the node extracted by the XPath expression simply provide a reference to the + implementation of the org.springframework.xml.xpath.NodeMapper - an interface used by + XPathOperations implementations for mapping Node objects on a per-node basis. To provide a + reference to a NodeMapper simply use node-mapper attribute: + +]]> +. . . and Sample NodeMapper implementation: + + + + XML Payload Converter + + + You can also use implementation of the org.springframework.integration.xml.XmlPayloadConverter to + provide more granular transformation: + +]]> +. . . and Sample XmlPayloadConverter implementation: +"))); + } + catch (Exception e) { + throw new IllegalStateException(e); + } + } + // + public Document convertToDocument(Object object) { + throw new UnsupportedOperationException(); + } +}]]> + + + Combination of SpEL and XPath expressions + + + You can also combine Spring Expression Language (SpEL) expressions with XPath expression and configure + them using expression attribute: + ]]> + In the above case the overall result of the expression will be the result of the XPathe expression multiplied by 2. + +
+ + +
+ XPath components namespace support + All XPath based components have namespace support allowing them to be configured as + Message Endpoints with the exception of the XPath selectors which are not designed to act as + endpoints. Each component allows the XPath to either be referenced at the top level or configured via a nested + xpath-expression element. So the following configurations of an xpath-selector are all valid and represent the general + form of XPath namespace support. All forms of XPath expression result in the creation of an + XPathExpression using the Spring XPathExpressionFactory + + + + + + + + + + + + + + + + + + + + + + + + + + +]]> + + + XPath splitter namespace support allows the creation of a Message Endpoint with an input channel and output channel. + + + + + + + + + +]]> + + + XPath router namespace support allows for the creation of a Message Endpoint with an input channel but no output channel + since the output channel is determined dynamically. The multi-channel attribute causes the creation of a multi channel router capable of + routing a single message to many channels when true and a single channel router when false. + + + + + + + + + +]]> + +
+ +
diff --git a/docs/src/reference/docbook/xmpp.xml b/docs/src/reference/docbook/xmpp.xml new file mode 100644 index 0000000000..9576a9fe9c --- /dev/null +++ b/docs/src/reference/docbook/xmpp.xml @@ -0,0 +1,442 @@ + + + XMPP Support + + Spring Integration provides Channel Adapters for XMPP. + +
+ Introduction + + Spring Integration provides adapters for sending and receiving both XMPP messages and status changes from other + entries in your roster as well as XMPP. + + + XMPP describes a way for multiple agents to communicate with each other in a distributed system. + The canonical use case is to send and receive instant messages, though XMPP can be, and is, used for far more + applications. + XMPP is used to describe a network of actors. Within that network, actors may address each other directly, as well + as broadcast status changes. + + + + XMPP provides the messaging fabric that underlies some of the biggest Instant Messaging networks in the world, + including Google Talk (GTalk) + - which is also available from within GMail - and Facebook Chat. + There are many good open-source XMPP servers available. Two popular implementations are + + Openfire + + and + + ejabberd + + . + + + In XMPP, + rosters + (the roster corresponds to the notion of a "buddy list" in your typical IM client) are used to manage a list of + other agents ("contacts", or "buddies", in an IM client) + in the system, calledroster items. + The roster item contains - at a minimum - the roster item's JID which is its unique ID on the network. + An actor may subscribe to the state changes of another actor in the system. The subscription can be bidirectional, + as well. + The subscription settings determine whose status updates are broadcast, and to whom. + These subscriptions are stored on the XMPP server, and are thus durable. + + + + +
+
+ Using The Spring Integration XMPP Namespace + + + Using the Spring Integration XMPP namespace support is simple. + + Its use is like any other module in the Spring framework: import the XML schema, and use it to define elements. + + A prototypical XMPP-based integration might feature the following header. We won't repeat this in subsequent + examples, because it is uninteresting. + + + + + + ... + + +]]> + + + +
+ + +
+ XMPP Connection + + To participate in the network, an actor must connect to an XMPP server. Typically this requires - at a minimum - a + user, apassword, ahost, and aport. + + To create an XMPP connection, you may use the XML namespace. + + + ]]> + +
+ +
+ XMPP Messages +
+ Inbound Message Adapter + The Spring Integration adapters support receiving messages from other users in the system. To do this, the + adapter "logs in" as a user on your behalf and receives the messages sent to that user. Those messages are then + forwarded to your Spring Integration client. + The payload of the inbound Spring Integration message may be of the raw type + org.jivesoftware.smack.packet.Message, or of the type + java.lang.String + - which is the type of the raw + Message's + body + property - + depending on whether you specify + extract-payload + on the adapter's configuration or not. + Inbound Messages are typically small and are text-oriented. Messages received using the adapter have + a pretty standard layout, with known headers (all headers have keys defined on + org.springframework.integration.xmpp.XmppHeaders): + + + + Header Values + + + + + + + + + Header Name + What It Describes + + + + + XmppHeaders.TYPE + The value of the + the + + org.jivesoftware.smack.packet.Message.Type + + enum that describes the inbound message. Possible values are: + normal, + chat, + groupchat, + headline, + error. + + + + + XmppHeaders.CHAT + A reference to the + org.jivesoftware.smack.Chat + class which represents the + threaded conversation containing the message. + + + + + + +
+ + + + This adapter requires a reference to an XMPP Connection. You may + use the + xmpp-connection + element to define one. + + An example might look as follows: + + + + + + + + + + + + ]]> + + + ]]> + +]]> + + + + + In this example, the message is received from the XMPP adapter and passed to a + service-activator + component. Here's the declaration of theservice-activator. + + + +
+
+ Outbound Message Adapter + + You may also send messages to other users on XMPP using the + outbound-message-channel-adapter + adapter. The is configured like the + + xmpp-message-inbound-channel-adapter. The + adapter takes an + xmpp-connection + reference. + + + Here is a (necessarily) contrived example solution using the outbound adapter. + + + + + + + + + + + + + + + + + + + + + +]]> + + + + + The adapter expects as its input - at a minimum - a payload of type java.lang.String, and + a header value + for + XmppHeaders.CHAT_TO_USER + that specifies to which the user the payload body should be sent to. + To create a message destined for theoutbound-message-channel-adapter, you might use the following + Java code: + + + xmppOutboundMsg = MessageBuilder.withPayload("Hello, world!" ) + .setHeader(XmppHeaders.CHAT_TO_USER, "userhandle") + .build(); +]]> + + + + It's easy enough to use Java to update the XmppHeaders.CHAT_TO_USER header, and this has the advantage of dynamically updating the header at runtime in Java code. + If, however, the target is more static in nature, you can + configure it using the + XMPP enricher support. Here is an example using the enricher. The enricher enriches the Spring Integration + message + to support the header values that the outbound XMPP adapters expect. + + + + + + + +]]> + + +
+
+
+ XMPP Presence + + + + XMPP also supports broadcasting state. You can use this capability to + let people who have you on their roster see your state changes. This happens all the time with your IM clients - you + change your away status, and then set an away message, and everybody who has you on their roster sees your icon or username change to reflect this new state, and + additionally might see your new "away" message. + + + If you would like to receive notification, or notify others, of state changes, you can use Spring Integration's "presence" adapters. + + + The most important data for these adapters resides in the headers. The header keys are enumerated on + the org.springframework.integration.xmpp.XmppHeaders class. + + The header keys specific to these "presence" adapters start with the token "PRESENCE_". + + Not all headers are available for both inbound and outbound. + + + Header Values + + + + + + + + + Header Name + What It Describes + + + + + + + XmppHeaders.PRESENCE_LANGUAGE + The java.lang.String language in which the message was written. + + + + XmppHeaders.PRESENCE_PRIORITY + + The priority (int) of the message. Arbitrary, but it can be used to help assign relevance to a message which + in turn might be used in its handling. + + + + XmppHeaders.PRESENCE_MODE + + An instance of the enum org.jivesoftware.smack.packet.Presence.Mode that has one of the following values: + chat, available, away, + xa, dnd + + + + XmppHeaders.PRESENCE_TYPE + + An instance of the enum org.jivesoftware.smack.packet.Presence.Type + that has one of the following values: + available, unavailable, subscribe, subscribed, + unsubscribe, unsubscribed, and error. + + + + + XmppHeaders.PRESENCE_STATUS + + A java.lang.String string representing the status of the agent. This corresponds to an agents "away" message. + + + + XmppHeaders.PRESENCE_FROM + + A java.lang.String string representing the handle of the user whose state is being received. + + + + + + + +
+
+ Inbound Presence Adapter + + The first adapter supports receiving messages whenever an agent on your roster has updated its + state. Most of the important data comes in through the headers. + + +
+
+ Outbound Presence Adapter + TBD +
+
+ + +
diff --git a/src/docbkx/endpoint.xml b/docs/src/reference/endpoint.xml similarity index 100% rename from src/docbkx/endpoint.xml rename to docs/src/reference/endpoint.xml diff --git a/src/docbkx/event.xml b/docs/src/reference/event.xml similarity index 100% rename from src/docbkx/event.xml rename to docs/src/reference/event.xml diff --git a/src/docbkx/file.xml b/docs/src/reference/file.xml similarity index 100% rename from src/docbkx/file.xml rename to docs/src/reference/file.xml diff --git a/src/docbkx/filter.xml b/docs/src/reference/filter.xml similarity index 100% rename from src/docbkx/filter.xml rename to docs/src/reference/filter.xml diff --git a/src/docbkx/gateway.xml b/docs/src/reference/gateway.xml similarity index 100% rename from src/docbkx/gateway.xml rename to docs/src/reference/gateway.xml diff --git a/src/docbkx/groovy.xml b/docs/src/reference/groovy.xml similarity index 100% rename from src/docbkx/groovy.xml rename to docs/src/reference/groovy.xml diff --git a/src/docbkx/http.xml b/docs/src/reference/http.xml similarity index 100% rename from src/docbkx/http.xml rename to docs/src/reference/http.xml diff --git a/src/docbkx/httpinvoker.xml b/docs/src/reference/httpinvoker.xml similarity index 100% rename from src/docbkx/httpinvoker.xml rename to docs/src/reference/httpinvoker.xml diff --git a/src/docbkx/index.xml b/docs/src/reference/index.xml similarity index 100% rename from src/docbkx/index.xml rename to docs/src/reference/index.xml diff --git a/src/docbkx/ip.xml b/docs/src/reference/ip.xml similarity index 100% rename from src/docbkx/ip.xml rename to docs/src/reference/ip.xml diff --git a/src/docbkx/jdbc.xml b/docs/src/reference/jdbc.xml similarity index 100% rename from src/docbkx/jdbc.xml rename to docs/src/reference/jdbc.xml diff --git a/src/docbkx/jms.xml b/docs/src/reference/jms.xml similarity index 100% rename from src/docbkx/jms.xml rename to docs/src/reference/jms.xml diff --git a/src/docbkx/jmx.xml b/docs/src/reference/jmx.xml similarity index 100% rename from src/docbkx/jmx.xml rename to docs/src/reference/jmx.xml diff --git a/src/docbkx/mail.xml b/docs/src/reference/mail.xml similarity index 100% rename from src/docbkx/mail.xml rename to docs/src/reference/mail.xml diff --git a/src/docbkx/message-history.xml b/docs/src/reference/message-history.xml similarity index 100% rename from src/docbkx/message-history.xml rename to docs/src/reference/message-history.xml diff --git a/src/docbkx/message-publishing.xml b/docs/src/reference/message-publishing.xml similarity index 100% rename from src/docbkx/message-publishing.xml rename to docs/src/reference/message-publishing.xml diff --git a/src/docbkx/message.xml b/docs/src/reference/message.xml similarity index 100% rename from src/docbkx/message.xml rename to docs/src/reference/message.xml diff --git a/src/docbkx/overview.xml b/docs/src/reference/overview.xml similarity index 100% rename from src/docbkx/overview.xml rename to docs/src/reference/overview.xml diff --git a/docs/src/reference/resequencer.xml b/docs/src/reference/resequencer.xml new file mode 100644 index 0000000000..acbdedf8ef --- /dev/null +++ b/docs/src/reference/resequencer.xml @@ -0,0 +1,127 @@ + + + + Resequencer + +
+ Introduction + + Related to the Aggregator, albeit different from a functional + standpoint, is the Resequencer. +
+ +
+ Functionality + + The Resequencer works in a similar way to the Aggregator, in the + sense that it uses the CORRELATION_ID to store messages in groups, the + difference being that the Resequencer does not process the messages in any + way. It simply releases them in the order of their SEQUENCE_NUMBER header + values. + + With respect to that, the user might opt to release all messages at + once (after the whole sequence, according to the SEQUENCE_SIZE, has been + released), or as soon as a valid sequence is available. +
+ +
+ Configuring a Resequencer with XML + + Configuring a resequencer requires only including the appropriate + element in XML. + + A sample resequencer configuration is shown below. + + + + + + ]]> + + + + The id of the resequencer is + optional. + + + + The input channel of the resequencer. + Required. + + + + The channel where the resequencer will send the reordered + messages. Optional. + + + + The channel where the resequencer will send the messages that + timed out (if send-partial-result-on-timeout is + false). Optional. + + + + + + Whether to send out ordered sequences as soon as they are + available, or only after the whole message group arrives. + Optional (false by default). + + If this flag is not specified (so a complete sequence is defined by the sequence headers) then it can make sense to provide a custom + + Comparator + + to be used to order the messages when sending (use the XML attribute + + comparator + + to point to a bean definition). If + + release-partial-sequences + + is true then there is no way with a custom comparator to define a partial sequence. To do that you would have to provide a + + release-strategy + + (also a reference to another bean definition, either a POJO or a + + ReleaseStrategy + + ). + + + + A reference to a MessageGroupStore that can be + used to store groups of messages under their correlation key until + they are complete. Optional with default a + volatile in-memory store. + + + + Whether, upon the expiration of the group, the ordered group + should be sent out (even if some of the messages are missing). + Optional (false by default). See . + + + + The timeout for sending out messages. + Optional. + + + + + Since there is no custom behavior to be implemented in Java classes for resequencers, there is no annotation support for it. + +
+
diff --git a/src/docbkx/resources.xml b/docs/src/reference/resources.xml similarity index 100% rename from src/docbkx/resources.xml rename to docs/src/reference/resources.xml diff --git a/src/docbkx/resources/css/highlight.css b/docs/src/reference/resources/css/highlight.css similarity index 100% rename from src/docbkx/resources/css/highlight.css rename to docs/src/reference/resources/css/highlight.css diff --git a/src/docbkx/resources/css/html.css b/docs/src/reference/resources/css/html.css similarity index 100% rename from src/docbkx/resources/css/html.css rename to docs/src/reference/resources/css/html.css diff --git a/docs/src/reference/resources/css/manual.css b/docs/src/reference/resources/css/manual.css new file mode 100644 index 0000000000..524d462211 --- /dev/null +++ b/docs/src/reference/resources/css/manual.css @@ -0,0 +1,69 @@ +@IMPORT url("highlight.css"); + +html { + padding: 0pt; + margin: 0pt; +} + +body { + margin-left: 10%; + margin-right: 10%; + font-family: Arial, Sans-serif; +} + +div { + margin: 0pt; +} + +p { + text-align: justify; +} + +hr { + border: 1px solid gray; + background: gray; +} + +h1,h2,h3,h4 { + color: #234623; + font-family: Arial, Sans-serif; +} + +pre { + line-height: 1.0; + color: black; +} + +pre.programlisting { + font-size: 10pt; + padding: 7pt 3pt; + border: 1pt solid black; + background: #eeeeee; + clear: both; +} + +div.table { + margin: 1em; + padding: 0.5em; + text-align: center; +} + +div.table table { + display: table; + width: 100%; +} + +div.table td { + padding-left: 7px; + padding-right: 7px; +} + +.sidebar { + float: right; + margin: 10px 0 10px 30px; + padding: 10px 20px 20px 20px; + width: 33%; + border: 1px solid black; + background-color: #F4F4F4; + font-size: 14px; +} diff --git a/src/docbkx/resources/css/stylesheet.css b/docs/src/reference/resources/css/stylesheet.css similarity index 100% rename from src/docbkx/resources/css/stylesheet.css rename to docs/src/reference/resources/css/stylesheet.css diff --git a/docs/src/reference/resources/images/bank-router.png b/docs/src/reference/resources/images/bank-router.png new file mode 100644 index 0000000000000000000000000000000000000000..8191565440673841d01e17dcf77db56c30bc79cd GIT binary patch literal 15480 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Μ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

)FuZHX*}i)Yi0%;#~3Teogi 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%0A=;co{?1f4m1*Wo`yt_yS} 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

i=K&1p7*)+ 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 literal 0 HcmV?d00001 diff --git a/docs/src/reference/resources/images/channel.png b/docs/src/reference/resources/images/channel.png new file mode 100644 index 0000000000000000000000000000000000000000..25e3458dca1b5c348144b0580e7d72af5251cbfa GIT binary patch literal 23472 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 literal 0 HcmV?d00001 diff --git a/docs/src/reference/resources/images/gateway.png b/docs/src/reference/resources/images/gateway.png new file mode 100644 index 0000000000000000000000000000000000000000..8a2088cda021e74d6de32917925503d9d9cc3d9f GIT binary patch literal 11559 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 Z{};Y*vJ7Fn8+`x(002ovPDHLkV1iK^W1av2 literal 0 HcmV?d00001 diff --git a/docs/src/reference/resources/images/handler-endpoint.png b/docs/src/reference/resources/images/handler-endpoint.png new file mode 100644 index 0000000000000000000000000000000000000000..8a7adfe50c2dbc9e52bbf443b1d5bcca24823a88 GIT binary patch literal 34981 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 literal 0 HcmV?d00001 diff --git a/docs/src/reference/resources/images/handler.png b/docs/src/reference/resources/images/handler.png new file mode 100644 index 0000000000000000000000000000000000000000..f1398d5d36960dd4dacfc05fd194bc932440c1df GIT binary patch literal 23782 zcmYg$1yCGa6Yby-l3+oC6Fj)P1b25Q5Zv9_;O_1&!QI{6-QC^&?f1WWRj;ddYj>-5 z=FZ&d)7|HsU^yAlFQ2eK0RZqtTuev-03g4CKij}Vg5QU>y%qrAtB|Rnpq#j%AfcR{ zwUMdC9{_Mki%)cAkF$Ikm~c138o@F+^^4XPT0&T=A$dtaHKPB_H1=8iCy6krB*ij? z28D*0MiG8>94Tq>H*s|dB88*}B&Cjn2i^3 zkVsXsl~V!uhEg5F;QpCNtKKOm4lIGXo1q zz!U&PPr`W9071|+kN5y#b@-Sb6rnyqh>D9L2Ft$y>q``}u?oMDUfH;(ZykvimupEIXqK1~!{@^OGf#Rn|&N`gDSoFgo1VBM`RRRtw zPypal1HE~?XG0bTQK=5tC*zJ!{P=2o{uy{i=f|UAPx)T+*oM5z(CMv7m*zS(2@iY% zUY!6+exEE;8p)F7+@O8}B-P%20Uu=sZ;jWbZ=(DAM7uX~WqDl9_`)ATP&PvOG z(ImyvX~ARh$HH~{oN=nh3T%t*i{jU@2*s1oG)=bJmf9Al#xXaoTaW#@y|>lE6{MQ0 zkdG4S3bqH>)}?D!cubF2Zhlt+MyzL|Q({L7fjB3+YsFdPXRMu(`HE57c@lTVXU);s z`lH2*72|EM)1>gsHI4>Nnk{wIYPk5Y^-%Gx<$*SW)Zy5EchCjl2a#5Dr@lvk9vP7& zMXHMsyC{h&v+QZnBSWyq5M=SrG{y8rJ!)O`D&2ggCGWo`2@%lowQV7s_T!rYlmKQ4}q0W-9w16Nb)Moaa|r+PHLETE<`3 zmtQcDs6VRz4a}0WEppdd)|yva*IRFyb6gHyRVkL(N++%kQ57A5AL;x+eb=f=46e~)KqH+wyXwvV|B=gDVNX2HARaWZ;|JmU-ZUQbzLz~r;$ z^iJ%7;QuD)GK=YeSP(~*%7u?JywhdgS2$APqlgmK8Hy-@OyVaLJly^7M?j9u@6pRN903+2ghyK=3# zTRL{{uF&6EBx@SOf!wbD1~U)$C0dwrpNKcRrCUbvq+3^XROpjvS(YYKcYQw-lbZ19 z@L_*a;!1!);r1k#-?lgxi__7WPU>b-Ba!J&2F*}hTkW@d-u-vKS-)ByI0YmlJkF>L z??*Ke9V4UptJ6~ACJs^iiGy@5x2MIY*J+>Yod(%eUUl!|siTPQ@tkp{bYoo%q&N@u z1@HGa|Ef@3$$?>BUF;5S6|a&p&-}Qeo!RC& z=gXQ3y)s?A_q$d)Qcfz^4EYRMo7s-oB-!jW-0-!%)8>yC3MN?>y~+#@&{AbQ4o(US zGyR>99L9LOSJU5qD@JNe^p2#cidW#d3%j{*Xt|6WGaU`wvUPAVRz9^2zf5(dAO#cP z1qcP|AZ6lZhaZQJdz(F{vD9CMZYNGvEcEY?pOOW~u5E-A9?pntOl=U18@?|-DsCMV zF8yorb9Ilv3WNgOqtujem!Y+Nmxlg~E03fHt&JFrC{CnyH$?J%IRKfXu>0|mB*`rD zo1hI78X*{m8iu+B@uH8QPsFqTOr}#N)UG^j4C@#*UsALy6!*XOA3;PPr^rzLsX{By zQRt>~=EJG%>Cz`0&NwDXMQ0vwu3Fk${rqp7W$naG`B@oOIiM&cum()6d?m_PxsfB!D&Xv#O7I;0oG< zOk`n(wocRf@AV1KW>4M6I}7T|#Cz|$qq}`J2yNh zw}KQ>U@dPyiUxb>(2Lit8a>I*2O=`BYPb%Z#xC|r1W=C?WAq*j6kQckr*Xet67=GA z=Of}`j1n4tdYeYA;=am74b`YVm8GFP=0o#P$yTcpdP=*FNr^Mnnr>~qMxvQ2o-Lbh z(UmzmQKA*<>a>48xQY+P-}bvfW|ur zJ5|7C52_IpBCiyXLjaJukT!n+oBGfcwCeoHjDRh@b~7IU0Xf(yQ3s;YTwBPiXYO<8KN2jYf;6d%Jl1aN8AIOgp6C!d35! zT-<8-#2JPeC^`l@oYr`mWV(>LEPNS!(H}4}(3t)&6ney!qFG1;K^=5K7@tvaNgGk^ z5bOnt1$KlCepglgwW+#H5(5p^QYhC-SokjrULhlt_6m!W4q3*;Dv;-$<$*CdK|U@x zQP_}buUq^&5C4gHB#};54q3@Waa8GADM8^}l~TD*p)Jd(m^N>{VLPRtSNbEKQ-i$> zY1zB%r$&07;C$W8%p~S~CJPqxC{s7i+;`QaZ{-}nn>Q>Pp6cr~X-pE7O6X7MQ{h)A zxbB4&-YButc7l+pW81rtXX&K{*GPRj{=3!G(hsf zhQ^*ztOyPlp>ENlnASd1d|UI02Jb;=>KRr#dP!qCzB5;bb>T*N^;()xq~Wa2M;y+J zzhXmyBkr(x<`Dd##o#<=Oy&URGwnuO*8A?>jD$b=cu*qpc)o6@F1H6|g;v4#sq&b_ z$-ju>&Q#rtpbeUm8jsF$ObZHg2NQAk(xv4o{F$Z8uq&wi^m{PB=8-kr)l*Uj0=k&}-zN8Ke@(_bfe8eI|TvV(+uB{Om80aG(ZNECd8UdGVtn5S~&24o37@LI4 zR(Q$XSd+%XN-Sv$tuz{5QWWxFG5olgm}Uw~lC?@Oj6_NKl;&B)rB~OI?wc*DZpZMF zMGq_{+X8&U**OfpDi48c+ik`j`qj+x;c18COx4&O1OcS0Z>?|7;8Wak6rH}Al7x#+ zZ;jXyg{&LI4zXf9dXH5|^iqF_WrX5lG(KPJh_kanj+cThqpkHb@AmsDb1)Q4;O(>~ z6Gbv#HPRl|ZabeFBj0P|fq31FmVd7CIi_j`mlIJw^J9#6(;0e?d2>9KwaL0tTfT#6 zoytqbldt1lIg+WgrY0jnrd7+@)XLCN%n9omQ3vOw=8e;B`mXy35`y4?C@im}C&G6= z4i5G*PPDrkGyE+Z0E7ci2$isj_+1V{HepeB+v~4e7-2u=P54Lxm3Q=mYbjqOt}NpO zd8C45Cnd*pb&3Y( zDyF)VHlb_u4i?J@-}iUv%O4%GVaH)qUNtYNtKR$feDXNUqVe#~Ph52jJl+SaN86dZ z_*!qNt6JxzPO?}uQ|_$p!5fU*s9g*H60zFrjQ?)C^GM>deW}aic|NhVG8c6pMN1wJ zFb*pZIiOq%=V7Rb(-pnd=ny|)y4ZN2HOV@Co7FoIZORVPe?gg(KP9i2AT^-W73e6( zQO(@UeB@qwKU-EhuN}BOeAxXyLhzFh*84moK8c5eoH>!3jmJB|9t4I{7di+4$V5*U zF^)+qE&Ui6Sof|G)3}}f3<+!&S-2ws$Pl1=kz1W2ZAHN&`n;329FFi+=Ji ztb-mTdI}*{5;D9zzfS|dj~@8DT4w-%P=FdC#FwH<^qjw+46^|9Dqd_8{=X)AJ~Ysf zXaavBQ$o?+KXB==05Z7`L0I%bexxii2I7ivt-GzXd(d znd-YuPGjeWsfSPXsQs2=Fv21x)bFKN$O@k7!}?84zmJ6$hTmW0c-wziQLfVA#Q!{J z3nU>wH?)}vz=Kcu8w5!m1p1{XU?-$J7R&!$O^9smQa#6P8mf=D7i3&JKM zBjMA;C+;UVBaz5qz&^?C7wR0)yC!6qLT130LOGS_b;>CUnhvEn+dN)hyNL9^V-G3X zRKI_7J2JO+b~18GNWbtH8Ktk)pfUMh;KLMTQ}GLe^cw&Bf6thm#ulzloCl28Y zo5pV2O*oh9>XhXV_hqa`($mY+wtU;v4QElSKm{tNjxqgh%=qH$p{v5nIkb8mn2!2MT3!CP_RitH zK2TC6)_4=t4)9p#w5MXWz5ct>p|ISMkS0q^xe_yeNywfqyG~hk zz3M6U#8tFoIo>arw{?^rj$g#R!uRo=e46cX|BOFuPK6NK14Pv|g!LFRVCm6!=`mtS z(I?Et3fSD2rT(_H_3~`26`aZrKrq<|PNS+S#lw_NX+YP#OR1 zX3nfmspSMe_vyujXk&~x`(=F4VC`dynd3yhCLaBdUw~)@kLDgNs*{4W<`41kPazm^ z8D)|e_6KrugFbb}|5o96TG^lONIHT@5fus{2c_TGDLA1zmur+mp&Twq-__1AGXTO% z3+?7Xer>w}26Q4;PG}v{5m64TJjhjiP$k-qq4JXEr@bG6U4ko8M5p}*)!+F(xC#xv z{}d4Lk1mav+#lOu!wi9 z(dAf~Az5l|CjkNfYak+M;3$r>9-)DpkadR{ec)^|%>Vd;F9}1vDQXz zug`z!%f}eZ&hnT0c)ky5iX*96c7==TC%1`kBlUXQSl9DR7H7@w>X!^->$zlWs-L7b z;U0f(4He0<8*z2V@r;TeOCD!`6+h9Rpb*^J)EWROt9T6;uIw?`0R^pOXDb1qzIlJm zn`#K^7TfL~`^Cxm_+}lhGx#zUM3W&|e2p*6ej>R68u{{+%o4>K8u`t-gjCI1 z&R*88qlFBCGhg}U_Dv$J;DjA{n|b2bC+}e}@S6n$9zMv=Ts3lYQ{e8fnX$vqHK*Q+ zQ%}W@Zy~c@>Wd7j)v=@x$-MGL$Dl2gFb$0`S&KGzc@~8io&}W-_ExFOf5quZdysI&qYR_Tj*mmS4LLr z*v?k8aoqpdH`JRye@IUu$FzQDF_x}$R&3C8J(p83ZyKh$DPL}9xqxG%JvIUU(yTdi`n7G2YCvaP7crF*+r77YFjWW})5vb7piC6|76_-xff zPf?v3kM?nKCt9arnW!PQEGp}A7#!|&N=k?C#)CxpbC9Wd;P7+kyx_ZtL#j^hlpI|E zHyQl)a-I1?xwc}-T=VapJ}(};Uk~VZ?6^q(3)a-J-&KQb|K`lZh5fqpq73pQN@C>+ z{6zj3GQV9fdA?s9wf_L-FrC70Ls3uiv??`UGmq9myDxI79N+n~kQh_SUrJl!n^yhd z0M+}xN52YF9Wg4%yl08)R9+ONE_f}s_r$q&0pPmUa;me`HCEeU=H-!}T1JekVc0zh z9w6kqSENR6c7T|-NMO#7$qb6b=OzE!Oyyv?{DA?N3OT15Bl;|K$St!Q{fd{H<`Q+_ zd6i;*>g%TW$87u>;ry%~08MMx2+5Ar2XxrIhZ+ksedt{zsqQ4wHc2oB2aBR zDI>?uB%`hb{61KIS0cgLaplh}`EaA_zyP0Z)ib6Q;UDjrG&so)cDvjPO+DcCrHaFF z$vX9`Tzl$W(9gL_)Gk<@(rk^DM~8#y5~+@lk4MMGxTq$+PAdo;-pd;n=FOR1tTx%- zpQ;}xV755tG^3EkF6D|wuD7{ss;ftjB$_f~w`COO>s*V~QgYwwgo(gimz^$F8LZS> z`uqDwz9i9M*4Nixv^}i*z#xW&g(XRmrH+xonM;wydL+i_Twk^_GC~?#sxw%dOufgW zR28Gh^F?%UZ+wgA%E{^N^ywwOflQa6BY37}cC+ujHr;uEOY$)nS*Os!PQ+eDayRm~ z!WbBra^dl8uh!T7Qg`0SG5*8hHeIQU zis84HohXi~Y(-HOZG19|LYSc2q^Kfj2FOJGC1e%vYwzr-REQ*=+bMvb+0BfCaXyVI z$kC25>qz2D)`bxn2x}R!YuG`_Y+Gxw2@$0N>f>ojTb}*W_ zKOE=d^=2ZS%bAmd0|mP4cNK+jj9WV1u;w ztgc|2OAVr^l?nox(Kf9ilu}D8X4;H+A)WSL6llWK%K*W+sfBO8{!QP%pjP%Q&F))Jt`SXW^gQMf){iRgBW_x>^)q4GO zZx04k?VUALJNJ|lxZWaPtb`q2@b915XcB{?qob**=}v#R`>C!w{3xUmBVA_jF5 zXF>6O4L3N@$^3K>Lyu@{v%?3pB7nS<1evsBaId&KT}lNIM^KyIZICmaS198K7@m|Wg2BNQc|zCGqPuAXA5PTY`=TquSeVv zwrtpW-0x49Y7WdR+Q=|M!NrBkYPFF@vtBBNIT*LTT8)}Dwd_F5n}l+@`Eqg&uDC$} z*-xQZtJ+Z9(ebV?6f-?NJ@XMlm-hML!h5S5hL5k~VcngMhi7eZG3j;0sAkC|r0+QB zDr8{F+Z-1t3iDnu`Z{;?0u2lK-R($;KX*}{<$ePi8c2D=yYztd%kkGuMFhlxA|^4# zEpz3%C{1FJP=9-KcHAnbW}<-xzk6}-QedM+d2$j)d_}VMDk%o-RNfXXzQ*oNArvE+ z_ac}Bgm!1qc%haB%hTc#We}#Gus@^HO03JUl#5(a<_xuSe8t zjOOO%goT7E)u@SyiOm*6$RNVkIf)lHh*`8xchxR zq+}12BcI7k#v2p_v=ya%v7w`3xg%+Vo!vE?>&@<*-&(2ly}7dE6Nm9bKg}IPOoE3) zGir>4>&Fq830GDoZHOrBANvH&IPVeTk)MtsH@7}hk^1_V(DY(zu$H9`SS^LYGntSH zFc;{ft(>|yO!c)+4?lCiU+{!q<|wLQLesl@nI6I4;}Xr#;vpKKD?O6Qs5-DfJ8ij| z8^_=+JAmL3EiK=bD^@B|DGP~={Me0^#h}xXlKjd8uCXemY7Cywx5A+qXB!=v77YI& zC|d~dNmq}Ez};%VV8;21bq5}=$78MO4Ch(04zEZU7K7L8BY1q9NMi5}^Wcx&i$=wd z)c2ttZ~COCva6&^jsl3$lJtc@5XihJ#=2S&MT<#DuseChyMy2X`KT*Ps%l>YYeaqz z87*|&(@t2VBAFnEh;e?iU^4;d3Vy=7?k^mzsV~s*{Op`|5DILf!VvIZzRz>(3@Pox z8XBfi#Z=-Avae3(5|tDEE^Tuknd)bOq>408M6$O-vav%t)Nyy3j0wAb*$Y-Y%k7iA zsVhmx)e4Zd`96<`fNy_nmVZ_YQ06P-?o^D1JnTb6ooe1kH_G3bJWSy(0wJ^+u#*FA zE4l4)2G1}sYcxFeC&U2^#HqI$jfEM!!~*=$EFnHu06IVzDIng&`+hu zX0^CzUpM?vuD-aYOd0QG)rHP&@>KNWu0{Qv))4*_+2;P>1+J$Ap11O9YDw8AkEhpD zq6BmE^Io@8qUGh~85tR~-yo}Re%&;gAPMW97rtf?2HI7jIso zDe-wooxxTbVE=P<@RB3@8~>}?ft)Q>uxmx%DGV~s^jU7%P$1H2XtK%obO@pIuMT>G zhqIXc=Wp}Zfg?dz;X5CLlu)<*;}#FDw$c34gd+{kcrvmZ4US3;$PAUtmj4DR^)Nt- zTQv>mBdt-cguF)cF`xAkDoWB9PIx<05UjnUGhDZNx3p{clAs7(da2IpKsJ{?FaW9t z*GB5w+0L!6yJVVJ;uuNB7FH09u!3Hz>;Z-^;twpO6uW!P5dQZi&EZa{CMou%JPA-5hCSpi=R&+*sjOc4L*zJVf_S$0 z98EPb_|urlfBY7QRIzf^n>D|f0+1JWauv7Gwhk^&?;0%%^2u>aGbAtih^MBJb5u&= zCGrKbqlOGaG3lIaY}9H^qO(h$a69+x7E09>H8h%CZ;bw+8GZ;RS8}p@&298(vAO+? z!(~hkJKg+>$62e_<zuQlZuYh(^F_jh{TaS8+MWZg%V-! zj^!&QB~2q0@uLyz*B^?&^|1tk%a5%d13!52qp}#zuN%Wd#cO+?5X67|3jXXtB`LXP z5!~vDyKvcAXFP)m$1PH~Hg9)O_eEcHeKcREAp}+nk=UQOY4<5)3 zxSypdsS_=Ew^gRDw9|njfs-y&R8uoCHy_!HS+-`zTvgJmTnFc0VJjXX}*lUa@#s>%4z294< z$iQ8r8T$u^&r{wz=PwJ$cI^IUFgoSbziAv|lU^f(3y9Z%wQ&#d#pSt<7t)ACre zY-9!Q<$5-sEc(JA7WY&ZN^amw$F&?e>;}#0XcPQL;82pNsHZBmvXAMW>F7eSUruZG zb$S1wg5J(!tB9Z@Cu*?aKm;DR?{Ic>^gKv+?(XTKp{5?J*nfX};d{Llba82nkBHw>P) z*U#F4PL)oGE(2#%T8v~)_`avjSwHXYUi#BoV4w-Gcv(T$5hmr{w)-!hm63Rrhq|)v z(Ot%9b~I$u`?e?ZWfQzF)U2#dy+J671ybJ`4Z&qNM4=d5^O?a2DVZd-4=(L*dx^T> zL8G~;Nxt8nELMD}VtFDv`EnBP$;{CRUg20um1jV5s7$lrUr9-Lc=(eC?-338no3?z znwEF}q+^~d^Y!&LXI#V>iGR-M}-09@Znu@z@?D7hp=hbU^Es6+ zlz7+KfVaBJ4#>^e?5}i(de5=KO9zafaJaf)$og14r= zo|S#95aeu(1q@^8Msx3c{MMc8N(eD^Z-s!yTqh%S|wp;)a;lGh-R%+0d=U(rC z$3g9ESBs5y9tMVJLJjrEz}k`^p&SN-{xEEokObVwfyb*IBs@-s=i8&HT+vuY!7`QD z=RlEMQ*ZU5dq23nd%`;;@J`XLwKzA_)G)EJv9Yl1-8^yQ%Mv1Eeg9syWWl(ff`LDQ zCoC+CCq)S-rRC@A6J1+j=0hrjgx2Xl-GoZJXLX6hdRq`~k zy|;ge#A54R-s|L&-7xfYO&xcSnL*ms+M%W$jdFfjm6udcGa|nT-1ofq`Gh z8V^>W-gaZ*AdEEoJPj6p9f2RZwWAyET8*-{wzhRuekU_99-GySR?_-FdlrhK5^)F1r5(|rJ zTK`&Mw*3D3w5))<=w+!c!@s!coNSpZLpnhNw(#3Yq^fbulZ@NmO;DuSYuy=wq$4+1(qj)qr zyxs%^1)n_LxBEgrERDTV%xhXpr?F2hFKhgW_5f>IDk>@g%Ns{92A7*%A8!}l6*_Ip z6=2`v)-REhYPHgP_q=pzM%lQxh-?7*Ph8s zTW-M7d+=TWmi6%mugskIWH=&_62r8I{AuOqILHhx7@WdF|Ak*i2OmdqeRlS*G8NrM zo34$GjmbLqUxzb=NRb0v;8N4jz{X*%>zrHW)Lal4M&odi$JID4e9<>K_HvyKp?1E- z0{}Vi5L$L<}jiWWz7+dhVMy{ue*h4@Hmk|*+#0=_CC``pHk&QTIuk4wwpP!*ttCy0xPX09 zkOm;dKHHD(-(a-Jr3L`#Yrpx*9$rX~)2Gx2Ab|2IUTg4_&TOyhxY925+Q-Qlf0&;8 zBLc4^K6ZX|0VC9@yaoI#K-N`~Mn^ZY!BKlV@~JRMmpRy4N0R`_C8U)*n#Qz{-8Xwq zT@8s7v5PW(7!i}UXwIyIJR|BSO^a8Z8sw$6XPaMXgpM20)y<8hlvLc1;r~R@7<=AJ z`UW@}ZWEIXPVSk9pCWAdnra^Wc)l$3e{MVb4P-LCAGB{G1b)H|_!&$$np4kM77Q$3 zs+yTI>oJYt;WSuV+!^kiK|{}L(c(V`n7-^Z&LWJ1)s(r-NI_gkfG(jRlD-N;QapICT3E+tF zTE4!%wu70?lZA?x=jY>ckE!;h5Da`~<_TJ@lLGWVj+<&WWi*@)3J*>N2!TixRtu+T zwms%ms)I^5&$q8PqZC{zwjuk9*nGK>;g84E5}16D24*z62Cl z)2q3ZyYek7Xs!IWM>ByVdpgYyLjwa~ts@FSBb}zGgIiqEp~C5oskOFt?%ILmhx9@B zoo!N!PQADM{j(!L@6z^>IwSR2yLf&|`##) zuJrZgXJvux+@t>9A?*E| zizNWJP71}f?hohb%2BB}cJ_)gx~V72nVvIxVxh3$1rJU43x&KA{O+#Dceha- zjVOzK2?b`?IJw=Is}JPOZvLMaU={Ak-{Qk^32>+V*7p&fft7f-*_|f+@^0P81ZqC% z7>m%#wnr?eSgxU8LGeTa*K+BG-9-6pG@i^-N>j@nVFeoF<}D-JQ7F)&y$oJ=%{FEVJ~;TB85ab{}ur> znaY`A#U<^%Wg*BSUFX6z_SnZt)2{Na z*P4I4dzv4}!cOm(vy;GFe}qMjbO&*mKb&r4-a3ZyAvf3@firUMMYVJgrog-2^TYbZ z+2VN-%mCE$Xnx}NJWmB*jNKMN9S^1H%)pF&4FJ+A{2Xs=B&(SKBjkC1m*LsMn{gUY z+B?|ie#}{n*X(?uqoMK7^s7Uji{#T)%;GILA@LKvN;Z>QsdZJZ(8UjoipZIYq^AdW zy1NBneW$=3;`mRQLr$ArcwEVMst4VkwWgw0w|gvPmV%1QcS^>;KRyg4#XbLuLz;v~`A zyD3NFlhs+9R->?Io6Rc#MBL95$gW4lL$U&<;~BkLde<4!A9m=#`S}Yqay|8TAdC0m zW?oD0J>vHJ+ZfQ;e_GwyGNPbB7w?bMZ~=Xz9Er~Z?rKRG9bTx{fhgQd@mL!pnOnK*u+%-_w-N%8qWto9fOd(e6$$Jwo`_#ZXd=MFH6RV z{IqX$4g`8m?-lHw-hPoh?-sS{=-Q8P{8mF_!~@Ddi$CFhl^BK)!-0pl;90eyX0vVm z7#fl%f@p8&mB$H01o$bw0ct#!kC{aB27xXwx9M1zY*4^vD?L>Sf>+uOTX>ABichyP4)p-B!!CGJW)cPcJE-Z5wF6DS7s2I6PS z>wRm{o(s~kf7Qvj`| z#(wUQS*oOl(T1et9v&WM=A%5Nne}>K^CAZx zDw)x2)Gt4*N89+RxPCY-#^$o>4)*Fq*QPuC&$Od z9a7?+^?Exs^`sSzb46!(2_)X$q9vXy@%!DslnwT7(h6}>;(_hvd z@ehZf2X_XkzAT;SoKIQ9gW?cjphKxP?O?R5mafjwdb(9!wex7lvB0`qRBxyr!fAS& z5821b%+ouVrdxK0toh9n7JvM=OhuGLO+<+T1u!cDUdPmJ>3uMdtMNGa1X19zl8sq zLc__M5G0GedU_4qcnxBI{%S91M+=H#$QTQ}hJ4V!S*v9EGt`pA=Ny*GeDLr`a|VQR zBhpeG<{JAqt}(epdS2$xSkv)r@xDyG)9~SZK3;GwDz(vu!+C2q+d|xG`Jn`&^>}6M z@7pI(+=ti6Sh61Nn7B?o3nE~J_jZyaSUGWfG$C{!jq z9Mgy-c+9KAviR4Y$Wi<^26FYV?yM=S;9q{i*r8jky|Yo$!)M-@9+*wEravpK?{YDP z*yVU@JmjpV_I?w9?vjJEPRj$IwBbQ}c*GbyE*INqSJcTfH-E_-KDe2<-Wvf6Z1fJ= zCipVS%5#ajUX+O=U$mnmy7lP6M5z|-LT_&`xbFbp*M)_J)zwu{-H$$4jox6hI*leR zT4aZ5A0k|Up3E|=n|DUA^2Zl@vPYJuZ5ZH)33F_*32CIKzQ96z@z4gV%5=k6#|XeR zK7TH~TtlbCNnmdJ@v2HXW^a`JvXVL0g!erWgN=4XdbY=4s0PtdY>UbYz6GjjZ6a#90U^_)!A2037(U>;w1?pw36$S zSfD+O>#Kr4UFnT3pTIKysZukmU>nDXtSM;C-ej{91Sip7so!Nqfe&IyGX!RFzEcQDiWP}Mi9&Ul2P%vChN{Uk5DEmQ;hrhb&lp)mR zXsd4;{t1`-0)qAjKH%y&qz&*3i|4N@_Zl>$LlG6XQekoi1r4{_gB@6~FQ2$th^#l- z-+GYvJRa7ZNl8fs1Hb0`57>8shjmuV<=L^Gv_3B@BRSK$No0+9Ep6o=q)KK0HHP`% zq-yTEr}gn{u{Oh~x0xpy>6a`Pd#fx-M^ z^|l5~V}E}_4qR-Xu+Gj7qi;y4#2$1ftJ9&C>^O#Ta?{5~e<|C@^#vO;u(DdvQe=DF zr1#jd9U)6uqEOV-pYS6a=qyH=$>0106Y_e};P1OWJ{+PVhHmi}r0m3QC79cT3!3C% zr?q!cU($wY+&9`6sFBfelq5tR+_Te8&&|IPWP6*b9;Z-pBd1R3TON|_6-CO7<$wFC zoqFHV*R^~2G2D)odC3xv=^;QIokH@JTQd&~X}!JT*VH z7o6=;PP}ZhEG&k>^;JlXsq@yecG^W@0gM7X7AhHK8u*>oRB*xUQ~h+DHuI$~2nfG7 zUDBP@$W6h_)ZKroKN8=o&Hm_jJAYsjv4@*4%G&I{y`5}+Vk2SMPr&{;aQkh<>K>u$ zpGD*Q`U}_wxD$yXM3=^9t)qG>yN+SmG|Yl6Ehq>Dl9}PgN6Bt8I4SEyW#??Ew+*!~ zX@D2HZ=UF6L9>G>vi8J#I%jAsTf4E0Dv{Ind`tBo0X`odToO`B>RlYZy4-nFK>p1t zCceK35li@-Fw#Q7QaolVL5;Qk9j;3?5F)^Waj$mAg z8>lU6?O!JIXz8G1Bd9Sw+=g?!m}L$X=$5N5^)$VJv81G=B-7}R#+SS3Aw&AK%R@W0 za)R=d&%3nAto<7se0oxbziC$stWze{siL?)|K-n;qtIY&>B8M7DW38Q!_c__8-g|* z5B?6WU_=9>s3qHNOMu6Rs-xC#4sO%4ztS`5k$n>om3yaCPY?oxgjFPEd742H@wACO^N#n zXOlWeyn@x;%@f*FMNLijmwU^#ULzwT zT3Xs!*w$nWS9Y1Ub878%Hz5J2$h?Y|xJ9Z@GVQGRIO23H-)4pre7H}6 zheUB_v4uBndA>T0vv3?XY;5dZJB}xBFE3sI|6=JX#))yfi^01oFpb+iKSu|Fc!akd z3eJs#x9&~o(SsKZlPYzLX+5ndnVpjvMJ2w;-;d7?4TB&I^D;})E~sMGTA%=9ru&N) zu$%|>N+|tb&x82vSq*4nxDq6?7kNf+CqlufK%k=G?kZqt@JTNsa!EE?vM}JYo8#c< z?QI_b*k!{6OTcEe;c`O&H3hBjela_deD9CvEf+;riE+3zO&(9x6%}-@7Dh%Yii(1s zf5EExJ6*?XPHIw@-fD+;W;GMIDp@R53)A&bsg}FAx<(IZHdwtq?nK_9zJf(|A|j&Q zE3liZP&&0Bk&uW;e}6Q2_v&b-F!1yDoJ2w}*W4F^zH1A1mt3s3-JuEz3wwewc(+O* z`*5x#QDSbip2KJ~iSOez_L)Pk6Er=oum%m*L%?p9*$K9FmmRPPU`qP(b_I;ViZ0^} zH7qeoKZ`TT=0$c4)*$(8BsLO0=9=jmyxLr+1|-2mE8pAg4DEA^8~7wc>&O3D2+ryj zH0Gmv7#{B%wSy*`K3opoVJTB^TaUkj97qGZJn*wMW9}!sH|Y}-Gm@4pT@=hTq77N; z*qG3P-l?svF>6NjqLG_k{=5<2EAm@Ua-*^`MM6_@*{`b`Z}&ktFQWGIh9qS}Vvqnd zxYy7=vs#|Q74vAbTz1`!pa-k63%cHKV0i*8ay8oRecIcd%mo)C@O-gb1-4dMjrNSE zbAcDF_`gTK8RK}aM785)oU0k(RwU@=U;^pWCo>L#Jg^W6gRiop$PbuwSnkZG`LOBBc4xX6Ik; zk2kh_*FnQ-Fkev7{v5)rGv&Z(*R(n~SVZ&SBAJo0KXp10eLzo0@lCwAcpEj?dgA>r zzsP1n3?E-*9174WuN)sYTUE9you>lCR8zeN7DNbnPud=wLm7xkTOzpXEz4wZi~Zbt zE39bccK_pO`pap4Lp=3>#IW><phU`6ZzH<2lJ< zC01tU*||9uX67hc6>Vbf**^JSig$^Rj z6DWTu8xo%XkkO3rG*TZd#5ajs|M4+}Gv5qMkM73Qv`CJV#iy-l$0Tdnofl5882{rLQ0u5#y>q$>|K$tmbhdnl zwO23vf`@T*7A28?mglPVZ9rx8)#f}zK=@{6dIiS_oHO=4XEM}^8jY4)G17&S0EL9? z_?yl7l}|w6`t3LH-$X=^f>CEZf5E1TjcuhsMzJC5wM>MDN+rcI526N}%JUr8sQQbB z{>?X4^xtfIzlawL*GB#3)AsS*BIZSXFbz&UDdhp0Fe3dq`e~cLW^IHZDBkJjn_JsC z)D_seaPz@*;V4tbZn}mGbP?-7bix3(-NR)fH%4{oP@JwPW_U?bMsjj;Ha3+?Ki{4X zGCN+*TSiBvH2hjgX46}1ysUTw*hQ@!?d*1e<85F6)b)v#dCbf>m&Mwrs(;lD--d<1 z`Udja1*dGc3_L8gy;r~)Q{z2Ju^L?DoZyXay*+Gz0o5HWFcBxNv05fe527ezCYOcb zfmSi7B>ztf=N(UF*v9c=9kPzdo+X>?gAlSME1Q$O_X?4S9GTfGRJLOun-JM#?`%gl znW6OF-uHd}Ie(qU=eeKTeXi^G`~I%VnR^g{{lVCTE;!Wu8x&G^JJ{~qJJw`1f2r*9 z#L$QKr#@16D_`-<`&~w*OtFI5=wU;QXXWR+jLLW3eB2BxA{)aC!F%`904j+^Mq=_{ zktpYIhHXU-Lbe%7>;ZTz9b9%SLkfB9Ve#a) zU`=!8_M+Jp%7X+6uU1l+kEcL1p9`CqkP-0Fs6%PYg_y--fFYz*HhI$%u%g&XBCXjB z?)R)l>X-g$@p_A7YRaNc9oVBA%I&PF3N3wX%*TfNSlHFaD5&qRV|ss0y(XH^f#>*O z;?0n)$-}6bH{FWILF07fjYfqUKZ!5t5lXFV6@S;m1Dh|KsEy<5TIz^v+RwYKro0{#))~ zFMf%C)@giPQo6ou%BxRWsEkFE-m`inm&)Zf&AYoJNTF4*_q+KnYO87f!{6rX;dr8t zLN=#=CMO>2xk3a!Q(nDawe0UsM=_T+KC--?HXEejh2%BjcPqFa=14Wd+1RLOJfu*s zsRw;P2@N1~M$Lc3W&e689ySonA4VL7X*{sjjaInl;L%q+v{kXU&IRC!$>#oz^o;Gm zFME@b;RVN9cP4FceM7e1btARD?9Ng&Y4y72^6W%2`YX=5xpABqA*%d>d+~Dbbb)E!-EuSr zr4O`7)oDItmpwM3+&?M%ddDw6nDAgl_ND0F*GYWIUX5S%6@${WZSL|%)q7S*w-fSU z`F*O)WO_=pg987b3rxrQj|ROq(wNMRAfWl8o_Vgo{r6UHy;-$lE?2>Y5Xq7I z$$xSAR?C}s#+-l)m#9`(-NK4~;~Wwe^HSBs@R8rAQ&ez~ptcwUB*X0XVa7Gp55&9&-WmChvq`* zj8&%6U`4|>6yHw1PM^;1oLzzq5iIV{52wP?SH}#Dkg!g$`yaiCF*_==xiCOB%}p(s zNrPAt79`Vx(Aun|)r6I0NH0Knv1TZ+tF-*A-Q?oX+sngREyhrGafvG>7b>LL^6FEm zs$UVMvngs|plTcQHNaMpKpr0ya>csFdV2ZI`$l%3>pMcfn=Ul%%FNBl)kzaTIC;yV zA2K6Z=pbtw#l0@L=sz+VSL{DZ9qQ+s`kP63z3g1qTJQD4Q~0;<5E2p1I@bY{$jdK8S6Oef2<_B+kCB^=%^v$DgGKQRheJ?N^A1`rye07!3>@#sj+yvqXS0tmw0|E4bIDzcvb*N?D7&o*g$m9-KP8XtfB}@ON3-xtUo#%*o^;m8Q3t=D)ppdm2L&bxZm5ht`NZ9{c&MNpZ?3!&r(X z0LIJ(A|oT`%&yi2S*+Yodd{}HwPmnQ+@0+3XBW$sNM%Lbuf6MGiHV(y$rZ*l9eqzs zs_)_j%kt}{Vx-vE@7wsyHRm4APE+jW`Aeoc_u_qSWwM&8$+bw;F*M{Pe^*q%ZbHAO z^nCPY&l!bUtoBaV$3Ht1w=I(pm0;%;DX);{yyafn$cH^c%U;&yC*)uHAZ!29Prz6< zd)-|ebpCjFcv;WyDMMsOJi{9)A%?#U$r|d>p}QI(ln^Wv4p})!I|0P$u%j%e?`MUI zsu5fauRWsgZja7b#(IeMnoPS7IC0gke~@tTJaRq(NFcAnck?lv;ZF%Zw=XU()~l1t z-~p(k&>Jt9pHv-AL`D-7^M&JM{tS!q*LC-_E=vhcr2E-znM35mr> zc&)bVCun8tn0=TPVL!f_u(SRC_OAVwz;x}0_iL6gSRBfrq8}57{znGl>-}tpCfG#Fk8 zzZ6+mS#yCbvazvYeZ1XOSG&E(@+r5>-kvxZJD8(?l}F7=Ayx`f)aI?}HpD(8-3LG% zgKEl+=TkUKFWkM>AhJ(8)7^;pul43xL}(vY{9M-VcF7Lo_SM{yaX5Ema~>tz`Fi^- z_Jum6DD^LeS&~V4-KGs@B_y(0={k{5+=bGPf(u0WyyjaHFB6 z>qNo2+|nMa-_iuFyy?>uXq&iI1_HJONl9WX{MMGT%Q@R#q}P}_90d)^r#*2OSpPp* z#&JCD_tq&wbk(aKCjCOG6nh={GH13~af@kkVZ1fyz{KwC-(9!0JopV%Hrlx9GA{G2 z!4vVlpjB+2Jh%lQWyR7vgfV-5H%ysZZ_fb?QfP_KM6XIM1I#nR%J zsD;V78JmcG=bhdN45%WOw&ecP{oOmVh=vY#H>Ry3fkL!>dGCwT(B|2t7}micRY}RM znwR7m|L4Licis5v!0p!D%{AGu*3BYY5gt;$pcqNNW)U$h`tM?;m{aTAO!Z5f+olp~I#yobv>p0`y zLz<-*9_!UK;j;V_k#t1p%*vXYlcOWRMdlP}WU0NDi|YXbWw~i1IW2ARd}R|M{xiF` zsFZrKaj7}qigCB1olO;IoFO8pTsv?36jQR;@BrcUpt8FdK82Fi?t@RI;&`&!LHXr} zI(vJA55Lp={J4e9o+(phJ#)2#V7On4PyKHC$|msqDT%T4t*)F9+RVk47O|(;lE|R@8jPfS@m3*(_@7*FUR|R3u`?14;B*_ayW0YQDT~f<+Mq+WCxc7!DDp0EQf2-zuYdE43iyJxl~vUB$8d}3mnlSs$4?DapT zAnC+`?)cvy@?v~ZP7~Du{Q>^6Fsh2$L?x*dX{~g=;?_c54gSkOrMt2dRK>hkMmTIT zJt--a1Ld#1Fjvfwad?!l-+}D*lCGIjKQZ@iWS1o#KK@dRzc5IL0r2@cA}R`9SxF=1 zSD9Th`gIHQ5e$K#3zg;D;$U!Gi|jBF-eu&41RIl02N@rnKbersMaSYmOmkl?W>^r~ zZy-NQb*?!zu+V%SPC^fbF%AAa zCNW(388tXK2t;N{US4&;e~KcjmQE$yXQAB znlc-?J?;IE`kjKkaZBokDof}%fTH*43murtMGZE4CwKZKs7#&gT744V+yA^joxxMH z<~a*#7g;%cnwHTlDrsl^w;{i!)HM4_{(FJVWDxpo;KB)Cq%ceL#*^wqIFDl;{_NM; zxj85ly1)1(^X!A~d!WRYeEw|N5q7JLkXSlXPZIGg^EF$OZvsBBnwNk1d7Gamg3HR* zwtMYY+R*vSJVk=12AwxVSZmK;pV^(i8ZKtKLI4Ug8K3)6GqS9;gg09epT%fnz5>5Z zLo)+@95Dl_zFnlD{4_VBIymltkbUa9(4%7Ef+PIGdI)7cXhu z9A4J=&00t`R|?rVO34JKqVV!Y_pA+NOE)((%#2XJegS?D+CdT-2OAr(cHZ<_^?IsR zAxH_Sk)Rq%|G52o2f$r$ti3F&U%dClP$cdvM^2!QmKGTU!(iY{la+`F0vg(B<>@zk z0zzyODnp?)M)A3Zh`*t`xWH>)^8d*Q4ZTfCsaP?!NFJj^K}}uniBU5%TYCSVOwD%l zvJa$YjLT0_rd>pbk>Z2t53goHlGDrU7zkHD-WTNMbsk9Ji;ay%9H#N}3Z*+wmgs?6 zfKl>ADH@Gl^!x-PiO%(Z-f&`qH@t51&WgA7-q!ZLqT)BkWhqGvbTQ$kEB(E_D)~C` z3pus5rvSjuN=Oj$-T%S$te^!XdO@j*K-B+y0|uSBEi~!zQng)fqvYh|Kwcz)_5=Hg zZQ3(JGf4q&A25*uHR;&*UOZn1*ksm1>AKv>0~n$7QjjAnC@5%cy+g06MKmZa3F#uuVwc`uykajR9=i4_0gWI1AsRr8GzeJ2zFM7ZkG&}1*Q)vObCSWZN4o2T$VrOT^ z4hd!;I=l$f@q2&NIigqK&p_}-3uRVb1}S#HLf~>q^aj0SApk6lPH~&vonbKtm9$DhyLlAlQ_wxg{XNuz>Bj_D1 z0gpvn$7=uBEgPRrYVLC~Q)HjDqX?aJ&MitN}IH}2Dp%|}}|aJc>QlUgX^t{&~h zN%_8y9^9Dst1&COHfwZc<4l+9!cL^{0<(?e$ZmG;6Oi=*`<6eBg}{?)CF;bI=~l^T zafE{o3gmG9uonrt;C0_LXyI?F+nz0wLPJ04qX5d19(;#5Ddz1iMc*jB92s|VrzO9BWH-+F}(73DH&(x#Ij_IWj0n_ zeXREwv3~!7szeUI~NyVOu(wnO#^YNM{69{f6o73M=|%fX@040QXR7Kh`6=07JY zrDSAOkRdizu@+Mnp~7>W*)$WOWdAU-{d38T;u-p$LDsx};?EH*wT#(xG%{3nMxWkz zLC*R{_sj^g1$pG^%^RbLBpwSA&fjhLex9U85y?h^qDWT$i*wfQFYDZTB*5bukQBfq z+UC(NbvV?}IFr`lV%Iq+U+YQ8&r?*CrY2yEbY^7cCvu1-`_Z-qj9Ol9K2t<{tB#d&L@oEnYr7u zM9$n?E{~!tl&_vCO&pY}^Tg&1$TEtZh}V!r3XW^hRuy$!DI&t=?`94`k@Z&E1Nknf zZQT^g%=9~0blUM~*&O&-#?;JWFx?24SC5M^qUhM#UeH8>uLwfmv@O*0kx@b2%>f4ElH zUP2*J)lVZ#!*J~UbSGG|T*pct+C;{4!4#m0f)Ax+@AjAIp-(tuvcueW-VBXKV>v}+ zxK~PxMQP!z6f69bPkc(}YWco8EOdd@@wz+Bp}}}Endg{z;Z2u0%W$+q&@ii1oL=?& ze3ap7G&Q0A$8Euyxkk!oIXE0}?K;apkL9^6q(iSOP>^o^egYNmfMmf6@^N*Ba4AD{ zq{BakNZgRQ{9_aP@uF&H%IxDfb@!sjX4E;OgE&P`y!w^A;+5s>y)WCyNwUicHkq|w zR-M|^ky+V(a?EWC8?Jp_c=1`q=#1dNAX^iBgU32%Z1&sJCwx#m?+2nEF&#{$GCqJONFE%J4RCa;!J7URF{vnlf1Jn26d9& zi0czLOv=Dn+^cXakVGUK4j=8bFtyUf<88<+c89y?yiM4~Uxu+%Y) z^&y7{ZMItXXZz@jAT>Tmoh+#0Mp-{P*q_EK+K7I!M6{bmm_8FJ*qt^zBNZ*!J-7iQ XDX(SO_&p>G0hg+xhC=yc^Edwi_EW$M literal 0 HcmV?d00001 diff --git a/docs/src/reference/resources/images/loan-broker-eip.png b/docs/src/reference/resources/images/loan-broker-eip.png new file mode 100644 index 0000000000000000000000000000000000000000..06fa75d92b8b4af5303295826bb4af1285fcc636 GIT binary patch literal 104145 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 Y^R7jdI!>mu391mb2Syx1Odd-% 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

Pv_ry;ZHQ&*-2nwNE1)hy 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 literal 0 HcmV?d00001 diff --git a/docs/src/reference/resources/images/quotes-aggregator.png b/docs/src/reference/resources/images/quotes-aggregator.png new file mode 100644 index 0000000000000000000000000000000000000000..34364224e5db8848a297bb923edf8cd08a4495e6 GIT binary patch literal 14373 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 literal 0 HcmV?d00001 diff --git a/docs/src/reference/resources/images/router.png b/docs/src/reference/resources/images/router.png new file mode 100644 index 0000000000000000000000000000000000000000..a45966c2e484274cd5080c5889b905cecdbe1821 GIT binary patch literal 20766 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 E3#3zRu>b%7 literal 0 HcmV?d00001 diff --git a/docs/src/reference/resources/images/source-endpoint.png b/docs/src/reference/resources/images/source-endpoint.png new file mode 100644 index 0000000000000000000000000000000000000000..4fa95e01980430ab795abb37aa43111cbde14141 GIT binary patch literal 25560 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%0A=1g$36%UQfvu*S` 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 bbw8rxP??{1kmLp&8iBZ>ri-dqv5om36;f)e literal 0 HcmV?d00001 diff --git a/docs/src/reference/resources/images/source.png b/docs/src/reference/resources/images/source.png new file mode 100644 index 0000000000000000000000000000000000000000..bec59cf7b3a9b2619eac860cff421f0a71b25acf GIT binary patch literal 21241 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 literal 0 HcmV?d00001 diff --git a/docs/src/reference/resources/images/xdev-spring_logo.jpg b/docs/src/reference/resources/images/xdev-spring_logo.jpg new file mode 100644 index 0000000000000000000000000000000000000000..622962ee3c89651ded6aea73c854d7ad44f880f5 GIT binary patch literal 37376 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 literal 0 HcmV?d00001 diff --git a/src/docbkx/rmi.xml b/docs/src/reference/rmi.xml similarity index 100% rename from src/docbkx/rmi.xml rename to docs/src/reference/rmi.xml diff --git a/src/docbkx/router.xml b/docs/src/reference/router.xml similarity index 100% rename from src/docbkx/router.xml rename to docs/src/reference/router.xml diff --git a/src/docbkx/samples.xml b/docs/src/reference/samples.xml similarity index 100% rename from src/docbkx/samples.xml rename to docs/src/reference/samples.xml diff --git a/src/docbkx/security.xml b/docs/src/reference/security.xml similarity index 100% rename from src/docbkx/security.xml rename to docs/src/reference/security.xml diff --git a/src/docbkx/service-activator.xml b/docs/src/reference/service-activator.xml similarity index 100% rename from src/docbkx/service-activator.xml rename to docs/src/reference/service-activator.xml diff --git a/src/docbkx/splitter.xml b/docs/src/reference/splitter.xml similarity index 100% rename from src/docbkx/splitter.xml rename to docs/src/reference/splitter.xml diff --git a/src/docbkx/stream.xml b/docs/src/reference/stream.xml similarity index 100% rename from src/docbkx/stream.xml rename to docs/src/reference/stream.xml diff --git a/src/docbkx/transactions.xml b/docs/src/reference/transactions.xml similarity index 100% rename from src/docbkx/transactions.xml rename to docs/src/reference/transactions.xml diff --git a/src/docbkx/transformer.xml b/docs/src/reference/transformer.xml similarity index 100% rename from src/docbkx/transformer.xml rename to docs/src/reference/transformer.xml diff --git a/src/docbkx/ws.xml b/docs/src/reference/ws.xml similarity index 100% rename from src/docbkx/ws.xml rename to docs/src/reference/ws.xml diff --git a/src/docbkx/xml.xml b/docs/src/reference/xml.xml similarity index 100% rename from src/docbkx/xml.xml rename to docs/src/reference/xml.xml diff --git a/src/docbkx/xmpp.xml b/docs/src/reference/xmpp.xml similarity index 100% rename from src/docbkx/xmpp.xml rename to docs/src/reference/xmpp.xml diff --git a/src/docbkx/resources/xsl/html/html_chunk.xsl b/docs/src/reference/xsl/html-custom.xsl similarity index 67% rename from src/docbkx/resources/xsl/html/html_chunk.xsl rename to docs/src/reference/xsl/html-custom.xsl index 81e6ab2358..76e6fb0bbe 100644 --- a/src/docbkx/resources/xsl/html/html_chunk.xsl +++ b/docs/src/reference/xsl/html-custom.xsl @@ -24,8 +24,17 @@ exclude-result-prefixes="xslthl" version='1.0'> + + + '5' - + '1' + + + 1 + + + 1 1 @@ -35,23 +44,26 @@ images/ - .gif + .png 120 images/callouts/ - .gif + .png - css/stylesheet.css + css/manual.css text/css book toc,title text-align: left + + + - + @@ -70,39 +82,36 @@ - - - - - + + - - + + - - + + - - + + - - + + - - + + - - + + - - + + diff --git a/docs/src/reference/xsl/html-single-custom.xsl b/docs/src/reference/xsl/html-single-custom.xsl new file mode 100644 index 0000000000..63ccaaff6c --- /dev/null +++ b/docs/src/reference/xsl/html-single-custom.xsl @@ -0,0 +1,142 @@ + + + + + + + + + + + 1 + + + 1 + + + 1 + 0 + 1 + + + + images/ + .png + + 120 + images/callouts/ + .png + + + css/manual.css + text/css + book toc,title + + text-align: left + + + + + + + + + + + + + + 2 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Begin Google Analytics code + + +End Google Analytics code + + + + +Begin LoopFuse code + + +End LoopFuse code + + + \ No newline at end of file diff --git a/docs/src/reference/xsl/pdf-custom.xsl b/docs/src/reference/xsl/pdf-custom.xsl new file mode 100644 index 0000000000..7de82b2546 --- /dev/null +++ b/docs/src/reference/xsl/pdf-custom.xsl @@ -0,0 +1,502 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + -5em + -5em + + + + + + book toc,title + + + + + + + + + + + + + + + + + please define productname in your docbook file! + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 1 + 0 + 1 + 1 + + + + + 0 + 0 + 0 + + + + false + + + 11 + 8 + + + 1.4 + + + + left + bold + + + pt + + + + + + + + + + + + + + + + 0.8em + 0.8em + 0.8em + + + pt + + 0.1em + 0.1em + 0.1em + + + 0.6em + 0.6em + 0.6em + + + pt + + 0.1em + 0.1em + 0.1em + + + 0.4em + 0.4em + 0.4em + + + pt + + 0.1em + 0.1em + 0.1em + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + 4pt + 4pt + 4pt + 4pt + + + + 0.1pt + 0.1pt + + + + + + + + + + + + + + + + + + pt + + + + + 1em + 1em + 1em + 0.1em + 0.1em + 0.1em + + #444444 + solid + 0.1pt + 0.5em + 0.5em + 0.5em + 0.5em + 0.5em + 0.5em + + + + 1 + + #F0F0F0 + + + + 0.1em + 0.1em + 0.1em + 0.1em + 0.1em + 0.1em + + + + 0.5em + 0.5em + 0.5em + 0.1em + 0.1em + 0.1em + always + + + + + + normal + italic + + + pt + + false + 0.1em + 0.1em + 0.1em + + + + + + + + + + + figure after + example after + equation before + table before + procedure before + + + + 1 + + 0pt + + + 3 + + + + + + + + + + + + + + + + + + diff --git a/gradle.properties b/gradle.properties index b301df9c31..bdd574521c 100644 --- a/gradle.properties +++ b/gradle.properties @@ -39,5 +39,4 @@ role=developer # sshHost=static.springsource.org # sshUsername= # sshPrivateKey= # mavenSyncRepoDir= diff --git a/gradle/dist.gradle b/gradle/dist.gradle index 0a75974679..f0568b0473 100644 --- a/gradle/dist.gradle +++ b/gradle/dist.gradle @@ -65,22 +65,38 @@ task distArchive(type: Zip) { // configuration phase event. no zip is being created yet. the Zip // task we extend will do that for us during the execution phase. into(zipRootDir) { - with(project(':docs').docsSpec) + // add all jars from java subprojects + into('bin') { + from javaprojects.collect { project -> project.libsBinDir } + } - // add each subproject, but only add the 'src' dir and 'pom.xml' - project('spring-amqp-samples').subprojects.each { sample -> - into("${zipRootDir}/samples/${sample.name}") { - from(sample.projectDir) { - include 'src/**/*' - include 'pom.xml' - } + // add all source jars from java subprojects + into('src') { + from javaprojects.collect { project -> project.libsSrcDir } + } + + into('') { + from('docs/src/info') + } + + into("docs/api") { + from("docs/build/api") + } + + into("docs/reference") { + from("docs/build/reference") + } + + // copy images and css into respective html dirs + ['html', 'htmlsingle'].each { dir -> + into("docs/reference/${dir}/images") { + from "src/docbook/images" + } + into("docs/reference/${dir}/css") { + from "src/resources/css" } } - // add all jars and source jars from all core java projects - // (i.e.: don't include sample project jars!) - into('dist') { - from coreprojects.collect { project -> project.libsDir } - } + } // once the zip has been written, create a sha1 hash for it @@ -94,8 +110,8 @@ task distArchive(type: Zip) { /** * Upload the distribution zip file. * - * @author ltaylor - * @author cbeams + * @author Luke Taylor + * @author Chris Beams */ task uploadArchives(overwrite: true, dependsOn: distArchive) { // base plugin adds one we need to overwrite group = 'Buildmaster' @@ -116,14 +132,14 @@ task uploadArchives(overwrite: true, dependsOn: distArchive) { // base plugin ad classpath: configurations.antlibs.asPath) s3(accessKey: s3AccessKey, secretKey: s3SecretAccessKey) { upload(bucketName: 'dist.springframework.org', file: distArchive.archivePath, - toFile: releaseType + "/AMQP/${distArchive.archiveName}", publicRead: 'true') { - metadata(name: 'project.name', value: 'Spring AMQP') + toFile: releaseType + "/${rootProject.abbreviation}/${distArchive.archiveName}", publicRead: 'true') { + metadata(name: 'project.name', value: 'Spring Integration') metadata(name: 'release.type', value: releaseType) metadata(name: 'bundle.version', value: version) metadata(name: 'package.file.name', value: distArchive.archiveName) } upload(bucketName: 'dist.springframework.org', file: "${distArchive.archivePath}.sha1", - toFile: releaseType + "/AMQP/${distArchive.archiveName}.sha1", publicRead: 'true') + toFile: releaseType + "/${rootProject.abbreviation}/${distArchive.archiveName}.sha1", publicRead: 'true') } } } diff --git a/gradle/maven-deployment.gradle b/gradle/maven-deployment.gradle index 5f9b4165b1..2b45990a6a 100644 --- a/gradle/maven-deployment.gradle +++ b/gradle/maven-deployment.gradle @@ -39,6 +39,9 @@ task sourceJar(type: Jar) { } build.dependsOn sourceJar +jar.destinationDir = project.libsBinDir +sourceJar.destinationDir = project.libsSrcDir + // Add the source jar archive to the set of artifacts for this project. // Note that the regular 'jar' archive is already added by default. artifacts { @@ -91,7 +94,15 @@ uploadArchives { case 'MILESTONE': description += milestoneRepositoryUrl - // fall through and pick up config below + s3credentials = [userName: project.properties.s3AccessKey, passphrase: project.properties.s3SecretAccessKey] + configuration = configurations.deployerJars + repository(url: milestoneRepositoryUrl) { + authentication(s3credentials) + } + snapshotRepository(url: snapshotRepositoryUrl) { + authentication(s3credentials) + } + break; case 'SNAPSHOT': description += snapshotRepositoryUrl diff --git a/settings.gradle b/settings.gradle index 3b503057ef..cbb72884fa 100644 --- a/settings.gradle +++ b/settings.gradle @@ -14,6 +14,7 @@ * limitations under the License. */ +include 'docs' include 'spring-integration-core' include 'spring-integration-event' include 'spring-integration-feed' diff --git a/src/docbkx/resources/xsl/fopdf.xsl b/src/docbkx/resources/xsl/fopdf.xsl deleted file mode 100644 index b1fbf5dcdb..0000000000 --- a/src/docbkx/resources/xsl/fopdf.xsl +++ /dev/null @@ -1,418 +0,0 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Copyright © 2005-2010 - - - , - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -5em - -5em - - - - - - - - - - - Spring-Integration ( - - ) - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 1 - 0 - 1 - - 1 - - - - - - book toc - - - - 2 - - - - - - - - - - 0 - 0 - 0 - - - 5mm - 10mm - 10mm - - 15mm - 10mm - 0mm - - 18mm - 18mm - - - 0pc - - - - - justify - false - - - 11 - 8 - - - 1.4 - - - - - - - 0.8em - - - - - - 17.4cm - - - - 4pt - 4pt - 4pt - 4pt - - - - 0.1pt - 0.1pt - - - - - 1 - - - - - - - - left - bold - - - pt - - - - - - - - - - - - - - - 0.8em - 0.8em - 0.8em - - - pt - - 0.1em - 0.1em - 0.1em - - - 0.6em - 0.6em - 0.6em - - - pt - - 0.1em - 0.1em - 0.1em - - - 0.4em - 0.4em - 0.4em - - - pt - - 0.1em - 0.1em - 0.1em - - - - - bold - - - pt - - false - 0.4em - 0.6em - 0.8em - - - - - - - - - pt - - - - - 1em - 1em - 1em - #444444 - solid - 0.1pt - 0.5em - 0.5em - 0.5em - 0.5em - 0.5em - 0.5em - - - - 1 - - #F0F0F0 - - - - - - 0 - 1 - - - 90 - - - - - '1' - - - - - - - figure after - example before - equation before - table before - procedure before - - - - 1 - - - - 0.8em - 0.8em - 0.8em - 0.1em - 0.1em - 0.1em - - - - - - - - - - - - - - - - - diff --git a/src/docbkx/resources/xsl/html.xsl b/src/docbkx/resources/xsl/html.xsl deleted file mode 100644 index aa7930bab8..0000000000 --- a/src/docbkx/resources/xsl/html.xsl +++ /dev/null @@ -1,91 +0,0 @@ - - - - - - - - - html.css - - - 1 - 0 - 1 - 0 - - - - - - book toc - - - - 3 - - - - - 1 - - - - - - - 0 - - - 90 - - - - - 0 - - - - - figure after - example before - equation before - table before - procedure before - - - - , - - - - - - - - -

- - - diff --git a/src/docbkx/resources/xsl/html/titlepage.xml b/src/docbkx/resources/xsl/html/titlepage.xml deleted file mode 100644 index 09539c068c..0000000000 --- a/src/docbkx/resources/xsl/html/titlepage.xml +++ /dev/null @@ -1,61 +0,0 @@ - - - - - - - - - - - - - <subtitle/> - <!-- <corpauthor/> - <authorgroup/> - <author/> - <mediaobject/> --> - <othercredit/> - <releaseinfo/> - <copyright/> - <legalnotice/> - <pubdate/> - <revision/> - <revhistory/> - <abstract/> - </t:titlepage-content> - - <t:titlepage-content t:side="verso"> - </t:titlepage-content> - - <t:titlepage-separator> - <hr/> - </t:titlepage-separator> - - <t:titlepage-before t:side="recto"> - </t:titlepage-before> - - <t:titlepage-before t:side="verso"> - </t:titlepage-before> -</t:titlepage> - -</t:templates> diff --git a/src/docbkx/resources/xsl/html_chunk.xsl b/src/docbkx/resources/xsl/html_chunk.xsl deleted file mode 100644 index 59016d819a..0000000000 --- a/src/docbkx/resources/xsl/html_chunk.xsl +++ /dev/null @@ -1,208 +0,0 @@ -<?xml version="1.0" encoding="utf-8"?> -<!-- - This is the XSL HTML configuration file for the Spring Reference Documentation. ---> -<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" - xmlns:fo="http://www.w3.org/1999/XSL/Format" - version="1.0"> - - <xsl:import href="urn:docbkx:stylesheet"/> - <!--################################################### - HTML Settings - ################################################### --> - <xsl:param name="chunk.section.depth">'5'</xsl:param> - <xsl:param name="use.id.as.filename">'1'</xsl:param> - <!-- These extensions are required for table printing and other stuff --> - <xsl:param name="use.extensions">1</xsl:param> - <xsl:param name="tablecolumns.extension">0</xsl:param> - <xsl:param name="callout.extensions">1</xsl:param> - <xsl:param name="graphicsize.extension">0</xsl:param> - <!--################################################### - Table Of Contents - ################################################### --> - <!-- Generate the TOCs for named components only --> - <xsl:param name="generate.toc"> - book toc - </xsl:param> - <!-- Show only Sections up to level 3 in the TOCs --> - <xsl:param name="toc.section.depth">3</xsl:param> - <!--################################################### - Labels - ################################################### --> - <!-- Label Chapters and Sections (numbering) --> - <xsl:param name="chapter.autolabel">1</xsl:param> - <xsl:param name="section.autolabel" select="1"/> - <xsl:param name="section.label.includes.component.label" select="1"/> - <!--################################################### - Callouts - ################################################### --> - <!-- Place callout marks at this column in annotated areas --> - <xsl:param name="callout.graphics">1</xsl:param> - <xsl:param name="callout.defaultcolumn">90</xsl:param> - <!--################################################### - Misc - ################################################### --> - <!-- Placement of titles --> - <xsl:param name="formal.title.placement"> - figure after - example before - equation before - table before - procedure before - </xsl:param> - <xsl:template match="author" mode="titlepage.mode"> - <xsl:if test="name(preceding-sibling::*[1]) = 'author'"> - <xsl:text>, </xsl:text> - </xsl:if> - <span class="{name(.)}"> - <xsl:call-template name="person.name"/> - <xsl:apply-templates mode="titlepage.mode" select="./contrib"/> - <xsl:apply-templates mode="titlepage.mode" select="./affiliation"/> - </span> - </xsl:template> - <xsl:template match="authorgroup" mode="titlepage.mode"> - <div class="{name(.)}"> - <h2>Authors</h2> - <p/> - <xsl:apply-templates mode="titlepage.mode"/> - </div> - </xsl:template> - <!--################################################### - Headers and Footers - ################################################### --> - <!-- let's have a Spring and SpringSource banner across the top of each page --> - <xsl:template name="user.header.navigation"> - <div style="background-color:white;border:none;height:73px;border:1px solid black;"> - <a style="border:none;" href="http://static.springframework.org/spring-ws/site/" - title="The Spring Framework - Spring Web Services"> - <img style="border:none;" src="images/xdev-spring_logo.jpg"/> - </a> - <a style="border:none;" href="http://www.springsource.com/" title="SpringSource"> - <img style="border:none;position:absolute;padding-top:5px;right:42px;" src="images/s2_box_logo.png"/> - </a> - </div> - </xsl:template> - <!-- no other header navigation (prev, next, etc.) --> - <xsl:template name="header.navigation"/> - <xsl:param name="navig.showtitles">1</xsl:param> - <!-- let's have a 'Sponsored by SpringSource' strapline (or somesuch) across the bottom of each page --> - <xsl:template name="footer.navigation"> - <xsl:param name="prev" select="/foo"/> - <xsl:param name="next" select="/foo"/> - <xsl:param name="nav.context"/> - <xsl:variable name="home" select="/*[1]"/> - <xsl:variable name="up" select="parent::*"/> - <xsl:variable name="row1" select="count($prev) > 0 - or count($up) > 0 - or count($next) > 0"/> - <xsl:variable name="row2" select="($prev and $navig.showtitles != 0) - or (generate-id($home) != generate-id(.) - or $nav.context = 'toc') - or ($chunk.tocs.and.lots != 0 - and $nav.context != 'toc') - or ($next and $navig.showtitles != 0)"/> - <xsl:if test="$suppress.navigation = '0' and $suppress.footer.navigation = '0'"> - <div class="navfooter"> - <xsl:if test="$footer.rule != 0"> - <hr/> - </xsl:if> - <xsl:if test="$row1 or $row2"> - <table width="100%" summary="Navigation footer"> - <xsl:if test="$row1"> - <tr> - <td width="40%" align="left"> - <xsl:if test="count($prev)>0"> - <a accesskey="p"> - <xsl:attribute name="href"> - <xsl:call-template name="href.target"> - <xsl:with-param name="object" select="$prev"/> - </xsl:call-template> - </xsl:attribute> - <xsl:call-template name="navig.content"> - <xsl:with-param name="direction" select="'prev'"/> - </xsl:call-template> - </a> - </xsl:if> - <xsl:text> </xsl:text> - </td> - - <td width="20%" align="center"> - <xsl:choose> - <xsl:when test="$home != . or $nav.context = 'toc'"> - <a accesskey="h"> - <xsl:attribute name="href"> - <xsl:call-template name="href.target"> - <xsl:with-param name="object" select="$home"/> - </xsl:call-template> - </xsl:attribute> - <xsl:call-template name="navig.content"> - <xsl:with-param name="direction" select="'home'"/> - </xsl:call-template> - </a> - <xsl:if test="$chunk.tocs.and.lots != 0 and $nav.context != 'toc'"> - <xsl:text> | </xsl:text> - </xsl:if> - </xsl:when> - <xsl:otherwise> </xsl:otherwise> - </xsl:choose> - <xsl:if test="$chunk.tocs.and.lots != 0 and $nav.context != 'toc'"> - <a accesskey="t"> - <xsl:attribute name="href"> - <xsl:apply-templates select="/*[1]" mode="recursive-chunk-filename"> - <xsl:with-param name="recursive" select="true()"/> - </xsl:apply-templates> - <xsl:text>-toc</xsl:text> - <xsl:value-of select="$html.ext"/> - </xsl:attribute> - <xsl:call-template name="gentext"> - <xsl:with-param name="key" select="'nav-toc'"/> - </xsl:call-template> - </a> - </xsl:if> - </td> - <td width="40%" align="right"> - <xsl:text> </xsl:text> - <xsl:if test="count($next)>0"> - <a accesskey="n"> - <xsl:attribute name="href"> - <xsl:call-template name="href.target"> - <xsl:with-param name="object" select="$next"/> - </xsl:call-template> - </xsl:attribute> - <xsl:call-template name="navig.content"> - <xsl:with-param name="direction" select="'next'"/> - </xsl:call-template> - </a> - </xsl:if> - </td> - </tr> - </xsl:if> - <xsl:if test="$row2"> - <tr> - <td width="40%" align="left" valign="top"> - <xsl:if test="$navig.showtitles != 0"> - <xsl:apply-templates select="$prev" mode="object.title.markup"/> - </xsl:if> - <xsl:text> </xsl:text> - </td> - <td width="20%" align="center"> - <span style="color:white;font-size:90%;"> - <a href="http://www.springsource.com/" - title="SpringSource">Sponsored by SpringSource - </a> - </span> - </td> - <td width="40%" align="right" valign="top"> - <xsl:text> </xsl:text> - <xsl:if test="$navig.showtitles != 0"> - <xsl:apply-templates select="$next" mode="object.title.markup"/> - </xsl:if> - </td> - </tr> - </xsl:if> - </table> - </xsl:if> - </div> - </xsl:if> - </xsl:template> -</xsl:stylesheet> diff --git a/src/docbkx/resources/xsl/pdf/fopdf.xsl b/src/docbkx/resources/xsl/pdf/fopdf.xsl deleted file mode 100644 index 2905ee3c21..0000000000 --- a/src/docbkx/resources/xsl/pdf/fopdf.xsl +++ /dev/null @@ -1,518 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> - -<!-- - Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> - -<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" - xmlns:fo="http://www.w3.org/1999/XSL/Format" - xmlns:xslthl="http://xslthl.sf.net" - exclude-result-prefixes="xslthl" - version='1.0'> - -<!-- Use nice graphics for admonitions --> - <xsl:param name="admon.graphics">'1'</xsl:param> - <xsl:param name="admon.graphics.path">@file.prefix@@dbf.xsl@/images/</xsl:param> - <xsl:param name="draft.watermark.image" select="'@file.prefix@@dbf.xsl@/images/draft.png'"/> - <xsl:param name="paper.type" select="'@paper.type@'"/> - - <xsl:param name="page.margin.top" select="'1cm'"/> - <xsl:param name="region.before.extent" select="'1cm'"/> - <xsl:param name="body.margin.top" select="'1.5cm'"/> - - <xsl:param name="body.margin.bottom" select="'1.5cm'"/> - <xsl:param name="region.after.extent" select="'1cm'"/> - <xsl:param name="page.margin.bottom" select="'1cm'"/> - <xsl:param name="title.margin.left" select="'0cm'"/> - -<!--################################################### - Header - ################################################### --> - -<!-- More space in the center header for long text --> - <xsl:attribute-set name="header.content.properties"> - <xsl:attribute name="font-family"> - <xsl:value-of select="$body.font.family"/> - </xsl:attribute> - <xsl:attribute name="margin-left">-5em</xsl:attribute> - <xsl:attribute name="margin-right">-5em</xsl:attribute> - </xsl:attribute-set> - -<!--################################################### - Table of Contents - ################################################### --> - - <xsl:param name="generate.toc"> - book toc,title - </xsl:param> - -<!--################################################### - Custom Header - ################################################### --> - - <xsl:template name="header.content"> - <xsl:param name="pageclass" select="''"/> - <xsl:param name="sequence" select="''"/> - <xsl:param name="position" select="''"/> - <xsl:param name="gentext-key" select="''"/> - - <xsl:variable name="Version"> - <xsl:choose> - <xsl:when test="//productname"> - <xsl:value-of select="//productname"/><xsl:text> </xsl:text> - </xsl:when> - <xsl:otherwise> - <xsl:text>please define productname in your docbook file!</xsl:text> - </xsl:otherwise> - </xsl:choose> - </xsl:variable> - - <xsl:choose> - <xsl:when test="$sequence='blank'"> - <xsl:choose> - <xsl:when test="$position='center'"> - <xsl:value-of select="$Version"/> - </xsl:when> - - <xsl:otherwise> - <!-- nop --> - </xsl:otherwise> - </xsl:choose> - </xsl:when> - - <xsl:when test="$pageclass='titlepage'"> - <!-- nop: other titlepage sequences have no header --> - </xsl:when> - - <xsl:when test="$position='center'"> - <xsl:value-of select="$Version"/> - </xsl:when> - - <xsl:otherwise> - <!-- nop --> - </xsl:otherwise> - </xsl:choose> - </xsl:template> - -<!--################################################### - Custom Footer - ################################################### --> - - <xsl:template name="footer.content"> - <xsl:param name="pageclass" select="''"/> - <xsl:param name="sequence" select="''"/> - <xsl:param name="position" select="''"/> - <xsl:param name="gentext-key" select="''"/> - - <xsl:variable name="Version"> - <xsl:choose> - <xsl:when test="//releaseinfo"> - <xsl:value-of select="//releaseinfo"/> - </xsl:when> - <xsl:otherwise> - <!-- nop --> - </xsl:otherwise> - </xsl:choose> - </xsl:variable> - - <xsl:variable name="Title"> - <xsl:value-of select="//title"/> - </xsl:variable> - - <xsl:choose> - <xsl:when test="$sequence='blank'"> - <xsl:choose> - <xsl:when test="$double.sided != 0 and $position = 'left'"> - <xsl:value-of select="$Version"/> - </xsl:when> - - <xsl:when test="$double.sided = 0 and $position = 'center'"> - <!-- nop --> - </xsl:when> - - <xsl:otherwise> - <fo:page-number/> - </xsl:otherwise> - </xsl:choose> - </xsl:when> - - <xsl:when test="$pageclass='titlepage'"> - <!-- nop: other titlepage sequences have no footer --> - </xsl:when> - - <xsl:when test="$double.sided != 0 and $sequence = 'even' and $position='left'"> - <fo:page-number/> - </xsl:when> - - <xsl:when test="$double.sided != 0 and $sequence = 'odd' and $position='right'"> - <fo:page-number/> - </xsl:when> - - <xsl:when test="$double.sided = 0 and $position='right'"> - <fo:page-number/> - </xsl:when> - - <xsl:when test="$double.sided != 0 and $sequence = 'odd' and $position='left'"> - <xsl:value-of select="$Version"/> - </xsl:when> - - <xsl:when test="$double.sided != 0 and $sequence = 'even' and $position='right'"> - <xsl:value-of select="$Version"/> - </xsl:when> - - <xsl:when test="$double.sided = 0 and $position='left'"> - <xsl:value-of select="$Version"/> - </xsl:when> - - <xsl:when test="$position='center'"> - <xsl:value-of select="$Title"/> - </xsl:when> - - <xsl:otherwise> - <!-- nop --> - </xsl:otherwise> - </xsl:choose> - </xsl:template> - - <xsl:template match="processing-instruction('hard-pagebreak')"> - <fo:block break-before='page'/> - </xsl:template> - -<!--################################################### - Extensions - ################################################### --> - -<!-- These extensions are required for table printing and other stuff --> - <xsl:param name="use.extensions">1</xsl:param> - <xsl:param name="tablecolumns.extension">0</xsl:param> - <xsl:param name="callout.extensions">1</xsl:param> - <xsl:param name="fop.extensions">1</xsl:param> - -<!--################################################### - Paper & Page Size - ################################################### --> - -<!-- Paper type, no headers on blank pages, no double sided printing --> - <xsl:param name="double.sided">0</xsl:param> - <xsl:param name="headers.on.blank.pages">0</xsl:param> - <xsl:param name="footers.on.blank.pages">0</xsl:param> - -<!--################################################### - Fonts & Styles - ################################################### --> - - <xsl:param name="hyphenate">false</xsl:param> - -<!-- Default Font size --> - <xsl:param name="body.font.master">11</xsl:param> - <xsl:param name="body.font.small">8</xsl:param> - -<!-- Line height in body text --> - <xsl:param name="line-height">1.4</xsl:param> - -<!-- Chapter title size --> - <xsl:attribute-set name="chapter.titlepage.recto.style"> - <xsl:attribute name="text-align">left</xsl:attribute> - <xsl:attribute name="font-weight">bold</xsl:attribute> - <xsl:attribute name="font-size"> - <xsl:value-of select="$body.font.master * 1.8"/> - <xsl:text>pt</xsl:text> - </xsl:attribute> - </xsl:attribute-set> - -<!-- Why is the font-size for chapters hardcoded in the XSL FO templates? - Let's remove it, so this sucker can use our attribute-set only... --> - <xsl:template match="title" mode="chapter.titlepage.recto.auto.mode"> - <fo:block xmlns:fo="http://www.w3.org/1999/XSL/Format" - xsl:use-attribute-sets="chapter.titlepage.recto.style"> - <xsl:call-template name="component.title"> - <xsl:with-param name="node" select="ancestor-or-self::chapter[1]"/> - </xsl:call-template> - </fo:block> - </xsl:template> - -<!-- Sections 1, 2 and 3 titles have a small bump factor and padding --> - <xsl:attribute-set name="section.title.level1.properties"> - <xsl:attribute name="space-before.optimum">0.8em</xsl:attribute> - <xsl:attribute name="space-before.minimum">0.8em</xsl:attribute> - <xsl:attribute name="space-before.maximum">0.8em</xsl:attribute> - <xsl:attribute name="font-size"> - <xsl:value-of select="$body.font.master * 1.5"/> - <xsl:text>pt</xsl:text> - </xsl:attribute> - <xsl:attribute name="space-after.optimum">0.1em</xsl:attribute> - <xsl:attribute name="space-after.minimum">0.1em</xsl:attribute> - <xsl:attribute name="space-after.maximum">0.1em</xsl:attribute> - </xsl:attribute-set> - <xsl:attribute-set name="section.title.level2.properties"> - <xsl:attribute name="space-before.optimum">0.6em</xsl:attribute> - <xsl:attribute name="space-before.minimum">0.6em</xsl:attribute> - <xsl:attribute name="space-before.maximum">0.6em</xsl:attribute> - <xsl:attribute name="font-size"> - <xsl:value-of select="$body.font.master * 1.25"/> - <xsl:text>pt</xsl:text> - </xsl:attribute> - <xsl:attribute name="space-after.optimum">0.1em</xsl:attribute> - <xsl:attribute name="space-after.minimum">0.1em</xsl:attribute> - <xsl:attribute name="space-after.maximum">0.1em</xsl:attribute> - </xsl:attribute-set> - <xsl:attribute-set name="section.title.level3.properties"> - <xsl:attribute name="space-before.optimum">0.4em</xsl:attribute> - <xsl:attribute name="space-before.minimum">0.4em</xsl:attribute> - <xsl:attribute name="space-before.maximum">0.4em</xsl:attribute> - <xsl:attribute name="font-size"> - <xsl:value-of select="$body.font.master * 1.0"/> - <xsl:text>pt</xsl:text> - </xsl:attribute> - <xsl:attribute name="space-after.optimum">0.1em</xsl:attribute> - <xsl:attribute name="space-after.minimum">0.1em</xsl:attribute> - <xsl:attribute name="space-after.maximum">0.1em</xsl:attribute> - </xsl:attribute-set> - <xsl:attribute-set name="section.title.level4.properties"> - <xsl:attribute name="space-before.optimum">0.3em</xsl:attribute> - <xsl:attribute name="space-before.minimum">0.3em</xsl:attribute> - <xsl:attribute name="space-before.maximum">0.3em</xsl:attribute> - <xsl:attribute name="font-size"> - <xsl:value-of select="$body.font.master * 0.9"/> - <xsl:text>pt</xsl:text> - </xsl:attribute> - <xsl:attribute name="space-after.optimum">0.1em</xsl:attribute> - <xsl:attribute name="space-after.minimum">0.1em</xsl:attribute> - <xsl:attribute name="space-after.maximum">0.1em</xsl:attribute> - </xsl:attribute-set> - -<!-- Use code syntax highlighting --> - <xsl:param name="highlight.source" select="1"/> - <xsl:param name="highlight.default.language" select="xml" /> - - <xsl:template match='xslthl:keyword'> - <fo:inline font-weight="bold" color="#7F0055"><xsl:apply-templates/></fo:inline> - </xsl:template> - - <xsl:template match='xslthl:comment'> - <fo:inline font-style="italic" color="#3F5F5F"><xsl:apply-templates/></fo:inline> - </xsl:template> - - <xsl:template match='xslthl:oneline-comment'> - <fo:inline font-style="italic" color="#3F5F5F"><xsl:apply-templates/></fo:inline> - </xsl:template> - - <xsl:template match='xslthl:multiline-comment'> - <fo:inline font-style="italic" color="#3F5FBF"><xsl:apply-templates/></fo:inline> - </xsl:template> - - <xsl:template match='xslthl:tag'> - <fo:inline color="#3F7F7F"><xsl:apply-templates/></fo:inline> - </xsl:template> - - <xsl:template match='xslthl:attribute'> - <fo:inline color="#7F007F"><xsl:apply-templates/></fo:inline> - </xsl:template> - - <xsl:template match='xslthl:value'> - <fo:inline color="#2A00FF"><xsl:apply-templates/></fo:inline> - </xsl:template> - - <xsl:template match='xslthl:string'> - <fo:inline color="#2A00FF"><xsl:apply-templates/></fo:inline> - </xsl:template> - -<!--################################################### - Tables - ################################################### --> - - <!-- Some padding inside tables --> - <xsl:attribute-set name="table.cell.padding"> - <xsl:attribute name="padding-left">4pt</xsl:attribute> - <xsl:attribute name="padding-right">4pt</xsl:attribute> - <xsl:attribute name="padding-top">4pt</xsl:attribute> - <xsl:attribute name="padding-bottom">4pt</xsl:attribute> - </xsl:attribute-set> - -<!-- Only hairlines as frame and cell borders in tables --> - <xsl:param name="table.frame.border.thickness">0.1pt</xsl:param> - <xsl:param name="table.cell.border.thickness">0.1pt</xsl:param> - -<!--################################################### - Labels - ################################################### --> - -<!-- Label Chapters and Sections (numbering) --> - <xsl:param name="chapter.autolabel" select="1"/> - <xsl:param name="section.autolabel" select="1"/> - <xsl:param name="section.autolabel.max.depth" select="1"/> - - <xsl:param name="section.label.includes.component.label" select="1"/> - <xsl:param name="table.footnote.number.format" select="'1'"/> - -<!--################################################### - Programlistings - ################################################### --> - -<!-- Verbatim text formatting (programlistings) --> - <xsl:attribute-set name="monospace.verbatim.properties"> - <xsl:attribute name="font-size"> - <xsl:value-of select="$body.font.small * 1.0"/> - <xsl:text>pt</xsl:text> - </xsl:attribute> - </xsl:attribute-set> - - <xsl:attribute-set name="verbatim.properties"> - <xsl:attribute name="space-before.minimum">1em</xsl:attribute> - <xsl:attribute name="space-before.optimum">1em</xsl:attribute> - <xsl:attribute name="space-before.maximum">1em</xsl:attribute> - <xsl:attribute name="space-after.minimum">0.1em</xsl:attribute> - <xsl:attribute name="space-after.optimum">0.1em</xsl:attribute> - <xsl:attribute name="space-after.maximum">0.1em</xsl:attribute> - - <xsl:attribute name="border-color">#444444</xsl:attribute> - <xsl:attribute name="border-style">solid</xsl:attribute> - <xsl:attribute name="border-width">0.1pt</xsl:attribute> - <xsl:attribute name="padding-top">0.5em</xsl:attribute> - <xsl:attribute name="padding-left">0.5em</xsl:attribute> - <xsl:attribute name="padding-right">0.5em</xsl:attribute> - <xsl:attribute name="padding-bottom">0.5em</xsl:attribute> - <xsl:attribute name="margin-left">0.5em</xsl:attribute> - <xsl:attribute name="margin-right">0.5em</xsl:attribute> - </xsl:attribute-set> - - <!-- Shade (background) programlistings --> - <xsl:param name="shade.verbatim">1</xsl:param> - <xsl:attribute-set name="shade.verbatim.style"> - <xsl:attribute name="background-color">#F0F0F0</xsl:attribute> - </xsl:attribute-set> - - <xsl:attribute-set name="list.block.spacing"> - <xsl:attribute name="space-before.optimum">0.1em</xsl:attribute> - <xsl:attribute name="space-before.minimum">0.1em</xsl:attribute> - <xsl:attribute name="space-before.maximum">0.1em</xsl:attribute> - <xsl:attribute name="space-after.optimum">0.1em</xsl:attribute> - <xsl:attribute name="space-after.minimum">0.1em</xsl:attribute> - <xsl:attribute name="space-after.maximum">0.1em</xsl:attribute> - </xsl:attribute-set> - - <xsl:attribute-set name="example.properties"> - <xsl:attribute name="space-before.minimum">0.5em</xsl:attribute> - <xsl:attribute name="space-before.optimum">0.5em</xsl:attribute> - <xsl:attribute name="space-before.maximum">0.5em</xsl:attribute> - <xsl:attribute name="space-after.minimum">0.1em</xsl:attribute> - <xsl:attribute name="space-after.optimum">0.1em</xsl:attribute> - <xsl:attribute name="space-after.maximum">0.1em</xsl:attribute> - <xsl:attribute name="keep-together.within-column">always</xsl:attribute> - </xsl:attribute-set> - -<!--################################################### - Title information for Figures, Examples etc. - ################################################### --> - - <xsl:attribute-set name="formal.title.properties" use-attribute-sets="normal.para.spacing"> - <xsl:attribute name="font-weight">normal</xsl:attribute> - <xsl:attribute name="font-style">italic</xsl:attribute> - <xsl:attribute name="font-size"> - <xsl:value-of select="$body.font.master"/> - <xsl:text>pt</xsl:text> - </xsl:attribute> - <xsl:attribute name="hyphenate">false</xsl:attribute> - <xsl:attribute name="space-before.minimum">0.1em</xsl:attribute> - <xsl:attribute name="space-before.optimum">0.1em</xsl:attribute> - <xsl:attribute name="space-before.maximum">0.1em</xsl:attribute> - </xsl:attribute-set> - -<!--################################################### - Callouts - ################################################### --> - -<!-- don't use images for callouts --> - <xsl:param name="callout.graphics">0</xsl:param> - <xsl:param name="callout.unicode">1</xsl:param> - -<!-- Place callout marks at this column in annotated areas --> - <xsl:param name="callout.defaultcolumn">90</xsl:param> - -<!--################################################### - Misc - ################################################### --> - -<!-- Placement of titles --> - <xsl:param name="formal.title.placement"> - figure after - example after - equation before - table before - procedure before - </xsl:param> - -<!-- Format Variable Lists as Blocks (prevents horizontal overflow) --> - <xsl:param name="variablelist.as.blocks">1</xsl:param> - - <xsl:param name="body.start.indent">0pt</xsl:param> - -<!-- Show only Sections up to level 3 in the TOCs --> - <xsl:param name="toc.section.depth">3</xsl:param> - -<!-- Remove "Chapter" from the Chapter titles... --> - <xsl:param name="local.l10n.xml" select="document('')"/> - <l:i18n xmlns:l="http://docbook.sourceforge.net/xmlns/l10n/1.0"> - <l:l10n language="en"> - <l:context name="title-numbered"> - <l:template name="chapter" text="%n. %t"/> - <l:template name="section" text="%n %t"/> - </l:context> - <l:context name="title"> - <l:template name="example" text="Example %n %t"/> - </l:context> - </l:l10n> - </l:i18n> - -<!--################################################### - colored and hyphenated links - ################################################### --> - - <xsl:template match="ulink"> - <fo:basic-link external-destination="{@url}" - xsl:use-attribute-sets="xref.properties" - text-decoration="underline" - color="blue"> - <xsl:choose> - <xsl:when test="count(child::node())=0"> - <xsl:value-of select="@url"/> - </xsl:when> - <xsl:otherwise> - <xsl:apply-templates/> - </xsl:otherwise> - </xsl:choose> - </fo:basic-link> - </xsl:template> - - <xsl:template match="link"> - <fo:basic-link internal-destination="{@linkend}" - xsl:use-attribute-sets="xref.properties" - text-decoration="underline" - color="blue"> - <xsl:choose> - <xsl:when test="count(child::node())=0"> - <xsl:value-of select="@linkend"/> - </xsl:when> - <xsl:otherwise> - <xsl:apply-templates/> - </xsl:otherwise> - </xsl:choose> - </fo:basic-link> - </xsl:template> - -</xsl:stylesheet> \ No newline at end of file diff --git a/src/docbkx/resources/xsl/pdf/titlepage.xml b/src/docbkx/resources/xsl/pdf/titlepage.xml deleted file mode 100644 index dc18e1e0de..0000000000 --- a/src/docbkx/resources/xsl/pdf/titlepage.xml +++ /dev/null @@ -1,101 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> - -<!-- - Licensed to the Apache Software Foundation (ASF) under one - or more contributor license agreements. See the NOTICE file - distributed with this work for additional information - regarding copyright ownership. The ASF licenses this file - to you under the Apache License, Version 2.0 (the - "License"); you may not use this file except in compliance - with the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, - software distributed under the License is distributed on an - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - KIND, either express or implied. See the License for the - specific language governing permissions and limitations - under the License. ---> - -<!DOCTYPE t:templates [ -<!ENTITY hsize0 "10pt"> -<!ENTITY hsize1 "12pt"> -<!ENTITY hsize2 "14.4pt"> -<!ENTITY hsize3 "17.28pt"> -<!ENTITY hsize4 "20.736pt"> -<!ENTITY hsize5 "24.8832pt"> -<!ENTITY hsize0space "7.5pt"> <!-- 0.75 * hsize0 --> -<!ENTITY hsize1space "9pt"> <!-- 0.75 * hsize1 --> -<!ENTITY hsize2space "10.8pt"> <!-- 0.75 * hsize2 --> -<!ENTITY hsize3space "12.96pt"> <!-- 0.75 * hsize3 --> -<!ENTITY hsize4space "15.552pt"> <!-- 0.75 * hsize4 --> -<!ENTITY hsize5space "18.6624pt"> <!-- 0.75 * hsize5 --> -]> -<t:templates xmlns:t="http://nwalsh.com/docbook/xsl/template/1.0" - xmlns:param="http://nwalsh.com/docbook/xsl/template/1.0/param" - xmlns:fo="http://www.w3.org/1999/XSL/Format" - xmlns:xsl="http://www.w3.org/1999/XSL/Transform"> - - <t:titlepage t:element="book" t:wrapper="fo:block"> - <t:titlepage-content t:side="recto"> - <title - t:named-template="division.title" - param:node="ancestor-or-self::book[1]" - text-align="center" - font-size="&hsize5;" - space-before="&hsize5space;" - font-weight="bold" - font-family="{$title.fontset}"/> - <subtitle - text-align="center" - font-size="&hsize4;" - space-before="&hsize4space;" - font-family="{$title.fontset}"/> - - <!-- <corpauthor space-before="0.5em" - font-size="&hsize2;"/> - <authorgroup space-before="0.5em" - font-size="&hsize2;"/> - <author space-before="0.5em" - font-size="&hsize2;"/> --> - - <mediaobject space-before="2em" space-after="2em"/> - <releaseinfo space-before="5em" font-size="&hsize2;"/> - <copyright space-before="1.5em" - font-weight="normal" - font-size="8"/> - <legalnotice space-before="5em" - font-weight="normal" - font-style="italic" - font-size="8"/> - <othercredit space-before="2em" - font-weight="normal" - font-size="8"/> - <pubdate space-before="0.5em"/> - <revision space-before="0.5em"/> - <revhistory space-before="0.5em"/> - <abstract space-before="0.5em" - text-align="start" - margin-left="0.5in" - margin-right="0.5in" - font-family="{$body.fontset}"/> - </t:titlepage-content> - - <t:titlepage-content t:side="verso"> - </t:titlepage-content> - - <t:titlepage-separator> - </t:titlepage-separator> - - <t:titlepage-before t:side="recto"> - </t:titlepage-before> - - <t:titlepage-before t:side="verso"> - </t:titlepage-before> -</t:titlepage> - -<!-- ==================================================================== --> - -</t:templates>