Author: supun
Date: Mon Feb 7 08:11:54 2011
New Revision: 1067874
URL: http://svn.apache.org/viewvc?rev=1067874&view=rev
Log:
applying patch SYNAPSE-731, thanks Ranga for the contrubution
Added:
synapse/trunk/java/repository/conf/sample/synapse_sample_16.xml
Modified:
synapse/trunk/java/src/site/xdoc/Synapse_Samples.xml
Added: synapse/trunk/java/repository/conf/sample/synapse_sample_16.xml
URL:
http://svn.apache.org/viewvc/synapse/trunk/java/repository/conf/sample/synapse_sample_16.xml?rev=1067874&view=auto
==============================================================================
--- synapse/trunk/java/repository/conf/sample/synapse_sample_16.xml (added)
+++ synapse/trunk/java/repository/conf/sample/synapse_sample_16.xml Mon Feb 7
08:11:54 2011
@@ -0,0 +1,49 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+~ Licensed to the Apache Software Foundation (ASF) under one
+~ or more contributor license agreements. See the NOTICE file
+~ distributed with this work for additional information
+~ regarding copyright ownership. The ASF licenses this file
+~ to you under the Apache License, Version 2.0 (the
+~ "License"); you may not use this file except in compliance
+~ with the License. You may obtain a copy of the License at
+~
+~ http://www.apache.org/licenses/LICENSE-2.0
+~
+~ Unless required by applicable law or agreed to in writing,
+~ software distributed under the License is distributed on an
+~ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+~ KIND, either express or implied. See the License for the
+~ specific language governing permissions and limitations
+~ under the License.
+-->
+
+<!-- Introduction to dynamic and static registry keys -->
+<definitions xmlns="http://synapse.apache.org/ns/2010/04/configuration";>
+
+ <!-- the SimpleURLRegistry allows access to a URL based registry (e.g.
file:/// or http://) -->
+ <registry provider="org.apache.synapse.registry.url.SimpleURLRegistry">
+ <!-- the root property of the simple URL registry helps resolve a
resource URL as root + key -->
+ <parameter
name="root">file:repository/conf/sample/resources/</parameter>
+ <!-- all resources loaded from the URL registry would be cached for
this number of milli seconds -->
+ <parameter name="cachableDuration">15000</parameter>
+ </registry>
+
+
+ <sequence name="main">
+ <in>
+ <!-- define the request processing XSLT resource as a property
value -->
+ <property name="symbol" value="transform/transform.xslt"/>
+ <!-- {} denotes that this key is a dynamic one and it is not a
static key -->
+ <!-- use Xpath expression "get-property()" to evaluate real key
from property -->
+ <xslt key="{get-property('symbol')}"/>
+ </in>
+ <out>
+ <!-- transform the standard response back into the custom format
the client expects -->
+ <!-- the key is looked up in the remote registry using a static
key -->
+ <xslt key="transform/transform_back.xslt"/>
+ </out>
+ <send/>
+ </sequence>
+
+</definitions>
Modified: synapse/trunk/java/src/site/xdoc/Synapse_Samples.xml
URL:
http://svn.apache.org/viewvc/synapse/trunk/java/src/site/xdoc/Synapse_Samples.xml?rev=1067874&r1=1067873&r2=1067874&view=diff
==============================================================================
--- synapse/trunk/java/src/site/xdoc/Synapse_Samples.xml (original)
+++ synapse/trunk/java/src/site/xdoc/Synapse_Samples.xml Mon Feb 7 08:11:54
2011
@@ -142,6 +142,8 @@
<a href="#Sample13">Sample 13: Dual channel invocation through Synapse</a></li>
<li>
<a href="#Sample13">Sample 15: Message Enrichment through Synapse</a></li>
+<li>
+<a href="#Sample16">Sample 16: Introduction to dynamic and static registry
keys</a></li>
</ul></li>
<li>
@@ -955,7 +957,44 @@ Standard dual channel :: Stock price = $
<pre xml:space="preserve">ant stockquote
-Dtrpurl=http://localhost:8280/services/StockQuote</pre>
<p>You can try with different local entries as the source with the correct
target xpath values. </p>
-
+<h2>
+<a name="Sample16" id="Sample16">Sample 16: Introduction to dynamic and static
registry keys</a></h2>
+<pre xml:space="preserve"><definitions
xmlns="http://synapse.apache.org/ns/2010/04/configuration">
+ <!-- the SimpleURLRegistry allows access to a URL based registry (e.g.
file:/// or http://) -->
+ <registry
provider="org.apache.synapse.registry.url.SimpleURLRegistry">
+ <!-- the root property of the simple URL registry helps resolve a
resource URL as root + key -->
+ <parameter
name="root">file:repository/conf/sample/resources/</parameter>
+ <!-- all resources loaded from the URL registry would be cached for
this number of milli seconds -->
+ <parameter
name="cachableDuration">15000</parameter>
+ </registry>
+ <sequence name="main">
+ <in>
+ <!-- define the request processing XSLT resource as a property
value -->
+ <property name="symbol"
value="transform/transform.xslt"
xmlns:m0="http://services.samples"/>
+ <!-- { } denotes that this key is a 'dynamic' one and it is not
a 'static' key -->
+ <!-- use Xpath expression "get-property()" to evaluate real key
from property -->
+ <xslt key="{get-property('symbol')}" />
+ </in>
+ <out>
+ <!-- transform the standard response back into the custom
format the client expects -->
+ <!-- the key is looked up in the remote registry using a
'static' key -->
+ <xslt key="transform/transform_back.xslt"/>
+ </out>
+ <send/>
+ </sequence>
+</definitions></pre>
+
+<p>
+<strong>Objective: Introduction to dynamic and static registry keys</strong>
</p>
+<p>
+<strong>Prerequisites:</strong>
+<br/> Start the Synapse configuration numbered 16: i.e. synapse -sample 16
+<br/> Start the Axis2 server and deploy the SimpleStockQuoteService if not
already done </p>
+<p>This Sample demonstrates the use of dynamic keys with mediators. XSLT
mediator is used as an example for that and deference between static and
dynamic usage of keys are shown with that. </p>
+<p>The first registry resource "transform/transform.xslt" is set as
a property value. Inside the XSLT mediator the local property value is lookup
using the Xpath expression "get-property()". Likewise any Xpath
expression can be enclosed inside "{ }" to denote that it is a
dynamic key. Then the mediator will evaluate the real value for that
expression. </p>
+<p>The second XSLT resource "transform/transform_back.xslt" is used
simply as a static key as usual. It is not included inside "{ }" and
because of the mediator directly use the static value as the key. </p>
+<p>Execute the custom quote client as 'ant stockquote -Dmode=customquote â¦'
and analys the output which is similar to the Sample 8. </p>
+<pre xml:space="preserve">ant stockquote
-Daddurl=http://localhost:9000/services/SimpleStockQuoteService
-Dtrpurl=http://localhost:8280/ -Dmode=customquote</pre>
<h1>
<a name="Endpoints" id="Endpoints">Advanced mediations with endpoints</a> </h1>
