d64d4281ec
git-svn-id: http://svn.us.apache.org/repos/asf/tuscany@1069273 13f79535-47bb-0310-9956-ffa450edef68
92 lines
3.7 KiB
Text
92 lines
3.7 KiB
Text
Hello World Web Service SDO WebApp Sample
|
|
=========================================
|
|
This sample demonstrates an SCA web service binding which works with
|
|
SDO and runs as a web application.
|
|
|
|
The README in the samples directory (the directory above this) provides
|
|
general instructions about building and running samples. Take a look there
|
|
first.
|
|
|
|
As this sample provides a web app there is a manual step where the WAR file
|
|
that contains the sample is is built and copied to your web app container.
|
|
See the sections below for instructions on building the war.
|
|
|
|
Once the web app is deployed use your browser to visit the following URL;
|
|
|
|
http://localhost:8080/sample-helloworld-ws-sdo-webapp
|
|
|
|
The port and hostname will of course vary depending on your local installation.
|
|
|
|
The resulting web page displayed should show:
|
|
|
|
Hello John Smith, Jane Doe!
|
|
|
|
Sample Overview
|
|
---------------
|
|
The sample builds a war with a single JSP (HelloWorld.jsp). This JSP
|
|
calls an SCA component with an SDO parameter. This in turn calls another
|
|
SCA component with the SDO parameter. The contents of the SDO are then
|
|
returned as a simple string. This sample shows how SDO objects can
|
|
be passed into and between services in the context of a web application.
|
|
|
|
|
|
helloworld-jsonrpc-webapp/
|
|
src/
|
|
main/
|
|
java/
|
|
helloworld/
|
|
HelloWorld.java - service interface
|
|
HelloWorldComponent.java - first service implementation
|
|
HelloWorldmpl.java - second service implementation
|
|
resources/
|
|
wsdl/
|
|
helloworld.wsdl - the web services description
|
|
helloworld.xsd - the SDO description
|
|
helloworldws.composite - the SCA assembly for this sample
|
|
webapp
|
|
META-INF/
|
|
sca-contribution.xml - specifies the composite to be deployed
|
|
WEB-INF/
|
|
web.xml - defines the listener that starts up the
|
|
Tuscany SCA runtime
|
|
HelloWorld.jsp - the web application that calls the
|
|
SCA service passing in an SDO
|
|
|
|
helloworld-ws-sdo-webapp.png - a pictorial representation of the
|
|
sample .composite file
|
|
build.xml - the Ant build file
|
|
pom.xml - the Maven build file
|
|
|
|
Building The Sample Using Ant
|
|
-----------------------------------------
|
|
With the binary distribution the sample can be built using Ant as
|
|
follows
|
|
|
|
cd helloworld-ws-sdo-webapp
|
|
ant package
|
|
|
|
This should result in a war file (sample-helloworld-ws-sdo-webapp.war) in the target
|
|
directory. Copy this war file to your web app deployment directory in your
|
|
web app container.
|
|
|
|
The process for getting the web app running will depend on which web app container
|
|
you are using. For example, if you are using Tomcat then it is simply a matter
|
|
of copying the WAR file to the webapps directory.
|
|
|
|
Once the web app is deployed use your browser to visit the following URL;
|
|
|
|
http://localhost:8080/sample-helloworld-ws-sdo-webapp
|
|
|
|
The port and hostname will of course vary depending on your local installation.
|
|
|
|
Building The Sample Using Maven
|
|
-------------------------------
|
|
With either the binary or source distributions the sample can be built and run
|
|
using Maven as follows. When using Maven you don't need to run the helloworld-
|
|
ws-service sample first as Maven does this for you.
|
|
|
|
cd helloworld-ws-sdo-webapp
|
|
mvn
|
|
|
|
That should end with "BUILD SUCCESSFUL" and create the target/sample-helloworld-ws-sdo-webapp.war
|
|
which you can copy to your server.
|