svn commit: r759471 - /synapse/trunk/java/src/site/xdoc/Synapse_Configuration_Language.xml

[veithen]

Author: veithen
Date: Sat Mar 28 14:45:44 2009
New Revision: 759471

URL: http://svn.apache.org/viewvc?rev=759471&view=rev
Log:
Updated documentation of the XSLT mediator ('target' attribute and behavior 
when the output methodd is text).

Modified:
    synapse/trunk/java/src/site/xdoc/Synapse_Configuration_Language.xml

Modified: synapse/trunk/java/src/site/xdoc/Synapse_Configuration_Language.xml
URL: 
http://svn.apache.org/viewvc/synapse/trunk/java/src/site/xdoc/Synapse_Configuration_Language.xml?rev=759471&r1=759470&r2=759471&view=diff
==============================================================================
--- synapse/trunk/java/src/site/xdoc/Synapse_Configuration_Language.xml 
(original)
+++ synapse/trunk/java/src/site/xdoc/Synapse_Configuration_Language.xml Sat Mar 
28 14:45:44 2009
@@ -1377,16 +1377,31 @@
     <h4>
       <a name="xslt" id="xslt">XSLT</a>
     </h4>
-<pre xml:space="preserve"> &lt;xslt key="string" [source="xpath"]&gt;
+<pre xml:space="preserve"> &lt;xslt key="string" [source="xpath"] 
[target="string"]&gt;
    &lt;property name="string" (value="literal" | expression="xpath")/&gt;*
-   &lt;feature name="string" value="true| false" /&gt;*
+   &lt;feature name="string" value="true | false" /&gt;*
    &lt;attribute name="string" value="string" /&gt;*
  &lt;/xslt&gt;</pre>
     <p>
       The &lt;xslt&gt; mediator applies the specified XSLT transformation to 
the
       selected element of the current message payload. If the source element is
-      not specified, it defaults to the first child of the soap body. 
Optionally
-      parameters (XSLT) could be passed into the transformations through the
+      not specified, it defaults to the first child of the SOAP body.
+      If no 'target' attribute is specified, the source node will be replaced
+      with the output of the transformation. Otherwise the output will be 
stored in
+      the specified property.
+    </p>
+    <p>
+      If the output method specified by the stylesheet is text (i.e. the 
stylesheet
+      has the following directive: <tt>&lt;xsl:output method="text"/&gt;</tt>),
+      then the output of the transformation is wrapped in an element with name
+      <tt>{http://ws.apache.org/commons/ns/payload}text</tt>. Note that when an
+      element with this name is present as the first child of the SOAP body of 
an
+      outgoing message, the JMS and VFS transports will automatically unwrap 
the
+      content and send it out as plain text. The XSLT mediator can therefore 
be used
+      for integration with systems relying on plain text messages.
+    </p>
+    <p>
+      Stylesheet parameters can be passed into the transformations through the
       'property' elements.
     </p>
     <p>