Author: ruwan
Date: Thu Jun  5 02:59:27 2008
New Revision: 17987
URL: http://wso2.org/svn/browse/wso2?view=rev&revision=17987

Log:
Adding the router mediator documentaion


Modified:
   branches/esb/java/1.7/esb/java/src/site/xdoc/ESB_Configuration_Language.xml

Modified: 
branches/esb/java/1.7/esb/java/src/site/xdoc/ESB_Configuration_Language.xml
URL: 
http://wso2.org/svn/browse/wso2/branches/esb/java/1.7/esb/java/src/site/xdoc/ESB_Configuration_Language.xml?rev=17987&r1=17986&r2=17987&view=diff
==============================================================================
--- branches/esb/java/1.7/esb/java/src/site/xdoc/ESB_Configuration_Language.xml 
(original)
+++ branches/esb/java/1.7/esb/java/src/site/xdoc/ESB_Configuration_Language.xml 
Thu Jun  5 02:59:27 2008
@@ -1091,7 +1091,7 @@
     </p>
     <p>
     </p>
-<pre xml:space="preserve"><a href="#send">send</a> | <a href="#drop">drop</a> 
| <a href="#log">log</a> | <a href="#property">property</a> | <a 
href="#sequence_ref">sequence</a> | <a href="#validate">validate</a> | <a 
href="#makefault">makefault</a> | <a href="#xslt">xslt</a> | <a 
href="#header">header</a> | <a href="#filter">filter</a> | <a 
href="#switch">switch</a> | <a href="#in">in</a> | <a href="#out">out</a>
+<pre xml:space="preserve"><a href="#send">send</a> | <a href="#drop">drop</a> 
| <a href="#log">log</a> | <a href="#property">property</a> | <a 
href="#sequence_ref">sequence</a> | <a href="#validate">validate</a> | <a 
href="#makefault">makefault</a> | <a href="#xslt">xslt</a> | <a 
href="#header">header</a> | <a href="#filter">filter</a> | <a 
href="#switch">switch</a> | <a href="#in">in</a> | <a href="#out">out</a> | <a 
href="#router">router</a>
     | <a href="#dblookup">dblookup</a> | <a href="#dbreport">dbreport</a> | <a 
href="#RMSequence">RMSequence</a> | <a href="#throttle">throttle</a> | <a 
href="#xquery">xquery</a> | <a href="#cache">cache</a> | <a 
href="#clone">clone</a> | <a href="#iterate">iterate</a> | <a 
href="#aggregate">aggregate</a> | <a href="#class">class</a> | <a 
href="#pojoCommand">pojoCommand</a> | <a href="#script">script</a> | <a 
href="#spring">spring</a> </pre>
     <p>
     </p>
@@ -1660,6 +1660,40 @@
       incoming messages would pass through the "&lt;in&gt;" mediators and vice
       versa.
     </p>
+    <h4>
+      <a id="router">Router</a>
+    </h4>
+    <pre xml:space="preserve">&lt;router [continueAfter=(true | false)]&gt;
+  &lt;route expression="xpath" [match="regEx"] [breakRouter=(true | false)]&gt;
+    &lt;target [sequence="string"] [endpoint="string"]&gt;
+      &lt;sequence ....../&gt;?
+      &lt;endpoint ....../&gt;?
+    &lt;/target&gt;
+  &lt;/route&gt;+
+&lt;/router&gt;</pre>
+    <p>
+      Router mediator is represented by the 'router' root tag and it can 
contain any
+      number of routes which are represented with the 'route' tags. Router 
mediator can be
+      configured to continue or to stop the mediation after the routing by 
setting the 'continueAfter'
+      attribute value to be 'true' and 'false' respectively. Each and every 
route must contain
+      an 'expression' attribute which is to specify the XPath over which the 
roting condition
+      is evaluated. Apart from that there can be an optional 'match' attribute 
as well. If both
+      expression and the match attirbutes are specified in a particualr route, 
the evaluated string
+      value of the XPath over the current message will be campared with the 
reular expression
+      provided as the value of the match attribute to see whether this route 
is matching for the
+      current message. Where as if only the expression is specified, presence 
of the element
+      specified by this XPath is considered as the routing condition.
+    </p>
+    <p>
+      One can configure a route to break routing or continue evaluating 
further routes to see
+      any further matchings by setting the 'breakRoute' attribute to 'true' or 
'false'
+      respectively. For all the routes there has to be a 'target' element 
which contains the
+      information about the routing path as a sequence or an endpoint both can 
be inlined as
+      well as refered. If both an endpoint and a sequence is specified message 
will be first
+      mediated through the sequence and sent to the endpoint after mediation. 
Particular target
+      cannot contain an inline sequence and a refered sequence at the same 
time. The same applies
+      to endpoit of the target as well.
+    </p>
     <p>
     </p>
     <p/>

_______________________________________________
Esb-java-dev mailing list
[email protected]
http://wso2.org/cgi-bin/mailman/listinfo/esb-java-dev

Reply via email to