You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@ws.apache.org by ja...@apache.org on 2005/03/02 15:42:19 UTC
cvs commit: ws-site/targets/ws-fx/sandesha/images Sandesha.jpg
jaliya 2005/03/02 06:42:19
Modified: targets/ws-fx/sandesha index.html
Added: targets/ws-fx/sandesha userguide.html
targets/ws-fx/sandesha/images Sandesha.jpg
Log:
User guide is added
Revision Changes Path
1.2 +3 -3 ws-site/targets/ws-fx/sandesha/index.html
Index: index.html
===================================================================
RCS file: /home/cvs/ws-site/targets/ws-fx/sandesha/index.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- index.html 1 Mar 2005 05:53:57 -0000 1.1
+++ index.html 2 Mar 2005 14:42:19 -0000 1.2
@@ -1,9 +1,9 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Apache Sandesha - Apache Sandesha</title><style type="text/css" media="all">
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Sandesha - Apache Sandesha</title><style type="text/css" media="all">
@import url("./style/maven-base.css");
@import url("./style/maven-theme.css");</style><link rel="stylesheet" href="./style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://ws.apache.org/" id="organizationLogo"><img alt="Apache Web Services" src="http://www.apache.org/images/asf-logo.gif"></img></a><a href="http://ws.apache.org/ws-fx/sandesha/" id="projectLogo"><img alt="Apache Sandesha" src="http://ws.apache.org/ws-fx/sandesha/images/Sandesha.jpg"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">
- Last published: 01 March 2005
- | Doc for 1.0</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuProject_Documentation"><h5>Project Documentation</h5><ul><li class="none"><strong><a href="index.html">About Apache Sandesha</a></strong></li><li class="collapsed"><a href="project-info.html">Project Info</a></li><li class="collapsed"><a href="maven-reports.html">Project Reports</a></li><li class="none"><a href="http://maven.apache.org/development-process.html" class="externalLink" title="External Link">Development Process</a></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="./images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Apache_Sandesha"></a><h2>Apache Sandesha</h2><p>
+ Last published: 02 March 2005
+ | Doc for 1.0</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuSandesha"><h5>Sandesha</h5><ul><li class="none"><a href="userguide.html">Simple User Guide</a></li></ul></div><div id="menuProject_Documentation"><h5>Project Documentation</h5><ul><li class="none"><strong><a href="index.html">About Apache Sandesha</a></strong></li><li class="collapsed"><a href="project-info.html">Project Info</a></li><li class="collapsed"><a href="maven-reports.html">Project Reports</a></li><li class="none"><a href="http://maven.apache.org/development-process.html" class="externalLink" title="External Link">Development Process</a></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="./images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Apache_Sandesha"></a><h2>Apache Sandesha</h2><p>
Apache Sandesha is an implementation of the Web Services ReliableMessaging (WS-ReliableMessaging), published by the IBM, Microsoft and BEA as a joint specification, on top of Apache Axis (The Next Generation SOAP). Apache Sandesha provides; An implementation for WS-ReliableMessaging with the support to WS-Policy and WS- Addressing. Interoperability with other WS-ReliableMessaging implementations. Sandesha provides a complete support for WS-ReliableMessaging specification allowing a reliable communication between web services as well as web services and clients. It also provides the INORDER message delivery assurance for the users.
</p></div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">� 2003-2005, Apache Web Services</div><div class="clear"><hr></hr></div></div></body></html>
\ No newline at end of file
1.1 ws-site/targets/ws-fx/sandesha/userguide.html
Index: userguide.html
===================================================================
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Sandesha - </title><style type="text/css" media="all">
@import url("./style/maven-base.css");
@import url("./style/maven-theme.css");</style><link rel="stylesheet" href="./style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://ws.apache.org/" id="organizationLogo"><img alt="Apache Web Services" src="http://www.apache.org/images/asf-logo.gif"></img></a><a href="http://ws.apache.org/ws-fx/sandesha/" id="projectLogo"><img alt="Apache Sandesha" src="http://ws.apache.org/ws-fx/sandesha/images/Sandesha.jpg"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">
Last published: 02 March 2005
| Doc for 1.0</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuSandesha"><h5>Sandesha</h5><ul><li class="none"><a href="userguide.html">Simple User Guide</a></li></ul></div><div id="menuProject_Documentation"><h5>Project Documentation</h5><ul><li class="none"><a href="index.html">About Apache Sandesha</a></li><li class="collapsed"><a href="project-info.html">Project Info</a></li><li class="collapsed"><a href="maven-reports.html">Project Reports</a></li><li class="none"><a href="http://maven.apache.org/development-process.html" class="externalLink" title="External Link">Development Process</a></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="./images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Simple_User_Guide_for_Apache_Sandesha"></a><h2>Simple User Guide for Apache Sandesha</h2><p>This is the primary version of the user guide for Apache Sandesha. The rest
of the document will guide you through the configuration of Sandesha and finally
to run the sample scenarios.</p><div class="subsection"><a name="Configuration"></a><h3>Configuration</h3><p>Configuration of Apache Sandesha can be described in three steps.</p><ul type="square">
<li>Checkout the code</li>
<li>Run the Maven (Compile)</li>
<li>use <font color="#FF0000">�</font>Sandesha-1.0.jar </li>
</ul><p>So as the first step let's focus on how to configure Sandesha and run the
sample tests. Following steps will guide you through the process.</p></div><div class="subsection"><a name="Check_out_Sandesha"></a><h3>Check out Sandesha</h3><p>Apache Sandesha is available for download as source. Please follow the cvs
instruction to download the code
<a href="http://ws.apache.org/ws-fx/sandesha/cvs-usage.html" class="externalLink" title="External Link">
http://ws.apache.org/ws-fx/sandesha/cvs-usage.html</a></p></div><div class="subsection"><a name="Build_Using_Maven"></a><h3>Build Using Maven</h3><p>Note : Sandesha build process is done using Apache Maven. So assume that the
user has already configured Maven in his machine. </p><p>Build process is mainly to run a single Maven command and it is</p>
<div class="source"><pre>maven</pre></div>
<p>Since we need the samples also to be build we need one more command</p>
<div class="source"><pre>maven interop:compile</pre></div>
<p>If you need a project to be created for eclipse or Intellij IDEA use the
maven commands</p>
<div class="source"><pre>maven eclipse</pre></div>
<p>
<div class="source"><pre>maven idea</pre></div>
</p></div><div class="subsection"><a name="Run_the_Inter-op_Samples"></a><h3>Run the Inter-op Samples</h3><p>Go to the directory, interop under the main directory tree. To run the sample
scenarios we only need to type simple ant commands in a command line.</p><p>Followings are the commands to run the samples scenarios.</p><table class="bodyTable"><tr class="b"><td width="13%">Ant command</td><td width="87%">�Description</td></tr><tr class="a"><td width="13%">run_sync_ping&nbsp</td><td width="87%">The scenario tests the simple one way Ping operation with
acknowledgements coming in same HTTP connection</td></tr><tr class="b"><td width="13%">run_async_ping</td><td width="87%">The scenario tests the simple one way Ping operation with
acknowledgements coming in a different� HTTP connection</td></tr><tr class="a"><td width="13%">run_echo_string </td><td width="87%">This scenario tests the simple two way Echo String
operation. Here the request, acknowledgement and the response all come in�
different HTTP Connections.</td></tr></table><p>In all these scenarios the service <b>RMInteropService</b> is deployed in a
<b>SimpleAxisServer</b> using the ant script and the results will be shown in TCP
monitors. Please check whether the java processes that is used to invoke TCP
monitors are not running in the back ground, before every test.</p></div><div class="subsection"><a name="To_Use_Sandesha_in_the_Client_Side"></a><h3>To Use Sandesha in the Client Side</h3><p>Following two steps will enable the usage of Sandesha in the Client Side.
(Assume that you have build Sandesha using Maven)</p><ul type="square">
<li>Copy the <b>Sandesha-1.0.jar</b> to your class path</li>
<li>Copy the <b>config/client-config.wsdd</b> to the class path of your client. This
<b>client-config.wsdd</b> is a default configuration file for Sandesha client. If the user needs to
modify the client side configuration file, just modify the <b>ClientDeploy.wsdd
</b>and then use the
<b>DeployClient.bat</b> to generate the <b>client-config,wsdd. </b></li>
</ul><p>To enable Sandesha in the client side, the only requirement is to use
<b>RMTransport</b> as the transport in the <b>client-config.wsdd</b></p><p>Note: please add the jars, that are there in the target/lib to your class
path</p></div><div class="subsection"><a name="To_Use_Sandesha_in_the_Server_Side"></a><h3>To Use Sandesha in the Server Side</h3><p>This can again be done using two steps.</p><p>Assume that axis is configured in Tomcat Server </p><ul type="square">
<li>Copy the <b>Sandesha-1.0.jar</b> to the <b>CATALINA_HOME/webapps/axis/WEB-INF/lib</b> along
with the other new jars that can be found in <b>target/lib</b> folder of Sandesha.</li>
<li>To configure Sandesha for a particular service( say MyService) change the
<b>deploy.wsdd</b> of <b>MyService</b> according to the following.</li>
</ul>
<div class="source"><pre>
<p><deployment xmlns="http://xml.apache.org/axis/wsdd/"</p>
<p>xmlns:java="http://xml.apache.org/axis/wsdd/providers/java"></p>
<p><service name="MyService" provider="Handler"></p>
<p><requestFlow></p>
<p><handler type="java:org.apache.sandesha.ws.rm.handlers.RMServerRequestHandler"></handler></p>
<p><handler type="java:org.apache.axis.message.addressing.handler.AddressingHandler"></handler></p>
<p></requestFlow></p>
<p><parameter name="handlerClass" value="org.apache.sandesha.ws.rm.providers.RMProvider"/></p>
<p><parameter name="className" value="test.MyService"/></p>
<p><parameter name="allowedMethods" value="*"/></p>
<p><parameter name="scope" value="request"/></p>
<p></service></p>
<p></deployment></p></pre></div>
<p>Note that we have to change the provider to <b>RMProvider</b> and need to add two
request handlers. A sample of this <b>deploy.wsdd</b> can be found in the interop
directory named <b>RMInteropServiceDeploy</b> with the required bat file to deploy the
service. (make sure that the classes for the <b>MyService</b> is copied to
<b>CATALINA_HOME/webapps/axis/WEB-INF/classes</b></p><p>�</p><p>�</p><p>�</p><p>�</p><p>�</p><p>�</p><p>�</p><p>�</p><p>�</p><p>�</p><p>�</p><p>�</p><p>�</p><p>�</p></div></div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">� 2003-2005, Apache Web Services</div><div class="clear"><hr></hr></div></div></body></html>
1.1 ws-site/targets/ws-fx/sandesha/images/Sandesha.jpg
<<Binary file>>