<html>
<head>
<base href="http://cwiki.apache.org/confluence" />
<style type="text/css">
<!--
body, p, td, table, tr, .bodytext, .stepfield {
font-family: Verdana, arial, sans-serif;
font-size: 11px;
line-height: 16px;
color: #000000;
font-weight: normal;
}
#PageContent {
text-align: left;
background-color: #fff;
padding: 0px;
margin: 0px;
padding-bottom:20px;
}
/*
** when this stylesheet is used for the Tiny MCE Wysiwyg editor's edit area, we can't
** use an id=PageContent or class=wiki-content, so we must
** set the body style to that used for PageContent, and p to that used for wiki-content.
*/
body {
margin: 0px;
padding: 0px;
text-align: center;
background-color: #f0f0f0;
}
@media print {
body {
background-color: #fff;
}
}
.monospaceInput {
font:12px monospace
}
.wiki-content p, .commentblock p {
margin: 16px 0px 16px 0px;
padding: 0px;
}
.wiki-content-preview {
padding: 5px;
border-left: 1px solid #3c78b5;
border-right: 1px solid #3c78b5;
}
ul, ol {
margin-top: 2px;
margin-bottom: 2px;
padding-top: 0px;
padding-bottom: 0px;
}
pre {
padding: 0px;
margin-top: 5px;
margin-left: 15px;
margin-bottom: 5px;
margin-right: 5px;
text-align: left;
}
.helpheading {
font-weight: bold;
background-color: #D0D9BD;
border-bottom: 1px solid #3c78b5;
padding: 4px 4px 4px 4px;
margin: 0px;
margin-top: 10px;
}
.helpcontent {
padding: 4px 4px 20px 4px;
background-color: #f5f7f1;
}
.code {
border: 1px dashed #3c78b5;
font-size: 11px;
font-family: Courier;
margin: 10px;
line-height: 13px;
}
.focusedComment {
background: #ffffce;
}
.commentBox, .focusedComment {
padding: 10px;
margin: 5px 0 5px 0;
border: 1px #bbb solid;
}
.codeHeader {
background-color: #f0f0f0;
border-bottom: 1px dashed #3c78b5;
padding: 3px;
text-align: center;
}
.codeContent {
text-align: left;
background-color: #f0f0f0;
padding: 3px;
}
.preformatted {
border: 1px dashed #3c78b5;
font-size: 11px;
font-family: Courier;
margin: 10px;
line-height: 13px;
}
.preformattedHeader {
background-color: #f0f0f0;
border-bottom: 1px dashed #3c78b5;
padding: 3px;
text-align: center;
}
.preformattedContent {
background-color: #f0f0f0;
padding: 3px;
}
.panel {
border: 1px dashed #3c78b5;
margin: 10px;
margin-top: 0px;
}
.panelHeader {
background-color: #f0f0f0;
border-bottom: 1px dashed #3c78b5;
padding: 3px;
text-align: center;
}
.panelContent {
background-color: #f0f0f0;
padding: 5px;
}
.anonymousAlert {
background-color: #f0f0f0;
border: 1px dashed red;
font-size: 11px;
padding: 10px 5px 10px 5px;
margin: 4px;
line-height: 13px;
}
.lockAlert {
background-color: #f0f0f0;
width: 50%;
border: 1px dashed red;
font-size: 11px;
padding: 10px 5px 10px 5px;
margin: 4px;
line-height: 13px;
}
.code-keyword {
color: #000091;
background-color: inherit;
}
.code-object {
color: #910091;
background-color: inherit;
}
.code-quote {
color: #009100;
background-color: inherit;
}
.code-comment {
color: #808080;
background-color: inherit;
}
.code-xml .code-keyword {
color: inherit;
font-weight: bold;
}
.code-tag {
color: #000091;
background-color: inherit;
}
.breadcrumbs {
background-color: #f0f0f0;
border-color: #3c78b5;
border-width: 1px 0px 1px 0px;
border-style: solid;
font-size: 11px;
padding: 3px 0px 3px 0px;
}
.navmenu {
border: 1px solid #ccc;
}
.menuheading {
font-weight: bold;
background-color: #f0f0f0;
border-bottom: 1px solid #3c78b5;
padding: 4px 4px 2px 4px;
}
.menuitems {
padding: 4px 4px 20px 4px;
}
.rightpanel {
border-left: 1px solid #ccc;
border-bottom: 1px solid #ccc;
}
#helpheading {
text-align: left;
font-weight: bold;
background-color: #D0D9BD;
border-bottom: 1px solid #3c78b5;
padding: 4px 4px 4px 4px;
margin: 0px;
}
#helpcontent {
padding: 4px 4px 4px 4px;
background-color: #f5f7f1;
}
.helptab-unselected {
font-weight: bold;
padding: 5px;
background-color: #f5f7f1;
}
.helptab-selected {
font-weight: bold;
background-color: #D0D9BD;
padding: 5px;
}
.helptabs {
margin: 0px;
background-color: #f5f7f1;
padding: 5px;
}
.infopanel-heading {
font-weight: bold;
padding: 4px 0px 2px 0px;
}
.pagebody {
}
.pageheader {
padding: 5px 5px 5px 0px;
border-bottom: 1px solid #3c78b5;
}
.pagetitle {
font-size: 22px;
font-weight: bold;
font-family: Arial, sans-serif;
color: #003366;
}
.newpagetitle {
color: #ccc !important;
}
.steptitle {
font-size: 18px;
font-weight: bold;
font-family: Arial, sans-serif;
color: #003366;
margin-bottom: 7px;
}
.substeptitle {
font-size: 12px;
font-weight: bold;
font-family: Arial, sans-serif;
color: #003366;
margin: 2px 4px 4px 4px;
padding: 2px 4px 1px 4px;
}
.stepdesc {
font-family: Verdana, arial, sans-serif;
font-size: 11px;
line-height: 16px;
font-weight: normal;
color: #666666;
margin-top: 7px;
margin-bottom: 7px;
}
.steplabel {
font-weight: bold;
margin-right: 4px;
color: black;
float: left;
width: 15%;
text-align: right;
}
.stepfield {
background: #f0f0f0;
padding: 5px;
}
.submitButtons{
margin-top:5px;
text-align:right;
}
.formtitle {
font-size: 12px;
font-weight: bold;
font-family: Arial, sans-serif;
color: #003366;
}
.sectionbottom {
border-bottom: 1px solid #3c78b5;
}
.topRow {
border-top: 2px solid #3c78b5;
}
.tabletitle {
font-size: 14px;
font-weight: bold;
font-family: Arial, sans-serif;
padding: 3px 0px 2px 0px;
margin: 8px 4px 2px 0px;
color: #003366;
border-bottom: 2px solid #3c78b5;
}
.pagesubheading {
color: #666666;
font-size: 10px;
padding: 0px 0px 5px 0px;
}
HR {
color: 3c78b5;
height: 1;
}
A:link, A:visited, A:active, A:hover {
color: #003366;
}
h1 A:link, h1 A:visited, h1 A:active {
text-decoration: none;
}
h1 A:hover {
border-bottom: 1px dotted #003366;
}
.wiki-content > :first-child, .commentblock > :first-child {
margin-top: 3px;
}
.logocell {
padding: 10px;
}
input {
font-family: verdana, geneva, arial, sans-serif;
font-size: 11px;
color: #000000;
}
textarea, textarea.editor {
font-family: verdana, geneva, arial, sans-serif;
font-size: 11px;
color: #333333;
}
/* use logoSpaceLink instead.
.spacenametitle {
font: 21px/31px Impact, Arial, Helvetica;
font-weight: 100;
color: #999999;
margin: 0px;
}
.spacenametitle img {
margin: 0 0 -4px 0;
}
.spacenametitle a {
text-decoration: none;
color: #999999;
}
.spacenametitle a:visited {
text-decoration: none;
color: #999999;
}*/
.spacenametitle-printable {
font: 20px/25px Impact, Arial, Helvetica;
font-weight: 100;
color: #999999;
margin: 0px;
}
.spacenametitle-printable a {
text-decoration: none;
color: #999999;
}
.spacenametitle-printable a:visited {
text-decoration: none;
color: #999999;
}
.blogDate {
font-weight: bold;
text-decoration: none;
color: black;
}
.blogSurtitle {
background: #f0f0f0;
border: 1px solid #ddd;
padding: 3px;
margin: 1px 1px 10px 1px;
}
.blogHeading {
font-size: 20px;
line-height: normal;
font-weight: bold;
padding: 0px;
margin: 0px;
}
.blogHeading a {
text-decoration: none;
color: black;
}
.endsection {
align: right;
color: #666666;
margin-top: 10px;
}
.endsectionleftnav {
align: right;
color: #666666;
margin-top: 10px;
}
h1 {
font-size: 24px;
line-height: normal;
font-weight: bold;
background-color: #f0f0f0;
color: #003366;
border-bottom: 1px solid #3c78b5;
padding: 2px;
margin: 36px 0px 4px 0px;
}
h2 {
font-size: 18px;
line-height: normal;
font-weight: bold;
background-color: #f0f0f0;
border-bottom: 1px solid #3c78b5;
padding: 2px;
margin: 27px 0px 4px 0px;
}
h3 {
font-size: 14px;
line-height: normal;
font-weight: bold;
background-color: #f0f0f0;
padding: 2px;
margin: 21px 0px 4px 0px;
}
h4 {
font-size: 12px;
line-height: normal;
font-weight: bold;
background-color: #f0f0f0;
padding: 2px;
margin: 18px 0px 4px 0px;
}
h4.search {
font-size: 12px;
line-height: normal;
font-weight: normal;
background-color: #f0f0f0;
padding: 4px;
margin: 18px 0px 4px 0px;
}
h5 {
font-size: 10px;
line-height: normal;
font-weight: bold;
background-color: #f0f0f0;
padding: 2px;
margin: 14px 0px 4px 0px;
}
h6 {
font-size: 8px;
line-height: normal;
font-weight: bold;
background-color: #f0f0f0;
padding: 2px;
margin: 14px 0px 4px 0px;
}
.smallfont {
font-size: 10px;
}
.descfont {
font-size: 10px;
color: #666666;
}
.smallerfont {
font-size: 9px;
}
.smalltext {
color: #666666;
font-size: 10px;
}
.smalltext a {
color: #666666;
}
.smalltext-blue {
color: #3c78b5;
font-size: 10px;
}
.surtitle {
margin-left: 1px;
margin-bottom: 5px;
font-size: 14px;
color: #666666;
}
/* css hack found here: http://www.fo3nix.pwp.blueyonder.co.uk/tutorials/css/hacks/ */
.navItemOver { font-size: 10px; font-weight: bold; color: #ffffff; background-color: #003366; cursor: hand; voice-family: '\'}\''; voice-family:inherit; cursor: pointer;}
.navItemOver a { color: #ffffff; background-color:#003366; text-decoration: none; }
.navItemOver a:visited { color: #ffffff; background-color:#003366; text-decoration: none; }
.navItemOver a:hover { color: #ffffff; background-color:#003366; text-decoration: none; }
.navItem { font-size: 10px; font-weight: bold; color: #ffffff; background-color: #3c78b5; }
.navItem a { color: #ffffff; text-decoration: none; }
.navItem a:hover { color: #ffffff; text-decoration: none; }
.navItem a:visited { color: #ffffff; text-decoration: none; }
div.padded { padding: 4px; }
div.thickPadded { padding: 10px; }
h3.macrolibrariestitle {
margin: 0px 0px 0px 0px;
}
div.centered { text-align: center; margin: 10px; }
div.centered table {margin: 0px auto; text-align: left; }
.tableview table {
margin: 0;
}
.tableview th {
text-align: left;
color: #003366;
font-size: 12px;
padding: 5px 0px 0px 5px;
border-bottom: 2px solid #3c78b5;
}
.tableview td {
text-align: left;
border-color: #ccc;
border-width: 0px 0px 1px 0px;
border-style: solid;
margin: 0;
padding: 4px 10px 4px 5px;
}
.grid {
margin: 2px 0px 5px 0px;
border-collapse: collapse;
}
.grid th {
border: 1px solid #ccc;
padding: 2px 4px 2px 4px;
background: #f0f0f0;
text-align: center;
}
.grid td {
border: 1px solid #ccc;
padding: 3px 4px 3px 4px;
}
.gridHover {
background-color: #f9f9f9;
}
td.infocell {
background-color: #f0f0f0;
}
.label {
font-weight: bold;
color: #003366;
}
label {
font-weight: bold;
color: #003366;
}
.error {
background-color: #fcc;
}
.errorBox {
background-color: #fcc;
border: 1px solid #c00;
padding: 5px;
margin: 5px;
}
.errorMessage {
color: #c00;
}
.success {
background-color: #dfd;
}
.successBox {
background-color: #dfd;
border: 1px solid #090;
padding: 5px;
margin-top:5px;
margin-bottom:5px;
}
blockquote {
padding-left: 10px;
padding-right: 10px;
margin-left: 5px;
margin-right: 0px;
border-left: 1px solid #3c78b5;
}
table.confluenceTable
{
margin: 5px;
border-collapse: collapse;
}
/* Added as a temporary fix for CONF-4223. The table elements appear to be inheriting the border: none attribute from the sectionMacro class */
table.confluenceTable td.confluenceTd
{
border-width: 1px;
border-style: solid;
border-color: #ccc;
padding: 3px 4px 3px 4px;
}
/* Added as a temporary fix for CONF-4223. The table elements appear to be inheriting the border: none attribute from the sectionMacro class */
table.confluenceTable th.confluenceTh
{
border-width: 1px;
border-style: solid;
border-color: #ccc;
padding: 3px 4px 3px 4px;
background-color: #f0f0f0;
text-align: center;
}
td.confluenceTd
{
border-width: 1px;
border-style: solid;
border-color: #ccc;
padding: 3px 4px 3px 4px;
}
th.confluenceTh
{
border-width: 1px;
border-style: solid;
border-color: #ccc;
padding: 3px 4px 3px 4px;
background-color: #f0f0f0;
text-align: center;
}
DIV.small {
font-size: 9px;
}
H1.pagename {
margin-top: 0px;
}
IMG.inline {}
.loginform {
margin: 5px;
border: 1px solid #ccc;
}
/* The text how the "This is a preview" comment should be shown. */
.previewnote { text-align: center;
font-size: 11px;
color: red; }
/* How the preview content should be shown */
.previewcontent { background: #E0E0E0; }
/* How the system messages should be shown (DisplayMessage.jsp) */
.messagecontent { background: #E0E0E0; }
/* How the "This page has been modified..." -comment should be shown. */
.conflictnote { }
.createlink {
color: maroon;
}
a.createlink {
color: maroon;
}
.templateparameter {
font-size: 9px;
color: darkblue;
}
.diffadded {
background: #ddffdd;
padding: 1px 1px 1px 4px;
border-left: 4px solid darkgreen;
}
.diffdeleted {
color: #999;
background: #ffdddd;
padding: 1px 1px 1px 4px;
border-left: 4px solid darkred;
}
.diffnochange {
padding: 1px 1px 1px 4px;
border-left: 4px solid lightgrey;
}
.differror {
background: brown;
}
.diff {
font-family: lucida console, courier new, fixed-width;
font-size: 12px;
line-height: 14px;
}
.diffaddedchars {
background-color:#99ff99;
font-weight:bolder;
}
.diffremovedchars {
background-color:#ff9999;
text-decoration: line-through;
font-weight:bolder;
}
.greybackground {
background: #f0f0f0
}
.greybox {
border: 1px solid #ddd;
padding: 3px;
margin: 1px 1px 10px 1px;
}
.borderedGreyBox {
border: 1px solid #cccccc;
background-color: #f0f0f0;
padding: 10px;
}
.greyboxfilled {
border: 1px solid #ddd;
background: #f0f0f0;
padding: 3px;
margin: 1px 1px 10px 1px;
}
.navBackgroundBox {
padding: 5px 5px 5px 5px;
font-size: 22px;
font-weight: bold;
font-family: Arial, sans-serif;
color: white;
background: #3c78b5;
text-decoration: none;
}
.previewBoxTop {
background-color: #f0f0f0;
border-width: 1px 1px 0px 1px;
border-style: solid;
border-color: #3c78b5;
padding: 5px;
margin: 5px 0px 0px 0px;
text-align: center;
}
.previewContent {
background-color: #fff;
border-color: #3c78b5;
border-width: 0px 1px 0px 1px;
border-style: solid;
padding: 10px;
margin: 0px;
}
.previewBoxBottom {
background-color: #f0f0f0;
border-width: 0px 1px 1px 1px;
border-style: solid;
border-color: #3c78b5;
padding: 5px;
margin: 0px 0px 5px 0px;
text-align: center;
}
.functionbox {
background-color: #f0f0f0;
border: 1px solid #3c78b5;
padding: 3px;
margin: 1px 1px 10px 1px;
}
.functionbox-greyborder {
background-color: #f0f0f0;
border: 1px solid #ddd;
padding: 3px;
margin: 1px 1px 10px 1px;
}
.search-highlight {
background-color: #ffffcc;
}
/* normal (white) background */
.rowNormal {
background-color: #ffffff;
}
/* alternate (pale yellow) background */
.rowAlternate {
background-color: #f7f7f7;
}
/* used in the list attachments table */
.rowAlternateNoBottomColor {
background-color: #f7f7f7;
}
.rowAlternateNoBottomNoColor {
}
.rowAlternateNoBottomColor td {
border-bottom: 0px;
}
.rowAlternateNoBottomNoColor td {
border-bottom: 0px;
}
/* row highlight (grey) background */
.rowHighlight {
background-color: #f0f0f0;
}
TD.greenbar {FONT-SIZE: 2px; BACKGROUND: #00df00; BORDER: 1px solid #9c9c9c; PADDING: 0px; }
TD.redbar {FONT-SIZE: 2px; BACKGROUND: #df0000; BORDER: 1px solid #9c9c9c; PADDING: 0px; }
TD.darkredbar {FONT-SIZE: 2px; BACKGROUND: #af0000; BORDER: 1px solid #9c9c9c; PADDING: 0px; }
TR.testpassed {FONT-SIZE: 2px; BACKGROUND: #ddffdd; PADDING: 0px; }
TR.testfailed {FONT-SIZE: 2px; BACKGROUND: #ffdddd; PADDING: 0px; }
.toolbar {
margin: 0px;
border-collapse: collapse;
}
.toolbar td {
border: 1px solid #ccc;
padding: 2px 2px 2px 2px;
color: #ccc;
}
td.noformatting {
border-width: 0px;
border-style: none;
text-align: center;
padding: 0px;
}
.commentblock {
margin: 12px 0 12px 0;
}
/*
* Divs displaying the license information, if necessary.
*/
.license-eval, .license-none, .license-nonprofit {
border-top: 1px solid #bbbbbb;
text-align: center;
font-size: 10px;
font-family: Verdana, Arial, Helvetica, sans-serif;
}
.license-eval, .license-none {
background-color: #ffcccc;
}
.license-eval b, .license-none b {
color: #990000
}
.license-nonprofit {
background-color: #ffffff;
}
/*
* The shadow at the bottom of the page between the main content and the
* "powered by" section.
*/
.bottomshadow {
height: 12px;
background-image: url("$req.contextPath/images/border/border_bottom.gif");
background-repeat: repeat-x;
}
/*
* Styling of the operations box
*/
.navmenu .operations li, .navmenu .operations ul {
list-style: none;
margin-left: 0;
padding-left: 0;
}
.navmenu .operations ul {
margin-bottom: 9px;
}
.navmenu .label {
font-weight: inherit;
}
/*
* Styling of ops as a toolbar
*/
.toolbar div {
display: none;
}
.toolbar .label {
display: none;
}
.toolbar .operations {
display: block;
}
.toolbar .operations ul {
display: inline;
list-style: none;
margin-left: 10px;
padding-left: 0;
}
.toolbar .operations li {
list-style: none;
display: inline;
}
/* list page navigational tabs */
#foldertab {
padding: 3px 0px 3px 8px;
margin-left: 0;
border-bottom: 1px solid #3c78b5;
font: bold 11px Verdana, sans-serif;
}
#foldertab li {
list-style: none;
margin: 0;
display: inline;
}
#foldertab li a {
padding: 3px 0.5em;
margin-left: 3px;
border: 1px solid #3c78b5;
border-bottom: none;
background: #3c78b5;
text-decoration: none;
}
#foldertab li a:link { color: #ffffff; }
#foldertab li a:visited { color: #ffffff; }
#foldertab li a:hover {
color: #ffffff;
background: #003366;
border-color: #003366;
}
#foldertab li a.current {
background: white;
border-bottom: 1px solid white;
color: black;
}
#foldertab li a.current:link { color: black; }
#foldertab li a.current:visited { color: black; }
#foldertab li a.current:hover {
background: white;
border-bottom: 1px solid white;
color: black;
}
/* alphabet list */
ul#squaretab {
margin-left: 0;
padding-left: 0;
white-space: nowrap;
font: bold 8px Verdana, sans-serif;
}
#squaretab li {
display: inline;
list-style-type: none;
}
#squaretab a {
padding: 2px 6px;
border: 1px solid #3c78b5;
}
#squaretab a:link, #squaretab a:visited {
color: #fff;
background-color: #3c78b5;
text-decoration: none;
}
#squaretab a:hover {
color: #ffffff;
background-color: #003366;
border-color: #003366;
text-decoration: none;
}
#squaretab li a#current {
background: white;
color: black;
}
.blogcalendar * {
font-family:verdana, arial, sans-serif;
font-size:x-small;
font-weight:normal;
line-height:140%;
padding:2px;
}
table.blogcalendar {
border: 1px solid #3c78b5;
}
.blogcalendar th.calendarhead, a.calendarhead {
font-size:x-small;
font-weight:bold;
padding:2px;
text-transform:uppercase;
background-color: #3c78b5;
color: #ffffff;
letter-spacing: .3em;
text-transform: uppercase;
}
.calendarhead:visited {color: white;}
.calendarhead:active {color: white;}
.calendarhead:hover {color: white;}
.blogcalendar th {
font-size:x-small;
font-weight:bold;
padding:2px;
background-color:#f0f0f0;
}
.blogcalendar td {
font-size:x-small;
font-weight:normal;
}
.searchGroup { padding: 0 0 10px 0; background: #f0f0f0; }
.searchGroupHeading { font-size: 10px; font-weight: bold; color: #ffffff; background-color: #3c78b5; padding: 2px 4px 1px 4px; }
.searchItem { padding: 1px 4px 1px 4px; }
.searchItemSelected { padding: 1px 4px 1px 4px; font-weight: bold; background: #ddd; }
/* permissions page styles */
.permissionHeading {
border-bottom: #bbb; border-width: 0 0 1px 0; border-style: solid; font-size: 16px; text-align: left;
}
.permissionTab {
border-width: 0 0 0 1px; border-style: solid; background: #3c78b5; color: #ffffff; font-size: 10px;
}
.permissionSuperTab {
border-width: 0 0 0 1px; border-style: solid; background: #003366; color: #ffffff;
}
.permissionCell {
border-left: #bbb; border-width: 0 0 0 1px; border-style: solid;
}
/* warning panel */
.warningPanel { background: #FFFFCE; border:#F0C000 1px solid; padding: 8px; margin: 10px; }
/* alert panel */
.alertPanel { background: #FFCCCC; border:#C00 1px solid; padding: 8px; margin: 10px; }
/* info panel */
.infoPanel { background: #D8E4F1; border:#3c78b5 1px solid; padding: 8px; margin: 10px; }
/* side menu highlighting (e.g. space content screen) */
.optionPadded { padding: 2px; }
.optionSelected { background-color: #ffffcc; padding: 2px; border: 1px solid #ddd; margin: -1px; }
.optionSelected a { font-weight: bold; text-decoration: none; color: black; }
/* information macros */
.noteMacro { border-style: solid; border-width: 1px; border-color: #F0C000; background-color: #FFFFCE; text-align:left; margin-top: 5px; margin-bottom: 5px}
.warningMacro { border-style: solid; border-width: 1px; border-color: #c00; background-color: #fcc; text-align:left; margin-top: 5px; margin-bottom: 5px}
.infoMacro { border-style: solid; border-width: 1px; border-color: #3c78b5; background-color: #D8E4F1; text-align:left; margin-top: 5px; margin-bottom: 5px}
.tipMacro { border-style: solid; border-width: 1px; border-color: #090; background-color: #dfd; text-align:left; margin-top: 5px; margin-bottom: 5px}
.informationMacroPadding { padding: 5px 0 0 5px; }
table.infoMacro td, table.warningMacro td, table.tipMacro td, table.noteMacro td, table.sectionMacro td {
border: none;
}
table.sectionMacroWithBorder td.columnMacro { border-style: dashed; border-width: 1px; border-color: #cccccc;}
.pagecontent
{
padding: 10px;
text-align: left;
}
/* styles for links in the top bar */
.topBarDiv a:link {color: #ffffff;}
.topBarDiv a:visited {color: #ffffff;}
.topBarDiv a:active {color: #ffffff;}
.topBarDiv a:hover {color: #ffffff;}
.topBarDiv {color: #ffffff;}
.topBar {
background-color: #003366;
}
/* styles for extended operations */
.greyLinks a:link {color: #666666; text-decoration:underline;}
.greyLinks a:visited {color: #666666; text-decoration:underline;}
.greyLinks a:active {color: #666666; text-decoration:underline;}
.greyLinks a:hover {color: #666666; text-decoration:underline;}
.greyLinks {color: #666666; display:block; padding: 10px}
.logoSpaceLink {color: #999999; text-decoration: none}
.logoSpaceLink a:link {color: #999999; text-decoration: none}
.logoSpaceLink a:visited {color: #999999; text-decoration: none}
.logoSpaceLink a:active {color: #999999; text-decoration: none}
.logoSpaceLink a:hover {color: #003366; text-decoration: none}
/* basic panel (basicpanel.vmd) style */
.basicPanelContainer {border: 1px solid #3c78b5; margin-top: 2px; margin-bottom: 8px; width: 100%}
.basicPanelTitle {padding: 5px; margin: 0px; background-color: #f0f0f0; color: black; font-weight: bold;}
.basicPanelBody {padding: 5px; margin: 0px}
.separatorLinks a:link {color: white}
.separatorLinks a:visited {color: white}
.separatorLinks a:active {color: white}
.greynavbar {background-color: #f0f0f0; border-top: 1px solid #3c78b5; margin-top: 2px}
div.headerField {
float: left;
width: auto;
height: 100%;
}
.headerFloat {
margin-left: auto;
width: 50%;
}
.headerFloatLeft {
float: left;
margin-right: 20px;
margin-bottom: 10px;
}
#headerRow {
padding: 10px;
}
div.license-personal {
background-color: #003366;
color: #ffffff;
}
div.license-personal a {
color: #ffffff;
}
.greyFormBox {
border: 1px solid #cccccc;
padding: 5px;
}
/* IE automatically adds a margin before and after form tags. Use this style to remove that */
.marginlessForm {
margin: 0px;
}
.openPageHighlight {
background-color: #ffffcc;
padding: 2px;
border: 1px solid #ddd;
}
.editPageInsertLinks, .editPageInsertLinks a
{
color: #666666;
font-weight: bold;
font-size: 10px;
}
/* Style for label heatmap. */
.top10 a {
font-weight: bold;
font-size: 2em;
color: #003366;
}
.top25 a {
font-weight: bold;
font-size: 1.6em;
color: #003366;
}
.top50 a {
font-size: 1.4em;
color: #003366;
}
.top100 a {
font-size: 1.2em;
color: #003366;
}
.heatmap {
list-style:none;
width: 95%;
margin: 0px auto;
}
.heatmap a {
text-decoration:none;
}
.heatmap a:hover {
text-decoration:underline;
}
.heatmap li {
display: inline;
}
.minitab {
padding: 3px 0px 3px 8px;
margin-left: 0;
margin-top: 1px;
margin-bottom: 0px;
border-bottom: 1px solid #3c78b5;
font: bold 9px Verdana, sans-serif;
text-decoration: none;
float:none;
}
.selectedminitab {
padding: 3px 0.5em;
margin-left: 3px;
margin-top: 1px;
border: 1px solid #3c78b5;
background: white;
border-bottom: 1px solid white;
color: #000000;
text-decoration: none;
}
.unselectedminitab {
padding: 3px 0.5em;
margin-left: 3px;
margin-top: 1px;
border: 1px solid #3c78b5;
border-bottom: none;
background: #3c78b5;
color: #ffffff;
text-decoration: none;
}
a.unselectedminitab:hover {
color: #ffffff;
background: #003366;
border-color: #003366;
}
a.unselectedminitab:link { color: white; }
a.unselectedminitab:visited { color: white; }
a.selectedminitab:link { color: black; }
a.selectedminitab:visited { color: black; }
.linkerror { background-color: #fcc;}
a.labelOperationLink:link {text-decoration: underline}
a.labelOperationLink:active {text-decoration: underline}
a.labelOperationLink:visited {text-decoration: underline}
a.labelOperationLink:hover {text-decoration: underline}
a.newLabel:link {background-color: #ddffdd}
a.newLabel:active {background-color: #ddffdd}
a.newLabel:visited {background-color: #ddffdd}
a.newLabel:hover {background-color: #ddffdd}
ul.square {list-style-type: square}
.inline-control-link {
background: #ffc;
font-size: 9px;
color: #666;
padding: 2px;
text-transform: uppercase;
text-decoration: none;
}
.inline-control-link a:link {text-decoration: none}
.inline-control-link a:active {text-decoration: none}
.inline-control-link a:visited {text-decoration: none}
.inline-control-link a:hover {text-decoration: none}
.inline-control-link {
background: #ffc;
font-size: 9px;
color: #666;
padding: 2px;
text-transform: uppercase;
text-decoration: none;
cursor: pointer;
}
div.auto_complete {
width: 350px;
background: #fff;
}
div.auto_complete ul {
border: 1px solid #888;
margin: 0;
padding: 0;
width: 100%;
list-style-type: none;
}
div.auto_complete ul li {
margin: 0;
padding: 3px;
}
div.auto_complete ul li.selected {
background-color: #ffb;
}
div.auto_complete ul strong.highlight {
color: #800;
margin: 0;
padding: 0;
}
/******* Edit Page Styles *******/
.toogleFormDiv{
border:1px solid #A7A6AA;
background-color:white;
padding:5px;
margin-top: 5px;
}
.toogleInfoDiv{
border:1px solid #A7A6AA;
background-color:white;
display:none;
padding:5px;
margin-top: 10px;
}
.inputSection{
margin-bottom:20px;
}
#editBox{
border:1px solid lightgray;
background-color:#F0F0F0;
}
/******* Left Navigation Theme Styles ********/
.leftnav li a {
text-decoration:none;
color:white;
margin:0px;
display:block;
padding:2px;
padding-left:5px;
background-color: #3c78b5;
border-top:1px solid #3c78b5;
}
.leftnav li a:active {color:white;}
.leftnav li a:visited {color:white;}
.leftnav li a:hover {background-color: #003366; color:white;}
/* Added by Shaun during i18n */
.replaced
{
background-color: #33CC66;
}
.topPadding
{
margin-top: 20px;
}
/* new form style */
.form-block {
padding: 6px;
}
.form-error-block {
padding: 6px;
background: #fcc;
border-top: #f0f0f0 1px solid;
border-bottom: #f0f0f0 1px solid;
margin-bottom: 6px;
padding: 0 12px 0 12px;
}
.form-element-large {
font-size: 16px;
font-weight: bold;
font-family: Arial, sans-serif;
color: #003366;
}
.form-element-small {
font-size: 12px;
font-weight: bold;
font-family: Arial, sans-serif;
color: #003366;
}
.form-header {
background: lightyellow;
border-top: #f0f0f0 1px solid;
border-bottom: #f0f0f0 1px solid;
margin-bottom: 6px;
padding: 0 12px 0 12px;
}
.form-header p, .form-block p, .form-error-block p {
line-height: normal;
margin: 12px 0 12px 0;
}
.form-example {
color: #888;
font-size: 11px;
}
.form-divider {
border-bottom: #ccc 1px solid;
margin-bottom: 6px;
}
.form-buttons {
margin-top: 6px;
border-top: #ccc 1px solid;
border-bottom: #ccc 1px solid;
background: #f0f0f0;
padding: 10px;
text-align: center;
}
.form-buttons input {
width: 100px;
}
.form-block .error {
padding: 6px;
margin-bottom: 6px;
}
-->
</style>
</head>
<body>
<div id="PageContent">
<table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%"><tr>
<td valign="top" class="pagebody">
<div class="pageheader">
<span class="pagetitle">
Page Edited :
<a href="http://cwiki.apache.org/confluence/display/CAMEL">CAMEL</a> :
<a href="http://cwiki.apache.org/confluence/display/CAMEL/Splitter">Splitter</a>
</span>
</div>
<p>
<a href="http://cwiki.apache.org/confluence/display/CAMEL/Splitter">Splitter</a>
has been edited by <a href="http://cwiki.apache.org/confluence/display/~davsclaus">Claus Ibsen</a>
<span class="smallfont">(Mar 10, 2009)</span>.
</p>
<p>
<a href="http://cwiki.apache.org/confluence/pages/diffpagesbyversion.action?pageId=49410&originalVersion=28&revisedVersion=29">(View changes)</a>
</p>
<span class="label">Content:</span><br/>
<div class="greybox wiki-content"><h3><a name="Splitter-Splitter"></a>Splitter</h3>
<p>The <span class="nobr"><a href="http://www.enterpriseintegrationpatterns.com/Sequencer.html" title="Visit page outside Confluence" rel="nofollow">Splitter<sup><img class="rendericon" src="/confluence/images/icons/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"/></sup></a></span> from the <a href="/confluence/display/CAMEL/Enterprise+Integration+Patterns" title="Enterprise Integration Patterns">EIP patterns</a> allows you split a message into a number of pieces and process them individually</p>
<p><img src="http://www.enterpriseintegrationpatterns.com/img/Sequencer.gif" align="absmiddle" border="0" /></p>
<p>As of Camel 2.0, you need to specify a Splitter as <tt>split()</tt>. In earlier versions of Camel, you need to use <tt>splitter()</tt>.</p>
<h4><a name="Splitter-Example"></a>Example</h4>
<p>The following example shows how to take a request from the <b>queue:a</b> endpoint the split it into pieces using an <a href="/confluence/display/CAMEL/Expression" title="Expression">Expression</a>, then forward each piece to <b>queue:b</b></p>
<p><b>Using the <a href="/confluence/display/CAMEL/Fluent+Builders" title="Fluent Builders">Fluent Builders</a></b></p>
<div class="code"><div class="codeContent">
<pre class="code-java">RouteBuilder builder = <span class="code-keyword">new</span> RouteBuilder() {
<span class="code-keyword">public</span> void configure() {
from(<span class="code-quote">"seda:a"</span>).split(body(<span class="code-object">String</span>.class).tokenize(<span class="code-quote">"\n"</span>)).to(<span class="code-quote">"seda:b"</span>);
}
};</pre>
</div></div>
<p>The splitter can use any <a href="/confluence/display/CAMEL/Expression" title="Expression">Expression</a> language so you could use any of the <a href="/confluence/display/CAMEL/Languages+Supported" title="Languages Supported">Languages Supported</a> such as <a href="/confluence/display/CAMEL/XPath" title="XPath">XPath</a>, <a href="/confluence/display/CAMEL/XQuery" title="XQuery">XQuery</a>, <a href="/confluence/display/CAMEL/SQL" title="SQL">SQL</a> or one of the <a href="/confluence/display/CAMEL/Scripting+Languages" title="Scripting Languages">Scripting Languages</a> to perform the split. e.g.</p>
<div class="code"><div class="codeContent">
<pre class="code-java">from(<span class="code-quote">"activemq:my.queue"</span>).split(xpath(<span class="code-quote">"<span class="code-comment">//foo/bar"</span>)).convertBodyTo(<span class="code-object">String</span>.class).to(<span class="code-quote">"file://some/directory"</span>)</span></pre>
</div></div>
<p><b>Using the <a href="/confluence/display/CAMEL/Spring+XML+Extensions" title="Spring XML Extensions">Spring XML Extensions</a></b></p>
<div class="code"><div class="codeContent">
<pre class="code-xml"><span class="code-tag"><camelContext id=<span class="code-quote">"camel"</span> xmlns=<span class="code-quote">"http://camel.apache.org/schema/spring"</span>></span>
<span class="code-tag"><route></span>
<span class="code-tag"><from uri=<span class="code-quote">"seda:a"</span>/></span>
<span class="code-tag"><split></span>
<span class="code-tag"><xpath></span>/invoice/lineItems<span class="code-tag"></xpath></span>
<span class="code-tag"><to uri=<span class="code-quote">"seda:b"</span>/></span>
<span class="code-tag"></split></span>
<span class="code-tag"></route></span>
<span class="code-tag"></camelContext></span></pre>
</div></div>
<p>For further examples of this pattern in use you could look at one of the <span class="nobr"><a href="http://svn.apache.org/viewvc/camel/trunk/camel-core/src/test/java/org/apache/camel/processor/SplitterTest.java?view=markup" title="Visit page outside Confluence" rel="nofollow">junit test case<sup><img class="rendericon" src="/confluence/images/icons/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"/></sup></a></span></p>
<p><b>Using Tokenizer from <a href="/confluence/display/CAMEL/Spring+XML+Extensions" title="Spring XML Extensions">Spring XML Extensions</a></b><br/>
<b>Avaiaible as of Camel 2.0</b></p>
<p>You can use the tokenizer expression in the Spring DSL to split bodies or headers using a token. This is a common use-case, so we provided a special <b>tokenizer</b> tag for this.<br/>
In the sample below we split the body using a @ as separator. You can of course use comma or space or even a regex pattern, also set regex=true.</p>
<div class="code"><div class="codeContent">
<pre class="code-xml"><span class="code-tag"><camelContext id=<span class="code-quote">"camel"</span> xmlns=<span class="code-quote">"http://camel.apache.org/schema/spring"</span>></span>
<span class="code-tag"><route></span>
<span class="code-tag"><from uri=<span class="code-quote">"direct:start"</span>/></span>
<span class="code-tag"><split></span>
<span class="code-tag"><tokenize token=<span class="code-quote">"@"</span>/></span>
<span class="code-tag"><to uri=<span class="code-quote">"mock:result"</span>/></span>
<span class="code-tag"></split></span>
<span class="code-tag"></route></span>
<span class="code-tag"></camelContext></span></pre>
</div></div>
<h4><a name="Splitter-MessageHeaders"></a>Message Headers</h4>
<p>The following headers is set on each Exchange that are split:</p>
<table class='confluenceTable'><tbody>
<tr>
<th class='confluenceTh'> header </th>
<th class='confluenceTh'> type </th>
<th class='confluenceTh'> description </th>
</tr>
<tr>
<td class='confluenceTd'> <tt>org.apache.camel.splitCounter</tt> </td>
<td class='confluenceTd'> int </td>
<td class='confluenceTd'> Camel 1.x: A split counter that increases for each Exchange being split. The counter starts from 0. </td>
</tr>
<tr>
<td class='confluenceTd'> <tt>org.apache.camel.splitSize</tt> </td>
<td class='confluenceTd'> int </td>
<td class='confluenceTd'> Camel 1.x: The total number of Exchanges that was splitted. This header is not applied for stream based splitting. </td>
</tr>
<tr>
<td class='confluenceTd'> <tt>CamelSplitIndex</tt> </td>
<td class='confluenceTd'> int </td>
<td class='confluenceTd'> Camel 2.0: A split counter that increases for each Exchange being split. The counter starts from 0. </td>
</tr>
<tr>
<td class='confluenceTd'> <tt>CamelSplitSize</tt> </td>
<td class='confluenceTd'> int </td>
<td class='confluenceTd'> Camel 2.0: The total number of Exchanges that was splitted. This header is not applied for stream based splitting. </td>
</tr>
</tbody></table>
<h4><a name="Splitter-Parallelexecutionofdistinct%27parts%27"></a>Parallel execution of distinct 'parts'</h4>
<p>If you want to execute all parts in parallel you can use special notation of <tt>split()</tt> with two arguments, where the second one is a <b>boolean</b> flag if processing should be parallel. e.g.</p>
<div class="code"><div class="codeContent">
<pre class="code-java">XPathBuilder xPathBuilder = <span class="code-keyword">new</span> XPathBuilder(<span class="code-quote">"<span class="code-comment">//foo/bar"</span>);
</span>from(<span class="code-quote">"activemq:my.queue"</span>).split(xPathBuilder, <span class="code-keyword">true</span>).to(<span class="code-quote">"activemq:my.parts"</span>);</pre>
</div></div>
<p>In <b>Camel 2.0</b> the boolean option has been refactored into a builder method <tt>parallelProcessing</tt> so its easier to understand what the route does when we use a method instead of true|false.</p>
<div class="code"><div class="codeContent">
<pre class="code-java">XPathBuilder xPathBuilder = <span class="code-keyword">new</span> XPathBuilder(<span class="code-quote">"<span class="code-comment">//foo/bar"</span>);
</span>from(<span class="code-quote">"activemq:my.queue"</span>).split(xPathBuilder).parallelProcessing().to(<span class="code-quote">"activemq:my.parts"</span>);</pre>
</div></div>
<h4><a name="Splitter-Streambased"></a>Stream based</h4>
<p><b>Available as of Camel 1.5</b></p>
<p>You can split streams by enabling the streaming mode using the <tt>streaming</tt> builder method.</p>
<div class="code"><div class="codeContent">
<pre class="code-java">from(<span class="code-quote">"direct:streaming"</span>).split(body().tokenize(<span class="code-quote">","</span>)).streaming().to(<span class="code-quote">"activemq:my.parts"</span>);</pre>
</div></div>
<h4><a name="Splitter-Specifyingacustomaggregationstrategy"></a>Specifying a custom aggregation strategy </h4>
<p><b>Available as of Camel 2.0</b></p>
<p>This is specified similar to the <a href="/confluence/display/CAMEL/Aggregator" title="Aggregator">Aggregator</a>.</p>
<h4><a name="Splitter-SpecifyingacustomThreadPoolExecutor"></a>Specifying a custom ThreadPoolExecutor</h4>
<p>You can customize the underlying ThreadPoolExecutor used in the parallel splitter. In the Java DSL try something like this:</p>
<div class="code"><div class="codeContent">
<pre class="code-java">XPathBuilder xPathBuilder = <span class="code-keyword">new</span> XPathBuilder(<span class="code-quote">"<span class="code-comment">//foo/bar"</span>);
</span>ThreadPoolExecutor threadPoolExecutor = <span class="code-keyword">new</span> ThreadPoolExecutor(8, 16, 0L, TimeUnit.MILLISECONDS, <span class="code-keyword">new</span> LinkedBlockingQueue());
from(<span class="code-quote">"activemq:my.queue"</span>).split(xPathBuilder, <span class="code-keyword">true</span>, threadPoolExecutor).to(<span class="code-quote">"activemq:my.parts"</span>);</pre>
</div></div>
<p>In the Spring DSL try this:</p>
<p><b>Available as of Camel 1.6.0</b></p>
<div class="code"><div class="codeContent">
<pre class="code-xml"><span class="code-tag"><camelContext id=<span class="code-quote">"camel"</span> xmlns=<span class="code-quote">"http://camel.apache.org/schema/spring"</span>></span>
<span class="code-tag"><route></span>
<span class="code-tag"><from uri=<span class="code-quote">"direct:parallel-custom-pool"</span>/></span>
<span class="code-tag"><split threadPoolExecutorRef=<span class="code-quote">"threadPoolExecutor"</span>></span>
<span class="code-tag"><xpath></span>/invoice/lineItems<span class="code-tag"></xpath></span>
<span class="code-tag"><to uri=<span class="code-quote">"mock:result"</span>/></span>
<span class="code-tag"></split></span>
<span class="code-tag"></route></span>
<span class="code-tag"></camelContext></span>
<!-- There's an easier way of specifying constructor args, just can't remember it
at the moment... old Spring syntax will do for now! -->
<span class="code-tag"><bean id=<span class="code-quote">"threadPoolExecutor"</span> class=<span class="code-quote">"java.util.concurrent.ThreadPoolExecutor"</span>></span>
<span class="code-tag"><constructor-arg index=<span class="code-quote">"0"</span> value=<span class="code-quote">"8"</span>/></span>
<span class="code-tag"><constructor-arg index=<span class="code-quote">"1"</span> value=<span class="code-quote">"16"</span>/></span>
<span class="code-tag"><constructor-arg index=<span class="code-quote">"2"</span> value=<span class="code-quote">"0"</span>/></span>
<span class="code-tag"><constructor-arg index=<span class="code-quote">"3"</span> value=<span class="code-quote">"MILLISECONDS"</span>/></span>
<span class="code-tag"><constructor-arg index=<span class="code-quote">"4"</span>></span><span class="code-tag"><bean class=<span class="code-quote">"java.util.concurrent.LinkedBlockingQueue"</span>/></span><span class="code-tag"></constructor-arg></span>
<span class="code-tag"></bean></span></pre>
</div></div>
<h4><a name="Splitter-UsingaPojotodothesplitting"></a>Using a Pojo to do the splitting</h4>
<p>As the <a href="/confluence/display/CAMEL/Splitter" title="Splitter">Splitter</a> can use any <a href="/confluence/display/CAMEL/Expression" title="Expression">Expression</a> to do the actual splitting we leverage this fact and use a <b>method</b> expression to invoke a <a href="/confluence/display/CAMEL/Bean" title="Bean">Bean</a> to get the splitted parts.<br/>
The <a href="/confluence/display/CAMEL/Bean" title="Bean">Bean</a> should return a value that is iterable such as: <tt>java.util.Collection, java.util.Iterator</tt> or an array. </p>
<p>In the route we define the <a href="/confluence/display/CAMEL/Expression" title="Expression">Expression</a> as a method call to invoke our <a href="/confluence/display/CAMEL/Bean" title="Bean">Bean</a> that we have registered with the id mySplitterBean in the <a href="/confluence/display/CAMEL/Registry" title="Registry">Registry</a>.</p>
<div class="code"><div class="codeContent">
<pre class="code-java">from(<span class="code-quote">"direct:start"</span>)
<span class="code-comment">// here we use a POJO bean mySplitterBean to <span class="code-keyword">do</span> the split of the payload
</span> .split().method(<span class="code-quote">"mySplitterBean"</span>)
.to(<span class="code-quote">"mock:result"</span>);</pre>
</div></div>
<p>And the logic for our <a href="/confluence/display/CAMEL/Bean" title="Bean">Bean</a> is as simple as. Notice we use Camel <a href="/confluence/display/CAMEL/Bean+Binding" title="Bean Binding">Bean Binding</a> to pass in the message body as a String object. </p>
<div class="code"><div class="codeContent">
<pre class="code-java"><span class="code-keyword">public</span> class MySplitterBean {
/**
* The split method returns something that is iteratable such as a java.util.List.
*
* @param body the payload of the incoming message
* @<span class="code-keyword">return</span> a list containing each part splitted
*/
<span class="code-keyword">public</span> List split(<span class="code-object">String</span> body) {
<span class="code-comment">// since <span class="code-keyword">this</span> is based on an unit test you can of couse
</span> <span class="code-comment">// use different logic <span class="code-keyword">for</span> splitting as Camel have out
</span> <span class="code-comment">// of the box support <span class="code-keyword">for</span> splitting a <span class="code-object">String</span> based on comma
</span> <span class="code-comment">// but <span class="code-keyword">this</span> is <span class="code-keyword">for</span> show and tell, since <span class="code-keyword">this</span> is java code
</span> <span class="code-comment">// you have the full power how you like to split your messages
</span> List answer = <span class="code-keyword">new</span> ArrayList();
<span class="code-object">String</span>[] parts = body.split(<span class="code-quote">","</span>);
<span class="code-keyword">for</span> (<span class="code-object">String</span> part : parts) {
answer.add(part);
}
<span class="code-keyword">return</span> answer;
}
}</pre>
</div></div>
<h4><a name="Splitter-Splitaggregaterequest%2Freplysample"></a>Split aggregate request/reply sample</h4>
<p>This sample shows how you can split an <a href="/confluence/display/CAMEL/Exchange" title="Exchange">Exchange</a>, process each splitted message, aggregate and return a combined response to the original caller using request/reply.</p>
<p>The route below illustrates this and how the split supports a <b>aggregationStrategy</b> to hold the in progress processed messages:</p>
<div class="code"><div class="codeContent">
<pre class="code-java"><span class="code-comment">// <span class="code-keyword">this</span> routes starts from the direct:start endpoint
</span><span class="code-comment">// the body is then splitted based on @ separator
</span><span class="code-comment">// the splitter in Camel supports InOut as well and <span class="code-keyword">for</span> that we need
</span><span class="code-comment">// to be able to aggregate what response we need to send back, so we provide our
</span><span class="code-comment">// own strategy with the class MyOrderStrategy.
</span>from(<span class="code-quote">"direct:start"</span>)
.split(body().tokenize(<span class="code-quote">"@"</span>), <span class="code-keyword">new</span> MyOrderStrategy())
<span class="code-comment">// each splitted message is then send to <span class="code-keyword">this</span> bean where we can process it
</span> .to(<span class="code-quote">"bean:MyOrderService?method=handleOrder"</span>)
<span class="code-comment">// <span class="code-keyword">this</span> is important to end the splitter route as we <span class="code-keyword">do</span> not want to <span class="code-keyword">do</span> more routing
</span> <span class="code-comment">// on each splitted message
</span> .end()
<span class="code-comment">// after we have splitted and handled each message we want to send a single combined
</span> <span class="code-comment">// response back to the original caller, so we let <span class="code-keyword">this</span> bean build it <span class="code-keyword">for</span> us
</span> <span class="code-comment">// <span class="code-keyword">this</span> bean will receive the result of the aggregate strategy: MyOrderStrategy
</span> .to(<span class="code-quote">"bean:MyOrderService?method=buildCombinedResponse"</span>)</pre>
</div></div>
<p>And the OrderService bean is as follows:</p>
<div class="code"><div class="codeContent">
<pre class="code-java"><span class="code-keyword">public</span> <span class="code-keyword">static</span> class MyOrderService {
<span class="code-keyword">private</span> <span class="code-keyword">static</span> <span class="code-object">int</span> counter;
/**
* We just handle the order by returning a id line <span class="code-keyword">for</span> the order
*/
<span class="code-keyword">public</span> <span class="code-object">String</span> handleOrder(<span class="code-object">String</span> line) {
<span class="code-keyword">return</span> <span class="code-quote">"(id="</span> + ++counter + <span class="code-quote">",item="</span> + line + <span class="code-quote">")"</span>;
}
/**
* We use the same bean <span class="code-keyword">for</span> building the combined response to send
* back to the original caller
*/
<span class="code-keyword">public</span> <span class="code-object">String</span> buildCombinedResponse(<span class="code-object">String</span> line) {
<span class="code-keyword">return</span> <span class="code-quote">"Response["</span> + line + <span class="code-quote">"]"</span>;
}
}</pre>
</div></div>
<p>And our custom <b>aggregationStrategy</b> that is responsible for holding the in progress aggregated message that after the splitter is ended will be sent to the <b>buildCombinedResponse</b> method for final processing before the combined response can be returned to the waiting caller.</p>
<div class="code"><div class="codeContent">
<pre class="code-java">/**
* This is our own order aggregation strategy where we can control
* how each splitted message should be combined. As we <span class="code-keyword">do</span> not want to
* loos any message we copy from the <span class="code-keyword">new</span> to the old to preserve the
* order lines as <span class="code-object">long</span> we process them
*/
<span class="code-keyword">public</span> <span class="code-keyword">static</span> class MyOrderStrategy <span class="code-keyword">implements</span> AggregationStrategy {
<span class="code-keyword">public</span> Exchange aggregate(Exchange oldExchange, Exchange newExchange) {
<span class="code-comment">// put order together in old exchange by adding the order from <span class="code-keyword">new</span> exchange
</span>
<span class="code-comment">// copy from OUT as we use InOut pattern
</span> <span class="code-object">String</span> orders = oldExchange.getOut().getBody(<span class="code-object">String</span>.class);
<span class="code-object">String</span> newLine = newExchange.getOut().getBody(<span class="code-object">String</span>.class);
<span class="code-comment">// put orders together separating by semi colon
</span> orders = orders + <span class="code-quote">";"</span> + newLine;
<span class="code-comment">// put combined order back on old to preserve it
</span> oldExchange.getOut().setBody(orders);
<span class="code-comment">// <span class="code-keyword">return</span> old as <span class="code-keyword">this</span> is the one that has all the orders gathered until now
</span> <span class="code-keyword">return</span> oldExchange;
}
}</pre>
</div></div>
<p>So lets run the sample and see how it works.<br/>
We send an <a href="/confluence/display/CAMEL/Exchange" title="Exchange">Exchange</a> to the <b>direct:start</b> endpoint containing a IN body with the String value: <tt>A<input type="text" name="variableValues.B" size="12" onkeyup="updateOthers(this)" /> <span class="templateparameter">(B)</span>C</tt>. The flow is:</p>
<div class="code"><div class="codeContent">
<pre class="code-java">HandleOrder: A
HandleOrder: B
Aggregate old orders: (id=1,item=A)
Aggregate <span class="code-keyword">new</span> order: (id=2,item=B)
HandleOrder: C
Aggregate old orders: (id=1,item=A);(id=2,item=B)
Aggregate <span class="code-keyword">new</span> order: (id=3,item=C)
BuildCombinedResponse: (id=1,item=A);(id=2,item=B);(id=3,item=C)
Response to caller: Response[(id=1,item=A);(id=2,item=B);(id=3,item=C)]</pre>
</div></div>
<h4><a name="Splitter-UsingThisPattern"></a>Using This Pattern</h4>
<p>If you would like to use this EIP Pattern then please read the <a href="/confluence/display/CAMEL/Getting+Started" title="Getting Started">Getting Started</a>, you may also find the <a href="/confluence/display/CAMEL/Architecture" title="Architecture">Architecture</a> useful particularly the description of <a href="/confluence/display/CAMEL/Endpoint" title="Endpoint">Endpoint</a> and <a href="/confluence/display/CAMEL/URIs" title="URIs">URIs</a>. Then you could try out some of the <a href="/confluence/display/CAMEL/Examples" title="Examples">Examples</a> first before trying this pattern out.</p></div>
</td></tr></table></div>
<p>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
<td height="12" background="http://cwiki.apache.org/confluence/images/border/border_bottom.gif"><img src="http://cwiki.apache.org/confluence/images/border/spacer.gif" width="1" height="1" border="0"/></td>
</tr>
</table>
<div class="smalltext">
Powered by
<a href="http://www.atlassian.com/software/confluence/default.jsp?clicked=footer" class="smalltext">Atlassian Confluence</a>
(Version: 2.2.9 Build:#527 Sep 07, 2006)
-
<a href="http://jira.atlassian.com/secure/BrowseProject.jspa?id=10470" class="smalltext">Bug/feature request</a><br/>
<br>
<a href="http://cwiki.apache.org/confluence/users/viewnotifications.action">Unsubscribe or edit your notifications preferences</a>
</div>
</body>
</html>
|