8.14. Loop

Loop
링크 복사

The loop pattern enables you to process a message multiple times. It is used mainly for testing.

Default mode

Notice by default the loop uses the same exchange throughout the looping. So the result from the previous iteration is used for the next (eg Pipes and Filters). From Camel 2.8 onwards you can enable copy mode instead. See the options table for more details.

Exchange properties
링크 복사

On each loop iteration, two exchange properties are set, which can optionally be read by any processors included in the loop.

Expand

Property	Description
`CamelLoopSize`	Apache Camel 2.0: Total number of loops
`CamelLoopIndex`	Apache Camel 2.0: Index of the current iteration (0 based)

Java DSL examples
링크 복사

The following examples show how to take a request from the direct:x endpoint and then send the message repeatedly to mock:result. The number of loop iterations is specified either as an argument to loop() or by evaluating an expression at run time, where the expression must evaluate to an int (or else a RuntimeCamelException is thrown).

The following example passes the loop count as a constant:

from("direct:a").loop(8).to("mock:result");

from("direct:a").loop(8).to("mock:result");

Copy to Clipboard

Toggle word wrap

The following example evaluates a simple expression to determine the loop count:

from("direct:b").loop(header("loop")).to("mock:result");

from("direct:b").loop(header("loop")).to("mock:result");

Copy to Clipboard

Toggle word wrap

The following example evaluates an XPath expression to determine the loop count:

from("direct:c").loop().xpath("/hello/@times").to("mock:result");

from("direct:c").loop().xpath("/hello/@times").to("mock:result");

Copy to Clipboard

Toggle word wrap

XML configuration example
링크 복사

You can configure the same routes in Spring XML.

The following example passes the loop count as a constant:

<route>
  <from uri="direct:a"/>
  <loop>
    <constant>8</constant>
    <to uri="mock:result"/>
  </loop>
</route>

<route>
  <from uri="direct:a"/>
  <loop>
    <constant>8</constant>
    <to uri="mock:result"/>
  </loop>
</route>

Copy to Clipboard

Toggle word wrap

The following example evaluates a simple expression to determine the loop count:

<route>
  <from uri="direct:b"/>
  <loop>
    <header>loop</header>
    <to uri="mock:result"/>
  </loop>
</route>

<route>
  <from uri="direct:b"/>
  <loop>
    <header>loop</header>
    <to uri="mock:result"/>
  </loop>
</route>

Copy to Clipboard

Toggle word wrap

Using copy mode
링크 복사

Now suppose we send a message to direct:start endpoint containing the letter A. The output of processing this route will be that, each mock:loop endpoint will receive AB as message.

from("direct:start")
     // instruct loop to use copy mode, which mean it will use a copy of the input exchange
     // for each loop iteration, instead of keep using the same exchange all over
     .loop(3).copy()
         .transform(body().append("B"))
         .to("mock:loop")
     .end()
     .to("mock:result");

from("direct:start")
     // instruct loop to use copy mode, which mean it will use a copy of the input exchange
     // for each loop iteration, instead of keep using the same exchange all over
     .loop(3).copy()
         .transform(body().append("B"))
         .to("mock:loop")
     .end()
     .to("mock:result");

Copy to Clipboard

Toggle word wrap

However if we do not enable copy mode then mock:loop will receive AB, ABB, ABBB messages.

from("direct:start")
     // by default loop will keep using the same exchange so on the 2nd and 3rd iteration its
     // the same exchange that was previous used that are being looped all over
     .loop(3)
         .transform(body().append("B"))
         .to("mock:loop")
     .end()
     .to("mock:result");

from("direct:start")
     // by default loop will keep using the same exchange so on the 2nd and 3rd iteration its
     // the same exchange that was previous used that are being looped all over
     .loop(3)
         .transform(body().append("B"))
         .to("mock:loop")
     .end()
     .to("mock:result");

Copy to Clipboard

Toggle word wrap

The equivalent example in XML DSL in copy mode is as follows:

<route>
   <from uri="direct:start"/>
   <!-- enable copy mode for loop eip -->
   <loop copy="true">
     <constant>3</constant>
     <transform>
       <simple>${body}B</simple>
     </transform>
     <to uri="mock:loop"/>
   </loop>
   <to uri="mock:result"/>
 </route>

<route>
   <from uri="direct:start"/>
   <!-- enable copy mode for loop eip -->
   <loop copy="true">
     <constant>3</constant>
     <transform>
       <simple>${body}B</simple>
     </transform>
     <to uri="mock:loop"/>
   </loop>
   <to uri="mock:result"/>
 </route>

Copy to Clipboard

Toggle word wrap

Options
링크 복사

The loop DSL command supports the following options:

Expand

Name	Default Value	Description
`copy`	`false`	Camel 2.8: Whether or not copy mode is used. If `false` then the same Exchange is being used throughout the looping. So the result from the previous iteration will be visible for the next iteration. Instead you can enable copy mode, and then each iteration is restarting with a fresh copy of the input Exchange.

이 콘텐츠는 선택한 언어로 제공되지 않습니다.

Loop
링크 복사

Exchange properties
링크 복사

Java DSL examples
링크 복사

XML configuration example
링크 복사

Using copy mode
링크 복사

Options
링크 복사

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat 소개

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

이 콘텐츠는 선택한 언어로 제공되지 않습니다.

8.14. Loop

Loop링크 복사링크가 클립보드에 복사되었습니다!

Exchange properties링크 복사링크가 클립보드에 복사되었습니다!

Java DSL examples링크 복사링크가 클립보드에 복사되었습니다!

XML configuration example링크 복사링크가 클립보드에 복사되었습니다!

Using copy mode링크 복사링크가 클립보드에 복사되었습니다!

Options링크 복사링크가 클립보드에 복사되었습니다!

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat 소개

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

Loop
링크 복사

Exchange properties
링크 복사

Java DSL examples
링크 복사

XML configuration example
링크 복사

Using copy mode
링크 복사

Options
링크 복사