<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> | |
<HTML> | |
<HEAD> | |
<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=windows-1252"> | |
<TITLE></TITLE> | |
<META NAME="GENERATOR" CONTENT="OpenOffice.org 1.1.4 (Win32)"> | |
<META NAME="AUTHOR" CONTENT="Chamikara Jayalath"> | |
<META NAME="CREATED" CONTENT="20050923;21203268"> | |
<META NAME="CHANGEDBY" CONTENT="Chamikara Jayalath"> | |
<META NAME="CHANGED" CONTENT="20050923;22064610"> | |
</HEAD> | |
<BODY LANG="en-US" DIR="LTR"> | |
<H2><U><B>Sample application to demonstrate the functionality of | |
service groups</B></U></H2> | |
<P>Service Groups are a brand new concept introduced by Axis2. With | |
Service Groups, users can group several services together. This | |
concept gives two main advantages to users.</P> | |
<OL> | |
<LI><P>Several related services can be easily managed and deployed.</P> | |
<LI><P>Can share information between different services of the same | |
Service Group at run time.</P> | |
</OL> | |
<P>This sample application demonstrate how you can create a service | |
group and how you can use the functionalities offered by axis2 to | |
share information between services of the same group at runtime.</P> | |
<P><BR><BR> | |
</P> | |
<P><U>The idea</U></P> | |
<P STYLE="text-decoration: none">The ides behind the sample is pretty | |
simple. We have developed a Calculator service group with three | |
services AddService, SubstractService and MultiplyService. Each | |
service has two operations. For e.g. AddServices has a 'add' | |
operation and a 'addPrevious' operation. | |
</P> | |
<P STYLE="text-decoration: none">The 'add' operation is used to add | |
two integers and produce a result. When a operation is run the result | |
will be saved in the current ServiceGroupContext which is the Context | |
that has to be used to share information between services of the same | |
service group.</P> | |
<P STYLE="text-decoration: none">When the addPrevious operation is | |
run (which takes a single integer as the parameter) the saved value | |
of the last operation will be added to the integer values that comes | |
as a parameter.</P> | |
<P STYLE="text-decoration: none">You can even call operations of the | |
other two services. These services can also use the value saved from | |
the previous operation.</P> | |
<P STYLE="text-decoration: none">You can use the client class | |
provided to run this in a interactive manner.</P> | |
<P><U>How to run the sample</U></P> | |
<P>Please run axis2 and deploy the provided Calculator.aar service by | |
simply dropping it to the Axis2_webapp/WEB-INF/services directory (see | |
axis user guide for more details).</P> | |
<P>Run the run.bat file.</P> | |
<P>You will see the following screen.</P> | |
<P><BR><BR> | |
</P> | |
<P><IMG SRC="images/image1.JPG" NAME="Graphic1" ALIGN=LEFT WIDTH=701 HEIGHT=168 BORDER=0><BR CLEAR=LEFT><BR><BR> | |
</P> | |
<P>Select 'n' to start a new round.</P> | |
<P><BR><BR> | |
</P> | |
<P><IMG SRC="images/image2.JPG" NAME="Graphic2" ALIGN=LEFT WIDTH=701 HEIGHT=211 BORDER=0><BR CLEAR=LEFT><BR><BR> | |
</P> | |
<P>Now select the service. + for AddService, - for SubstractService, | |
* for MultiplyService. And press enter. | |
</P> | |
<P>Enter the two parameters.</P> | |
<P>You will see the result.</P> | |
<P><BR><BR> | |
</P> | |
<P><IMG SRC="images/image3.JPG" NAME="Graphic3" ALIGN=LEFT WIDTH=701 HEIGHT=231 BORDER=0><BR CLEAR=LEFT><BR><BR> | |
</P> | |
<P>Now select the option 'c' to continue the round. Select the | |
operation. You have to give a single parameter and press enter.</P> | |
<P>The result will be generated using the entered valus and the | |
result of the previous operation (which is obtained from the | |
ServiceGroupContext).</P> | |
<P><BR><BR> | |
</P> | |
<P><IMG SRC="images/image4.JPG" NAME="Graphic4" ALIGN=LEFT WIDTH=701 HEIGHT=307 BORDER=0><BR CLEAR=LEFT><BR><BR> | |
</P> | |
<P>You can continue this interactively any number of times.</P> | |
<P><BR><BR> | |
</P> | |
</BODY> | |
</HTML> |