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. This tutorial requires a full installation (Typical, not Custom) of the Java WSDP.
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:
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 Architecture for XML Binding (JAXB)
- 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.
- Case Study
The Coffee Break Application chapter in this part describes an application that ties together most of the APIs discussed in this tutorial.
The appendixes cover the tools shipped with the Java WSDP.
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 in the The Java Tutorial that are particularly relevant are listed in Table P-1:
Table P-1 Relevant Topics in The Java Tutorial Topic Web Page JDBC technology Threads JavaBeans architecture Security
Running the Examples
This section tells you everything you need to know to obtain, build, install, and run the examples.
If you are viewing this online, you need to download The Java Web Services Tutorial from:
Once you have installed the tutorial bundle using a Typical installation (installed all of the components), the example source code is in the
>/docs/tutorial/examplesdirectory, with subdirectories for each of the technologies included in the pack.
This tutorial documents the Java WSDP 1.1. To build, deploy, and run the examples you need a copy of the Java WSDP and the Java 2 Software Development Kit, Standard Edition (J2SE SDK) 1.3.1_07, 1.4.0_03, or 1.4.1_01. You download the Java WSDP from:
the J2SE 1.3.1 SDK from
or the J2SE 1.4 SDK from
bindirectories of the Java WSDP and J2SE SDK installations to the front of your
PATHenvironment variable so that the Java WSDP startup scripts for Tomcat overrides other installations.
Building the Examples
Most of the examples are distributed with a build file for
Ant1.5.1, a portable build tool contained in the Java WSDP. Directions for building the examples are provided in each chapter.
The version of
Antshipped with the Java WSDP sets the
jwsdp.homeenvironment variable, which is required by the example build files. To ensure that you use this version of
Ant, you must add
>/jakarta-ant-1.5.1/binto the front of your
Managing the Examples
Many of the Java WSDP examples run on the Tomcat Java servlet and JSP container. You use the
managertool 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:
- Ensure that Adobe Acrobat Reader is installed on your system.
- Open the PDF version of this book.
- Click the printer icon in Adobe Acrobat Reader.
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
URLs, code examples, file names, command names, programming language keywords
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.
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.