The J2EETM Tutorial
Home
TOC
PREV TOC NEXT Search
Feedback

Preface

The Java Tutorial has been an indispensable resource for many programmers learning the Java programming language. This tutorial hopes to serve the same role for developers encountering the JavaTM 2 Platform, Enterprise Edition (J2EETM) for the first time. It follows an example-oriented focus similar to the Java Tutorial.

Who Should Use This Tutorial
About the Examples
Related Information
Typographical Conventions
Acknowledgments

Who Should Use This Tutorial

This tutorial is intended for programmers interested in developing and deploying J2EE applications. It covers the main component technologies comprising the J2EE platform and describes how to develop J2EE components and deploy them on the J2EE SDK.

This tutorial is not intended for J2EE server or tools vendors. It does not explain how to implement the J2EE architecture, nor does it explain the internals of the J2EE SDK. The J2EE specifications describe the J2EE architecture and can be downloaded from:

http://java.sun.com/j2ee/docs.html#specs 

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 following topics in the Java Tutorial are particularly relevant:

Topic
Java Tutorial
JDBCTM
http://java.sun.com/docs/books/tutorial/jdbc
Threads
http://java.sun.com/docs/books/tutorial/essential/threads
JavaBeansTM
http://java.sun.com/docs/books/tutorial/javabeans
Security
http://java.sun.com/docs/books/tutorial/security1.2

Where to Find the Examples

If you are viewing this online, and you want to build and run the examples, you need to download the tutorial bundle from:

http://java.sun.com/j2ee/download.html#tutorial 
Once you have installed the bundle, the example code is in the examples/src directory, with subdirectories ejb for enterprise bean technology examples, web for web technology examples, and connector for connector technology examples.

How to Build and Run the Examples

This tutorial documents the J2EE SDK version 1.3. To build, deploy, and run the examples you need a copy of the J2EE SDK and the J2SE SDK version 1.3, also known as a JDK. You can download the J2EE SDK from:
http://java.sun.com/j2ee/download.html#sdk 

and the J2SE 1.3 from:

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

The examples are distributed with a configuration file for ant version 1.2. A portable make tool, ant is hosted by the Jakarta project at the Apache Software Foundation. You can download ant from:

http://jakarta.apache.org/builds/jakarta-ant/release/v1.2/bin 
To build the examples:
  1. Download and install a binary version of ant.
  2. Go to the examples/src directory.
  3. Open the file build.xml in a text editor. Edit the line:
    <property name="j2ee-home" value="C:\j2sdkee1.3" /> 
    
    and set the value of the j2ee-home property to be the J2EE SDK installation directory.
  4. Execute ant target. For example, to build all the examples, execute ant all or to build the web layer examples, execute ant web. The build process deposits the output into the directory examples/build.

Related Information

This tutorial provides a concise overview of how to use the central component technologies in the J2EE platform. For more information about these technologies, see:

Component Technology
Web Site
Enterprise JavaBeansTM (EJBTM)
http://java.sun.com/products/ejb
Java Servlet
http://java.sun.com/products/servlets
JavaServer PagesTM (JSPTM)
http://java.sun.com/products/jsp

The J2EE platform includes a wide variety of APIs that this tutorial only briefly touches on. Some of these technologies have their own tutorials:

API
Tutorial
Java Message Service (JMS)
http://java.sun.com/products/jms/tutorial/
Java Naming and Directory
InterfaceTM (JNDI)
http://java.sun.com/products/jndi/tutorial/
Extensible Markup Language (XML)
http://java.sun.com/xml/tutorial_intro.html

For complete information on these topics see:

API
Web Site
XML
http://java.sun.com/xml
J2EE Connector
http://java.sun.com/j2ee/connector
JavaMailTM
http://java.sun.com/products/javamail
JMS
http://java.sun.com/products/jms
JNDI
http://java.sun.com/products/jndi
JDBCTM
http://java.sun.com/products/jdbc

Once you have become familiar with the J2EE technologies described in this tutorial, you may be interested in guidelines for architecting J2EE applications. The J2EE Blueprints is a book and sample application that illustrate best practices for developing and deploying J2EE applications. You can obtain the J2EE Blueprints from:

http://java.sun.com/j2ee/blueprints 

Typographical Conventions

The following table lists the typographical conventions used in this tutorial.

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

Acknowledgments

The J2EE tutorial team would like to thank the J2EE SDK team for their technical advice and enthusiasm.

We would also like to thank our manager Jim Inscore for his support and steadying influence.

The chapters on web components use an example and some material that first appeared in the servlet trail of the Java Tutorial. The chapter on custom tags describes a template tag library that first appeared in the J2EE Blueprints.

Home
TOC
PREV TOC NEXT Search
Feedback