123 lines
5.5 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div class="header">
<div class="subTitle">
javax.xml.bind.annotation
</div>
<h2 class="title" title="Annotation Type XmlEnumValue">Annotation Type XmlEnumValue</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<hr/> <br/> <pre><a href="../../../../java/lang/annotation/Retention.html" title="annotation in java.lang.annotation">@Retention</a>(<a href="../../../../java/lang/annotation/Retention.html#value--">value</a>=<a href="../../../../java/lang/annotation/RetentionPolicy.html#RUNTIME">RUNTIME</a>)
<a href="../../../../java/lang/annotation/Target.html" title="annotation in java.lang.annotation">@Target</a>(<a href="../../../../java/lang/annotation/Target.html#value--">value</a>=<a href="../../../../java/lang/annotation/ElementType.html#FIELD">字段</a>)
public @interface <span class="memberNameLabel">XmlEnumValue</span></pre>
<div class="block">
<span>将一个枚举常数映射到<a href="../../../../java/lang/Enum.html" title="java.lang中的类"><code>Enum</code></a>类型到XML表示。</span>
<p> <span><b>用法</b></span> </p>
<p> <span><tt>@XmlEnumValue</tt>注释可以与以下程序元素一起使用:</span> </p>
<ul>
<li> <span>枚举常数</span> </li>
</ul>
<p> <span>有关其他常见信息请参阅javax.xml.bind.package javadoc中的“Package Specification”。</span> </p>
<p> <span>该注释与<a href="../../../../javax/xml/bind/annotation/XmlEnum.html" title="javax.xml.bind.annotation中的注释"><code>XmlEnum</code></a>一起提供了枚举类型到XML表示的映射。</span> </p>
<p> <span>枚举类型映射到具有枚举方面的模式简单类型。</span> <span>模式类型派生自@XmlEnum.value()中<tt>指定</tt>的Java类型。</span> <span>每个枚举常量<tt>@XmlEnumValue</tt>必须有一个有效的词汇表示类型<tt>@XmlEnum.value()</tt></span> </p>
<p> <span>在没有这个注释的情况下, <a href="../../../../java/lang/Enum.html#name--"><code>Enum.name()</code></a>被用作XML表示。</span> </p>
<p> <span><b>示例1</b>映射枚举常量名称 - &gt;枚举方面</span> </p>
<pre> <span>//Example: Code fragment
@XmlEnum(String.class)
public enum Card { CLUBS, DIAMONDS, HEARTS, SPADES }
&lt;!-- Example: XML Schema fragment --&gt;
&lt;xs:simpleType name="Card"&gt;
&lt;xs:restriction base="xs:string"/&gt;
&lt;xs:enumeration value="CLUBS"/&gt;
&lt;xs:enumeration value="DIAMONDS"/&gt;
&lt;xs:enumeration value="HEARTS"/&gt;
&lt;xs:enumeration value="SPADES"/&gt;
&lt;/xs:simpleType&gt;</span> </pre>
<p> <span><b>示例2</b>映射枚举常量名称(值) - &gt;枚举方面</span> </p>
<pre> <span>//Example: code fragment
@XmlType
@XmlEnum(Integer.class)
public enum Coin {
@XmlEnumValue("1") PENNY(1),
@XmlEnumValue("5") NICKEL(5),
@XmlEnumValue("10") DIME(10),
@XmlEnumValue("25") QUARTER(25) }
&lt;!-- Example: XML Schema fragment --&gt;
&lt;xs:simpleType name="Coin"&gt;
&lt;xs:restriction base="xs:int"&gt;
&lt;xs:enumeration value="1"/&gt;
&lt;xs:enumeration value="5"/&gt;
&lt;xs:enumeration value="10"/&gt;
&lt;xs:enumeration value="25"/&gt;
&lt;/xs:restriction&gt;
&lt;/xs:simpleType&gt;</span> </pre>
<p> <span><b>示例3</b>映射枚举常量名称 - &gt;枚举方面</span> </p>
<pre> <span>//Code fragment
@XmlType
@XmlEnum(Integer.class)
public enum Code {
@XmlEnumValue("1") ONE,
@XmlEnumValue("2") TWO;
}
&lt;!-- Example: XML Schema fragment --&gt;
&lt;xs:simpleType name="Code"&gt;
&lt;xs:restriction base="xs:int"&gt;
&lt;xs:enumeration value="1"/&gt;
&lt;xs:enumeration value="2"/&gt;
&lt;/xs:restriction&gt;
&lt;/xs:simpleType&gt;</span> </pre>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
JAXB 2.0
</dd>
</dl> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- =========== ANNOTATION TYPE REQUIRED MEMBER SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="annotation.type.required.element.summary">
<!-- --> </a> <h3>Required Element Summary</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Required Element Summary table, listing required elements, and an explanation">
<caption>
<span>Required Elements</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Required Element and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code><a href="../../../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/xml/bind/annotation/XmlEnumValue.html#value--">value</a></span></code> </td>
</tr>
</tbody>
</table> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ ANNOTATION TYPE MEMBER DETAIL =========== -->
<ul class="blockList">
<li class="blockList"><a name="annotation.type.element.detail">
<!-- --> </a> <h3>Element Detail</h3> <a name="value--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>value</h4> <pre>public abstract <a href="../../../../java/lang/String.html" title="class in java.lang">String</a> value</pre> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>