Thu, 31 Aug 2017 15:18:52 +0800
merge
aoqi@0 | 1 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> |
aoqi@0 | 2 | <!-- |
aoqi@0 | 3 | Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. |
aoqi@0 | 4 | DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
aoqi@0 | 5 | |
aoqi@0 | 6 | This code is free software; you can redistribute it and/or modify it |
aoqi@0 | 7 | under the terms of the GNU General Public License version 2 only, as |
aoqi@0 | 8 | published by the Free Software Foundation. Oracle designates this |
aoqi@0 | 9 | particular file as subject to the "Classpath" exception as provided |
aoqi@0 | 10 | by Oracle in the LICENSE file that accompanied this code. |
aoqi@0 | 11 | |
aoqi@0 | 12 | This code is distributed in the hope that it will be useful, but WITHOUT |
aoqi@0 | 13 | ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
aoqi@0 | 14 | FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
aoqi@0 | 15 | version 2 for more details (a copy is included in the LICENSE file that |
aoqi@0 | 16 | accompanied this code). |
aoqi@0 | 17 | |
aoqi@0 | 18 | You should have received a copy of the GNU General Public License version |
aoqi@0 | 19 | 2 along with this work; if not, write to the Free Software Foundation, |
aoqi@0 | 20 | Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. |
aoqi@0 | 21 | |
aoqi@0 | 22 | Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
aoqi@0 | 23 | or visit www.oracle.com if you need additional information or have any |
aoqi@0 | 24 | questions. |
aoqi@0 | 25 | --> |
aoqi@0 | 26 | |
aoqi@0 | 27 | <html> |
aoqi@0 | 28 | <head> |
aoqi@0 | 29 | |
aoqi@0 | 30 | |
aoqi@0 | 31 | </head> |
aoqi@0 | 32 | |
aoqi@0 | 33 | <body bgcolor="white"> |
aoqi@0 | 34 | |
aoqi@0 | 35 | <p> |
aoqi@0 | 36 | Defines annotations for customizing Java program elements to XML Schema mapping. |
aoqi@0 | 37 | |
aoqi@0 | 38 | <h2>Package Specification</h2> |
aoqi@0 | 39 | <p>The following table shows the JAXB mapping annotations |
aoqi@0 | 40 | that can be associated with each program element. </p> |
aoqi@0 | 41 | |
aoqi@0 | 42 | <table border="1" cellpadding="4" cellspacing="3"> |
aoqi@0 | 43 | <tbody> |
aoqi@0 | 44 | <tr> |
aoqi@0 | 45 | <td><b>Program Element</b></td> |
aoqi@0 | 46 | <td><b>JAXB annotation</b></td> |
aoqi@0 | 47 | </tr> |
aoqi@0 | 48 | <tr valign="top"> |
aoqi@0 | 49 | <td><b>Package</b></td> |
aoqi@0 | 50 | <td> |
aoqi@0 | 51 | <table> |
aoqi@0 | 52 | <tr valign="top"> |
aoqi@0 | 53 | <td><b><a HREF="../../../../javax/xml/bind/annotation/XmlAccessorOrder.html">XmlAccessorOrder</a></b></td> |
aoqi@0 | 54 | </tr> |
aoqi@0 | 55 | <tr valign="top"> |
aoqi@0 | 56 | <td><b><a HREF="../../../../javax/xml/bind/annotation/XmlAccessorType.html">XmlAccessorType</a></b></td> |
aoqi@0 | 57 | </tr> |
aoqi@0 | 58 | <tr valign="top"> |
aoqi@0 | 59 | <td><b><a HREF="../../../../javax/xml/bind/annotation/XmlSchema.html">XmlSchema</a></b></td> |
aoqi@0 | 60 | </tr> |
aoqi@0 | 61 | <tr valign="top"> |
aoqi@0 | 62 | <td><b><a HREF="../../../../javax/xml/bind/annotation/XmlSchemaType.html">XmlSchemaType</a></b></td> |
aoqi@0 | 63 | </tr> |
aoqi@0 | 64 | <tr valign="top"> |
aoqi@0 | 65 | <td><b><a HREF="../../../../javax/xml/bind/annotation/XmlSchemaTypes.html">XmlSchemaTypes</a></b></td> |
aoqi@0 | 66 | </tr> |
aoqi@0 | 67 | <tr valign="top"> |
aoqi@0 | 68 | <td><b><a HREF="../../../../javax/xml/bind/annotation/adapters/XmlJavaTypeAdapter.html">XmlJavaTypeAdapter</a></b></td> |
aoqi@0 | 69 | </tr> |
aoqi@0 | 70 | <tr valign="top"> |
aoqi@0 | 71 | <td><b><a HREF="../../../../javax/xml/bind/annotation/adapters/XmlJavaTypeAdapters.html">XmlJavaTypeAdapters</a></b></td> |
aoqi@0 | 72 | </tr> |
aoqi@0 | 73 | </table> |
aoqi@0 | 74 | </td> |
aoqi@0 | 75 | </tr> |
aoqi@0 | 76 | |
aoqi@0 | 77 | <tr valign="top"> |
aoqi@0 | 78 | <td><b>Class</b></td> |
aoqi@0 | 79 | <td> |
aoqi@0 | 80 | <table> |
aoqi@0 | 81 | <tr valign="top"> |
aoqi@0 | 82 | <td><b><a HREF="../../../../javax/xml/bind/annotation/XmlAccessorOrder.html">XmlAccessorOrder</a></b></td> |
aoqi@0 | 83 | </tr> |
aoqi@0 | 84 | <tr valign="top"> |
aoqi@0 | 85 | <td><b><a HREF="../../../../javax/xml/bind/annotation/XmlAccessorType.html">XmlAccessorType</a></b></td> |
aoqi@0 | 86 | </tr> |
aoqi@0 | 87 | <tr valign="top"> |
aoqi@0 | 88 | <td><b><a HREF="../../../../javax/xml/bind/annotation/XmlInlineBinaryData.html">XmlInlineBinaryData</a></b></td> |
aoqi@0 | 89 | </tr> |
aoqi@0 | 90 | <tr valign="top"> |
aoqi@0 | 91 | <td><b><a HREF="../../../../javax/xml/bind/annotation/XmlRootElement.html">XmlRootElement</a></b></td> |
aoqi@0 | 92 | </tr> |
aoqi@0 | 93 | <tr valign="top"> |
aoqi@0 | 94 | <td><b><a HREF="../../../../javax/xml/bind/annotation/XmlType.html">XmlType</a></b></td> |
aoqi@0 | 95 | </tr> |
aoqi@0 | 96 | <tr valign="top"> |
aoqi@0 | 97 | <td><b><a HREF="../../../../javax/xml/bind/annotation/adapters/XmlJavaTypeAdapter.html">XmlJavaTypeAdapter</a></b></td> |
aoqi@0 | 98 | </tr> |
aoqi@0 | 99 | </table> |
aoqi@0 | 100 | </td> |
aoqi@0 | 101 | </tr> |
aoqi@0 | 102 | |
aoqi@0 | 103 | <tr valign="top"> |
aoqi@0 | 104 | <td><b>Enum type</b></td> |
aoqi@0 | 105 | <td> |
aoqi@0 | 106 | <table> |
aoqi@0 | 107 | <tr valign="top"> |
aoqi@0 | 108 | <td><b><a HREF="../../../../javax/xml/bind/annotation/XmlEnum.html">XmlEnum</a></b></td> |
aoqi@0 | 109 | </tr> |
aoqi@0 | 110 | <tr valign="top"> |
aoqi@0 | 111 | <td><b><a HREF="../../../../javax/xml/bind/annotation/XmlEnumValue.html">XmlEnumValue (enum constant only)</a></b></td> |
aoqi@0 | 112 | </tr> |
aoqi@0 | 113 | <tr valign="top"> |
aoqi@0 | 114 | <td><b><a HREF="../../../../javax/xml/bind/annotation/XmlRootElement.html">XmlRootElement</a></b></td> |
aoqi@0 | 115 | </tr> |
aoqi@0 | 116 | <tr valign="top"> |
aoqi@0 | 117 | <td><b><a HREF="../../../../javax/xml/bind/annotation/XmlType.html">XmlType</a></b></td> |
aoqi@0 | 118 | </tr> |
aoqi@0 | 119 | <tr valign="top"> |
aoqi@0 | 120 | <td><b><a HREF="../../../../javax/xml/bind/annotation/adapters/XmlJavaTypeAdapter.html">XmlJavaTypeAdapter</a></b></td> |
aoqi@0 | 121 | </tr> |
aoqi@0 | 122 | </table> |
aoqi@0 | 123 | </td> |
aoqi@0 | 124 | </tr> |
aoqi@0 | 125 | |
aoqi@0 | 126 | <tr valign="top"> |
aoqi@0 | 127 | <td><b>JavaBean Property/field</b></td> |
aoqi@0 | 128 | <td> |
aoqi@0 | 129 | <table> |
aoqi@0 | 130 | <tr valign="top"> |
aoqi@0 | 131 | <td><b><a HREF="../../../../javax/xml/bind/annotation/XmlElement.html">XmlElement</a></b></td> |
aoqi@0 | 132 | </tr> |
aoqi@0 | 133 | <tr valign="top"> |
aoqi@0 | 134 | <td><b><a HREF="../../../../javax/xml/bind/annotation/XmlElements.html">XmlElements</a></b></td> |
aoqi@0 | 135 | </tr> |
aoqi@0 | 136 | <tr valign="top"> |
aoqi@0 | 137 | <td><b><a HREF="../../../../javax/xml/bind/annotation/XmlElementRef.html">XmlElementRef</a></b></td> |
aoqi@0 | 138 | </tr> |
aoqi@0 | 139 | <tr valign="top"> |
aoqi@0 | 140 | <td><b><a HREF="../../../../javax/xml/bind/annotation/XmlElementRefs.html">XmlElementRefs</a></b></td> |
aoqi@0 | 141 | </tr> |
aoqi@0 | 142 | <tr valign="top"> |
aoqi@0 | 143 | <td><b><a HREF="../../../../javax/xml/bind/annotation/XmlElementWrapper.html">XmlElementWrapper</a></b></td> |
aoqi@0 | 144 | </tr> |
aoqi@0 | 145 | <tr valign="top"> |
aoqi@0 | 146 | <td><b><a HREF="../../../../javax/xml/bind/annotation/XmlAnyElement.html">XmlAnyElement</a></b></td> |
aoqi@0 | 147 | </tr> |
aoqi@0 | 148 | <tr valign="top"> |
aoqi@0 | 149 | <td><b><a HREF="../../../../javax/xml/bind/annotation/XmlAttribute.html">XmlAttribute</a></b></td> |
aoqi@0 | 150 | </tr> |
aoqi@0 | 151 | <tr valign="top"> |
aoqi@0 | 152 | <td><b><a HREF="../../../../javax/xml/bind/annotation/XmlAnyAttribute.html">XmlAnyAttribute</a></b></td> |
aoqi@0 | 153 | </tr> |
aoqi@0 | 154 | <tr valign="top"> |
aoqi@0 | 155 | <td><b><a HREF="../../../../javax/xml/bind/annotation/XmlTransient.html">XmlTransient</a></b></td> |
aoqi@0 | 156 | </tr> |
aoqi@0 | 157 | <tr valign="top"> |
aoqi@0 | 158 | <td><b><a HREF="../../../../javax/xml/bind/annotation/XmlValue.html">XmlValue</a></b></td> |
aoqi@0 | 159 | </tr> |
aoqi@0 | 160 | <tr valign="top"> |
aoqi@0 | 161 | <td><b><a HREF="../../../../javax/xml/bind/annotation/XmlID.html">XmlID</a></b></td> |
aoqi@0 | 162 | </tr> |
aoqi@0 | 163 | <tr valign="top"> |
aoqi@0 | 164 | <td><b><a HREF="../../../../javax/xml/bind/annotation/XmlIDREF.html">XmlIDREF</a></b></td> |
aoqi@0 | 165 | </tr> |
aoqi@0 | 166 | <tr valign="top"> |
aoqi@0 | 167 | <td><b><a HREF="../../../../javax/xml/bind/annotation/XmlList.html">XmlList</a></b></td> |
aoqi@0 | 168 | </tr> |
aoqi@0 | 169 | <tr valign="top"> |
aoqi@0 | 170 | <td><b><a HREF="../../../../javax/xml/bind/annotation/XmlMixed.html">XmlMixed</a></b></td> |
aoqi@0 | 171 | </tr> |
aoqi@0 | 172 | <tr valign="top"> |
aoqi@0 | 173 | <td><b><a HREF="../../../../javax/xml/bind/annotation/XmlMimeType.html">XmlMimeType</a></b></td> |
aoqi@0 | 174 | </tr> |
aoqi@0 | 175 | <tr valign="top"> |
aoqi@0 | 176 | <td><b><a HREF="../../../../javax/xml/bind/annotation/XmlAttachmentRef.html">XmlAttachmentRef</a></b></td> |
aoqi@0 | 177 | </tr> |
aoqi@0 | 178 | <tr valign="top"> |
aoqi@0 | 179 | <td><b><a HREF="../../../../javax/xml/bind/annotation/XmlInlineBinaryData.html">XmlInlineBinaryData</a></b></td> |
aoqi@0 | 180 | </tr> |
aoqi@0 | 181 | <tr valign="top"> |
aoqi@0 | 182 | <td><b><a HREF="../../../../javax/xml/bind/annotation/XmlElementDecl.html">XmlElementDecl (only on method)</a></b></td> |
aoqi@0 | 183 | </tr> |
aoqi@0 | 184 | <tr valign="top"> |
aoqi@0 | 185 | <td><b><a HREF="../../../../javax/xml/bind/annotation/adapters/XmlJavaTypeAdapter.html">XmlJavaTypeAdapter</a></b></td> |
aoqi@0 | 186 | </tr> |
aoqi@0 | 187 | </table> |
aoqi@0 | 188 | </td> |
aoqi@0 | 189 | </tr> |
aoqi@0 | 190 | |
aoqi@0 | 191 | <tr valign="top"> |
aoqi@0 | 192 | <td><b>Parameter</b></td> |
aoqi@0 | 193 | <td> |
aoqi@0 | 194 | <table> |
aoqi@0 | 195 | <tr valign="top"> |
aoqi@0 | 196 | <td><b><a HREF="../../../../javax/xml/bind/annotation/XmlList.html">XmlList</a></b></td> |
aoqi@0 | 197 | </tr> |
aoqi@0 | 198 | <tr valign="top"> |
aoqi@0 | 199 | <td><b><a HREF="../../../../javax/xml/bind/annotation/XmlAttachmentRef.html">XmlAttachmentRef</a></b></td> |
aoqi@0 | 200 | </tr> |
aoqi@0 | 201 | <tr valign="top"> |
aoqi@0 | 202 | <td><b><a HREF="../../../../javax/xml/bind/annotation/XmlMimeType.html">XmlMimeType</a></b></td> |
aoqi@0 | 203 | </tr> |
aoqi@0 | 204 | <tr valign="top"> |
aoqi@0 | 205 | <td><b><a HREF="../../../../javax/xml/bind/annotation/adapters/XmlJavaTypeAdapter.html">XmlJavaTypeAdapter</a></b></td> |
aoqi@0 | 206 | </tr> |
aoqi@0 | 207 | </table> |
aoqi@0 | 208 | </td> |
aoqi@0 | 209 | </tr> |
aoqi@0 | 210 | |
aoqi@0 | 211 | </tbody> |
aoqi@0 | 212 | </table> |
aoqi@0 | 213 | <h3>Terminology</h3> |
aoqi@0 | 214 | <p> |
aoqi@0 | 215 | <b>JavaBean property and field:</b> For the purposes of |
aoqi@0 | 216 | mapping, there is no semantic difference between a field and |
aoqi@0 | 217 | a JavaBean property. Thus, an annotation that can be applied |
aoqi@0 | 218 | to a JavaBean property can always be applied to a |
aoqi@0 | 219 | field. Hence in the Javadoc documentation, for brevity, the |
aoqi@0 | 220 | term JavaBean property or property is used to mean either JavaBean |
aoqi@0 | 221 | property or a field. Where required, both are explicitly |
aoqi@0 | 222 | mentioned. |
aoqi@0 | 223 | <p> |
aoqi@0 | 224 | <b>top level class:</b> For the purpose of mapping, there is |
aoqi@0 | 225 | no semantic difference between a top level class and a |
aoqi@0 | 226 | static nested class. Thus, an annotation that can be applied |
aoqi@0 | 227 | to a top level class, can always be applied to a nested |
aoqi@0 | 228 | static class. Hence in the Javadoc documentation, for |
aoqi@0 | 229 | brevity, the term "top level class" or just class is used to |
aoqi@0 | 230 | mean either a top level class or a nested static |
aoqi@0 | 231 | class. |
aoqi@0 | 232 | <p> |
aoqi@0 | 233 | <b>mapping annotation:</b>A JAXB 2.0 defined program |
aoqi@0 | 234 | annotation based on the JSR 175 programming annotation |
aoqi@0 | 235 | facility. |
aoqi@0 | 236 | <h3>Common Usage Constraints</h3> |
aoqi@0 | 237 | <p>The following usage constraints are defined here since |
aoqi@0 | 238 | they apply to more than annotation: |
aoqi@0 | 239 | <ul> |
aoqi@0 | 240 | <li> For a property, a given annotation can be applied to |
aoqi@0 | 241 | either read or write property but not both. </li> |
aoqi@0 | 242 | |
aoqi@0 | 243 | <li> A property name must be different from any other |
aoqi@0 | 244 | property name in any of the super classes of the |
aoqi@0 | 245 | class being mapped. </li> |
aoqi@0 | 246 | |
aoqi@0 | 247 | <li> A mapped field name or the decapitalized name of a |
aoqi@0 | 248 | mapped property must be unique within a class. </li> |
aoqi@0 | 249 | </ul> |
aoqi@0 | 250 | <h3>Notations</h3> |
aoqi@0 | 251 | <b>Namespace prefixes</b> |
aoqi@0 | 252 | <p>The following namespace prefixes are used in the XML Schema |
aoqi@0 | 253 | fragments in this package.<p> |
aoqi@0 | 254 | |
aoqi@0 | 255 | <table border="1" cellpadding="4" cellspacing="3"> |
aoqi@0 | 256 | <tbody> |
aoqi@0 | 257 | <tr> |
aoqi@0 | 258 | <td><b>Prefix</b></td> |
aoqi@0 | 259 | <td><b>Namespace</b></td> |
aoqi@0 | 260 | <td><b>Notes</b></td> |
aoqi@0 | 261 | </tr> |
aoqi@0 | 262 | |
aoqi@0 | 263 | <tr valign="top"> |
aoqi@0 | 264 | <td>xs</td> |
aoqi@0 | 265 | <td>http://www.w3.org/2001/XMLSchema</td> |
aoqi@0 | 266 | <td>Namespace of XML Schema namespace</td> |
aoqi@0 | 267 | </tr> |
aoqi@0 | 268 | <tr valign="top"> |
aoqi@0 | 269 | <td>ref</td> |
aoqi@0 | 270 | <td>http://ws-i.org/profiles/basic/1.1/xsd</td> |
aoqi@0 | 271 | <td>Namespace for swaref schema component</td> |
aoqi@0 | 272 | </tr> |
aoqi@0 | 273 | <tr valign="top"> |
aoqi@0 | 274 | <td>xsi</td> |
aoqi@0 | 275 | <td>http://www.w3.org/2001/XMLSchema-instance</td> |
aoqi@0 | 276 | <td>XML Schema namespace for instances</td> |
aoqi@0 | 277 | </tr> |
aoqi@0 | 278 | </tbody> |
aoqi@0 | 279 | </table> |
aoqi@0 | 280 | |
aoqi@0 | 281 | <!-- Put @see and @since tags down here. --> |
aoqi@0 | 282 | @since JAXB 2.0 |
aoqi@0 | 283 | </body> |
aoqi@0 | 284 | </html> |
aoqi@0 | 285 | |
aoqi@0 | 286 |