Java 2 Platform, Enterprise Edition (J2EE) : XML Schemas for J2EE Deployment Descriptors

Table of contents

1. Introduction
2. Using J2EE Schemas
3. J2EE 1.4 Schema Resources
4. J2EE DTDs

1. Introduction

This document lists the document formats that will be used by the Java 2 Platform, Enterprise Edition (J2EE) deployment descriptors described by J2EE 1.4 and later specifications. Prior to the J2EE 1.4 specifications, each Deployment Descriptor must be valid with respect to a specific DTD that describes the Deployment Descriptor. They are found in the J2EE section of this document. Starting with the J2EE 1.4 specification, each specification requires its Deployment Descriptor be validated with respect to an XML Schema that is listed by this document. Note that deployment descriptors defined by previous versions of the J2EE specification must also be supported, and must continue to be validated against the corresponding DTD.

This document describes how to use the J2EE schemas that are described as a set of modules and provides a list of XML Schemas for each deployment descriptor.

2. Using J2EE Schemas

All J2EE Deployment Descriptor Schemas share the namespace, http://www.oracle.com/webfolder/technetwork/jsc/xml/ns/javaee/index.html. Each schema document contains a version attribute that contains the version of the specification. For example, the XML Schema document for the Servlet specification contains the version attribute value "2.4", pertaining to the specific version of the specification as well as the schema document itself.

Each J2EE XML Schema document's file name contains the specific version of the related specification. This is introduced for convenience to locate specific versions of the schema documents. However, Deployment Descriptor instances are not required to refer to a specific file. Instead, an instance must specify the version of the corresponding specification by using a version attribute. For example, connector Deployment Descriptor instances that must be processed with the Connector 1.5 version must indicate the version within the version attribute of the instance document, for example, "1.5". The Deployment Descriptor processors use the version information to choose the appropriate version of the schema document(s) to process the Deployment Descriptor instances.

A specific version of the J2EE specification contains a set of deployment descriptor schemas that constitute the J2EE Schema. The common definitions are contained in the j2ee_<version>.xsd document that may be included by several J2EE Deployment Descriptor schemas.

3. J2EE 1.4 Schema Resources

This table contains the XML Schema components for J2EE 1.4 schema.

4. J2EE DTDs

DTDs specified by previous versions of the J2EE specification are available at http://www.oracle.com/webfolder/technetwork/jsc/xml/ns/javaee/index.html.