The JavaTM Web Services Tutorial
Home
TOC
TOP NEXT

Preface

This tutorial is a beginner's guide to developing Web services and Web applications using the Java Web Services Developer Pack (Java WSDP). The Java WSDP is an all-in-one download containing key technologies to simplify building of Web services using the Java 2 Platform. The technologies available on the Java WSDP are:

To provide a development and deployment environment, the Java WSDP includes the:

Here we cover all the things you need to know to make the best use of The Java Web Services Tutorial.

Who Should Use This Tutorial
About the Examples
Related Information
How to Print This Tutorial
Typographical Conventions

Who Should Use This Tutorial

This tutorial is intended for programmers interested in developing and deploying Web services and Web applications on the Java WSDP.

About the Examples

This tutorial includes many complete, working examples.

Prerequisites for the Examples

To understand the examples you will need a good knowledge of the Java programming language, SQL, and relational database concepts. The topics listed in Table P-1 The Java Tutorial are particularly relevant:

Table P-1 Relevant Topics in The Java Tutorial
Topic
Web Page
JDBC
http://java.sun.com/docs/books/tutorial/jdbc
Threads
http://java.sun.com/docs/books/tutorial/essential/threads
JavaBeans
http://java.sun.com/docs/books/tutorial/javabeans
Security
http://java.sun.com/docs/books/tutorial/security1.2

Running the Examples

This section tells you everything you need to know to obtain, build, install, and run the examples.

Required Software

If you are viewing this online, you need to download The Java Web Services Tutorial from:

http://java.sun.com/webservices/downloads/webservicestutorial.html
 

Once you have installed the tutorial bundle, the example source code is in the <JWSDP_HOME>/docs/tutorial/examples directory, with subdirectories for each of the technologies included in the pack.

This tutorial documents the Java WSDP EA2. To build, deploy, and run the examples you need a copy of the Java WSDP and the Java 2 Platform, Standard Edition (J2SE) SDK 1.3.1 or 1.4. You download the Java WSDP from:

http://java.sun.com/webservices/downloads/webservicespack.html
 

the J2SE 1.3.1 SDK from

http://java.sun.com/j2se/1.3/
 

or the J2SE 1.4 SDK from

http://java.sun.com/j2se/1.4/
 

Add the bin directories of the Java WSDP and J2SE SDK installations to the front of your PATH environment variable so that the Java WSDP startup scripts for Tomcat, Ant, deploytool, the registry server and other tools override other installations.

Building the Examples

Most of the examples are distributed with a configuration file for version 1.4.1 of Ant, a portable build tool contained in the Java WSDP. Directions for building the examples are provided in each chapter.

Managing the Examples

Many of the Java WSDP examples run on the Tomcat Java servlet and JSP container. Tomcat provides the manager web application for installing, listing, reloading, and removing web applications. The format of the commands is listed in Table P-2. The document Manager App HOW-TO, distributed with the Java WSDP at <JWSDP_HOME>/docs/tomcat/tomcat-managerhowto.html, contains information about the manager application.

Table P-2 Tomcat Manager Application Commands
Function
Command
install
http://<host>:8080/manager/install? path=/mywebapp& war=file:/path/to/mywebapp

http://<host>:8080/manager/install? path=/mywebapp& war=jar:file:/path/to/mywebapp.war!/
list
http://<host>:8080/manager/list
reload
http://<host>:8080/manager/reload?path=/mywebapp
remove
http://<host>:8080/manager/remove?path=/mywebapp

The build files distributed with some of the examples provide Ant targets that invoke these manager tasks. Before you can run these tasks you need to put a file named build.properties in your home directory with the following contents:

username=ManagerName	
password=ManagerPassword
 

Replace ManagerName and ManagerPassword with the values you specified for the user name and password when you installed the Java WSDP.


Note: On Windows, your home directory is the directory where your Windows profile is stored. For example, on Windows 2000 it would be C:\Documents and Settings\yourProfile.

Related Information

For further information on the technologies discussed in this tutorial see the reference documentation contained in the Java WSDP (<JWSDP_HOME>/docs/index.html) and the Web sites listed in Table P-3. References to individual technology homes listed in some chapters map as follows:

How to Print This Tutorial

To print this tutorial, follow these steps:

  1. Ensure that Adobe Acrobat Reader is installed on your system.
  2. Open the PDF version of this book.
  3. Click the printer icon in Adobe Acrobat Reader.

Typographical Conventions

Table P-4 lists the typographical conventions used in this tutorial.

Table P-4 Typographical Conventions
Font Style
Uses
italic
Emphasis, titles, first occurrence of terms
monospace
URLs, code examples, file names, command names, programming language keywords
italic monospace
Programming variables, variable file names

Menu selections indicated with the right-arrow character , for example, FirstSecond, should be interpreted as: select the First menu, then choose Second from the First submenu.

Home
TOC
TOP NEXT