web server - Borland Technical Publications

web server - Borland Technical Publications web server - Borland Technical Publications

techpubs.borland.com
from techpubs.borland.com More from this publisher
12.11.2014 Views

Tools Overview Tools Overview 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 “iastool command-line utility” on page 293. Deployment Wizard, for more information go to the Management Console User's Guide. 3 Run. To run an example, navigate to its directory and use the ant run-client command. For example, to run the Java Provider client: C:/BDP/examples/webservices/java>Ant run-client Apache Axis Web Service samples The Apache Axis web service samples are already deployed in the axis-samples.war file present in the Borland Partition. Since these are already pre-deployed, you do not need to use the Apache Axis deploy commands suggested in the Apache Axis User's Guide. The Apache Axis User's Guide is also provided with the BES installation and is located in: /doc/axis/user-guide.html or refer to the Axis User Guide located in /doc/axis/user-guide.html. These samples illustrate the capabilities of Axis. They are unmodified from the original Apache Axis implementation and are not guaranteed to run. This section describes the various tools used in examples. Apache ANT tool The Apache ANT utility is a platform-independent, java-based build tool used to build the examples. The XML build script build.xml is used to drive the tool. This build.xml file describes the various targets available for a project and the commands executed in response to those targets. The Borland Enterprise Server conveniently provides all necessary JARs and scripts to run the Apache Ant tool. Chapter 9: Borland Enterprise Server Web Services 81

Tools Overview Java2WSDL tool Note The Java2WSDL is an Apache Axis utility class that generates WSDL corresponding to a Java class. This class can accept a number of command line arguments. You can get the full usage help by running this utility without arguments as follows: java org.apache.axis.wsdl.Java2WSDL You must set your CLASSPATH to include all jar files in the \lib\axis directory, before you run the following command. WSDL2Java tool Note The WSDL2Java is an Apache Axis utility class that generates Java classes from a WSDL file. This tool can generate java stubs (used on the client side), or java skeletons (used on the server side). The generated files make it easy to develop your client or server for a given WSDL. This class can accept a number of command line arguments. You can get the full usage help by running this utility without arguments as follows: java org.apache.axis.wsdl.WSDL2Java You must set your CLASSPATH to include all jar files in the \lib\axis directory, before you run the following command. Axis Admin tool Note The Apache Axis Admin tool is a utility class that generates WAR level global configuration files based on deployment information specific to some web services. The input to this utility is a XML file (typically named deploy.wsdd) containing deployment information about one or more web services. The Apache Axis Admin utility adds some global definitions that are necessary and writes an output file. Use this tool as follows: java org.apache.axis.utils.Admin server|client deployment-file You must set your CLASSPATH to include all jar files in the \lib\axis directory, before you run the command. This tool generates server-config.wsdd or client-config.wsdd based on what option you choose. 82 BES Developer’s Guide

Tools Overview<br />

Java2WSDL tool<br />

Note<br />

The Java2WSDL is an Apache Axis utility class that generates WSDL corresponding to<br />

a Java class. This class can accept a number of command line arguments. You can get<br />

the full usage help by running this utility without arguments as follows:<br />

java org.apache.axis.wsdl.Java2WSDL<br />

You must set your CLASSPATH to include all jar files in the \lib\axis<br />

directory, before you run the following command.<br />

WSDL2Java tool<br />

Note<br />

The WSDL2Java is an Apache Axis utility class that generates Java classes from a<br />

WSDL file. This tool can generate java stubs (used on the client side), or java skeletons<br />

(used on the <strong>server</strong> side). The generated files make it easy to develop your client or<br />

<strong>server</strong> for a given WSDL.<br />

This class can accept a number of command line arguments. You can get the full<br />

usage help by running this utility without arguments as follows:<br />

java org.apache.axis.wsdl.WSDL2Java<br />

You must set your CLASSPATH to include all jar files in the \lib\axis<br />

directory, before you run the following command.<br />

Axis Admin tool<br />

Note<br />

The Apache Axis Admin tool is a utility class that generates WAR level global<br />

configuration files based on deployment information specific to some <strong>web</strong> services.<br />

The input to this utility is a XML file (typically named deploy.wsdd) containing<br />

deployment information about one or more <strong>web</strong> services. The Apache Axis Admin<br />

utility adds some global definitions that are necessary and writes an output file. Use<br />

this tool as follows:<br />

java org.apache.axis.utils.Admin <strong>server</strong>|client deployment-file<br />

You must set your CLASSPATH to include all jar files in the \lib\axis<br />

directory, before you run the command.<br />

This tool generates <strong>server</strong>-config.wsdd or client-config.wsdd based on what option<br />

you choose.<br />

82 BES Developer’s Guide

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!