Home TOC Index

About This Tutorial

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. Here we cover all the things you need to know to make the best use of this tutorial.

Who Should Use This Tutorial

How to Read This Tutorial

About the Examples

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.

How to Read This Tutorial

This tutorial is organized into five parts:

• Introduction

  The first five chapters introduce basic concepts and technologies and we suggest that you read these first in their entirety. In particular, many of the Java WSDP examples run on the Tomcat Java servlet and JSP container and the Getting Started with Tomcat chapter tells you how to start, stop, and manage Tomcat.

• Java XML Technology

  These chapters cover all the Java XML APIs.

  • The Java API for XML Processing (JAXP)
  • The Java API for XML Messaging (JAXM) and Soap with Attachments API for Java (SAAJ)
  • The Java API for XML-based RPC (JAX-RPC)
  • The Java API for XML Registries (JAXR) and the Registry Server, a UDDI-compliant registry accessible via JAXR
• Web Technology

  These chapters cover the technologies used in developing presentation-oriented Web applications.

  • Java Servlets
  • JavaServer Pages
  • Custom tags and the JSP Standard Tag Library (JSTL)
• Case Study

  The Coffee Break Application chapter in this part describes an application that ties together most of the APIs discussed in this tutorial.

• Appendixes

  The appendixes cover the tools shipped with the Java WSDP.

  • Tomcat Server Administration Tool
  • Tomcat Web Application Manager
  • JAXM Provider Admin
  • xrpcc
  • Registry Browser

  This part also includes appendixes on HTTP and Java encoding schemes.

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 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 1.0_01. 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. You use the manager tool to install, list, reload, and remove 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 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 Index

This tutorial contains information on the 1.0 version of the Java Web Services Developer Pack.

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