blob: de065acc6646a03715cdefa21bc7c22d22ad3be9 [file] [log] [blame]
<?xml version="1.0" encoding="UTF-8"?>
<!--
Copyright (c) 2004, 2005, Oracle and/or its affiliates. All rights reserved.
DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
This code is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License version 2 only, as
published by the Free Software Foundation. Oracle designates this
particular file as subject to the "Classpath" exception as provided
by Oracle in the LICENSE file that accompanied this code.
This code is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
version 2 for more details (a copy is included in the LICENSE file that
accompanied this code).
You should have received a copy of the GNU General Public License version
2 along with this work; if not, write to the Free Software Foundation,
Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
or visit www.oracle.com if you need additional information or have any
questions.
-->
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>javax.xml.xpath</title>
<meta name="@author" content="mailto:Jeff.Suttor@Sun.com" />
<meta name="@see" content='<a href="http://www.w3.org/TR/xmlschema-2/#dateTime">W3C XML Schema 1.0 Part 2, Section 3.2.7-14</a>' />
<meta name="@see" content='<a href="http://www.w3.org/TR/xpath-datamodel#dt-dayTimeDuration">XQuery 1.0 and XPath 2.0 Data Model, xdt:dayTimeDuration</a>' />
<meta name="@see" content='<a href="http://www.w3.org/TR/xpath-datamodel#dt-yearMonthDuration">XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration</a>' />
<meta name="@since" content="1.5" />
</head>
<body>
<p>XML/Java Type Mappings.</p>
<p><code>javax.xml.datatype</code>API provides XML/Java type mappings.</p>
<p>The following XML standards apply:</p>
<ul>
<li><a href="http://www.w3.org/TR/xmlschema-2/#dateTime">W3C XML Schema 1.0 Part 2, Section 3.2.7-14</a></li>
<li><a href="http://www.w3.org/TR/xpath-datamodel#dt-dayTimeDuration">XQuery 1.0 and XPath 2.0 Data Model, xdt:dayTimeDuration</a></li>
<li><a href="http://www.w3.org/TR/xpath-datamodel#dt-yearMonthDuration">XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration</a></li>
</ul>
<hr />
<table border="1" cellpadding="2">
<thead>
<tr>
<th>W3C XML Schema Data Type</th>
<th>Java Data Type</th>
</tr>
</thead>
<tbody>
<tr>
<td>xs:date</td>
<td>{@link javax.xml.datatype.XMLGregorianCalendar}</td>
</tr>
<tr>
<td>xs:dateTime</td>
<td>{@link javax.xml.datatype.XMLGregorianCalendar}</td>
</tr>
<tr>
<td>xs:duration</td>
<td>{@link javax.xml.datatype.Duration}</td>
</tr>
<tr>
<td>xs:gDay</td>
<td>{@link javax.xml.datatype.XMLGregorianCalendar}</td>
</tr>
<tr>
<td>xs:gMonth </td>
<td>{@link javax.xml.datatype.XMLGregorianCalendar}</td>
</tr>
<tr>
<td>xs:gMonthDay</td>
<td>{@link javax.xml.datatype.XMLGregorianCalendar}</td>
</tr>
<tr>
<td>xs:gYear</td>
<td>{@link javax.xml.datatype.XMLGregorianCalendar}</td>
</tr>
<tr>
<td>xs:gYearMonth</td>
<td>{@link javax.xml.datatype.XMLGregorianCalendar}</td>
</tr>
<tr>
<td>xs:time</td>
<td>{@link javax.xml.datatype.XMLGregorianCalendar}</td>
</tr>
</tbody>
</table>
<hr />
<table border="1" cellpadding="2">
<thead>
<tr>
<th>XQuery 1.0 and XPath 2.0 Data Model</th>
<th>Java Data Type</th>
</tr>
</thead>
<tbody>
<tr>
<td>xdt:dayTimeDuration</td>
<td>{@link javax.xml.datatype.Duration}</td>
</tr>
<tr>
<td>xdt:yearMonthDuration</td>
<td>{@link javax.xml.datatype.Duration}</td>
</tr>
</tbody>
</table>
<hr />
<p>
W3C XML Schema data types that have a "<em>natural</em>" mapping to Java types are defined by
JSR 31: Java&trade; Architecture for XML Binding (JAXB) Specification, Binding XML Schema to Java Representations.
JAXB defined mappings for XML Schema built-in data types include:
</p>
<ul>
<li>xs:anySimpleType</li>
<li>xs:base64Binary</li>
<li>xs:boolean</li>
<li>xs:byte</li>
<li>xs:decimal</li>
<li>xs:double</li>
<li>xs:float</li>
<li>xs:hexBinary</li>
<li>xs:int</li>
<li>xs:integer</li>
<li>xs:long</li>
<li>xs:QName</li>
<li>xs:short</li>
<li>xs:string</li>
<li>xs:unsignedByte</li>
<li>xs:unsignedInt</li>
<li>xs:unsignedShort</li>
</ul>
<hr />
<ul>
<li>Author <a href="mailto:Jeff.Suttor@Sun.com">Jeff Suttor</a></li>
<li>See <a href="http://www.w3.org/TR/xmlschema-2/#dateTime">W3C XML Schema 1.0 Part 2, Section 3.2.7-14</a></li>
<li>See <a href="http://www.w3.org/TR/xpath-datamodel#dt-dayTimeDuration">XQuery 1.0 and XPath 2.0 Data Model, xdt:dayTimeDuration</a></li>
<li>See <a href="http://www.w3.org/TR/xpath-datamodel#dt-yearMonthDuration">XQuery 1.0 and XPath 2.0 Data Model, xdt:yearMonthDuration</a></li>
<li>Since 1.5</li>
</ul>
<hr />
</body>
</html>