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

By Bill Shannon, Java EE Spec Lead, Oracle, April 7, 2017

Latest Version: http://xmlns.jcp.org/xml/ns/javaee/

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.

Date Published File Name Description Status
November 24, 2003 web-jsptaglibrary_2_0.xsd JSP Taglibrary Deployment Descriptor Schema Final Release
November 24, 2003 ejb-jar_2_1.xsd Enterprise JavaBeans Deployment Descriptor Schema Final Release
November 24, 2003 connector_1_5.xsd Connector Deployment Descriptor Schema Final Release
February, 2004 web-app_2_4.xsd Servlet Deployment Descriptor Schema Maintenance Release
November 24, 2003 jsp_2_0.xsd JavaServer Pages Deployment Descriptor Schema Final Release
November 24, 2003 j2ee_1_4.xsd J2EE 1.4 definitions file that contains common schema components Final Release
November 24, 2003 application-client_1_4.xsd Application Client schema Final Release
November 24, 2003 application_1_4.xsd Application schema Final Release
November 24, 2003 http://www.ibm.com/webservices/xsd/ j2ee_web_services_1_1.xsd Web services schema Final Release
November 24, 2003 http://www.ibm.com/webservices/xsd/ j2ee_web_services_client_1_1.xsd Web services client schema Final Release
November 24, 2003 http://www.ibm.com/webservices/xsd/ j2ee_jaxrpc_mapping_1_1.xsd JAX-RPC mapping schema Final Release
- http://www.w3.org/2001/xml.xsd The J2EE schemas use some common definitions provided and published by W3C -

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.

Oracle is reviewing the Sun product roadmap and will provide guidance to customers in accordance with Oracle's standard product communication policies. Any resulting features and timing of release of such features as determined by Oracle's review of roadmaps, are at the sole discretion of Oracle. All product roadmap information, whether communicated by Sun Microsystems or by Oracle, does not represent a commitment to deliver any material, code, or functionality, and should not be relied upon in making purchasing decisions. It is intended for information purposes only, and may not be incorporated into any contract.