user manual

Chapter 9: Borland Enterprise Server Web Services 95
Borland Web Services examples
Borland Web Services examples
To help you get started with developing and deploying web services, we
provide samples and examples for the Borland web services engine. These
examples are included in your Borland Enterprise Server installation in:
<install_dir>/examples/webservices/
The examples that illustrate the different “Web Service providers” on page 88,
are located in the web services examples directory in the Java, EJB, MDB or
VisiBroker folder.
Your Borland Enterprise Server installation also includes several “Apache Axis
Web Service samples” on page 96 in:
<install_dir>/examples/webservices/axis/samples/
Using the Web Service provider examples
BES examples must be built before they are deployed and deployed before
they are run. Building the examples involves generating the necessary WSDL
files and packaging the application's code and descriptors into a deployable
unit, in this case a WAR. This WAR can then be deployed to a Borland
Partition. The application is run by invoking its client from a command-line.
Building and running the examples is automated through the use of the “Tools
Overview” on page 96, while deployment is performed using Tools Overview
with BES.
Steps to build, deploy, and run the examples
1 Build. You can build all of the examples simultaneously or build each one
individually. To build them all simultaneously, navigate to the:
/examples/webservices/
directory and execute the Ant command. For example:
C:/BDP/examples/webservices>Ant
builds all the examples.
To build an individual example, navigate to its specific directory and
execute the Ant command.
For example:
C:/BDP/examples/webservices/java>Ant
builds only the Java Provider example.
2 Deploy. You deploy the examples to a running instance of BES. You can
use the ant deploy target, or any of the following to deploy your WAR and
JAR:
■
iastool command-line utility, for more information go to Chapter 29,
“iastool command-line utility”.