Download
FAQ
History
HomeHomeNext API
Search
Feedback
Divider

About This Tutorial

This tutorial is a beginner's guide to developing enterprise applications using the JavaTrademarked 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. This tutorial requires a full installation (Typical, not Custom) of the Java WSDP. Here we cover all the things you need to know to make the best use of this tutorial.

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.

How to Read This Tutorial

This tutorial is organized into six parts:

About the 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 JavaTrademarked Tutorial are particularly relevant:

Table P-1 Relevant Topics in The JavaTrademarked Tutorial
Topic
Web Page
JDBCTrademarked
Threads
JavaBeansTrademarked
Security

Building and Running the Examples

This section tells you everything you need to know to obtain, build, 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 <INSTALL>/jwstutorial12/examples/ directory, with subdirectories for each of the technologies included in the pack except for the JavaServer Faces and JAXB technologies. The examples for these technologies are included in the Java WSDP in the <JWSDP_HOME>/jsf/samples and <JWSDP_HOME>/jaxb/samples directories.

This tutorial documents the Java WSDP 1.2. To build, deploy, and run the examples you need a copy of the Java WSDP and the Java 2 Software Development Kit, Standard Edition (J2SETrademarked SDK) 1.4.1 or higher. You download the Java WSDP from:

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

and the J2SE 1.4 SDK from

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

Building the Examples

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

In order to run the Ant scripts, you must configure your environment and properties files as follows:

Tutorial Example Directory Structure

To facilitate iterative development and keep application source separate from compiled files, the source code for the tutorial examples is stored in the following structure under each application directory:

The Ant build files (build.xml) distributed with the examples contain targets to create a build subdirectory and copy and compile files into that directory and perform administrative functions on the application server. Build properties and targets common to a particular technology are specified in the files <INSTALL>/jwstutorial12/examples/technology/common/build.properties and <INSTALL>/jwstutorial12/examples/technology/common/targets.xml.

Managing the Examples

Many of the Java WSDP examples run on the Tomcat Java servlet and JSP container. You use the manager tool to list, install, list, reload, remove, deploy, and undeploy Web applications. See Appendix B for information on this tool.

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-2 lists the typographical conventions used in this tutorial.

Table P-2 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
Variable names
<italic monospace>
Environment variables

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

Divider
Download
FAQ
History
HomeHomeNext API
Search
Feedback
Divider

All of the material in The Java(TM) Web Services Tutorial is copyright-protected and may not be published in other works without express written permission from Sun Microsystems.