jaxws/src/java.xml.bind/share/classes/javax/xml/bind/annotation/XmlType.java
changeset 47210 1edad689f56c
parent 32795 5a5710ee05a0
equal deleted inserted replaced
47209:9f0f88e8f5a7 47210:1edad689f56c
     1 /*
     1 /*
     2  * Copyright (c) 2004, 2015, Oracle and/or its affiliates. All rights reserved.
     2  * Copyright (c) 2004, 2017, Oracle and/or its affiliates. All rights reserved.
     3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
     3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
     4  *
     4  *
     5  * This code is free software; you can redistribute it and/or modify it
     5  * This code is free software; you can redistribute it and/or modify it
     6  * under the terms of the GNU General Public License version 2 only, as
     6  * under the terms of the GNU General Public License version 2 only, as
     7  * published by the Free Software Foundation.  Oracle designates this
     7  * published by the Free Software Foundation.  Oracle designates this
   111  * <p>
   111  * <p>
   112  * The following table shows the mapping of the class to a XML Schema
   112  * The following table shows the mapping of the class to a XML Schema
   113  * complex type or simple type. The notational symbols used in the table are:
   113  * complex type or simple type. The notational symbols used in the table are:
   114  * <ul>
   114  * <ul>
   115  *   <li> {@literal ->}    : represents a mapping </li>
   115  *   <li> {@literal ->}    : represents a mapping </li>
   116  *   <li> [x]+  : one or more occurances of x </li>
   116  *   <li> [x]+  : one or more occurrences of x </li>
   117  *   <li> [ {@code @XmlValue} property ]: JavaBean property annotated with
   117  *   <li> [ {@code @XmlValue} property ]: JavaBean property annotated with
   118  *         {@code @XmlValue}</li>
   118  *         {@code @XmlValue}</li>
   119  *   <li> X     : don't care
   119  *   <li> X     : don't care
   120  * </ul>
   120  * </ul>
   121  * <blockquote>
   121  * <blockquote>
   122  *   <table summary="" border="1" cellpadding="4" cellspacing="3">
   122  *   <table class="striped">
       
   123  *     <thead>
       
   124  *       <tr>
       
   125  *         <th scope="col">Target</th>
       
   126  *         <th scope="col">propOrder</th>
       
   127  *         <th scope="col">ClassBody</th>
       
   128  *         <th scope="col">ComplexType</th>
       
   129  *         <th scope="col">SimpleType</th>
       
   130  *       </tr>
       
   131  *     </thead>
       
   132  *
   123  *     <tbody>
   133  *     <tbody>
   124  *       <tr>
   134  *       <tr>
   125  *         <td><b>Target</b></td>
       
   126  *         <td><b>propOrder</b></td>
       
   127  *         <td><b>ClassBody</b></td>
       
   128  *         <td><b>ComplexType</b></td>
       
   129  *         <td><b>SimpleType</b></td>
       
   130  *       </tr>
       
   131  *
       
   132  *       <tr valign="top">
       
   133  *         <td>Class</td>
   135  *         <td>Class</td>
   134  *         <td>{}</td>
   136  *         <td>{}</td>
   135  *         <td>[property]+ {@literal ->} elements</td>
   137  *         <th scope="row">[property]+ {@literal ->} elements</th>
   136  *         <td>complexcontent<br>xs:all</td>
   138  *         <td>complexcontent<br>xs:all</td>
   137  *         <td> </td>
   139  *         <td> </td>
   138  *       </tr>
   140  *       </tr>
   139  *
   141  *
   140  *       <tr valign="top">
   142  *       <tr>
   141  *         <td>Class</td>
   143  *         <td>Class</td>
   142  *         <td>non empty</td>
   144  *         <td>non empty</td>
   143  *         <td>[property]+ {@literal ->} elements</td>
   145  *         <th scope="row">[property]+ {@literal ->} elements</th>
   144  *         <td>complexcontent<br>xs:sequence</td>
   146  *         <td>complexcontent<br>xs:sequence</td>
   145  *         <td> </td>
   147  *         <td> </td>
   146  *       </tr>
   148  *       </tr>
   147  *
   149  *
   148  *       <tr valign="top">
   150  *       <tr>
   149  *         <td>Class</td>
   151  *         <td>Class</td>
   150  *         <td>X</td>
   152  *         <td>X</td>
   151  *         <td>no property {@literal ->} element</td>
   153  *         <th scope="row">no property {@literal ->} element</th>
   152  *         <td>complexcontent<br>empty sequence</td>
   154  *         <td>complexcontent<br>empty sequence</td>
   153  *         <td> </td>
   155  *         <td> </td>
   154  *       </tr>
   156  *       </tr>
   155  *
   157  *
   156  *       <tr valign="top">
   158  *       <tr>
   157  *         <td>Class</td>
   159  *         <td>Class</td>
   158  *         <td>X</td>
   160  *         <td>X</td>
   159  *         <td>1 [{@code @XmlValue} property] {@literal &&} <br> [property]+ {@literal ->} attributes</td>
   161  *         <th scope="row">1 [{@code @XmlValue} property] {@literal &&} <br> [property]+ {@literal ->} attributes</th>
   160  *         <td>simplecontent</td>
   162  *         <td>simplecontent</td>
   161  *         <td> </td>
   163  *         <td> </td>
   162  *       </tr>
   164  *       </tr>
   163  *
   165  *
   164  *       <tr valign="top">
   166  *       <tr>
   165  *         <td>Class</td>
   167  *         <td>Class</td>
   166  *         <td>X</td>
   168  *         <td>X</td>
   167  *         <td>1 [{@code @XmlValue} property] {@literal &&} <br> no properties {@literal ->} attribute</td>
   169  *         <th scope="row">1 [{@code @XmlValue} property] {@literal &&} <br> no properties {@literal ->} attribute</th>
   168  *         <td> </td>
   170  *         <td> </td>
   169  *         <td>simpletype</td>
   171  *         <td>simpletype</td>
   170  *       </tr>
   172  *       </tr>
   171  *     </tbody>
   173  *     </tbody>
   172  *   </table>
   174  *   </table>