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 da...@apache.org on 2007/05/23 21:10:41 UTC
svn commit: r541034 [6/10] - in /webservices/kandula/site/1: ./ images/
images/logos/ style/ xref/ xref/org/ xref/org/apache/
xref/org/apache/kandula/ xref/org/apache/kandula/coordinator/
xref/org/apache/kandula/coordinator/at/ xref/org/apache/kandula/...
Added: webservices/kandula/site/1/task-list.html
URL: http://svn.apache.org/viewvc/webservices/kandula/site/1/task-list.html?view=auto&rev=541034
==============================================================================
--- webservices/kandula/site/1/task-list.html (added)
+++ webservices/kandula/site/1/task-list.html Wed May 23 12:10:37 2007
@@ -0,0 +1,24 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Todos - Kandula-1</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><meta name="author" content="Maven"></meta><meta name="email" content="turbine-maven-user@jakarta.apache.org"></meta></head><body class="composite"><div id="banner"><a href="http://ws.apache.org/" id="organizationLogo"><img alt="Apache Web Services" src="http://ws.apache.org/images/project-logo.jpg"></img></a><a href="http://ws.apache.org/kandula/" id="projectLogo"><span>Apache Kandula</span></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">Last published: 23 May 2007
+ <span class="separator">|</span> Doc for 0.2-SNAPSHOT
+ </div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuKandula-1"><h5>Kandula-1</h5><ul><li class="none"><a href="ws-at--how_to_use.html">WS-AT How-To</a></li><li class="none"><a href="ws-ba--how_to_use.html">WS-BA How-To</a></li></ul></div><div id="menuProject_Documentation"><h5>Project Documentation</h5><ul><li class="none"><a href="index.html">About</a></li><li class="collapsed"><a href="project-info.html">Project Info</a></li><li class="expanded"><a href="maven-reports.html">Project Reports</a><ul><li class="none"><a href="jdepend-report.html">Metrics</a></li><li class="none"><a href="checkstyle-report.html">Checkstyle</a></li><li class="none"><a href="license.html">Project License</a></li><li class="none"><a href="xref/index.html" class="newWindow" title="New Window" target="_blank">Source Xref</a></li><li class="none"><a href="linkcheck.html">Link Check Report</a></li><li class="none
"><strong><a href="task-list.html">Task List</a></strong></li></ul></li><li class="none"><a href="http://maven.apache.org/development-process.html" class="externalLink" title="External Link">Development Process</a></li></ul></div><div id="legend"><h5>Legend</h5><ul><li class="externalLink">External Link</li><li class="newWindow">Opens in a new window</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="Todos"></a><h2>Todos</h2>
+
+ <table class="bodyTable">
+ <thead>
+ <tr class="a">
+ <th>Class</th>
+ <th>Class Todos Count</th>
+ <th>Method Todos Count</th>
+ <th>Field Todos Count</th>
+ </tr>
+ </thead>
+ <tbody>
+
<tr class="b">
+ <td colspan="4"><em>No class, method or field todo found</em></td>
+ </tr>
+ </tbody>
+ </table>
+
+
</div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 2004-2007, Apache Web Services</div><div class="clear"><hr></hr></div></div></body></html>
\ No newline at end of file
Added: webservices/kandula/site/1/team-list.html
URL: http://svn.apache.org/viewvc/webservices/kandula/site/1/team-list.html?view=auto&rev=541034
==============================================================================
--- webservices/kandula/site/1/team-list.html (added)
+++ webservices/kandula/site/1/team-list.html Wed May 23 12:10:37 2007
@@ -0,0 +1,130 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Project Team - Kandula-1</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><script type="text/javascript">
+ function offsetDate(id, offset) {
+ var now = new Date() ;
+ var nowTime = now.getTime() ;
+ var localOffset = now.getTimezoneOffset() ;
+ var developerTime = nowTime + (offset * 60 * 60 * 1000) + (localOffset * 60 * 1000) ;
+ var developerDate = new Date(developerTime) ;
+
+ document.getElementById(id).innerHTML = developerDate;
+ }
+
+ function init() {
+ }
+ </script></head><body class="composite" onload="init();"><div id="banner"><a href="http://ws.apache.org/" id="organizationLogo"><img alt="Apache Web Services" src="http://ws.apache.org/images/project-logo.jpg"></img></a><a href="http://ws.apache.org/kandula/" id="projectLogo"><span>Apache Kandula</span></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">Last published: 23 May 2007
+ <span class="separator">|</span> Doc for 0.2-SNAPSHOT
+ </div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuKandula-1"><h5>Kandula-1</h5><ul><li class="none"><a href="ws-at--how_to_use.html">WS-AT How-To</a></li><li class="none"><a href="ws-ba--how_to_use.html">WS-BA How-To</a></li></ul></div><div id="menuProject_Documentation"><h5>Project Documentation</h5><ul><li class="none"><a href="index.html">About</a></li><li class="expanded"><a href="project-info.html">Project Info</a><ul><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><strong><a href="team-list.html">Project Team</a></strong></li><li class="none"><a href="dependencies.html">Dependencies</a></li><li class="none"><a href="issue-tracking.html">Issue Tracking</a></li></ul></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><div id="legend"><h5>Legend</h5><ul><li class="externalLink">External Link</li><li class="newWindow">Opens in a new window</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="The_Team"></a><h2>The Team</h2>
+ <p>
+ A successful project requires many people to play many roles. Some members write code or documentation, while others are valuable as testers, submitting patches and suggestions.
+ </p>
+
+ <p>
+ The team is comprised of Members and Contributors. Members have direct access to the source of a project and actively evolve the code-base. Contributors improve the project through submission of patches and suggestions to the Members. The number of Contributors to the project is unbounded. Get involved today. All contributions to the project are greatly appreciated.
+ </p>
+
+ <div class="subsection"><a name="Members"></a><h3>Members</h3>
+ <p>
+ The following is a list of developers with commit privileges that have directly contributed to the project in one way or another.
+ </p>
+ <table class="bodyTable">
+ <thead>
+ <tr class="a">
+ <th>
+ Name
+ </th>
+ <th>
+ Id
+ </th>
+ <th>
+ Email
+ </th>
+ <th>
+ Organization
+ </th>
+ <th>
+ Roles
+ </th>
+ <th>
+ TZ Offset
+ </th>
+ <th>
+ Time
+ </th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr class="b">
+ <td>Dasarath Weeratunge</td>
+ <td>
+ <a name="dasarath"></a>
+ dasarath
+ </td>
+ <td>
+ <a href="mailto:dasarath@opensource.lk">
+ dasarath@opensource.lk
+ </a>
+ </td>
+ <td>Lanka Software Foundation (LSF), Sri Lanka.</td>
+ <td>
+ </td>
+ <td></td>
+ <td>
+ <span id="developer-dasarath">
+ Unknown
+ </span>
+ </td>
+ </tr>
+ <tr class="a">
+ <td>Sanjiva Weerawarana</td>
+ <td>
+ <a name="sanjiva"></a>
+ sanjiva
+ </td>
+ <td>
+ <a href="mailto:sanjiva@opensource.lk">
+ sanjiva@opensource.lk
+ </a>
+ </td>
+ <td>Lanka Software Foundation (LSF), Sri Lanka.</td>
+ <td>
+ </td>
+ <td></td>
+ <td>
+ <span id="developer-sanjiva">
+ Unknown
+ </span>
+ </td>
+ </tr>
+ <tr class="b">
+ <td>Thilina Gunarathne</td>
+ <td>
+ <a name="thilina"></a>
+ thilina
+ </td>
+ <td>
+ <a href="mailto:thilina@opensource.lk">
+ thilina@opensource.lk
+ </a>
+ </td>
+ <td>{Lanka Software Foundation (LSF),University of Moratuwa} Sri Lanka.</td>
+ <td>
+ </td>
+ <td></td>
+ <td>
+ <span id="developer-thilina">
+ Unknown
+ </span>
+ </td>
+ </tr>
+ </tbody>
+ </table>
+ </div>
+ <div class="subsection"><a name="Contributors"></a><h3>Contributors</h3>
+ <p>
+ There are no contributors listed for this project. Please check back again later.
+ </p>
+ </div>
+ </div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 2004-2007, Apache Web Services</div><div class="clear"><hr></hr></div></div></body></html>
\ No newline at end of file
Added: webservices/kandula/site/1/ws-at--how_to_use.html
URL: http://svn.apache.org/viewvc/webservices/kandula/site/1/ws-at--how_to_use.html?view=auto&rev=541034
==============================================================================
--- webservices/kandula/site/1/ws-at--how_to_use.html (added)
+++ webservices/kandula/site/1/ws-at--how_to_use.html Wed May 23 12:10:37 2007
@@ -0,0 +1,277 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>WS-AtomicTransaction for Kandula-1 How-To - Kandula-1</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><meta name="author" content="Dasarath Weeratunge (dweeratu@cs.purdue.edu)"></meta><meta name="email"></meta></head><body class="composite"><div id="banner"><a href="http://ws.apache.org/" id="organizationLogo"><img alt="Apache Web Services" src="http://ws.apache.org/images/project-logo.jpg"></img></a><a href="http://ws.apache.org/kandula/" id="projectLogo"><span>Apache Kandula</span></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">Last published: 23 May 2007
+ <span class="separator">|</span> Doc for 0.2-SNAPSHOT
+ </div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuKandula-1"><h5>Kandula-1</h5><ul><li class="none"><a href="ws-at--how_to_use.html">WS-AT How-To</a></li><li class="none"><a href="ws-ba--how_to_use.html">WS-BA How-To</a></li></ul></div><div id="menuProject_Documentation"><h5>Project Documentation</h5><ul><li class="none"><a href="index.html">About</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><div id="legend"><h5>Legend</h5><ul><li class="externalLink">External Link</li><li class="newWindow">Opens in a new window</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="Atomic_Transaction_basics"></a><h2>Atomic Transaction basics</h2>
+ <p>
+ Think of a hypothetical web service that provides banking services. The service
+ provides 2 operations: a credit operation and a debit operation. Now if the two
+ operations are to be used to perform a monetary transfer between two accounts, it
+ must be ensured that both operations succeed. Under these circumstances, the web
+ services coordination framework can be used to ensure the atomicity of operations.</p>
+ <p>
+ The sample code below shows how a non-J2EE client may use the Kandula implementation
+ in this scenario.</p>
+
+ <div class="source"><pre>
+import org.apache.kandula.coordinator.at.TransactionManagerImpl;
+
+public class ... {
+
+ public ... foo(....) {
+ Bank bank= new BankServiceLocator().getBank();
+ TransactionManagerImpl tm =
+ TransactionManagerImpl.getInstance();
+ tm.begin();
+ try {
+ bank.credit(1001, 10);
+ bank.debit(1002, 10);
+ }catch (Exception e) {
+ tm.rollback();
+ }
+ tm.commit();
+ }
+}
+</pre></div>
+
+ <p>
+ Though the web services coordination framework is platform independent, participant
+ services unavoidably need to use platform-specific technologies to perform transactional
+ work. For instance, if the banking service mentioned above is implemented in J2EE,
+ its would use JTA. Hence in the context of coordinated activities, the underlying
+ JTA runtime is required to coordinate with an external coordinator to decide if
+ and when to make any work performed as part of such activities, persistent. In this
+ scenario, Kandula interposes between the local JTA implementation and external coordinator
+ to allow transactions to be propagated to and from J2EE to web services domain.</p>
+ <p>
+ To illustrate the point further, consider how the same use case illustrated above
+ would be implemented by a J2EE client.</p>
+
+ <div class="source"><pre>
+public class ... implements SessionBean {
+ private SessionContext ctx;
+
+ public ... foo(....) {
+ Bank bank= new BankServiceLocator().getBank();
+ UserTransaction ut= ctx.getUserTransaction();
+ ut.begin();
+ try {
+ bank.credit(1001, 10);
+ bank.debit(1002, 10);
+ }catch (Exception e) {
+ ut.rollback();
+ }
+ ut.commit();
+ }
+}
+</pre></div>
+
+ <p>
+ Notice that the component uses JTA to ensure atomicity of operations. At runtime
+ however, the transaction context of the calling thread is propagated to the remote
+ service using the web services coordination framework.</p>
+</div><div class="section"><a name="How_to_download_and_build"></a><h2>How to download and build</h2>
+ <ol>
+ <li>
+ <p>
+ Checkout Kandula1 from the svn repository using an svn client at the following URL:
+ <a href="https://svn.apache.org/repos/asf/webservices/kandula/branches/Kandula_1/" class="externalLink" title="External Link">https://svn.apache.org/repos/asf/webservices/kandula/branches/Kandula_1/</a>.
+ Let us call the directory to which you checked out Kandula1, <tt>KANDULA_HOME</tt>.</p>
+ </li>
+ <li>
+ <p>
+ Download and install Apache Tomcat. (5.0 or later required).</p>
+ </li>
+ <li>
+ <p>
+ Download and install Apache Axis (1.3 or later required). Do NOT deploy Kandula
+ on a version of Axis different from the version on which it was built. Rebuild Kandula
+ if this is required on the required version by modifying the build files. However,
+ you may use different Axis versions on client/server ends.</p>
+ </li>
+ <li>
+ <p>
+ Download and install Apache Maven 1.x (2.0 not supported).</p>
+ </li>
+ <li>
+ <p>
+ Download and install Apache Ant (1.6.5 or later).</p>
+ </li>
+ <li>
+ <p>
+ Set the kandula.context property in <tt>%KANDULA_HOME%/src/conf/kandula.properties</tt>,
+ to the context under which services are deployed in Axis. Normally this is: <tt>http://localhost:8080/axis/services/</tt></p>
+ </li>
+ <li>
+ <p>
+ Build Kandula using Maven. Use the command <tt>maven</tt> in <tt>%KANDULA_HOME%</tt>.
+ This will create the directory <tt>%KANDULA_HOME%/target</tt>. You will find the
+ <tt>kandula-0.2-SNAPSHOT.jar</tt> along with all other required <tt>*.jar</tt> files
+ in the directory <tt>%KANDULA_HOME%/target/lib</tt>.</p>
+ </li>
+ <li>
+ <p>
+ To build the sample applications, move to each of the sample directories in <tt>%KANDULA_HOME%/src/samples/</tt>
+ and use the command <tt>ant dist</tt>.</p>
+ </li>
+ </ol>
+</div><div class="section"><a name="How_to_deploy"></a><h2>How to deploy</h2>
+ <ol>
+ <li>
+ <p>
+ Move all Apache Axis jars from <tt>%AXIS_DEPLOY%/WEB-INF/lib</tt> to <tt>%TOMCAT_HOME%/shared/lib</tt>.</p>
+ </li>
+ <li>
+ <p>
+ Move all <tt>geronimo-*.jar</tt> files, <tt>addressing-SNAPSHOT.jar</tt> and <tt>kandula-0.2-SNAPSHOT.jar</tt>
+ to <tt>%TOMCAT_HOME%/shared/lib</tt>.</p>
+ </li>
+ <li>
+ <p>
+ Copy the <tt>*.jar</tt> file in the <tt>build</tt> directory of each sample application
+ to <tt>%AXIS_DEPLOY%/WEB-INF/lib</tt>.</p>
+ </li>
+ <li>
+ <p>
+ Copy the <tt>server-config.wsdd</tt> file in <tt>%KANDULA_HOME%/src/conf/</tt> to
+ <tt>%AXIS_DEPLOY%/WEB-INF/</tt>.</p>
+ </li>
+ <li>
+ <p>
+ Copy the <tt>client-config.wsdd</tt> file in <tt>%KANDULA_HOME%/src/conf/</tt> to
+ <tt>%AXIS_DEPLOY%/WEB-INF/classes</tt>.</p>
+ </li>
+ <li>
+ <p>
+ Start Tomcat. To assure that Kandula has been properly deployed, first list all
+ deployed services in Axis from the "Happy Axis" page and then verify that you can
+ view the WSDL of each service.</p>
+ </li>
+ </ol>
+</div><div class="section"><a name="How_to_run_the_sample_applications"></a><h2>How to run the sample applications</h2>
+ <p>
+ Sample applications reside in the directory <tt>%KANDULA_HOME%/src/samples</tt>.
+ The Axis artifacts necessary to deploy all the samples are also included in <tt>%KANDULA_HOME%/src/conf/server-config.wsdd</tt>.
+ Hence unless you deploy the samples along with Kandula, you need to remove those
+ elements from the <tt>server-config.wsdd</tt> file copied to <tt>%AXIS_DEPLOY%/WEB-INF/</tt>
+ before you start Tomcat. Further, different samples use different handlers. You
+ need to change your handler configuration as appropriate when you try out a particular
+ sample application.</p>
+ <div class="subsection"><a name="How_to_setup_the_TCP_sniffer"></a><h3>How to setup the TCP sniffer</h3>
+ <p>
+ The default configuration of Kandula assumes that you will use a TCP sniffer such
+ as the "tcpmon" tool that comes with Apache Axis to monitor TCP traffic while running
+ the sample applications. We also assume that Tomcat would be run on port <tt>8080</tt>
+ and services in Axis are deployed under the URL: <tt>http://localhost:8080/axis/services/</tt>.
+ Hence, to facilitate monitoring of traffic, all Stubs in Kandula forward messages
+ that would otherwise be forwarded to port 8080 to port 8081.</p>
+ <p>
+ Therefore, inorder to run the samples (or any other application that uses Kandula
+ in the default setting) you MUST forward port 8081 (of your local machine) to port
+ 8080.</p>
+ <p>
+ You can change this behaviour by editing the WSDL files in <tt>%KANDULA_HOME%/src/schema/</tt>
+ and rebuilding Kandula thereafter.</p>
+ </div>
+ <div class="subsection"><a name="Test-suite1"></a><h3>Test-suite1</h3>
+ <p>
+ This sample application demostrates how to use Kandula to initiate and terminate
+ transactions using the WS-AtomicTransaction protocol. It also demostrates the behaviour
+ of Kandula under a number of failure scenarios. Note that we use pseudo XAResouces
+ instead of actual applications such as Databases, Messaging etc. to simplify the
+ testing process. Hence the application explicitly enlists all XAResources used in
+ operations. This would not be the case with real applications however. The container
+ would normally takecare of this for you, transparently.</p>
+ <p>
+ The most important aspect of this sample application is that it demostrates how
+ Kandula can be used to expose transactional resources in a J2EE environment via
+ the web services transaction management framework. After the revision of code in
+ December 2005, Kandula1 now supports ONLY the "Geronimo" Transaction Manager. The
+ required jars are automatically downloaded by Maven during the build process.</p>
+ <p>
+ To run the sample, do the following.</p>
+ <ol>
+ <li>
+ <p>
+ First ensure that the transaction handler used in your <tt>%AXIS_DEPLOY%/WEB-INF/classes/client-config.wsdd</tt>
+ is <tt>org.apache.kandula.geronimo.TxHandler</tt>.
+ </p>
+ </li>
+ <li>
+ <p>
+ Next open up the JUnit test case provided in the <tt>src</tt> directory in your
+ favourite IDE. This file contains a number of test cases. Each test case should
+ be run on its own. If you run a number of test cases this would result in a whole
+ lot of messages which would be rather difficult to interpret. Also note that some
+ of the test scenarios are positive tests while some others are negative. A short
+ description of the success criteria of most of the test cases can be found in the
+ <tt>success-criteria.txt</tt> file in <tt>%KANDULA_HOME%/src/samples/test-suite1/</tt>.</p>
+ </li>
+ <li>
+ <p>
+ To run the test cases use the standard JUnit test harness of your IDE.</p>
+ </li>
+ </ol>
+</div>
+<div class="subsection"><a name="InteropIBM"></a><h3>InteropIBM</h3>
+ <p>
+ The objective of this sample application is to test Kandula against IBM WS-AtomicTransaction
+ implementation for interoperability. For details on interoperability test, please
+ refer to the documentation available from: <a href="http://wsi.alphaworks.ibm.com:8080/interop/index.html" class="externalLink" title="External Link">
+ http://wsi.alphaworks.ibm.com:8080/interop/index.html</a> . We suggest that
+ you read through this specification before moving on since some of the terminology
+ used in the following section is explained in the specification.</p>
+ <p>
+ The sample allows you to exercies Kandula in both IA (Initiator Application) and
+ PA (Participant Application) configurations. We have successfully tested Kandula
+ in IA role against the IBM implementation in PA role for all scenarios except those
+ that involve WS-Security. Testing under the opposite configuration is still under
+ way. From the tests carried out thus far, Kandula in PA role interoperates with
+ IBM successfully in all scenarios upto Section 5.0 of the test scenario specification.</p>
+ <p>
+ To run this sample, you need to use <tt>org.apache.kandula.coordinator.at.TxHandler</tt>
+ in your <tt>%AXIS_DEPLOY%/WEB-INF/classes/client-config.wsdd</tt>. Most importantly
+ you MUST have an externally visible URL for your web container. If not, you may
+ setup and HTTP tunnel. However, in this case you must set the <tt>kandula.context</tt>
+ property to the externally visible URL. If neither option is available, you may
+ still run the sample using Kandula in both IA and PA configurations simultaniously.
+ The resulting message exchanges SHOULD still comply with the documented success
+ criteria.</p>
+ <p>
+ Further, in this particular scenario, the Kandula1 Stubs are pre-configured to forward
+ any messages addressed to <tt>http://wsi.alphaworks.ibm.com:8080/</tt> to <tt>http://localhost:8082/</tt>.
+ This allows you to monitor all outgoing traffic. So before you run the sample forward
+ the port 8082 of your local machine to <tt>http://wsi.alphaworks.ibm.com:8080/</tt></p>
+ <p>
+ To test Kandula in PA role follow the steps below.</p>
+ <ol>
+ <li>
+ <p>
+ Deploy the sample and start Tomcat. Ensure that InteropService is listed (along
+ with its operations) under deployed services in Axis and that you are able to view
+ the WSDL.</p>
+ </li>
+ <li>
+ <p>
+ Open the page <a href="http://wsi.alphaworks.ibm.com:8080/wstx/interop.jsp" class="externalLink" title="External Link">http://wsi.alphaworks.ibm.com:8080/wstx/interop.jsp</a>
+ in your web browser.</p>
+ </li>
+ <li>
+ <p>
+ Enter the URL of your "InteropService" as the participant destination. Here, if
+ you want to monitor incoming traffic, change the port from 8080 to 8081 when entering
+ the URL and forward port 8081 to 8080 as before.</p>
+ </li>
+ <li>
+ <p>
+ Select the test scenario you want to run. Do not select scenarios from Sections
+ 5.0 or later since these have not been tested yet under this setting.</p>
+ </li>
+ <li>
+ <p>
+ Select run test.</p>
+ </li>
+ </ol>
+</div>
+</div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 2004-2007, Apache Web Services</div><div class="clear"><hr></hr></div></div></body></html>
\ No newline at end of file
Added: webservices/kandula/site/1/ws-ba--how_to_use.html
URL: http://svn.apache.org/viewvc/webservices/kandula/site/1/ws-ba--how_to_use.html?view=auto&rev=541034
==============================================================================
--- webservices/kandula/site/1/ws-ba--how_to_use.html (added)
+++ webservices/kandula/site/1/ws-ba--how_to_use.html Wed May 23 12:10:37 2007
@@ -0,0 +1,257 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>WS-BusinessActivity for Kandula_1 How-To - Kandula-1</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><meta name="author" content="Hannes Erven and Georg Hicker"></meta><meta name="email"></meta></head><body class="composite"><div id="banner"><a href="http://ws.apache.org/" id="organizationLogo"><img alt="Apache Web Services" src="http://ws.apache.org/images/project-logo.jpg"></img></a><a href="http://ws.apache.org/kandula/" id="projectLogo"><span>Apache Kandula</span></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">Last published: 23 May 2007
+ <span class="separator">|</span> Doc for 0.2-SNAPSHOT
+ </div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuKandula-1"><h5>Kandula-1</h5><ul><li class="none"><a href="ws-at--how_to_use.html">WS-AT How-To</a></li><li class="none"><a href="ws-ba--how_to_use.html">WS-BA How-To</a></li></ul></div><div id="menuProject_Documentation"><h5>Project Documentation</h5><ul><li class="none"><a href="index.html">About</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><div id="legend"><h5>Legend</h5><ul><li class="externalLink">External Link</li><li class="newWindow">Opens in a new window</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="Business_Activity_basics"></a><h2>Business Activity basics</h2>
+ <p align="justify">A WS-BA Business Activity is a coordination context with relaxed constraints compared to
+ WS-AT Atomic Transaction. The most important differences are:
+ <ul>
+ <li><b>Atomicity:</b> the work done in the context need not appear to be atomic to the outside, e.g. intermediate results
+ may be seen by an observer.
+ </li>
+ <li><b>Consistency:</b> while the state after the transaction finished should be consistent with business rules, it is not
+ required that all participants share a common outcome.<br></br>
+ In WS-AT transactions, all participants agree to either commit
+ or roll back. The decision is made for all participants.<br></br>
+ By contrast, WS-BA allows for the separate management of every participant, so while one participant
+ is told to cancel, other participants may complete and close their work.
+ </li>
+ </ul>
+ </p>
+ </div><div class="section"><a name="Step_1:_Adopting_the_Web_Service_Interface_Definition__WSDL_"></a><h2>Step 1: Adopting the Web Service Interface Definition (WSDL)</h2>
+
+ <p align="justify">When a web service client invites a business partner into a WS-Coordination transaction, they send them
+ a WS-Coordination coordination context object that includes the address of the coordination service, the transaction's identifier
+ and other data the coordination service requires.</p>
+
+ <p align="justify">The web service provider needs to allow a WS-Coordination Coordination Context object to be included with the
+ business request:
+ <blockquote><code><pre>
+ <wsdl:definitions
+ xmlns:wscoor="http://schemas.xmlsoap.org/ws/2004/10/wscoor"
+ ...
+ >
+ <wsdl:types>
+ <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
+ <xsd:element name="applicationRequest">
+ <!-- This element needs to be added -->
+ <B><xsd:element ref="wscoor:CoordinationContext" /></B>
+
+ <!-- All other application elements need not be modified -->
+ <xsd:element name="flightNo" type="..." .../>
+ ...
+ </xsd:element>
+ </xsd:schema>
+ </wsdl:definitions>
+
+ <!-- The rest of the definitions also need not be modified -->
+
+ </wsdl:types>
+ </pre></code></blockquote>
+
+ </p>
+ </div><div class="section"><a name="Step_2:_Implementing_the_Service"></a><h2>Step 2: Implementing the Service</h2>
+ <p align="justify">
+ A WS-BA enabled web service needs to do only two things:
+ <ul>
+ <li>After receiving a CoordinationContext from the client, register yourself in the transaction.</li>
+ <li>When receiving commands from the Coordinator, do your business and report back.</li>
+ </ul>
+ </p>
+ <p align="justify">
+ Apache Kandula provides two classes for registering participants with a coordination context:
+ <ul>
+ <li><b>org.apache.kandula.coordinator.ba.participant.BAwPCParticipant</b>,
+ for registering for the Participant Completion Protocol.
+ <br></br>
+ Participants need to start performing their
+ work immediately and report Completed by invoking <code>this.tellCompleted()</code> when done.
+ </li>
+ <li><b>org.apache.kandula.coordinator.ba.participant.BAwCCParticipant</b>,
+ for registering for the Coordinator Completion Protocol.
+ <br></br>
+ Participants need to implement the onComplete method and perform their work there. Completed
+ is reported by returning a corresponding value.
+ </li>
+ </ul>
+ </p>
+ <p align="justify">
+ Your participant implementation needs to extend one of those classes and implement the abstract methods. Thats it!
+ </p>
+
+ <div class="subsection"><a name="Implementing_the_abstract_methods_of_the_participant_classes"></a><h3>Implementing the abstract methods of the participant classes</h3>
+ <p align="justify">The following sections document what your implementation of kandula's abstract methods is required to do.</p>
+ </div>
+
+ <div class="subsection"><a name="onComplete"></a><h3>onComplete</h3>
+ <p align="justify">This method is only applicable for the Coordination Completion participant. When it is invoked, the
+ coordinator tells you to actually perform the requested work.<br></br>
+ Return <code>ParticipantCompleteResult.COMPLETED</code> when you were able to complete your work as requested, or
+ <code>ParticipantCompleteResult.HANDLED_BY_APPLICATION</code> if you like not to report something back at the
+ moment. You need to call one of the <code>tell...()</code> methods to send your response to the coordinator at any
+ time you wish.
+ </p>
+ </div>
+
+ <div class="subsection"><a name="onCancel"></a><h3>onCancel</h3>
+ <p align="justify">When the coordinator sends Cancel, it asks you to cancel all outstanding work. If you were able
+ to successfully abort and cancel everything, return <code>ParticipantCancelResult.CANCELED</code>. After the coordinator
+ acknowledges the receipt of Canceled, the participant is no longer needed.
+ </p>
+ <p align="justify">If the service is unable to cancel, it should have reported Completed before.</p>
+ </div>
+
+ <div class="subsection"><a name="onClose"></a><h3>onClose</h3>
+ <p align="justify">
+ After having reported Completed, either from <code>onComplete</code> or by having invoked
+ <code>tellCompleted()</code>, the business partner decided to go for it. Perform whatever it takes
+ to finalize your work and return <code>ParticipantCloseResult.CLOSED</code> when done.
+ </p>
+ <p align="justify">Please note that the service may not report any fault at this stage! You must successfully complete!</p>
+ </div>
+
+ <div class="subsection"><a name="onCompensate"></a><h3>onCompensate</h3>
+ <p align="justify">
+ After having reported Completed, either from <code>onComplete</code> or by having invoked
+ <code>tellCompleted()</code>, the business partner decided to throw away your work. Perform whatever it takes
+ to compensate previous actions and return <code>ParticipantCompensateResult.COMPENSATED</code> when done.
+ </p>
+ <p align="justify">If compensation is not possible, you need to return <code>ParticipantCompensateResult.FAULTED</code>
+ and humans must investigate the issue. This should almost never happen.
+ </p>
+ </div>
+
+ <div class="subsection"><a name="onFinish"></a><h3>onFinish</h3>
+ <p align="justify">
+ The coordinator informs you that the result of your work, whatever it is, was acknowledged and that you may forget
+ about the transaction. This means the participant object may now be destroyed.
+ </p>
+ </div>
+ </div><div class="section"><a name="Step_3:_Implementing_the_Client"></a><h2>Step 3: Implementing the Client</h2>
+ <p align="justify">
+ </p>
+ </div><div class="section"><a name="Step_4:_Adding_business_logic_to_the_client"></a><h2>Step 4: Adding business logic to the client</h2>
+ <p align="justify">
+ </p>
+ </div><div class="section"><a name="Step_5:_Deploying_and_Testing"></a><h2>Step 5: Deploying and Testing</h2>
+ <p align="justify">
+ </p>
+ </div><div class="section"><a name="Running_the_samples"></a><h2>Running the samples</h2>
+ <p align="justify">
+ To try out the samples provided with Kandula-1, you need the following prerequisites:
+ <ul>
+ <li>Apache Tomcat with Apache Axis installed</li>
+ <li>Kandula Sources from SVN checked out</li>
+ </ul>
+ </p>
+ <p align="justify">
+ The WS-BA examples require you to have two Tomcat Servers running, one acting as the
+ coordination service and one as the participants. The initiator will run independently
+ as JUnit test cases or a Swing application.
+ </p>
+
+ <div class="subsection"><a name="Building"></a><h3>Building</h3>
+ <p align="justify">
+ Build Kandula as usual with "maven". Build the BusinessActivity-Testsuite and the Holiday example
+ by running "ant" in the "samples/holiday" or "samples/ba-testsuite" directories.
+ </p>
+ <p align="justify">
+ Copy the jar-files from the respective "build" directories into the axis/lib folders of your
+ Axis installation.
+ </p>
+ </div>
+ <div class="subsection"><a name="Preparing_the_Tomcats"></a><h3>Preparing the Tomcats</h3>
+ <p align="justify">
+ If you run Kandula from an IDE such as eclipse, you can typically manage multiple configurations
+ there. The Eclipse Web Tools Projects, for example, offers to set different "base" directories with
+ different axis installations.
+ </p>
+ <p align="justify">
+ The easiest way to have two Tomcat instances running is to copy the whole "Tomcat"-directory. This tutorial
+ will refer to the "Coordination Server" and to the "Participant Server".
+ </p>
+ <p align="justify">
+ First, we configure the Coordination Server. It does not require the two JAR files from holiday and
+ ba-testsuite. Copy the "src/conf/server-only-config_with_WSBA.wsdd" to the axis/WEB-INF folder and
+ rename it to "server-config.wsdd". If the file already exists, replace it with that one.
+ Next, copy the kandula.properties and the client-config.wsdd files from src/conf/ to the
+ axis/WEB-INF/classes directory.
+ <br></br>
+ Now we have to make sure the correct ports are configured. Open the Tomcat/conf/server.xml file with
+ your favorite text editor, scan for the <br></br>
+ <Connector ...><br></br>
+ line and make sure the port is set to 8280. If you don't want to use the TCP Monitor (which you only do
+ if you know what this is), set it to 8281.
+ <br></br>
+ Next, open the copy of the kandula.properties and make sure the following entries are set: <br></br>
+ <pre>kandula.localService=http://localhost:8281/axis/services/ <br></br>kandula.preferredCoordinationService=http://localhost:<B>8281</B>/axis/services/</pre>
+ The kandula.localService property shall point to the endpoint the coordination services are running,
+ and be fully qualified. It is used to generate the endpoint addresses that is sent to the peers. The
+ kandula.preferredCoordinationService property tells Kandula at which coordination service it shall
+ create new coordination contexts; at the coordinator, this should point to itself.
+ </p>
+ <p>
+ The Coordination Server is now ready!<br></br>
+ Start it up by invoking the Tomcat/bin/startup script and verify that the Axis List Services page
+ shows the "coordinator", "kandula_BA_PC_coordinator" and some more services named like that.
+ </p>
+ <p align="justify">
+ Second, we configure the Participant Service. This server requires the Kandula, ba-testsuite and holiday
+ jar files in its axis/web-inf/lib directory. Copy the "server-participant-only-with-test-config_with_WSBA.wsdd"
+ from the src/conf directory to the axis/WEB-INF folder and
+ rename it to "server-config.wsdd". If the file already exists, replace it with that one.
+ Next, copy the kandula.properties and the client-config.wsdd files from src/conf/ to the
+ axis/WEB-INF/classes directory.
+ <br></br>
+ Now we have to make sure the correct ports are configured. Open the Tomcat/conf/server.xml file with
+ your favorite text editor, scan for the <br></br>
+ <Connector ...><br></br>
+ line and make sure the port is set to 8180. If you don't want to use the TCP Monitor (which you only do
+ if you know what this is), set it to 8181.
+ <br></br>
+ Next, open the copy of the kandula.properties and make sure the following entries are set: <br></br>
+ <pre>kandula.localService=http://localhost:<B>8181</B>/axis/services/ <br></br>kandula.preferredCoordinationService=http://localhost:8281/axis/services/</pre>
+ The kandula.localService property shall point to the endpoint the participant services are running,
+ and be fully qualified. It is used to generate the endpoint addresses that is sent to the peers.
+ The
+ kandula.preferredCoordinationService property tells Kandula at which coordination service it shall
+ create new coordination contexts.
+ </p>
+ <p>
+ The Participant Server is now ready!<br></br>
+ Start it up by invoking the Tomcat/bin/startup script and verify that the Axis List Services page
+ shows the "participant", "kandula_BA_PC_participant" and some more services named like that.
+ </p>
+ <p align="justify">
+ Start up now the TCP Port Monitor, if you chose to use it.
+ </p>
+ </div>
+ <div class="subsection"><a name="Run_"></a><h3>Run!</h3>
+ <p align="justify">
+ After having started both servers, the port monitor if configured and verifying everything is OK,
+ start the holiday demo by issuing "ant run"
+ in the holiday folder.
+ </p>
+ <p align="justify">
+ The holiday example consists of two rental providers that offer cars and rooms for rent. When starting
+ up the client, you must first chose whether you'd like atomic or mixed outcome.
+ </p>
+ <p align="justify">
+ Select "car" or "room" from the dropdown and hit the "Search for offers" button. The client now fetches
+ offers from the remote web service on the participant web server. You may search for multiple different
+ offers, also cars and rooms mixed. Choose some of the offers from the list, and hit the "add selected offer
+ to basket" button to put the offer into the basket. The client now contacts the remote web service again,
+ but this time provides the CoordinationContext to enrol a participant. The Rental Web Service immediatly
+ enroles for the transaction.
+ </p>
+ <p align="justify">
+ To check the state of the business activity, switch to the "basket" tab and hit the "refresh basket" button.
+ Depending on mixed or atomic outcome, the available buttons at the bottom change. With mixed outcome, select
+ one or more participants from the basket and hit the "complete", "close", etc. buttons to send the
+ corresponding messages to the participants. Refresh will always refresh the participant list.
+ If you press buttons to send messages that are not applicable in the current state of the context or participant,
+ there is no error message but the command is silently ignored.
+ </p>
+ </div>
+ </div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 2004-2007, Apache Web Services</div><div class="clear"><hr></hr></div></div></body></html>
\ No newline at end of file
Added: webservices/kandula/site/1/xref/allclasses-frame.html
URL: http://svn.apache.org/viewvc/webservices/kandula/site/1/xref/allclasses-frame.html?view=auto&rev=541034
==============================================================================
--- webservices/kandula/site/1/xref/allclasses-frame.html (added)
+++ webservices/kandula/site/1/xref/allclasses-frame.html Wed May 23 12:10:37 2007
@@ -0,0 +1,159 @@
+
+
+ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "DTD/xhtml1-transitional.dtd">
+ <html xml:lang="en" lang="en">
+ <head>
+ <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1"></meta>
+ <title>All Classes</title>
+ <link rel="stylesheet" href="stylesheet.css" type="text/css" title="style"></link>
+ </head>
+ <body>
+
+ <h3>All Classes</h3>
+
+ <ul>
+
+ <li>
+ <a href="org/apache/kandula/coordinator/at/AT2PCStatus.html" target="classFrame">AT2PCStatus</a>
+ </li>
+
+ <li>
+ <a href="org/apache/kandula/coordinator/at/ATCoordinator.html" target="classFrame">ATCoordinator</a>
+ </li>
+
+ <li>
+ <a href="org/apache/kandula/coordinator/at/ATCoordinatorImpl.html" target="classFrame">ATCoordinatorImpl</a>
+ </li>
+
+ <li>
+ <a href="org/apache/kandula/coordinator/at/AbstractParticipant.html" target="classFrame">AbstractParticipant</a>
+ </li>
+
+ <li>
+ <a href="org/apache/kandula/coordinator/ActivationImpl.html" target="classFrame">ActivationImpl</a>
+ </li>
+
+ <li>
+ <a href="org/apache/kandula/coordinator/ActivationStub.html" target="classFrame">ActivationStub</a>
+ </li>
+
+ <li>
+ <a href="org/apache/kandula/utils/AddressingHeaders.html" target="classFrame">AddressingHeaders</a>
+ </li>
+
+ <li>
+ <a href="org/apache/kandula/geronimo/Bridge.html" target="classFrame">Bridge</a>
+ </li>
+
+ <li>
+ <a href="org/apache/kandula/coordinator/Callback.html" target="classFrame">Callback</a>
+ </li>
+
+ <li>
+ <a href="org/apache/kandula/coordinator/CallbackRegistry.html" target="classFrame">CallbackRegistry</a>
+ </li>
+
+ <li>
+ <a href="org/apache/kandula/coordinator/at/CompletionCoordinatorImpl.html" target="classFrame">CompletionCoordinatorImpl</a>
+ </li>
+
+ <li>
+ <a href="org/apache/kandula/coordinator/at/CompletionCoordinatorStub.html" target="classFrame">CompletionCoordinatorStub</a>
+ </li>
+
+ <li>
+ <a href="org/apache/kandula/coordinator/at/CompletionInitiatorImpl.html" target="classFrame">CompletionInitiatorImpl</a>
+ </li>
+
+ <li>
+ <a href="org/apache/kandula/coordinator/at/CompletionInitiatorStub.html" target="classFrame">CompletionInitiatorStub</a>
+ </li>
+
+ <li>
+ <a href="org/apache/kandula/coordinator/CoordinationContext.html" target="classFrame">CoordinationContext</a>
+ </li>
+
+ <li>
+ <a href="org/apache/kandula/coordinator/CoordinationService.html" target="classFrame">CoordinationService</a>
+ </li>
+
+ <li>
+ <a href="org/apache/kandula/coordinator/Coordinator.html" target="classFrame">Coordinator</a>
+ </li>
+
+ <li>
+ <a href="org/apache/kandula/coordinator/at/CoordinatorImpl.html" target="classFrame">CoordinatorImpl</a>
+ </li>
+
+ <li>
+ <a href="org/apache/kandula/coordinator/at/CoordinatorStub.html" target="classFrame">CoordinatorStub</a>
+ </li>
+
+ <li>
+ <a href="org/apache/kandula/coordinator/FaultDispatcher.html" target="classFrame">FaultDispatcher</a>
+ </li>
+
+ <li>
+ <a href="org/apache/kandula/coordinator/InvalidCoordinationProtocolException.html" target="classFrame">InvalidCoordinationProtocolException</a>
+ </li>
+
+ <li>
+ <a href="org/apache/kandula/KandulaConfig.html" target="classFrame">KandulaConfig</a>
+ </li>
+
+ <li>
+ <a href="org/apache/kandula/geronimo/Mediator.html" target="classFrame">Mediator</a>
+ </li>
+
+ <li>
+ <a href="org/apache/kandula/coordinator/at/ParticipantImpl.html" target="classFrame">ParticipantImpl</a>
+ </li>
+
+ <li>
+ <a href="org/apache/kandula/coordinator/at/ParticipantStub.html" target="classFrame">ParticipantStub</a>
+ </li>
+
+ <li>
+ <a href="org/apache/kandula/coordinator/RegistrationImpl.html" target="classFrame">RegistrationImpl</a>
+ </li>
+
+ <li>
+ <a href="org/apache/kandula/coordinator/RegistrationStub.html" target="classFrame">RegistrationStub</a>
+ </li>
+
+ <li>
+ <a href="org/apache/kandula/utils/Service.html" target="classFrame">Service</a>
+ </li>
+
+ <li>
+ <a href="org/apache/kandula/utils/SoapFaultSender.html" target="classFrame">SoapFaultSender</a>
+ </li>
+
+ <li>
+ <a href="org/apache/kandula/utils/TCPSnifferHelper.html" target="classFrame">TCPSnifferHelper</a>
+ </li>
+
+ <li>
+ <a href="org/apache/kandula/coordinator/TimedOutException.html" target="classFrame">TimedOutException</a>
+ </li>
+
+ <li>
+ <a href="org/apache/kandula/coordinator/at/TransactionImpl.html" target="classFrame">TransactionImpl</a>
+ </li>
+
+ <li>
+ <a href="org/apache/kandula/coordinator/at/TransactionManagerImpl.html" target="classFrame">TransactionManagerImpl</a>
+ </li>
+
+ <li>
+ <a href="org/apache/kandula/geronimo/TxHandler.html" target="classFrame">TxHandler</a>
+ </li>
+
+ <li>
+ <a href="org/apache/kandula/coordinator/UnsupportedCoordinationTypeException.html" target="classFrame">UnsupportedCoordinationTypeException</a>
+ </li>
+
+ </ul>
+
+ </body>
+ </html>
Added: webservices/kandula/site/1/xref/index.html
URL: http://svn.apache.org/viewvc/webservices/kandula/site/1/xref/index.html?view=auto&rev=541034
==============================================================================
--- webservices/kandula/site/1/xref/index.html (added)
+++ webservices/kandula/site/1/xref/index.html Wed May 23 12:10:37 2007
@@ -0,0 +1,22 @@
+
+ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Frameset//EN" "DTD/xhtml1-frameset.dtd">
+ <html xml:lang="en" lang="en">
+ <head>
+ <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1"></meta>
+ <title>Apache Kandula 0.2-SNAPSHOT Reference</title>
+ </head>
+ <frameset cols="20%,80%">
+ <frameset rows="30%,70%">
+ <frame name="packageListFrame" src="overview-frame.html"></frame>
+ <frame name="packageFrame" src="allclasses-frame.html"></frame>
+ </frameset>
+ <frame name="classFrame" src="overview-summary.html"></frame>
+ </frameset>
+ <noframes>
+ <h1>Frame Alert</h1>
+ <p>
+ You don't have frames. Go
+ <a href="overview-summary.html">here</a>
+ </p>
+ </noframes>
+ </html>
Added: webservices/kandula/site/1/xref/org/apache/kandula/KandulaConfig.html
URL: http://svn.apache.org/viewvc/webservices/kandula/site/1/xref/org/apache/kandula/KandulaConfig.html?view=auto&rev=541034
==============================================================================
--- webservices/kandula/site/1/xref/org/apache/kandula/KandulaConfig.html (added)
+++ webservices/kandula/site/1/xref/org/apache/kandula/KandulaConfig.html Wed May 23 12:10:37 2007
@@ -0,0 +1,64 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /><title>KandulaConfig xref</title>
+<link type="text/css" rel="stylesheet" href="../../../stylesheet.css" />
+</head>
+<body>
+<div id="overview"><a href="../../../../apidocs/org/apache/kandula/KandulaConfig.html">View Javadoc</a></div><pre>
+
+<a name="1" href="#1">1</a> <em class="comment">/*</em>
+<a name="2" href="#2">2</a> <em class="comment"> * Created on Jan 6, 2006</em>
+<a name="3" href="#3">3</a> <em class="comment"> *</em>
+<a name="4" href="#4">4</a> <em class="comment"> */</em>
+<a name="5" href="#5">5</a> <strong>package</strong> org.apache.kandula;
+<a name="6" href="#6">6</a>
+<a name="7" href="#7">7</a> <strong>import</strong> java.io.IOException;
+<a name="8" href="#8">8</a> <strong>import</strong> java.io.InputStream;
+<a name="9" href="#9">9</a> <strong>import</strong> java.util.Properties;
+<a name="10" href="#10">10</a>
+<a name="11" href="#11">11</a> <em>/**<em>*</em></em>
+<a name="12" href="#12">12</a> <em> * @author Dasarath Weeratunge</em>
+<a name="13" href="#13">13</a> <em> * </em>
+<a name="14" href="#14">14</a> <em> */</em>
+<a name="15" href="#15">15</a> <strong>public</strong> <strong>class</strong> <a href="../../../org/apache/kandula/KandulaConfig.html">KandulaConfig</a> {
+<a name="16" href="#16">16</a>
+<a name="17" href="#17">17</a> <strong>private</strong> <strong>static</strong> <strong>final</strong> String PROPERTY_FILE = <span class="string">"kandula.properties"</span>;
+<a name="18" href="#18">18</a>
+<a name="19" href="#19">19</a> <strong>private</strong> <strong>static</strong> <strong>final</strong> String CONTEXT_PROPERTY = <span class="string">"kandula.context"</span>;
+<a name="20" href="#20">20</a>
+<a name="21" href="#21">21</a> <strong>private</strong> <strong>static</strong> <a href="../../../org/apache/kandula/KandulaConfig.html">KandulaConfig</a> instance = <strong>new</strong> <a href="../../../org/apache/kandula/KandulaConfig.html">KandulaConfig</a>();
+<a name="22" href="#22">22</a>
+<a name="23" href="#23">23</a> <strong>private</strong> Properties properties = <strong>null</strong>;
+<a name="24" href="#24">24</a>
+<a name="25" href="#25">25</a> <strong>private</strong> <a href="../../../org/apache/kandula/KandulaConfig.html">KandulaConfig</a>() {
+<a name="26" href="#26">26</a> properties = <strong>new</strong> Properties();
+<a name="27" href="#27">27</a> loadProperties();
+<a name="28" href="#28">28</a> }
+<a name="29" href="#29">29</a>
+<a name="30" href="#30">30</a> <strong>public</strong> <strong>static</strong> <a href="../../../org/apache/kandula/KandulaConfig.html">KandulaConfig</a> getInstance() {
+<a name="31" href="#31">31</a> <strong>return</strong> instance;
+<a name="32" href="#32">32</a> }
+<a name="33" href="#33">33</a>
+<a name="34" href="#34">34</a> <strong>private</strong> <strong>void</strong> loadProperties() {
+<a name="35" href="#35">35</a> InputStream in = getClass().getClassLoader().getResourceAsStream(
+<a name="36" href="#36">36</a> PROPERTY_FILE);
+<a name="37" href="#37">37</a>
+<a name="38" href="#38">38</a> <strong>try</strong> {
+<a name="39" href="#39">39</a> properties.load(in);
+<a name="40" href="#40">40</a> in.close();
+<a name="41" href="#41">41</a> } <strong>catch</strong> (IOException e) {
+<a name="42" href="#42">42</a> e.printStackTrace();
+<a name="43" href="#43">43</a> <strong>throw</strong> <strong>new</strong> RuntimeException(e);
+<a name="44" href="#44">44</a> }
+<a name="45" href="#45">45</a> }
+<a name="46" href="#46">46</a>
+<a name="47" href="#47">47</a> <strong>public</strong> String getContext() {
+<a name="48" href="#48">48</a> <strong>return</strong> properties.getProperty(CONTEXT_PROPERTY);
+<a name="49" href="#49">49</a> }
+<a name="50" href="#50">50</a>
+<a name="51" href="#51">51</a> }
+</pre>
+<hr/><div id="footer">This page was automatically generated by <a href="http://maven.apache.org/">Maven</a></div></body>
+</html>
+
Added: webservices/kandula/site/1/xref/org/apache/kandula/coordinator/ActivationImpl.html
URL: http://svn.apache.org/viewvc/webservices/kandula/site/1/xref/org/apache/kandula/coordinator/ActivationImpl.html?view=auto&rev=541034
==============================================================================
--- webservices/kandula/site/1/xref/org/apache/kandula/coordinator/ActivationImpl.html (added)
+++ webservices/kandula/site/1/xref/org/apache/kandula/coordinator/ActivationImpl.html Wed May 23 12:10:37 2007
@@ -0,0 +1,45 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /><title>ActivationImpl xref</title>
+<link type="text/css" rel="stylesheet" href="../../../../stylesheet.css" />
+</head>
+<body>
+<div id="overview"><a href="../../../../../apidocs/org/apache/kandula/coordinator/ActivationImpl.html">View Javadoc</a></div><pre>
+
+<a name="1" href="#1">1</a> <em class="comment">/*</em>
+<a name="2" href="#2">2</a> <em class="comment"> * Copyright 2004 The Apache Software Foundation.</em>
+<a name="3" href="#3">3</a> <em class="comment"> * </em>
+<a name="4" href="#4">4</a> <em class="comment"> * Licensed under the Apache License, Version 2.0 (the "License"); you may not</em>
+<a name="5" href="#5">5</a> <em class="comment"> * use this file except in compliance with the License. You may obtain a copy of</em>
+<a name="6" href="#6">6</a> <em class="comment"> * the License at</em>
+<a name="7" href="#7">7</a> <em class="comment"> * </em>
+<a name="8" href="#8">8</a> <em class="comment"> * <a href="http://www.apache.org/licenses/LICENSE-2.0" target="alexandria_uri">http://www.apache.org/licenses/LICENSE-2.0</a></em>
+<a name="9" href="#9">9</a> <em class="comment"> * </em>
+<a name="10" href="#10">10</a> <em class="comment"> * Unless required by applicable law or agreed to in writing, software</em>
+<a name="11" href="#11">11</a> <em class="comment"> * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT</em>
+<a name="12" href="#12">12</a> <em class="comment"> * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the</em>
+<a name="13" href="#13">13</a> <em class="comment"> * License for the specific language governing permissions and limitations under</em>
+<a name="14" href="#14">14</a> <em class="comment"> * the License.</em>
+<a name="15" href="#15">15</a> <em class="comment"> * </em>
+<a name="16" href="#16">16</a> <em class="comment"> */</em>
+<a name="17" href="#17">17</a> <strong>package</strong> org.apache.kandula.coordinator;
+<a name="18" href="#18">18</a>
+<a name="19" href="#19">19</a> <strong>import</strong> java.rmi.RemoteException;
+<a name="20" href="#20">20</a>
+<a name="21" href="#21">21</a> <strong>import</strong> org.apache.kandula.wscoor.ActivationPortTypeRPC;
+<a name="22" href="#22">22</a> <strong>import</strong> org.apache.kandula.wscoor.CreateCoordinationContextResponseType;
+<a name="23" href="#23">23</a> <strong>import</strong> org.apache.kandula.wscoor.CreateCoordinationContextType;
+<a name="24" href="#24">24</a>
+<a name="25" href="#25">25</a> <strong>public</strong> <strong>class</strong> <a href="../../../../org/apache/kandula/coordinator/ActivationImpl.html">ActivationImpl</a> implements ActivationPortTypeRPC {
+<a name="26" href="#26">26</a>
+<a name="27" href="#27">27</a> <strong>public</strong> CreateCoordinationContextResponseType createCoordinationContextOperation(
+<a name="28" href="#28">28</a> CreateCoordinationContextType params) throws RemoteException {
+<a name="29" href="#29">29</a> <strong>return</strong> CoordinationService.getInstance().createCoordinationContextOperation(
+<a name="30" href="#30">30</a> params);
+<a name="31" href="#31">31</a> }
+<a name="32" href="#32">32</a> }
+</pre>
+<hr/><div id="footer">This page was automatically generated by <a href="http://maven.apache.org/">Maven</a></div></body>
+</html>
+
Added: webservices/kandula/site/1/xref/org/apache/kandula/coordinator/ActivationStub.html
URL: http://svn.apache.org/viewvc/webservices/kandula/site/1/xref/org/apache/kandula/coordinator/ActivationStub.html?view=auto&rev=541034
==============================================================================
--- webservices/kandula/site/1/xref/org/apache/kandula/coordinator/ActivationStub.html (added)
+++ webservices/kandula/site/1/xref/org/apache/kandula/coordinator/ActivationStub.html Wed May 23 12:10:37 2007
@@ -0,0 +1,69 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+<meta http-equiv="content-type" content="text/html; charset=ISO-8859-1" /><title>ActivationStub xref</title>
+<link type="text/css" rel="stylesheet" href="../../../../stylesheet.css" />
+</head>
+<body>
+<div id="overview"><a href="../../../../../apidocs/org/apache/kandula/coordinator/ActivationStub.html">View Javadoc</a></div><pre>
+
+<a name="1" href="#1">1</a> <em class="comment">/*</em>
+<a name="2" href="#2">2</a> <em class="comment"> * Copyright 2004 The Apache Software Foundation.</em>
+<a name="3" href="#3">3</a> <em class="comment"> *</em>
+<a name="4" href="#4">4</a> <em class="comment"> * Licensed under the Apache License, Version 2.0 (the "License");</em>
+<a name="5" href="#5">5</a> <em class="comment"> * you may not use this file except in compliance with the License.</em>
+<a name="6" href="#6">6</a> <em class="comment"> * You may obtain a copy of the License at</em>
+<a name="7" href="#7">7</a> <em class="comment"> *</em>
+<a name="8" href="#8">8</a> <em class="comment"> * <a href="http://www.apache.org/licenses/LICENSE-2.0" target="alexandria_uri">http://www.apache.org/licenses/LICENSE-2.0</a></em>
+<a name="9" href="#9">9</a> <em class="comment"> *</em>
+<a name="10" href="#10">10</a> <em class="comment"> * Unless required by applicable law or agreed to in writing, software</em>
+<a name="11" href="#11">11</a> <em class="comment"> * distributed under the License is distributed on an "AS IS" BASIS,</em>
+<a name="12" href="#12">12</a> <em class="comment"> * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.</em>
+<a name="13" href="#13">13</a> <em class="comment"> * See the License for the specific language governing permissions and</em>
+<a name="14" href="#14">14</a> <em class="comment"> * limitations under the License.</em>
+<a name="15" href="#15">15</a> <em class="comment"> *</em>
+<a name="16" href="#16">16</a> <em class="comment"> */</em>
+<a name="17" href="#17">17</a> <strong>package</strong> org.apache.kandula.coordinator;
+<a name="18" href="#18">18</a>
+<a name="19" href="#19">19</a> <strong>import</strong> java.net.MalformedURLException;
+<a name="20" href="#20">20</a> <strong>import</strong> java.net.URL;
+<a name="21" href="#21">21</a> <strong>import</strong> java.rmi.RemoteException;
+<a name="22" href="#22">22</a>
+<a name="23" href="#23">23</a> <strong>import</strong> org.apache.axis.AxisFault;
+<a name="24" href="#24">24</a> <strong>import</strong> org.apache.axis.message.addressing.EndpointReference;
+<a name="25" href="#25">25</a> <strong>import</strong> org.apache.axis.types.URI;
+<a name="26" href="#26">26</a> <strong>import</strong> org.apache.axis.types.URI.MalformedURIException;
+<a name="27" href="#27">27</a> <strong>import</strong> org.apache.kandula.utils.AddressingHeaders;
+<a name="28" href="#28">28</a> <strong>import</strong> org.apache.kandula.utils.Service;
+<a name="29" href="#29">29</a> <strong>import</strong> org.apache.kandula.utils.TCPSnifferHelper;
+<a name="30" href="#30">30</a> <strong>import</strong> org.apache.kandula.wscoor.ActivationPortTypeRPCBindingStub;
+<a name="31" href="#31">31</a> <strong>import</strong> org.apache.kandula.wscoor.CreateCoordinationContextResponseType;
+<a name="32" href="#32">32</a> <strong>import</strong> org.apache.kandula.wscoor.CreateCoordinationContextType;
+<a name="33" href="#33">33</a>
+<a name="34" href="#34">34</a> <em>/**<em>*</em></em>
+<a name="35" href="#35">35</a> <em> * @author Dasarath Weeratunge</em>
+<a name="36" href="#36">36</a> <em> * </em>
+<a name="37" href="#37">37</a> <em> * Created on Jun 14, 2004</em>
+<a name="38" href="#38">38</a> <em> */</em>
+<a name="39" href="#39">39</a> <strong>public</strong> <strong>class</strong> <a href="../../../../org/apache/kandula/coordinator/ActivationStub.html">ActivationStub</a> <strong>extends</strong> ActivationPortTypeRPCBindingStub {
+<a name="40" href="#40">40</a>
+<a name="41" href="#41">41</a> <strong>public</strong> <a href="../../../../org/apache/kandula/coordinator/ActivationStub.html">ActivationStub</a>(EndpointReference epr) throws AxisFault,
+<a name="42" href="#42">42</a> MalformedURLException {
+<a name="43" href="#43">43</a> <strong>super</strong>(<strong>new</strong> URL(TCPSnifferHelper.redirect(epr.getAddress().toString())),
+<a name="44" href="#44">44</a> <strong>new</strong> <a href="../../../../org/apache/kandula/utils/Service.html">Service</a>());
+<a name="45" href="#45">45</a> AddressingHeaders headers = <strong>new</strong> <a href="../../../../org/apache/kandula/utils/AddressingHeaders.html">AddressingHeaders</a>(epr, <strong>null</strong>);
+<a name="46" href="#46">46</a> ((Service) service).setAddressingHeaders(headers);
+<a name="47" href="#47">47</a> }
+<a name="48" href="#48">48</a>
+<a name="49" href="#49">49</a> <strong>public</strong> <a href="../../../../org/apache/kandula/coordinator/CoordinationContext.html">CoordinationContext</a> createCoordinationContext(String coordinationType)
+<a name="50" href="#50">50</a> throws RemoteException, MalformedURIException {
+<a name="51" href="#51">51</a> CreateCoordinationContextType params = <strong>new</strong> CreateCoordinationContextType();
+<a name="52" href="#52">52</a> params.setCoordinationType(<strong>new</strong> URI(coordinationType));
+<a name="53" href="#53">53</a> CreateCoordinationContextResponseType response = createCoordinationContextOperation(params);
+<a name="54" href="#54">54</a> <strong>return</strong> <strong>new</strong> <a href="../../../../org/apache/kandula/coordinator/CoordinationContext.html">CoordinationContext</a>(response.getCoordinationContext());
+<a name="55" href="#55">55</a> }
+<a name="56" href="#56">56</a> }
+</pre>
+<hr/><div id="footer">This page was automatically generated by <a href="http://maven.apache.org/">Maven</a></div></body>
+</html>
+
---------------------------------------------------------------------
To unsubscribe, e-mail: kandula-dev-unsubscribe@ws.apache.org
For additional commands, e-mail: kandula-dev-help@ws.apache.org