Author: hiranya
Date: Thu Dec 22 13:14:20 2011
New Revision: 1222213
URL: http://svn.apache.org/viewvc?rev=1222213&view=rev
Log:
Site updates
Modified:
synapse/trunk/scratch/hiranya/website/src/site/site.xml
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/deployment.xml
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/extending.xml
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/history.xml
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/transports.xml
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/upgrading.xml
Modified: synapse/trunk/scratch/hiranya/website/src/site/site.xml
URL:
http://svn.apache.org/viewvc/synapse/trunk/scratch/hiranya/website/src/site/site.xml?rev=1222213&r1=1222212&r2=1222213&view=diff
==============================================================================
--- synapse/trunk/scratch/hiranya/website/src/site/site.xml (original)
+++ synapse/trunk/scratch/hiranya/website/src/site/site.xml Thu Dec 22 13:14:20
2011
@@ -36,12 +36,14 @@
<item name="Installation Guide"
href="userguide/installation.html"/>
<item name="Quick Start Guide" href="userguide/quick_start.html"/>
<item name="Samples Setup Guide"
href="userguide/samples/setup/index.html"/>
- <item name="Extending the Service Bus"
href="userguide/extending.html"/>
+ <item name="Extending Synapse" href="userguide/extending.html"/>
<item name="Samples Catalog" href="userguide/samples.html"/>
<item name="Configuration Language" href="userguide/config.html"/>
<item name="Upgrading" href="userguide/upgrading.html"/>
<item name="Deployment" href="userguide/deployment.html"/>
<item name="Transport" href="userguide/transports.html"/>
+ <item name="Javadocs" href="apidocs/"/>
+ <item name="FAQ" href="apidocs/"/>
</menu>
<menu name="Developer Resources">
<item name="Checkout the Source"/>
Modified:
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/deployment.xml
URL:
http://svn.apache.org/viewvc/synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/deployment.xml?rev=1222213&r1=1222212&r2=1222213&view=diff
==============================================================================
---
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/deployment.xml
(original)
+++
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/deployment.xml
Thu Dec 22 13:14:20 2011
@@ -19,6 +19,9 @@
-->
<document>
+ <properties>
+ <title>Apache Synapse - Deployment Guide</title>
+ </properties>
<body>
<section name="Contents">
<ul>
Modified:
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/extending.xml
URL:
http://svn.apache.org/viewvc/synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/extending.xml?rev=1222213&r1=1222212&r2=1222213&view=diff
==============================================================================
--- synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/extending.xml
(original)
+++ synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/extending.xml
Thu Dec 22 13:14:20 2011
@@ -21,11 +21,11 @@
<document>
<properties>
- <title>Apache Synapse - Extending the Service Bus</title>
+ <title>Apache Synapse - Extending Synapse</title>
</properties>
<body>
<div id="contentBox">
- <section name="Apache Synapse ESB -
Extending the Service Bus">
+ <section name="Apache Synapse ESB -
Extending Synapse">
<p>
Apache Synapse provides a
number of extension points so that
users can plug-in custom
developed code to extend the
@@ -69,7 +69,6 @@
Interface
</a>
</h4>
- <p></p>
<div class="xmlConf">package
org.apache.synapse;
import ...
@@ -365,7 +364,6 @@ public interface MediatorFactory {
*/
public QName getTagQName();
}</div>
- <p></p>
<h4>
<a class="externalLink"
href="http://svn.apache.org/viewvc/synapse/trunk/java/modules/core/src/main/java/org/apache/synapse/config/xml/MediatorSerializer.java?view=markup";>The
Modified:
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/history.xml
URL:
http://svn.apache.org/viewvc/synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/history.xml?rev=1222213&r1=1222212&r2=1222213&view=diff
==============================================================================
--- synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/history.xml
(original)
+++ synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/history.xml
Thu Dec 22 13:14:20 2011
@@ -19,6 +19,9 @@
-->
<document>
+ <properties>
+ <title>Apache Synapse - Down the Memory Lane</title>
+ </properties>
<body>
<section name="History of Synapse">
<p>
Modified:
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/transports.xml
URL:
http://svn.apache.org/viewvc/synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/transports.xml?rev=1222213&r1=1222212&r2=1222213&view=diff
==============================================================================
---
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/transports.xml
(original)
+++
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/transports.xml
Thu Dec 22 13:14:20 2011
@@ -20,6 +20,9 @@
-->
<document>
+ <properties>
+ <title>Apache Synapse - Transports Catalog</title>
+ </properties>
<body>
<section name="Introduction" id="Introduction">
<p>
Modified:
synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/upgrading.xml
URL:
http://svn.apache.org/viewvc/synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/upgrading.xml?rev=1222213&r1=1222212&r2=1222213&view=diff
==============================================================================
--- synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/upgrading.xml
(original)
+++ synapse/trunk/scratch/hiranya/website/src/site/xdoc/userguide/upgrading.xml
Thu Dec 22 13:14:20 2011
@@ -20,6 +20,9 @@
-->
<document>
+ <properties>
+ <title>Apache Synapse - Upgrading to the Latest Version</title>
+ </properties>
<body>
<section name="Content">
<ul>
@@ -27,7 +30,7 @@
<a
href="#General_comments">General comments</a>
</li>
<li>
- <a
href="#Upgrading_from_1.2_to_2.0.0">Upgrading from 1.2 to 2.0.0</a>
+ <a
href="#Upgrading_from_1.2_to_2.1">Upgrading from 1.2 to 2.1</a>
<ul>
<li>
<a
href="#Configuration_file_vs_multi_XML_configuration">Configuration file vs
multi XML configuration</a>
@@ -89,14 +92,14 @@
</p>
</section>
- <section name="Upgrading from 1.2 to 2.0.0"
id="Upgrading_from_1.2_to_2.0.0">
+ <section name="Upgrading from 1.2 to 2.1"
id="Upgrading_from_1.2_to_2.1">
<subsection name="Configuration file vs multi XML
configuration" id="Configuration_file_vs_multi_XML_configuration">
<p>
In 1.2 you have been using a single synapse.xml file which
resides on the
- repository/conf directory of the distribution, where as on
2.0.0 we have structured
+ repository/conf directory of the distribution, where as on
2.1 we have structured
this into a configuration repository with multiple
directories to have different
artifact types and each and every artifact configuration
to reside on a different
- files inside the desired repository directory. This
repository directory on the 2.0.0
+ files inside the desired repository directory. This
repository directory on the 2.1
release resides in the repository/conf
directory too, and named as synapse-config.
The repository directory structure
inside the synapse-config directory
looks like follows;
@@ -132,7 +135,7 @@
</subsection>
<subsection name="Endpoint URLs for proxy services"
id="Endpoint_URLs_for_proxy_services">
<p>
- In release 2.0.0 the endpoint URLs for
proxy services have changed from
+ In release 2.1 the endpoint URLs for
proxy services have changed from
<tt>/soap</tt> to <tt>/services</tt>.
E.g. <tt>http://localhost:8280/services/StockQuote</tt>
should be used instead of
<tt>http://localhost:8280/soap/StockQuote</tt>.
</p>
@@ -148,22 +151,21 @@
configuration file. In 1.2 the deployer
was configured as follows:
</p>
<div class="xmlConf"><deployer
extension="jar" directory="mediators"
- class="org.apache.synapse.core.axis2.MediatorDeployer"/></div>
+
class="org.apache.synapse.core.axis2.MediatorDeployer"/></div>
<p>
- In 2.0.0 the suggested configuration is:
+ In 2.1 the suggested configuration is:
</p>
<div class="xmlConf"><deployer
extension="xar" directory="extensions"
- class="org.apache.synapse.deployers.ExtensionDeployer"/>
</div>
+ class="org.apache.synapse.deployers.ExtensionDeployer"/>
</div>
<p>
It is possible to have multiple configuration entries for
the extension deployer
with different settings. For example, if you used the
deployer in 1.2 you might
want to have the following configuration:
</p>
<div class="xmlConf"><deployer
extension="jar" directory="mediators"
- class="org.apache.synapse.deployers.ExtensionDeployer"/>
-<deployer extension="xar"
- directory="extensions"
-
class="org.apache.synapse.deployers.ExtensionDeployer"/></div>
+ class="org.apache.synapse.deployers.ExtensionDeployer"/>
+<deployer extension="xar" directory="extensions"
+
class="org.apache.synapse.deployers.ExtensionDeployer"/></div>
</subsection>
<subsection name="JMS transport" id="JMS_transport">
<p>
@@ -182,7 +184,7 @@
top level mediators and a main sequence leading the
synapse to fail to start on
2.x Synapse configuration builder simply ignores the top
level mediators. So you
need to wrap the top level mediators, if there are any,
with the sequence named
- <strong>main</strong> on the new 2.0.0
version.
+ <strong>main</strong> on the new 2.1
version.
</p>
<p>
To further explain this lets have a
look at the following valid configuration bit
@@ -194,7 +196,7 @@
<!-- Send the message to implicit destination -->
<send/>
</definitions></div>
- which needs to be changed to the
following configuration on 2.0.0
+ which needs to be changed to the
following configuration on 2.1
<div class="xmlConf"><definitions
xmlns="http://ws.apache.org/ns/synapse">
<sequence name="main">
@@ -210,7 +212,7 @@
</subsection>
<subsection name="Filter Mediator" id="Filter_Mediator">
<p>
- From 2.0.0 onwards Synapse filter mediator supports the
else close as well, and hence
+ From 2.1 onwards Synapse filter mediator supports the else
close as well, and hence
the filter matching set of mediators
has to be enclosed within a <then> element.
</p>
<p>
@@ -223,7 +225,7 @@
</send>
<drop/>
</filter></div>
- the equivalent configuration for the
2.0.0 release is going to be;
+ the equivalent configuration for the
2.1 release is going to be;
<div class="xmlConf"><filter
source="get-property('To')" regex=".*/StockQuote.*">
<then>
<send>
@@ -255,12 +257,12 @@
<p>
In general it is recommended to run the configuration
through the migration tool
provided with the Synapse 2.x release,
on your synapse 1.2 configuration before
- using it with the 2.0.0.
+ using it with the 2.1.
</p>
<p>
To run the migration tool execute the
synapse-config-migrator.sh by passing the
synapse.xml file location of the
- 1.2 configuration. Which will create
the 2.0.0
+ 1.2 configuration. Which will create
the 2.1
compatible configuration with the .new
suffix. For example;
<pre>sh bin/synapse-config-migrator.sh
synapse-i1.2/repository/conf/synapse.xml</pre>
</p>
@@ -288,7 +290,7 @@
<td>
This was the method
that you have been overwriting on the 1.2 version to
implement a new custom
mediator factory to build the mediator by looking at
- the XML configuration.
On the 2.0.0 version you should be extending the
+ the XML configuration.
On the 2.1 version you should be extending the
<a
href="apidocs/org/apache/synapse/config/xml/AbstractMediatorFactory.html#createSpecificMediator(org.apache.axiom.om.OMElement,%20java.util.Properties)">createSpecificMediator(OMElement,
Properties)</a>
. Note that in the
process of changing the method to be extended, the method
<a
href="apidocs/org/apache/synapse/config/xml/AbstractMediatorFactory.html#createMediator(org.apache.axiom.om.OMElement,%20java.util.Properties)">createMediator</a>
@@ -305,7 +307,7 @@
<td>
This was the method
that you have been overwriting on the 1.2 version to
implement a new custom
mediator serializer to serialize to the XML
- Configuration by walking through the mediator
properties. On the 2.0.0
+ Configuration by walking through the mediator
properties. On the 2.1
version you should be extending the
<a
href="apidocs/org/apache/synapse/config/xml/AbstractMediatorSerializer.html#serializeSpecificMediator(org.apache.synapse.Mediator)">serializeSpecificMediator(Mediator)</a>
. Note that in the
process of changing the method to be extended, the method
