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 PublishedFile NameDescriptionStatus
August 21, 2017application_8.xsdApplication schemaFinal Release
August 21, 2017application-client_8.xsdApplication Client schemaFinal Release
April 30, 2013batchXML_1_0.xsdSchema for batch.xml-based artifact loading in Java BatchFinal Release
August 21, 2017beans_2_0.xsdContexts and Dependency Injection schemaFinal Release
April 30, 2013connector_1_7.xsdJava EE Connector schemaFinal Release
April 30, 2013ejb-jar_3_2.xsdEnterprise JavaBeans Deployment Descriptor SchemaFinal Release
August 21, 2017javaee_8.xsdJava EE 8 definitions file that contains common schema componentsFinal Release
April 30, 2013javaee_web_services_1_4.xsdWeb services schemaFinal Release
April 30, 2013javaee_web_services_client_1_4.xsdWeb services client schemaFinal Release
April 30, 2013jobXML_1_0.xsdBatch Job Specification Language (JSL) schemaFinal Release
April 30, 2013jsp_2_3.xsdJavaServer Pages Deployment Descriptor schemaFinal Release
April 30, 2013permissions_7.xsdJava EE application permissions schemaFinal Release
August 21, 2017web-app_4_0.xsdWeb Application Deployment Descriptor schemaFinal Release
August 21, 2017web-common_4_0.xsdWeb Application Deployment Descriptor common definitions schemaFinal Release
August 21, 2017web-fragment_4_0.xsdWeb Application Deployment Descriptor fragment schemaFinal Release
August 21, 2017web-facelettaglibrary_2_3.xsdJavaServer Faces Facelet Tag Library schemaFinal Release
August 21, 2017web-facesconfig_2_3.xsdJavaServer Faces Application Configuration File schemaFinal Release
August 21, 2017web-partialresponse_2_3.xsdJavaServer Faces partial response schemaFinal Release
July 1, 2009web-facesuicomponent_2_0.xsdJavaServer Faces UI Component Configuration schemaFinal Release
December 10, 2009web-jsptaglibrary_2_1.xsdJSP Taglibrary Deployment Descriptor schemaFinal Release
November 21, 2007javaee_web_services_metadata_handler_2_0.xsdWeb services schemaFinal Release
-http://www.w3.org/2001/xml.xsdThe 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 PublishedFile NameDescriptionStatus
April 30, 2013application_7.xsdApplication schemaFinal Release
April 30, 2013application-client_7.xsdApplication Client schemaFinal Release
April 30, 2013batchXML_1_0.xsdSchema for batch.xml-based artifact loading in Java BatchFinal Release
April 30, 2013beans_1_1.xsdContexts and Dependency Injection schemaFinal Release
April 30, 2013connector_1_7.xsdJava EE Connector schemaFinal Release
April 30, 2013ejb-jar_3_2.xsdEnterprise JavaBeans Deployment Descriptor SchemaFinal Release
April 30, 2013javaee_7.xsdJava EE 7 definitions file that contains common schema componentsFinal Release
April 30, 2013javaee_web_services_1_4.xsdWeb services schemaFinal Release
April 30, 2013javaee_web_services_client_1_4.xsdWeb services client schemaFinal Release
April 30, 2013jobXML_1_0.xsdBatch Job Specification Language (JSL) schemaFinal Release
April 30, 2013jsp_2_3.xsdJavaServer Pages Deployment Descriptor schemaFinal Release
April 30, 2013permissions_7.xsdJava EE application permissions schemaFinal Release
April 30, 2013web-app_3_1.xsdWeb Application Deployment Descriptor schemaFinal Release
April 30, 2013web-common_3_1.xsdWeb Application Deployment Descriptor common definitions schemaFinal Release
April 30, 2013web-fragment_3_1.xsdWeb Application Deployment Descriptor fragment schemaFinal Release
April 30, 2013web-facelettaglibrary_2_2.xsdJavaServer Faces Facelet Tag Library schemaFinal Release
April 30, 2013web-facesconfig_2_2.xsdJavaServer Faces Application Configuration File schemaFinal Release
April 30, 2013web-partialresponse_2_2.xsdJavaServer Faces partial response schemaFinal Release
July 1, 2009web-facesuicomponent_2_0.xsdJavaServer Faces UI Component Configuration schemaFinal Release
December 10, 2009web-jsptaglibrary_2_1.xsdJSP Taglibrary Deployment Descriptor schemaFinal Release
November 21, 2007javaee_web_services_metadata_handler_2_0.xsdWeb services schemaFinal Release
-http://www.w3.org/2001/xml.xsdThe 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 PublishedFile NameDescriptionStatus
December 10, 2009application_6.xsdApplication schemaFinal Release
December 10, 2009application-client_6.xsdApplication Client schemaFinal Release
December 10, 2009beans_1_0.xsdContexts and Dependency Injection schemaFinal Release
December 10, 2009connector_1_6.xsdJava EE Connector schemaFinal Release
December 10, 2009ejb-jar_3_1.xsdEnterprise JavaBeans Deployment Descriptor SchemaFinal Release
December 10, 2009javaee_6.xsdJava EE 6 definitions file that contains common schema componentsFinal Release
December 10, 2009javaee_web_services_1_3.xsdWeb services schemaFinal Release
December 10, 2009javaee_web_services_client_1_3.xsdWeb services client schemaFinal Release
December 10, 2009jsp_2_2.xsdJavaServer Pages Deployment Descriptor schemaFinal Release
December 10, 2009web-app_3_0.xsdWeb Application Deployment Descriptor schemaFinal Release
December 10, 2009web-common_3_0.xsdWeb Application Deployment Descriptor common definitions schemaFinal Release
December 10, 2009web-fragment_3_0.xsdWeb Application Deployment Descriptor fragment schemaFinal Release
July 1, 2009web-facelettaglibrary_2_0.xsdJavaServer Faces Facelet Tag Library schemaFinal Release
July 1, 2009web-facesconfig_2_0.xsdJavaServer Faces Application Configuration File schemaFinal Release
July 1, 2009web-facesuicomponent_2_0.xsdJavaServer Faces UI Component Configuration schemaFinal Release
July 1, 2009web-partialresponse_2_0.xsdJavaServer Faces partial response schemaFinal Release
December 10, 2009web-jsptaglibrary_2_1.xsdJSP Taglibrary Deployment Descriptor schemaFinal Release
November 21, 2007javaee_web_services_metadata_handler_2_0.xsdWeb services schemaFinal Release
-http://www.w3.org/2001/xml.xsdThe 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 PublishedFile NameDescriptionStatus
May 2, 2006application_5.xsdApplication schemaFinal Release
May 2, 2006application-client_5.xsdApplication Client schemaFinal Release
May 2, 2006ejb-jar_3_0.xsdEnterprise JavaBeans Deployment Descriptor SchemaFinal Release
May 2, 2006javaee_5.xsdJava EE 5 definitions file that contains common schema componentsFinal Release
May 2, 2006javaee_web_services_1_2.xsdWeb services schemaFinal Release
May 2, 2006javaee_web_services_client_1_2.xsdWeb services client schemaFinal Release
May 2, 2006jsp_2_1.xsdJavaServer Pages Deployment Descriptor SchemaFinal Release
May 2, 2006web-app_2_5.xsdServlet Deployment Descriptor SchemaFinal Release
July 1, 2008web-facesconfig_1_2.xsdJavaServer Faces Application Configuration File schemaFinal Release
May 2, 2006web-jsptaglibrary_2_1.xsdJSP Taglibrary Deployment Descriptor SchemaFinal Release
November 21, 2007javaee_web_services_metadata_handler_2_0.xsdJava EE Web Services Metadata Handler Chain SchemaFinal Release
-http://www.w3.org/2001/xml.xsdThe 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/.

close