Java EE: XML Schemas for Java EE Deployment Descriptors

By Bill Shannon, Java EE Spec Lead, Oracle, August 21, 2017

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

Contents
 
Introduction
Using Java EE Schemas
Java EE 8 Schema Resources
Java EE 7 Schema Resources
Java EE 6 Schema Resources
Java EE 5 Schema Resources
J2EE 1.4 XML Schemas
J2EE 1.3 DTDs
J2EE 1.2 DTDs
 
Introduction

This document lists the document formats that will be used by the Java Platform, Enterprise Edition (Java EE) deployment descriptors described by Java EE 5 and later specifications. Prior to the J2EE 1.4 specifications, each Deployment Descriptor was required to be valid with respect to a specific DTD that describes the Deployment Descriptor. The DTDs 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 in the J2EE 1.4 document and this document. Note that deployment descriptors defined by previous versions of the Java EE specification must also be supported by all current Java EE products, and must continue to be validated against the corresponding DTD or schema. Note that not all deployment descriptors are updated for every release of Java EE, in which case the deployment descriptor from the previous version is used.

The Java EE specification also requires support for the Java Persistence API and the Bean Validation API. The Java Persistence API Schemas are available at http://xmlns.jcp.org/xml/ns/persistence/. The Bean Validation API Schemas are available at http://www.jboss.org/xml/ns/javax/validation/configuration/.

This document describes how to use the Java EE schemas and provides a list of XML Schemas for each deployment descriptor.

Using Java EE Schemas

All Java EE 7 and newer Deployment Descriptor Schemas share the namespace http://xmlns.jcp.org/xml/ns/javaee/. 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 "3.1", pertaining to the specific version of the specification as well as the schema document itself.

Each Java EE 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 the version attribute. For example, servlet Deployment Descriptor instances that must be processed with the servlet 3.1 version must indicate the version within the version attribute of the instance document, for example, "3.1". 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 Java EE specification contains a set of deployment descriptor schemas to constitute the Java EE Schema. The common definitions are contained in the javaee_<version>.xsd document that may be included by several Java EE Deployment Descriptor schemas.

Java EE 8 Schema Resources

This table contains the XML Schema components for Java EE 8 schema. All new schemas are in the http://xmlns.jcp.org/xml/ns/javaee/ namespace. Most older schemas remain in the http://java.sun.com/xml/ns/javaee/ namespace.

Date Published File Name Description Status
August 21, 2017 application_8.xsd Application schema Final Release
August 21, 2017 application-client_8.xsd Application Client schema Final Release
April 30, 2013 batchXML_1_0.xsd Schema for batch.xml-based artifact loading in Java Batch Final Release
August 21, 2017 beans_2_0.xsd Contexts and Dependency Injection schema Final Release
April 30, 2013 connector_1_7.xsd Java EE Connector schema Final Release
April 30, 2013 ejb-jar_3_2.xsd Enterprise JavaBeans Deployment Descriptor Schema Final Release
August 21, 2017 javaee_8.xsd Java EE 8 definitions file that contains common schema components Final Release
April 30, 2013 javaee_web_services_1_4.xsd Web services schema Final Release
April 30, 2013 javaee_web_services_client_1_4.xsd Web services client schema Final Release
April 30, 2013 jobXML_1_0.xsd Batch Job Specification Language (JSL) schema Final Release
April 30, 2013 jsp_2_3.xsd JavaServer Pages Deployment Descriptor schema Final Release
April 30, 2013 permissions_7.xsd Java EE application permissions schema Final Release
August 21, 2017 web-app_4_0.xsd Web Application Deployment Descriptor schema Final Release
August 21, 2017 web-common_4_0.xsd Web Application Deployment Descriptor common definitions schema Final Release
August 21, 2017 web-fragment_4_0.xsd Web Application Deployment Descriptor fragment schema Final Release
August 21, 2017 web-facelettaglibrary_2_3.xsd JavaServer Faces Facelet Tag Library schema Final Release
August 21, 2017 web-facesconfig_2_3.xsd JavaServer Faces Application Configuration File schema Final Release
August 21, 2017 web-partialresponse_2_3.xsd JavaServer Faces partial response schema Final Release
July 1, 2009 web-facesuicomponent_2_0.xsd JavaServer Faces UI Component Configuration schema Final Release
December 10, 2009 web-jsptaglibrary_2_1.xsd JSP Taglibrary Deployment Descriptor schema Final Release
November 21, 2007 javaee_web_services_metadata_handler_2_0.xsd Web services schema Final Release
- http://www.w3.org/2001/xml.xsd The Java EE schemas use some common definitions provided and published by W3C -



Java EE 7 Schema Resources

This table contains the XML Schema components for Java EE 7 schema. All new schemas are in the http://xmlns.jcp.org/xml/ns/javaee/ namespace. Most older schemas remain in the http://java.sun.com/xml/ns/javaee/ namespace.

Date Published File Name Description Status
April 30, 2013 application_7.xsd Application schema Final Release
April 30, 2013 application-client_7.xsd Application Client schema Final Release
April 30, 2013 batchXML_1_0.xsd Schema for batch.xml-based artifact loading in Java Batch Final Release
April 30, 2013 beans_1_1.xsd Contexts and Dependency Injection schema Final Release
April 30, 2013 connector_1_7.xsd Java EE Connector schema Final Release
April 30, 2013 ejb-jar_3_2.xsd Enterprise JavaBeans Deployment Descriptor Schema Final Release
April 30, 2013 javaee_7.xsd Java EE 7 definitions file that contains common schema components Final Release
April 30, 2013 javaee_web_services_1_4.xsd Web services schema Final Release
April 30, 2013 javaee_web_services_client_1_4.xsd Web services client schema Final Release
April 30, 2013 jobXML_1_0.xsd Batch Job Specification Language (JSL) schema Final Release
April 30, 2013 jsp_2_3.xsd JavaServer Pages Deployment Descriptor schema Final Release
April 30, 2013 permissions_7.xsd Java EE application permissions schema Final Release
April 30, 2013 web-app_3_1.xsd Web Application Deployment Descriptor schema Final Release
April 30, 2013 web-common_3_1.xsd Web Application Deployment Descriptor common definitions schema Final Release
April 30, 2013 web-fragment_3_1.xsd Web Application Deployment Descriptor fragment schema Final Release
April 30, 2013 web-facelettaglibrary_2_2.xsd JavaServer Faces Facelet Tag Library schema Final Release
April 30, 2013 web-facesconfig_2_2.xsd JavaServer Faces Application Configuration File schema Final Release
April 30, 2013 web-partialresponse_2_2.xsd JavaServer Faces partial response schema Final Release
July 1, 2009 web-facesuicomponent_2_0.xsd JavaServer Faces UI Component Configuration schema Final Release
December 10, 2009 web-jsptaglibrary_2_1.xsd JSP Taglibrary Deployment Descriptor schema Final Release
November 21, 2007 javaee_web_services_metadata_handler_2_0.xsd Web services schema Final Release
- http://www.w3.org/2001/xml.xsd The Java EE schemas use some common definitions provided and published by W3C -



Java EE 6 Schema Resources

This table contains the XML Schema components for Java EE 6 schema. All of these schemas are in the http://java.sun.com/xml/ns/javaee namespace.

Date Published File Name Description Status
December 10, 2009 application_6.xsd Application schema Final Release
December 10, 2009 application-client_6.xsd Application Client schema Final Release
December 10, 2009 beans_1_0.xsd Contexts and Dependency Injection schema Final Release
December 10, 2009 connector_1_6.xsd Java EE Connector schema Final Release
December 10, 2009 ejb-jar_3_1.xsdEnterprise JavaBeans Deployment Descriptor Schema Final Release
December 10, 2009 javaee_6.xsd Java EE 6 definitions file that contains common schema components Final Release
December 10, 2009 javaee_web_services_1_3.xsd Web services schema Final Release
December 10, 2009 javaee_web_services_client_1_3.xsd Web services client schema Final Release
December 10, 2009 jsp_2_2.xsd JavaServer Pages Deployment Descriptor schema Final Release
December 10, 2009 web-app_3_0.xsd Web Application Deployment Descriptor schema Final Release
December 10, 2009 web-common_3_0.xsd Web Application Deployment Descriptor common definitions schema Final Release
December 10, 2009 web-fragment_3_0.xsd Web Application Deployment Descriptor fragment schema Final Release
July 1, 2009 web-facelettaglibrary_2_0.xsd JavaServer Faces Facelet Tag Library schema Final Release
July 1, 2009 web-facesconfig_2_0.xsd JavaServer Faces Application Configuration File schema Final Release
July 1, 2009 web-facesuicomponent_2_0.xsd JavaServer Faces UI Component Configuration schema Final Release
July 1, 2009 web-partialresponse_2_0.xsd JavaServer Faces partial response schema Final Release
December 10, 2009 web-jsptaglibrary_2_1.xsd JSP Taglibrary Deployment Descriptor schema Final Release
November 21, 2007 javaee_web_services_metadata_handler_2_0.xsd Web services schema Final Release
- http://www.w3.org/2001/xml.xsd The Java EE schemas use some common definitions provided and published by W3C -



Java EE 5 Schema Resources

This table contains the XML Schema components for Java EE 5 schema. All of these schemas are in the http://java.sun.com/xml/ns/javaee namespace.

Date Published File Name Description Status
May 2, 2006 application_5.xsd Application schema Final Release
May 2, 2006 application-client_5.xsd Application Client schema Final Release
May 2, 2006 ejb-jar_3_0.xsdEnterprise JavaBeans Deployment Descriptor Schema Final Release
May 2, 2006 javaee_5.xsd Java EE 5 definitions file that contains common schema components Final Release
May 2, 2006 javaee_web_services_1_2.xsd Web services schema Final Release
May 2, 2006 javaee_web_services_client_1_2.xsd Web services client schema Final Release
May 2, 2006 jsp_2_1.xsd JavaServer Pages Deployment Descriptor Schema Final Release
May 2, 2006 web-app_2_5.xsdServlet Deployment Descriptor Schema Final Release
July 1, 2008 web-facesconfig_1_2.xsd JavaServer Faces Application Configuration File schema Final Release
May 2, 2006 web-jsptaglibrary_2_1.xsd JSP Taglibrary Deployment Descriptor Schema Final Release
November 21, 2007 javaee_web_services_metadata_handler_2_0.xsd Java EE Web Services Metadata Handler Chain Schema Final Release
- http://www.w3.org/2001/xml.xsd The Java EE schemas use some common definitions provided and published by W3C -



J2EE 1.4 XML Schemas

XML Schemas specified by the J2EE 1.4 specification are available at http://java.sun.com/xml/ns/j2ee/.

J2EE 1.3 DTDs

DTDs specified by the J2EE 1.3 specification are available at http://java.sun.com/dtd/.

J2EE 1.2 DTDs

DTDs specified by the J2EE 1.2 specification are available at http://java.sun.com/j2ee/dtds/.