Home TOC |
![]() ![]() |
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:
- Tomcat servlet and JSP container
Ant
build tooldeploytool
web application deployment utility- Java WSDP Registry Server
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
http://java.sun.com/j2se/1.3/http://java.sun.com/j2se/1.4/Add the
bin
directories of the Java WSDP and J2SE SDK installations to the front of yourPATH
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.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 namedbuild.properties
in your home directory with the following contents:username=ManagerName password=ManagerPasswordReplace 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 beC:\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:
JAXM-HOME
toJWSDP_HOME/docs/jaxm/index.html
JAXP-HOME
toJWSDP_HOME/docs/jaxp/index.html
JAXR-HOME
toJWSDP_HOME/docs/jaxr/index.html
JAXRPC-HOME
toJWSDP_HOME/docs/jaxrpc/index.html
Table P-3 Related Information Technology
Web Site
Java Servlets
http://java.sun.com/products/servlet/index.html
JavaServer Pages
http://java.sun.com/products/jsp/index.html
JSP Standard Tag Library
http://java.sun.com/products/jsp/taglibraries.html#jstl
JAXM
http://java.sun.com/xml/jaxm/index.html
JAXP
http://java.sun.com/xml/jaxp/index.html
JAXR
http://java.sun.com/xml/jaxr/index.html
JAX-RPC
http://java.sun.com/xml/jaxrpc/index.html
Tomcat
http://jakarta.apache.org/tomcat/index.html
Ant
http://jakarta.apache.org/ant/index.html
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.
Typographical Conventions
Table P-4 lists the typographical conventions used in this tutorial.
Menu selections indicated with the right-arrow character
, for example, First
Second, should be interpreted as: select the First menu, then choose Second from the First submenu.
Home TOC |
![]() ![]() |