Author: damitha
Date: Mon Apr 20 23:55:28 2009
New Revision: 766917
URL: http://svn.apache.org/viewvc?rev=766917&view=rev
Log:
Adding manual
Added:
webservices/savan/site/c/docs/savanc_manual.html (with props)
Added: webservices/savan/site/c/docs/savanc_manual.html
URL:
http://svn.apache.org/viewvc/webservices/savan/site/c/docs/savanc_manual.html?rev=766917&view=auto
==============================================================================
--- webservices/savan/site/c/docs/savanc_manual.html (added)
+++ webservices/savan/site/c/docs/savanc_manual.html Mon Apr 20 23:55:28 2009
@@ -0,0 +1,122 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";><html><head><title>Apache
Savan/C - The WS-Eventing Module for Apache Axis2/C</title><style
type="text/css" media="all">
+ @import url("../style/maven-base.css");
+
+ @import
url("../style/maven-classic.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://www.apache.org/"; id="organizationLogo"><img alt="Apache Software
Foundation" src="http://www.apache.org/images/asf-logo.gif";></img></a><a
href="http://ws.apache.org/savan/c"; id="projectLogo"><img alt="Apache Savan/C"
src="http://ws.apache.org/savan/c/images/savanc_logo.jpg";></img></a><div
class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">
+ Last published: 28 May 2007
+ </div><div class="xright"></div><div
class="clear"><hr></hr></div></div><div id="leftColumn"><div
id="navcolumn"><div id="menuApache_Savan_C"><h5>Apache Savan/C</h5><ul><li
class="none"><a href="../index.html">Apache Savan/C Home</a></li><li
class="expanded"><a href="../download.cgi">Download Savan/C</a><ul><li
class="none"><a href="../download.cgi">Releases</a></li></ul></li><li
class="expanded"><a href="../docs/index.html">Documentation</a><ul><li
class="none"><a href="../docs/installationguide.html">Installation
Guide</a></li><li class="none"><a href="../docs/savanc_manual.html">Savan/C
manual</a></li></ul></li><li class="expanded"><a
href="../lists_issues.html">Get Involved</a><ul><li class="none"><a
href="../lists_issues.html">Mailing Lists & Issue Tracking</a></li><li
class="none"><a href="../svn.html">Checkout Source Code</a></li></ul></li><li
class="expanded"><a href="../coding_conventions.html">Developer
Guidelines</a><ul><li class="none"
><a href="../coding_conventions.html">Coding Convention</a></li><li
>class="none"><a href="../versioning.html">Versionning</a></li></ul></li><li
>class="expanded"><a href="../team-list.html">Project Information</a><ul><li
>class="none"><a href="../team-list.html">Project Team</a></li><li
>class="none"><a
>href="http://svn.apache.org/repos/asf/webservices/sandesha/trunk/c";
>class="externalLink" title="External Link">Source
>Code</a></li></ul></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_Savan_C_Manual"></a><h2>Apache Savan/C Manual</h2><p>This
>document guide you through the architecture of Savan/C</p>
+
+<p>Please send your feedback to the developer mailing list: <a
+href="mailto:[email protected]";>[email protected]</a>
+(Subscription details are available on the <a
+href="http://ws.apache.org/sandesha/savan/c";>Savan site</a>.) Please remember
+to prefix the subject with [Savan/C].</p>
+
+<h2>Contents</h2>
+<ul>
+ <li><a href="#what_is_eventing">What is web services eventing.</a>
+ </li>
+ <li><a href="#components">Savan/C components<br></a>
+ <ul>
+ <li><a href="#subs_mgr">Subscription Manager</a></li>
+ <li><a href="#publisher">Publisher</a></li>
+ <li><a href="#filters">Filters</a></li>
+ </ul>
+ </li>
+ <li><a href="#understanding_internal">Understanding the internal
dependancies<br></a>
+ </li>
+</ul>
+<a id="what_is_eventing"></a>
+ <h2>
+ What is eventing
+ <br />
+ </h2>
+<p>For a long time web services lacked a standerd for event notification. On
20 January 2004, Akamai, The Globus Alliance, Hewlett-Packard, IBM, Sonic
Software and TIBCO Software proposed two new Web services specifications. The
first, WS-Notification, seeks to provide a standards-based means of
publish-and-subscribe message delivery. On 7 January 2004, BEA Systems,
Microsoft and TIBCO also published a specification for a Web services
publish-and-subscribe standard, known as WS-Eventing.</p>
+<p>Web Services Eventing is about using the Web services framework for
implementing a Subscriber-Publisher model. A client will send a request message
for a subscription to an Event Publishing Service (EPS), with information as to
who it is and from where it can receive notifications from the server . The
Publishing Service publishes its data, as and when available, to all client
endpoints given by respective subscribers when making subscription requests.
These endpoints can be an application running on the same machine as the client
application (subscriber) or, it can be an application running on a different
machine.</p>
+<p>Savan/C is an implementation of the WS-Eventing specification. It started
developement at the beginning of 2007 by some developers at WSO2 Inc. From the
beginning the code was donated to Apache foundation. The company was in the
process of implementating a complete web services stack for C which will be
then used in C++ and most of the scripting languages like PHP, Pearl and
Ruby.</p>
+<p>By now the complete C stack called Axis2/C is very matured and C++, PHP
stacks based on it also has gained wide popularity. Savan/C team first released
it's 0.90 version in 05 November 2007. Since then lot of improvements were done
to the code base leading to it's first major release on May 2009. </p>
+
+<a id="components"></a>
+ <h2>
+ Savan/C components
+ <br />
+ </h2>
+<p>Savan/C code is designed with scalability and performance in mind. As an
eventing implementation the main components should invariably be the
subscription manager and publisher. Then we need filter implementations. Since
these threee components are the most important components for the Savan/C user
special care has been taken in designing these components. These three
components are written as pluggable components. User has the options of using
the implementations provided by the Savan/C for these components or write his
own component implementing the corresponding API. The API's are
savan_subs_mgr.h, savan_publisher.h and savan_filter_mod.h respectively. I'll
explain these three components separately in following sections.</p>
+<p>Apart from these three important components there is a client component
which implement the client API whic is used by Savan/C subscribers to
subscribe, renew, query status of the subscription and unsubscribe.</p>
+<p>Rest of the components are just implementation specific and bear no
interest for the Savan/C user. They are core component which is the main
Savan/C module for Axis2/C, util component which provide common utility
functions and msgreceivers which is Savan/C specific message receiver for
Axis2/C and subscribers which is the internal representation of a
subscriber.</p>
+
+<a id="subs_mgr"></a>
+<h3>Subscription Manager</h3>
+<p>xxx</p>
+
+<a id="publisher"></a>
+<h3>Publisher</h3>
+<p>xxx</p>
+
+<a id="filters"></a>
+<h3>Filters</h3>
+<p>xxx</p>
+
+<a id="understanding_internal"></a>
+<h2>Understanding the internal dependancies</h2>
+<p>It is useful to understand the dependancies between the Savan/C
components.</p>
+<p>libmod_savan.so depends on</p>
+<ul>
+ <li>handlers</li>
+ <li>util</li>
+ <li>savan_storage</li>
+</ul>
+
+<p>libsavan_msgreceivers.so depends on</p>
+<ul>
+ <li>publisher</li>
+ <li>storage</li>
+ <li>util</li>
+</ul>
+
+<p>libsavan_util.so depends on</p>
+<ul>
+ <li>subscribers</li>
+</ul>
+
+<p>libsavan_client.so depends on</p>
+<ul>
+ <li>util</li>
+ <li>storage</li>
+ <li>filter</li>
+</ul>
+
+<p>registry storage depends on</p>
+<ul>
+ <li>common_storage</li>
+ <li>registry_client</li>
+</ul>
+
+<p>sqlite storage depends on</p>
+<ul>
+ <li>common_storage</li>
+ <li>sqlite</li>
+</ul>
+
+<p>esb publisher depends on</p>
+<ul>
+ <li>util</li>
+ <li>common_publisher</li>
+</ul>
+<p>default publisher depends on</p>
+<ul>
+ <li>util</li>
+ <li>filter</li>
+ <li>common_publisher</li>
+</ul>
+<p>xpath filter depends on</p>
+<ul>
+ <li>common_filter</li>
+ <li>libxml2</li>
+</ul>
+
+<h3>Notes</h3>
+<ol>
+ <li>Note1</li>
+ <li>Note2</li>
+</ol>
+</div></div></div></div><div class="clear"><hr></hr></div><div
id="footer"><div class="xright">© 2005-2007, Apache Software
Foundation</div><div class="clear"><hr></hr></div></div></body></html>
Propchange: webservices/savan/site/c/docs/savanc_manual.html
------------------------------------------------------------------------------
svn:executable = *
![http://www.apache.org/images/asf-logo.gif"](http://www.apache.org/images/asf-logo.gif"){kind=link}
![http://ws.apache.org/savan/c/images/savanc_logo.jpg"](http://ws.apache.org/savan/c/images/savanc_logo.jpg"){kind=link}