23297fa3b1
git-svn-id: http://svn.us.apache.org/repos/asf/tuscany@684661 13f79535-47bb-0310-9956-ffa450edef68
147 lines
5.1 KiB
Text
147 lines
5.1 KiB
Text
Calculator RMI Service Sample
|
|
=============================
|
|
|
|
This sample illustrates the use of Tuscany RMI Binding to expose component
|
|
services as Java RMI Services. It also demonstrates how a simple Java RMI
|
|
Client application invokes the SCA Application's services exposed as RMI
|
|
Services.
|
|
|
|
The README in the samples directory (the directory above this) provides
|
|
general instructions about building and running samples. Take a look there
|
|
first.
|
|
|
|
If you just want to run it to see what happens open a command prompt, navigate
|
|
to this sample directory and do:
|
|
|
|
ant run
|
|
|
|
OR if you don't have ant, on Windows do
|
|
|
|
java -cp ..\..\lib\tuscany-sca-manifest.jar;target\sample-calculator-rmi-service.jar calculator.CalculatorServer
|
|
|
|
and on *nix do
|
|
|
|
java -cp ../../lib/tuscany-sca-manifest.jar:target/sample-calculator-rmi-service.jar calculator.CalculatorServer
|
|
|
|
Now you have the server running you need to open another command prompt, navigate
|
|
to the calculator-rmi-reference sample directory and do:
|
|
|
|
ant run
|
|
|
|
OR if you don't have ant, on Windows do
|
|
|
|
java -cp ..\..\lib\tuscany-sca-manifest.jar;target\sample-calculator-rmi-reference.jar calculator.CalculatorClient
|
|
|
|
and on *nix do
|
|
|
|
java -cp ../../lib/tuscany-sca-manifest.jar:target/sample-calculator-rmi-reference.jar calculator.CalculatorClient
|
|
|
|
|
|
Sample Overview
|
|
---------------
|
|
This sample extends the calculator sample by replacing the local service
|
|
binding with an RMI binding. SO a java client can call the service exposed
|
|
by the SCA application using an RMI client.
|
|
|
|
This sample adds a number of classes to the basic calculator sample:
|
|
|
|
calculator-rmi-service/
|
|
src/
|
|
main/
|
|
java/
|
|
calculator/
|
|
CalculatorService.java - as calculator sample
|
|
CalculatorServiceImpl.java
|
|
AddService.java - as calculator sample
|
|
AddServiceImpl.java
|
|
SubtractService.java - as calculator sample
|
|
SubtractServiceImpl.java
|
|
MultiplyService.java - as calculator sample
|
|
MultiplyServiceImpl.java
|
|
DivideService.java - as calculator sample
|
|
DivideServiceImpl.java
|
|
CalculatorClient.java - (Not currently used) Uses the
|
|
java naming service to
|
|
look up the Calculator RMI service.
|
|
It then calls add, subtract, multiple
|
|
and divide methods on the service
|
|
CalculatorServer.java - starts the SCA Runtime and deploys
|
|
the CalculatorRMIServer.composite.
|
|
In doing this the SCA RMI binding
|
|
acts to expose the CalculatorService
|
|
over RMI.
|
|
resources/
|
|
CalculatorRMIServer.composite - the SCA assembly for this sample
|
|
test/
|
|
java/
|
|
calculator/
|
|
CalculatorRMIServerTestCase.java - JUnit test case
|
|
calculator-rmi-service.png - a pictorial representation of the
|
|
.composite file
|
|
build.xml - the Ant build file for the server
|
|
pom.xml - the Maven build file
|
|
|
|
Note. As this test creates and uses local network connections you may need to
|
|
configure your firewall, if you are running one, to allow the test to run
|
|
successfully.
|
|
|
|
Building And Running The Sample Using Ant
|
|
-----------------------------------------
|
|
With the binary distribution the sample can be built and run using Ant. Two
|
|
build files are used to support client and server functions.
|
|
|
|
The server starts the SCA runtime and loads the SCA calculator application
|
|
which exposes an RMI service. Start a new console and use the following
|
|
commands.
|
|
|
|
cd calculator-rmi-service
|
|
ant compile
|
|
ant run
|
|
|
|
This will run up the server and display the following.
|
|
|
|
run:
|
|
[java] Starting of the SCA Calculator Application exposed as RMI Services...
|
|
[java] ...Press Enter to Exit...
|
|
|
|
The client is very similar to the calculator sample
|
|
|
|
It locates the RMI service that the SCA runtime is exposing and calls each of
|
|
the calculator operations. Start a new console and use the following commands.
|
|
|
|
cd calculator-rmi-reference
|
|
ant compile
|
|
ant run
|
|
|
|
You should see the following output from the run target.
|
|
|
|
run:
|
|
[java] 3 + 2=5.0
|
|
[java] 3 - 2=1.0
|
|
[java] 3 * 2=6.0
|
|
[java] 3 / 2=1.5
|
|
|
|
If you now return to the console window running the server and press enter the
|
|
server should stop.
|
|
|
|
Building And Running The Sample Using Maven
|
|
-------------------------------------------
|
|
With either the binary or source distributions the sample can be built and run
|
|
using Maven as follows.
|
|
|
|
cd calculator-rmi-service
|
|
mvn
|
|
|
|
You should see the following output from the test phase.
|
|
|
|
-------------------------------------------------------
|
|
T E S T S
|
|
-------------------------------------------------------
|
|
Running calculator.CalculatorRMIServerTestCase
|
|
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 5.819 sec
|
|
|
|
Results :
|
|
|
|
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
|
|
|
|
This shows that the Junit test cases have run successfully.
|