You are viewing a plain text version of this content. The canonical link for it is here.
Posted to fx-dev@ws.apache.org by ch...@apache.org on 2006/05/08 13:16:55 UTC
svn commit: r405017 - in /webservices/sandesha/site/sandesha2: ./ apidocs/
apidocs/org/ apidocs/resources/
Author: chamikara
Date: Mon May 8 04:16:51 2006
New Revision: 405017
URL: http://svn.apache.org/viewcvs?rev=405017&view=rev
Log:
Modifications to the userguide.
Removed old javadoc.
Removed:
webservices/sandesha/site/sandesha2/apidocs/allclasses-frame.html
webservices/sandesha/site/sandesha2/apidocs/allclasses-noframe.html
webservices/sandesha/site/sandesha2/apidocs/constant-values.html
webservices/sandesha/site/sandesha2/apidocs/deprecated-list.html
webservices/sandesha/site/sandesha2/apidocs/help-doc.html
webservices/sandesha/site/sandesha2/apidocs/index-all.html
webservices/sandesha/site/sandesha2/apidocs/index.html
webservices/sandesha/site/sandesha2/apidocs/org/
webservices/sandesha/site/sandesha2/apidocs/overview-frame.html
webservices/sandesha/site/sandesha2/apidocs/overview-summary.html
webservices/sandesha/site/sandesha2/apidocs/overview-tree.html
webservices/sandesha/site/sandesha2/apidocs/package-list
webservices/sandesha/site/sandesha2/apidocs/packages.html
webservices/sandesha/site/sandesha2/apidocs/resources/
webservices/sandesha/site/sandesha2/apidocs/serialized-form.html
webservices/sandesha/site/sandesha2/apidocs/stylesheet.css
Modified:
webservices/sandesha/site/sandesha2/download.html
webservices/sandesha/site/sandesha2/userGuide.html
Modified: webservices/sandesha/site/sandesha2/download.html
URL: http://svn.apache.org/viewcvs/webservices/sandesha/site/sandesha2/download.html?rev=405017&r1=405016&r2=405017&view=diff
==============================================================================
--- webservices/sandesha/site/sandesha2/download.html (original)
+++ webservices/sandesha/site/sandesha2/download.html Mon May 8 04:16:51 2006
@@ -4,7 +4,7 @@
@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/sandesha2" id="projectLogo"><img alt="Apache Sandesha2" 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: 08 May 2006
| Doc for 1.0</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuApache_Sandesha2"><h5>Apache Sandesha2</h5><ul><li class="none"><a href="index.html">Home</a></li><li class="expanded"><a href="">Downloads</a><ul><li class="none"><a href="download.cgi">Releases</a></li><li class="none"><a href="http://svn.apache.org/repos/asf/webservices/sandesha/trunk" class="externalLink" title="External Link">Source Code</a></li></ul></li><li class="expanded"><a href="">Documentation</a><ul><li class="none"><a href="userGuide.html">User Guide</a></li><li class="none"><a href="architectureGuide.html">Architecture Guide</a></li><li class="none"><a href="apidocs/index.html">Java Docs</a></li></ul></li><li class="expanded"><a href="">Project Information</a><ul><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="team-list.html">Project Team</a></li></ul></li></ul></
div><div id="menuProject_Documentation"><h5>Project Documentation</h5><ul><li class="none"><a href="index.html">About Apache Sandesha2</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"><div align="left">
-<p>Please select the Sandesha2 version you want to download. Latest release is 0.9. You can download both
+<p>Please select the Sandesha2 version you want to download. Latest release is 1.0. You can download both
the binay distribution and the source distribution.</p>
</div><div align="center">
<table class="bodyTable"><tbody>
Modified: webservices/sandesha/site/sandesha2/userGuide.html
URL: http://svn.apache.org/viewcvs/webservices/sandesha/site/sandesha2/userGuide.html?rev=405017&r1=405016&r2=405017&view=diff
==============================================================================
--- webservices/sandesha/site/sandesha2/userGuide.html (original)
+++ webservices/sandesha/site/sandesha2/userGuide.html Mon May 8 04:16:51 2006
@@ -73,13 +73,25 @@
Apache Axis2. With Sandesha2 you can make your Web services reliable, or you
can invoke already hosted reliable Web services.</p><p>If you want to learn more about Apache Axis2, refer to <a href="http://ws.apache.org/axis2/0_95/userguide.html" class="newWindow" title="New Window" target="_blank">Apache Axis2 User
Guide</a> and <a href="http://ws.apache.org/axis2/0_95/Axis2ArchitectureGuide.html" class="newWindow" title="New Window" target="_blank">Apache
-Axis2 Architecture Guide</a>.</p><p>If you want to know about the design of Sandesha2 refer to <a href="architectureGuide.html" class="newWindow" title="New Window" target="_blank">Sandesha2 Architecture Guide</a>.</p><p>Sandesha2 supports two reliable messaging specifications. It fully
-supports WS-ReliableMessaging Feabruary 2005 specification which was created
-in collaboration with Microsoft, IBM, BEA and TOBCO Software. Later this
-specification was submitted to OASIS and is currently being standerdized
-under the OASIS WS-RX technical committee. Sandesha2 currently support up to
-the revision CD 3 of the specification being developed under this technical
-committee.</p><p><a name="yfs"></a></p></div><div class="subsection"><a name="Your_First_Service_with_Sandesha2"></a><h3>Your First Service with Sandesha2</h3><p>This section will give you step by step guidelines on creating a Web
+Axis2 Architecture Guide</a>.</p><p>If you want to know about the design of Sandesha2 refer to <a href="architectureGuide.html" class="newWindow" title="New Window" target="_blank">Sandesha2 Architecture Guide</a>.</p><p>
+Sandesha2 supports the WS-ReliableMessaging specification. It fully supports the WS-ReliableMessaging
+1.0 specification (February 2005)
+(<a href="http://specs.xmlsoap.org/ws/2005/02/rm/ws-reliablemessaging.pdf" class="externalLink" title="External Link">
+http://specs.xmlsoap.org/ws/2005/02/rm/ws-reliablemessaging.pdf
+ </a>).
+
+</p><p>
+This specification has been submitted to OASIS and currently being standardized under the OASIS WS-RX
+Technical Committee as WSRM 1.1 (see
+<a href="http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=ws-rx" class="externalLink" title="External Link">
+http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=ws-rx
+</a> ).
+Sandesha2 currently supports Committee Draft 3 of the specification being developed under this
+technical committee (
+<a href="http://docs.oasis-open.org/ws-rx/wsrm/200602/wsrm-1.1-spec-cd-03.pdf" class="externalLink" title="External Link">
+http://docs.oasis-open.org/ws-rx/wsrm/200602/wsrm-1.1-spec-cd-03.pdf
+</a>).
+</p><p><a name="yfs"></a></p></div><div class="subsection"><a name="Your_First_Service_with_Sandesha2"></a><h3>Your First Service with Sandesha2</h3><p>This section will give you step by step guidelines on creating a Web
service with reliability and making it available within your Axis2 server.
This simple service will have a single one-way operation (ping) and a
request-response operation (echoString).</p><p>The steps are as follows:"</p><p>1. Download the Axis2 Webapp distribution (Axis2.war file) and deploy it
@@ -442,7 +454,7 @@
request messages. If you want to avoid this and if you want to get
acknowledgements and faults to a different endpoint, add following part to
the client code before doing any invocation. Note that this does not effect
-the path of you application level faults. Only RM faults which occur within
+the path of your application level faults. Only RM faults which occur within
the Sandesha2 will be sent to this endpoint.</p>
<div class="source"><pre>clientOptions.setProperty(SandeshaClientConstants.AcksTo,<endpoint>); //example endpoint - http://tempuri.org/acks.
</pre></div>
@@ -486,7 +498,7 @@
which it is maintaining a sequence. This may be useful in a case where your
<a href="#sequencereport">SequenceReports</a> indicate that some of the
messages you sent have not been acknowledged and when you want to verify
-that. You can do this by adding one of the following line to the client
+that. You can do this by adding following line to the client
code.</p>
<div class="source"><pre>SandeshaClient.sendAckRequest (ServiceClient serviceClient);
@@ -553,7 +565,7 @@
<p><a name="smo"></a></p></div><div class="subsection"><a name="Sequence_Management_of_Sandesha2"></a><h3>Sequence Management of Sandesha2</h3><p>This section will explain you about the sequence managing method of
Sandesha2. This is basically about four things, each explained in following
sub topics.</p><p><a name="san"></a></p></div><div class="subsection"><a name="Starting_a_New_Sequence"></a><h3>Starting a New Sequence</h3><p>Sandesha client gets two properties given by the client to decide the
-sequence in which it should send a particular application messages. First one
+sequence in which it should send a particular application message. First one
is the address of the WS-Addressing To endpoint reference. The second is a
special constant given by the client called Sequence Key which is set as a
property in the Options object as I explained before. Sandesha2 client
@@ -569,7 +581,7 @@
sequence. Remember that if you are working on the Submitted WSRM
specification (the default), this is the only method you can use.</p><p>If you are working on the new WSRM specification (see previous section on
<a href="#sts">Selecting the Specification Version</a> if you want to know
-how to set this), these is a alternate method you can use to terminate a
+how to set this), these is an alternate method you can use to terminate a
sequence. You can keep invoking the ServiceClient to send messages, without
setting a Last Message property. After you finish your work call following
function to terminate the sequence.</p>
@@ -578,7 +590,7 @@
</pre></div>
<p>You can use the function below to terminate a sequence identified by a
particular Sequence Key.</p>
- <div class="source"><pre>SandeshaClient.terminateSequence (ServiceClient,, SequenceKey);
+ <div class="source"><pre>SandeshaClient.terminateSequence (ServiceClient, SequenceKey);
</pre></div>
<p>When a request sequence is terminated, Sandesha2 will wait till all the
@@ -615,8 +627,8 @@
client code.</p>
<div class="source"><pre>SandeshaClient.getSandeshaReport (ConfigurationContext c);
</pre></div>
- <p><a name="sequencereport"></a></p></div><div class="subsection"><a name="SequenceReport"></a><h3>SequenceReport</h3><p>A SequnceReport gives information on a specific sequences that a Sandesha
-system is working on. This can be an incoming sequence or a outgoing
+ <p><a name="sequencereport"></a></p></div><div class="subsection"><a name="SequenceReport"></a><h3>SequenceReport</h3><p>A SequenceReport gives information on a specific sequences that a Sandesha
+system is working on. This can be an incoming sequence or an outgoing
sequence.</p><p><em><strong>A SequenceReport will give following
information:</strong></em></p><ol>
<li>Status of the sequence which can be one of the following.
@@ -740,7 +752,7 @@
to be false if in-order invoking has to be disabled. Please remember that
this is a non-overridable property. I.e. value you set in the module.xml is
the one that is used for all the services and will not be overridden for a
-perticular service by setting a different value there.</p><p><a name="storagemanager"></a></p></div><div class="subsection"><a name="StorageManager"></a><h3>StorageManager</h3><p>This gives the storage manager implementation class used by Sandesha2. You
+particular service by setting a different value there.</p><p><a name="storagemanager"></a></p></div><div class="subsection"><a name="StorageManager"></a><h3>StorageManager</h3><p>This gives the storage manager implementation class used by Sandesha2. You
have to mention the full qualified class name here. Please read the Sandesha2
<a href="architectureGuide.html">Architecture Guide</a> for more details on
creating your own storage manager. This is also a property that cannot be
---------------------------------------------------------------------
To unsubscribe, e-mail: sandesha-dev-unsubscribe@ws.apache.org
For additional commands, e-mail: sandesha-dev-help@ws.apache.org