Author: supun Date: Wed Jul 1 00:58:56 2009 New Revision: 40481 URL: http://wso2.org/svn/browse/wso2?view=rev&revision=40481
Log: updating mediator guide Modified: trunk/esb/java/docs/xdoc/mediator_guide.xml Modified: trunk/esb/java/docs/xdoc/mediator_guide.xml URL: http://wso2.org/svn/browse/wso2/trunk/esb/java/docs/xdoc/mediator_guide.xml?rev=40481&r1=40480&r2=40481&view=diff ============================================================================== --- trunk/esb/java/docs/xdoc/mediator_guide.xml (original) +++ trunk/esb/java/docs/xdoc/mediator_guide.xml Wed Jul 1 00:58:56 2009 @@ -56,7 +56,7 @@ <p>Now let's briefly look at how the mediation framework works. </p> -<h3>How mediators work</h3> +<h3>How does a mediator work?</h3> <p>A mediator is a full powered processing unit in ESB. In run-time it has access to all the parts of ESB along with the current message. Usually a @@ -76,7 +76,7 @@ <li>XSLT Mediator: Do XSLT transformations on messages </li> </ul> -<p>Wide range of usages of mediators is clear from the above few examples.</p> +<p>Wide range usage of mediators is visible through the above few examples.</p> <p>Also mediators are considered as one of the main mechanisms for extending ESB. A user can write a mediator and put it in to ESB. This custom mediator and @@ -86,7 +86,7 @@ <h3>Sequences</h3> <p>Sequence is a List Mediator of the ESB. That means it can hold other -mediators and execute them. It is a part of the core of ESB and ESB message +mediators and execute them. It is a part of the core of ESB and message mediation cannot live without this mediator. When a message is delivered to a sequence, it sends the message through all it's child mediators.</p> @@ -133,15 +133,15 @@ Main Sequence.</p> <p>A sequence can have an error handler. Error handler is again another -sequence. If an error occurs while executing a sequence, it's error handler -will be called. Every sequence has an error handler. If one isn't explicitly -specified, fault sequence will be treated as it's error handler.</p> +sequence. If an error occurs while executing a sequence, its error handler will +be called. Every sequence has an error handler. If one isn't explicitly +specified, fault sequence will be treated as the error handler.</p> <h4>How does a message comes to a mediator?</h4> -<p>are two operational modes in the ESB. They are message mediation and proxy -services. Message mediation is all about mediators. Proxy services can use -message mediation as well.</p> +<p>There are two operational modes in the ESB. They are message mediation and +proxy services. Message mediation is all about mediators. Proxy services can +use message mediation as well.</p> <h4>Message Mediation</h4> @@ -157,12 +157,13 @@ <p>Response message will also go through every child mediator of main sequence</p> -<p>If an error occurs in the main sequence, message will go through main -sequence's fault sequence.</p> +<p>If an error occurs in a sequence, message will go through sequence's fault +sequence.</p> <h4>Proxy Services</h4> -<p>Proxy service can have 3 sequences</p> +<p>Proxy service can have 3 sequences. Depending on the message path these +three sequences can be executed. All the three sequences are optional.</p> <ol> <li>In Sequence : A request message coming to a proxy service will go through this sequence if the sequence is specified.</li> @@ -172,13 +173,13 @@ message will go through this sequence</li> </ol> -<p>As I have mentioned earlier, every sequence is a collection of mediators. A -message delivered to a sequence will go through all its child mediators.</p> +<p>As mentioned earlier, every sequence is a collection of mediators. A message +delivered to a sequence will go through all its child mediators.</p> -<p>WSO2 ESB has a built in sequence editor which helps you to develop/edit sequences. - This <a href="sequence_editor.html">Sequence Editor Guide</a> gives an introduction to the - usage of the sequence editor. Following is the catalog of the built in mediators - of WSO2 ESB.</p> +<p>WSO2 ESB has a built in sequence editor which helps user to develop/edit +sequences. The <a href="sequence_editor.html">Sequence Editor Guide</a> gives +an introduction to the usage of the sequence editor. Following is the catalog +of the built in mediators of WSO2 ESB.</p> <table border="1"> <thead> @@ -191,167 +192,138 @@ <tbody> <tr> <td>Core</td> - <td> - <a href="mediators/send.html">Send</a></td> + <td><a href="mediators/send.html">Send</a></td> <td>Send a message out </td> </tr> <tr> <td></td> - <td> - <a href="mediators/log.html">Log</a> </td> + <td><a href="mediators/log.html">Log</a> </td> <td>Logs a message </td> </tr> <tr> <td></td> - <td> - <a href="mediators/property.html">Property</a> </td> + <td><a href="mediators/property.html">Property</a> </td> <td>Set or remove properties associated with the message </td> </tr> <tr> <td></td> - <td> - <a href="mediators/sequence.html">Sequence</a> </td> + <td><a href="mediators/sequence.html">Sequence</a> </td> <td>Refer a sequence </td> </tr> <tr> <td></td> - <td> - <a href="mediators/event.html">Event</a></td> + <td><a href="mediators/event.html">Event</a></td> <td>Send event notifications to an event source </td> </tr> <tr> <td></td> - <td> - <a href="mediators/drop.html">Drop</a> </td> + <td><a href="mediators/drop.html">Drop</a> </td> <td>Drops a message </td> </tr> <tr> <td>Filter</td> - <td> - <a href="mediators/filter.html">Filter</a> - </td> + <td><a href="mediators/filter.html">Filter</a> </td> <td>Filter a messages using XPath, If else kind of logic </td> </tr> <tr> <td></td> - <td> - <a href="mediators/in-out.html">Out</a> </td> + <td><a href="mediators/in-out.html">Out</a> </td> <td>Inbuilt filter for choosing messages in ESB out path </td> </tr> <tr> <td></td> - <td> - <a href="mediators/in-out.html">In</a></td> + <td><a href="mediators/in-out.html">In</a></td> <td>Inbuilt filter for choosing messages in ESB in path </td> </tr> <tr> <td></td> - <td> - <a href="mediators/switch.html">Swith</a> </td> + <td><a href="mediators/switch.html">Swith</a> </td> <td>Filter messages using XPath, Switch logic </td> </tr> <tr> <td></td> - <td> - <a href="mediators/router.html">Router</a></td> + <td><a href="mediators/router.html">Router</a></td> <td>Route messages based on XPath filtering </td> </tr> <tr> <td></td> - <td> - <a href="mediators/validate.html">Validate</a></td> + <td><a href="mediators/validate.html">Validate</a></td> <td>Schema validation for messages </td> </tr> <tr> <td>Transform </td> - <td> - <a href="mediators/xslt.html">XSLT</a> </td> + <td><a href="mediators/xslt.html">XSLT</a> </td> <td>XSLT transformations</td> </tr> <tr> <td></td> - <td> - <a href="mediators/xquery.html">XQuery</a></td> + <td><a href="mediators/xquery.html">XQuery</a></td> <td>XQuey </td> </tr> <tr> <td></td> - <td> - <a href="mediators/header.html">Header</a> </td> + <td><a href="mediators/header.html">Header</a> </td> <td>Sets or remove SOAP headers </td> </tr> <tr> <td></td> - <td> - <a href="mediators/fault.html">Fault</a> - </td> + <td><a href="mediators/fault.html">Fault</a> </td> <td>Create SOAP Faults </td> </tr> <tr> <td>Advanced </td> - <td> - <a href="mediators/cache.html">Cache</a></td> + <td><a href="mediators/cache.html">Cache</a></td> <td>Evaluate messages based on weather the same message came to the ESB </td> </tr> <tr> <td></td> - <td> - <a href="mediators/clone.html">Clone</a> </td> + <td><a href="mediators/clone.html">Clone</a> </td> <td>Clones a message </td> </tr> <tr> <td></td> - <td> - <a href="mediators/iterate.html">Iterate</a> </td> + <td><a href="mediators/iterate.html">Iterate</a> </td> <td>Splits a message </td> </tr> <tr> <td></td> - <td> - <a href="mediators/aggregate.html">Aggregate</a></td> + <td><a href="mediators/aggregate.html">Aggregate</a></td> <td>Combines messages </td> </tr> <tr> <td></td> - <td> - <a href="mediators/callout.html">Callout</a></td> + <td><a href="mediators/callout.html">Callout</a></td> <td>Blocking web services calls</td> </tr> <tr> <td></td> - <td> - <a href="mediators/transaction.html">Transaction</a></td> + <td><a href="mediators/transaction.html">Transaction</a></td> <td>Executes a set of mediators transactionally </td> </tr> <tr> <td></td> - <td> - <a href="mediators/throttle.html">Throttle</a></td> + <td><a href="mediators/throttle.html">Throttle</a></td> <td>Limit the number of messages </td> </tr> <tr> <td></td> - <td> - <a href="mediators/rmsequence.html">RMSequence</a></td> + <td><a href="mediators/rmsequence.html">RMSequence</a></td> <td>Reliable messaging </td> </tr> <tr> <td></td> - <td> - <a href="mediators/dbreport.html">DBReport</a></td> + <td><a href="mediators/dbreport.html">DBReport</a></td> <td>Writes data to a database </td> </tr> <tr> <td></td> - <td> - <a href="mediators/dblookup.html">DBLookup</a></td> + <td><a href="mediators/dblookup.html">DBLookup</a></td> <td>Retrieve information from a database </td> </tr> <tr> <td></td> - <td> - <a href="mediators/rule.html">Rule</a></td> + <td><a href="mediators/rule.html">Rule</a></td> <td>Executes Rules </td> </tr> <tr> @@ -361,26 +333,22 @@ </tr> <tr> <td>Extension </td> - <td> - <a href="mediators/class.html">Class</a> </td> + <td><a href="mediators/class.html">Class</a> </td> <td>Create and execute a custom mediator</td> </tr> <tr> <td></td> - <td> - <a href="mediators/pojo-command.html">POJOCommand</a> </td> + <td><a href="mediators/pojo-command.html">POJOCommand</a> </td> <td>Executes a custom command </td> </tr> <tr> <td></td> - <td> - <a href="mediators/script.html">Script</a></td> + <td><a href="mediators/script.html">Script</a></td> <td>Executes a mediator written in a Scripting language </td> </tr> <tr> <td></td> - <td> - <a href="mediators/spring.html">Spring</a></td> + <td><a href="mediators/spring.html">Spring</a></td> <td>Create a mediator managed by Spring </td> </tr> </tbody> _______________________________________________ Esb-java-dev mailing list [email protected] https://wso2.org/cgi-bin/mailman/listinfo/esb-java-dev
