uTools-Manuals/docs/java/javax/xml/stream/XMLStreamReader.html

1439 lines
64 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">
compact2, compact3
</div>
<div class="subTitle">
javax.xml.stream
</div>
<h2 class="title" title="Interface XMLStreamReader">Interface XMLStreamReader</h2>
</div><div class="contentContainer">
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
All Superinterfaces:
</dt>
<dd>
<span><a href="../../../javax/xml/stream/XMLStreamConstants.html" title="javax.xml.stream中的接口">XMLStreamConstants</a></span>
</dd>
</dl>
<dl>
<dt>
所有已知实现类:
</dt>
<dd>
<span><a href="../../../javax/xml/stream/util/StreamReaderDelegate.html" title="javax.xml.stream.util中的类">StreamReaderDelegate</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public interface <span class="typeNameLabel">XMLStreamReader</span>
extends <a href="../../../javax/xml/stream/XMLStreamConstants.html" title="interface in javax.xml.stream">XMLStreamConstants</a></pre>
<div class="block">
<span>XMLStreamReader接口允许转发只读访问XML。</span>
<span>它被设计为读取XML数据的最低级别和最有效的方式。</span>
<p> <span>XMLStreamReader旨在使用next和hasNext来迭代XML。</span> <span>可以使用getEventTypegetNamespaceURIgetLocalName和getText等方法来访问数据;</span> </p>
<p> <span><a href="#next()">next()</a>方法使读者阅读下一个解析事件。</span> <span>next方法返回一个整数它标识刚刚读取的事件的类型。</span> </p>
<p> <span>事件类型可以使用<a href="#getEventType()">getEventType()确定</a></span> </p>
<p> <span>解析事件定义为XML声明DTD起始标记字符数据空格结束标签注释或处理指令。</span> <span>作为查询操作的结果,可能会在文档的根级别遇到属性或命名空间事件。</span> </p>
<p> <span>对于符合XML 1.0标准XML处理器必须将声明的未解析实体符号声明及其相关标识符的标识符传递给应用程序。</span> <span>此信息通过此接口上的属性API提供。</span> <span>以下两个属性允许访问此信息javax.xml.stream.notations和javax.xml.stream.entities。</span> <span>当当前事件是DTD时以下调用将返回符号列表<code>List l = (List) getProperty("javax.xml.stream.notations");</code>以下调用将返回实体声明的列表: <code>List l = (List) getProperty("javax.xml.stream.entities");</code>这些属性只能在DTD事件期间被访问如果信息不是它们被定义为返回null可用。</span> </p>
<p> <span>下表介绍哪些方法在什么状态下有效。</span> <span>如果一个方法在无效状态中被调用那么该方法将抛出一个java.lang.IllegalStateException。</span> </p>
<span> Valid methods for each state Event Type Valid Methods All States getProperty(), hasNext(), require(), close(), getNamespaceURI(), isStartElement(), isEndElement(), isCharacters(), isWhiteSpace(), getNamespaceContext(), getEventType(),getLocation(), hasText(), hasName() START_ELEMENT next(), getName(), getLocalName(), hasName(), getPrefix(), getAttributeXXX(), isAttributeSpecified(), getNamespaceXXX(), getElementText(), nextTag() ATTRIBUTE next(), nextTag() getAttributeXXX(), isAttributeSpecified(), NAMESPACE next(), nextTag() getNamespaceXXX() END_ELEMENT next(), getName(), getLocalName(), hasName(), getPrefix(), getNamespaceXXX(), nextTag() CHARACTERS next(), getTextXXX(), nextTag() CDATA next(), getTextXXX(), nextTag() COMMENT next(), getTextXXX(), nextTag() SPACE next(), getTextXXX(), nextTag() START_DOCUMENT next(), getEncoding(), getVersion(), isStandalone(), standaloneSet(), getCharacterEncodingScheme(), nextTag() END_DOCUMENT close() PROCESSING_INSTRUCTION next(), getPITarget(), getPIData(), nextTag() ENTITY_REFERENCE next(), getLocalName(), getText(), nextTag() DTD next(), getText(), nextTag() </span>
<table border="2" cellpadding="4" rules="all">
</table>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
1.6
</dd>
<dt>
<span class="simpleTagLabel">Version:</span>
</dt>
<dd>
1.0
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<span><a href="../../../javax/xml/stream/events/XMLEvent.html" title="javax.xml.stream.events中的接口"><code>XMLEvent</code></a> <a href="../../../javax/xml/stream/XMLInputFactory.html" title="javax.xml.stream中的类"><code>XMLInputFactory</code></a> <a href="../../../javax/xml/stream/XMLStreamWriter.html" title="javax.xml.stream中的接口"><code>XMLStreamWriter</code></a></span>
</dd>
</dl> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- =========== FIELD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="field.summary">
<!-- --> </a> <h3>Field Summary</h3>
<ul class="blockList">
<li class="blockList"><a name="fields.inherited.from.class.javax.xml.stream.XMLStreamConstants">
<!-- --> </a> <h3>Fields inherited from interface javax.xml.stream.<a href="../../../javax/xml/stream/XMLStreamConstants.html" title="interface in javax.xml.stream">XMLStreamConstants</a></h3> <code><a href="../../../javax/xml/stream/XMLStreamConstants.html#ATTRIBUTE">ATTRIBUTE</a>, <a href="../../../javax/xml/stream/XMLStreamConstants.html#CDATA">CDATA</a>, <a href="../../../javax/xml/stream/XMLStreamConstants.html#CHARACTERS">CHARACTERS</a>, <a href="../../../javax/xml/stream/XMLStreamConstants.html#COMMENT">COMMENT</a>, <a href="../../../javax/xml/stream/XMLStreamConstants.html#DTD">DTD</a>, <a href="../../../javax/xml/stream/XMLStreamConstants.html#END_DOCUMENT">END_DOCUMENT</a>, <a href="../../../javax/xml/stream/XMLStreamConstants.html#END_ELEMENT">END_ELEMENT</a>, <a href="../../../javax/xml/stream/XMLStreamConstants.html#ENTITY_DECLARATION">ENTITY_DECLARATION</a>, <a href="../../../javax/xml/stream/XMLStreamConstants.html#ENTITY_REFERENCE">ENTITY_REFERENCE</a>, <a href="../../../javax/xml/stream/XMLStreamConstants.html#NAMESPACE">NAMESPACE</a>, <a href="../../../javax/xml/stream/XMLStreamConstants.html#NOTATION_DECLARATION">NOTATION_DECLARATION</a>, <a href="../../../javax/xml/stream/XMLStreamConstants.html#PROCESSING_INSTRUCTION">PROCESSING_INSTRUCTION</a>, <a href="../../../javax/xml/stream/XMLStreamConstants.html#SPACE">SPACE</a>, <a href="../../../javax/xml/stream/XMLStreamConstants.html#START_DOCUMENT">START_DOCUMENT</a>, <a href="../../../javax/xml/stream/XMLStreamConstants.html#START_ELEMENT">START_ELEMENT</a></code></li>
</ul> </li>
</ul>
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method.summary">
<!-- --> </a> <h3>方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Method Summary table, listing methods, and an explanation">
<caption>
<span class="activeTableTab" id="t0"><span>所有方法</span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t2"><span><a href="javascript:show(2);">接口方法</a></span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t3"><span><a href="javascript:show(4);">抽象方法</a></span><span class="tabEnd"> </span></span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr class="altColor" id="i0">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLStreamReader.html#close--">close</a></span>()</code>
<div class="block">
释放与此Reader相关联的任何资源。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLStreamReader.html#getAttributeCount--">getAttributeCount</a></span>()</code>
<div class="block">
返回此START_ELEMENT上的属性数量此方法仅适用于START_ELEMENT或ATTRIBUTE。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<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/stream/XMLStreamReader.html#getAttributeLocalName-int-">getAttributeLocalName</a></span>(int index)</code>
<div class="block">
返回提供的索引处的属性的localName
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code><a href="../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLStreamReader.html#getAttributeName-int-">getAttributeName</a></span>(int index)</code>
<div class="block">
返回提供的索引处的属性的qname
</div> </td>
</tr>
<tr class="altColor" id="i4">
<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/stream/XMLStreamReader.html#getAttributeNamespace-int-">getAttributeNamespace</a></span>(int index)</code>
<div class="block">
返回在提供的索引处的属性的命名空间
</div> </td>
</tr>
<tr class="rowColor" id="i5">
<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/stream/XMLStreamReader.html#getAttributePrefix-int-">getAttributePrefix</a></span>(int index)</code>
<div class="block">
在提供的索引处返回此属性的前缀
</div> </td>
</tr>
<tr class="altColor" id="i6">
<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/stream/XMLStreamReader.html#getAttributeType-int-">getAttributeType</a></span>(int index)</code>
<div class="block">
返回提供的索引处的属性的XML类型
</div> </td>
</tr>
<tr class="rowColor" id="i7">
<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/stream/XMLStreamReader.html#getAttributeValue-int-">getAttributeValue</a></span>(int index)</code>
<div class="block">
返回索引处的属性值
</div> </td>
</tr>
<tr class="altColor" id="i8">
<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/stream/XMLStreamReader.html#getAttributeValue-java.lang.String-java.lang.String-">getAttributeValue</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> namespaceURI, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> localName)</code>
<div class="block">
返回具有命名空间和localName的属性的归一化属性值如果namespaceURI为空则不会检查命名空间是否相等
</div> </td>
</tr>
<tr class="rowColor" id="i9">
<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/stream/XMLStreamReader.html#getCharacterEncodingScheme--">getCharacterEncodingScheme</a></span>()</code>
<div class="block">
返回在xml声明中声明的字符编码如果没有声明则返回null
</div> </td>
</tr>
<tr class="altColor" id="i10">
<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/stream/XMLStreamReader.html#getElementText--">getElementText</a></span>()</code>
<div class="block">
读取纯文本元素的内容,如果这不是纯文本元素,则抛出异常。
</div> </td>
</tr>
<tr class="rowColor" id="i11">
<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/stream/XMLStreamReader.html#getEncoding--">getEncoding</a></span>()</code>
<div class="block">
如果已知返回输入编码如果未知则返回null。
</div> </td>
</tr>
<tr class="altColor" id="i12">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLStreamReader.html#getEventType--">getEventType</a></span>()</code>
<div class="block">
返回指示光标指向的事件类型的整数代码。
</div> </td>
</tr>
<tr class="rowColor" id="i13">
<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/stream/XMLStreamReader.html#getLocalName--">getLocalName</a></span>()</code>
<div class="block">
返回当前事件的(本地)名称。
</div> </td>
</tr>
<tr class="altColor" id="i14">
<td class="colFirst"><code><a href="../../../javax/xml/stream/Location.html" title="interface in javax.xml.stream">Location</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLStreamReader.html#getLocation--">getLocation</a></span>()</code>
<div class="block">
返回处理器的当前位置。
</div> </td>
</tr>
<tr class="rowColor" id="i15">
<td class="colFirst"><code><a href="../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLStreamReader.html#getName--">getName</a></span>()</code>
<div class="block">
返回当前START_ELEMENT或END_ELEMENT活动的QName
</div> </td>
</tr>
<tr class="altColor" id="i16">
<td class="colFirst"><code><a href="../../../javax/xml/namespace/NamespaceContext.html" title="interface in javax.xml.namespace">NamespaceContext</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLStreamReader.html#getNamespaceContext--">getNamespaceContext</a></span>()</code>
<div class="block">
返回当前位置的只读命名空间上下文。
</div> </td>
</tr>
<tr class="rowColor" id="i17">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLStreamReader.html#getNamespaceCount--">getNamespaceCount</a></span>()</code>
<div class="block">
返回在此START_ELEMENT或END_ELEMENT上声明的命名空间数此方法仅适用于START_ELEMENTEND_ELEMENT或NAMESPACE。
</div> </td>
</tr>
<tr class="altColor" id="i18">
<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/stream/XMLStreamReader.html#getNamespacePrefix-int-">getNamespacePrefix</a></span>(int index)</code>
<div class="block">
返回在索引处声明的命名空间的前缀。
</div> </td>
</tr>
<tr class="rowColor" id="i19">
<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/stream/XMLStreamReader.html#getNamespaceURI--">getNamespaceURI</a></span>()</code>
<div class="block">
如果当前事件是START_ELEMENT或END_ELEMENT则此方法返回前缀或缺省命名空间的URI。
</div> </td>
</tr>
<tr class="altColor" id="i20">
<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/stream/XMLStreamReader.html#getNamespaceURI-int-">getNamespaceURI</a></span>(int index)</code>
<div class="block">
返回在索引处声明的命名空间的uri。
</div> </td>
</tr>
<tr class="rowColor" id="i21">
<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/stream/XMLStreamReader.html#getNamespaceURI-java.lang.String-">getNamespaceURI</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> prefix)</code>
<div class="block">
返回给定前缀的uri。
</div> </td>
</tr>
<tr class="altColor" id="i22">
<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/stream/XMLStreamReader.html#getPIData--">getPIData</a></span>()</code>
<div class="block">
获取处理指令的数据部分
</div> </td>
</tr>
<tr class="rowColor" id="i23">
<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/stream/XMLStreamReader.html#getPITarget--">getPITarget</a></span>()</code>
<div class="block">
获取处理指令的目标
</div> </td>
</tr>
<tr class="altColor" id="i24">
<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/stream/XMLStreamReader.html#getPrefix--">getPrefix</a></span>()</code>
<div class="block">
返回当前事件的前缀如果事件没有前缀则返回null
</div> </td>
</tr>
<tr class="rowColor" id="i25">
<td class="colFirst"><code><a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLStreamReader.html#getProperty-java.lang.String-">getProperty</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)</code>
<div class="block">
从底层实现获取特征/属性的值
</div> </td>
</tr>
<tr class="altColor" id="i26">
<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/stream/XMLStreamReader.html#getText--">getText</a></span>()</code>
<div class="block">
以字符串形式返回解析事件的当前值返回CHARACTERS事件的字符串值返回COMMENT的值ENTITY_REFERENCE的替换值CDATA部分的字符串值SPACE的字符串值事件或DTD的内部子集的String值。
</div> </td>
</tr>
<tr class="rowColor" id="i27">
<td class="colFirst"><code>char[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLStreamReader.html#getTextCharacters--">getTextCharacters</a></span>()</code>
<div class="block">
返回一个包含此事件中的字符的数组。
</div> </td>
</tr>
<tr class="altColor" id="i28">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLStreamReader.html#getTextCharacters-int-char:A-int-int-">getTextCharacters</a></span>(int sourceStart, char[] target, int targetStart, int length)</code>
<div class="block">
获取与CHARACTERSSPACE或CDATA事件关联的文本。
</div> </td>
</tr>
<tr class="rowColor" id="i29">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLStreamReader.html#getTextLength--">getTextLength</a></span>()</code>
<div class="block">
返回文本字符数组中此Text事件的字符序列长度。
</div> </td>
</tr>
<tr class="altColor" id="i30">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLStreamReader.html#getTextStart--">getTextStart</a></span>()</code>
<div class="block">
返回文本字符数组中存在第一个字符(该文本事件)的偏移量。
</div> </td>
</tr>
<tr class="rowColor" id="i31">
<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/stream/XMLStreamReader.html#getVersion--">getVersion</a></span>()</code>
<div class="block">
获取在xml声明中声明的xml版本如果没有声明则返回null
</div> </td>
</tr>
<tr class="altColor" id="i32">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLStreamReader.html#hasName--">hasName</a></span>()</code>
<div class="block">
如果当前事件有一个名称是START_ELEMENT或END_ELEMENT返回false则返回true
</div> </td>
</tr>
<tr class="rowColor" id="i33">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLStreamReader.html#hasNext--">hasNext</a></span>()</code>
<div class="block">
如果有更多的解析事件返回true如果没有更多的事件返回false。
</div> </td>
</tr>
<tr class="altColor" id="i34">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLStreamReader.html#hasText--">hasText</a></span>()</code>
<div class="block">
如果当前事件有文本则返回true否则返回false以下事件具有文本CHARACTERSDTDENTITY_REFERENCECOMMENTSPACE
</div> </td>
</tr>
<tr class="rowColor" id="i35">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLStreamReader.html#isAttributeSpecified-int-">isAttributeSpecified</a></span>(int index)</code>
<div class="block">
返回一个布尔值,表示此属性是否默认创建
</div> </td>
</tr>
<tr class="altColor" id="i36">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLStreamReader.html#isCharacters--">isCharacters</a></span>()</code>
<div class="block">
如果光标指向字符数据事件则返回true
</div> </td>
</tr>
<tr class="rowColor" id="i37">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLStreamReader.html#isEndElement--">isEndElement</a></span>()</code>
<div class="block">
如果光标指向结束标记否则为false则返回true
</div> </td>
</tr>
<tr class="altColor" id="i38">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLStreamReader.html#isStandalone--">isStandalone</a></span>()</code>
<div class="block">
从xml声明获取独立声明
</div> </td>
</tr>
<tr class="rowColor" id="i39">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLStreamReader.html#isStartElement--">isStartElement</a></span>()</code>
<div class="block">
如果光标指向起始标记否则为false则返回true
</div> </td>
</tr>
<tr class="altColor" id="i40">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLStreamReader.html#isWhiteSpace--">isWhiteSpace</a></span>()</code>
<div class="block">
如果游标指向由所有空格组成的字符数据事件则返回true
</div> </td>
</tr>
<tr class="rowColor" id="i41">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLStreamReader.html#next--">next</a></span>()</code>
<div class="block">
获取下一个解析事件 - 处理器可能会在单个块中返回所有连续的字符数据,也可能会将其拆分成多个块。
</div> </td>
</tr>
<tr class="altColor" id="i42">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLStreamReader.html#nextTag--">nextTag</a></span>()</code>
<div class="block">
跳过任何空白处isWhiteSpace返回trueCOMMENT或PROCESSING_INSTRUCTION直到达到START_ELEMENT或END_ELEMENT。
</div> </td>
</tr>
<tr class="rowColor" id="i43">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLStreamReader.html#require-int-java.lang.String-java.lang.String-">require</a></span>(int type, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> namespaceURI, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> localName)</code>
<div class="block">
测试当前事件是否为给定类型,如果命名空间和名称与当前命名空间和当前事件的名称相匹配。
</div> </td>
</tr>
<tr class="altColor" id="i44">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLStreamReader.html#standaloneSet--">standaloneSet</a></span>()</code>
<div class="block">
检查文档中是否设置了独立的
</div> </td>
</tr>
</tbody>
</table> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="getProperty-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getProperty</h4> <pre><a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> getProperty(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)
throws <a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></pre>
<div class="block">
从底层实现获取特征/属性的值
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 属性的名称,可能不为空
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
物业的价值
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果name为null
</dd>
</dl> </li>
</ul> <a name="next--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>next</h4> <pre>int next()
throws <a href="../../../javax/xml/stream/XMLStreamException.html" title="class in javax.xml.stream">XMLStreamException</a></pre>
<div class="block">
<span>获取下一个解析事件 - 处理器可能会在单个块中返回所有连续的字符数据,也可能会将其拆分成多个块。</span>
<span>如果将属性javax.xml.stream.isCoalescing设置为true元素内容必须合并并且必须为连续的元素内容或CDATA节返回一个CHARACTERS事件。</span>
<span>默认情况下,实体引用必须对应用程序进行扩展和报告。</span>
<span>如果无法扩展实体引用,将抛出异常。</span>
<span>如果元素内容为空即内容为“”则不会报告CHARACTERS事件。</span>
<p> <span>给出以下XML</span> <br/> <span>&lt;foo&gt; &lt; - description - &gt;内容文本&lt;[CDATA [&lt;greeting&gt; Hello &lt;/ greeting&gt;]]&gt;其他内容&lt;/ foo&gt;</span> <br/> <span>在foo上调用next的行为是</span> <br/> <span>1-评论(评论)</span> <br/> <span>2-然后字符部分CHARACTERS</span> <br/> <span>3然后CDATA部分另一个字符</span> <br/> <span>4 - 然后下一个字符部分另一个CHARACTERS</span> <br/> <span>5然后END_ELEMENT</span> <br/></p>
<p> <span><b>注意:</b>空元素(例如&lt;tag /&gt;将报告两个单独的事件START_ELEMENTEND_ELEMENT - 这将空元素的解析等同于&lt;tag&gt; &lt;/ tag&gt;</span> <span>如果在hasNext返回false之后调用该方法则会抛出IllegalStateException异常。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
对应于当前解析事件的整数代码
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code>NoSuchElementException</code> - 如果在hasNext返回false时调用
</dd>
<dd>
<code><a href="../../../javax/xml/stream/XMLStreamException.html" title="class in javax.xml.stream">XMLStreamException</a></code> - 如果处理底层XML源时出错
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<span><a href="../../../javax/xml/stream/events/XMLEvent.html" title="javax.xml.stream.events中的接口"><code>XMLEvent</code></a></span>
</dd>
</dl> </li>
</ul> <a name="require-int-java.lang.String-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>require</h4> <pre>void require(int type,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> namespaceURI,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> localName)
throws <a href="../../../javax/xml/stream/XMLStreamException.html" title="class in javax.xml.stream">XMLStreamException</a></pre>
<div class="block">
<span>测试当前事件是否为给定类型,如果命名空间和名称与当前命名空间和当前事件的名称相匹配。</span>
<span>如果namespaceURI为空则不检查是否相等如果localName为空则不检查其是否相等。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>type</code> - 事件类型
</dd>
<dd>
<code>namespaceURI</code> - 事件的uri可能为null
</dd>
<dd>
<code>localName</code> - 该事件的localName可能为null
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/xml/stream/XMLStreamException.html" title="class in javax.xml.stream">XMLStreamException</a></code> - 如果所需值不匹配。
</dd>
</dl> </li>
</ul> <a name="getElementText--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getElementText</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getElementText()
throws <a href="../../../javax/xml/stream/XMLStreamException.html" title="class in javax.xml.stream">XMLStreamException</a></pre>
<div class="block">
<span>读取纯文本元素的内容,如果这不是纯文本元素,则抛出异常。</span>
<span>无论javax.xml.stream.is的结果如何这个方法总是返回合并的内容。</span>
<br/>
<span>前提条件当前事件为START_ELEMENT。</span>
<br/>
<span>后置条件当前事件是相应的END_ELEMENT。</span>
<br/>
<span>该方法执行以下操作(实现可以自由优化,但必须执行等效处理):</span>
<pre> <span>if(getEventType() != XMLStreamConstants.START_ELEMENT) {
throw new XMLStreamException(
"parser must be on START_ELEMENT to read next text", getLocation());
}
int eventType = next();
StringBuffer content = new StringBuffer();
while(eventType != XMLStreamConstants.END_ELEMENT ) {
if(eventType == XMLStreamConstants.CHARACTERS
|| eventType == XMLStreamConstants.CDATA
|| eventType == XMLStreamConstants.SPACE
|| eventType == XMLStreamConstants.ENTITY_REFERENCE) {
buf.append(getText());
} else if(eventType == XMLStreamConstants.PROCESSING_INSTRUCTION
|| eventType == XMLStreamConstants.COMMENT) {
// skipping
} else if(eventType == XMLStreamConstants.END_DOCUMENT) {
throw new XMLStreamException(
"unexpected end of document when reading element text content", this);
} else if(eventType == XMLStreamConstants.START_ELEMENT) {
throw new XMLStreamException(
"element text content may not contain START_ELEMENT", getLocation());
} else {
throw new XMLStreamException(
"Unexpected event type "+eventType, getLocation());
}
eventType = next();
}
return buf.toString();</span> </pre>
</div>
<dl>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/xml/stream/XMLStreamException.html" title="class in javax.xml.stream">XMLStreamException</a></code> - 如果当前事件不是START_ELEMENT或遇到非文本元素
</dd>
</dl> </li>
</ul> <a name="nextTag--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>nextTag</h4> <pre>int nextTag()
throws <a href="../../../javax/xml/stream/XMLStreamException.html" title="class in javax.xml.stream">XMLStreamException</a></pre>
<div class="block">
<span>跳过任何空白处isWhiteSpace返回trueCOMMENT或PROCESSING_INSTRUCTION直到达到START_ELEMENT或END_ELEMENT。</span>
<span>如果除了空白字符COMMENTPROCESSING_INSTRUCTIONSTART_ELEMENTEND_ELEMENT之外则会抛出异常。</span>
<span>当处理仅由空格分隔的元素内容时,应使用此方法。</span>
<br/>
<span>前提条件:无</span>
<br/>
<span>后置条件当前事件为START_ELEMENT或END_ELEMENT而游标可能已经移动了任何空格事件。</span>
<br/>
<span>本质上它执行以下操作(实现可以自由优化,但必须执行等效处理):</span>
<pre> <span>int eventType = next();
while((eventType == XMLStreamConstants.CHARACTERS &amp;&amp; isWhiteSpace()) // skip whitespace
|| (eventType == XMLStreamConstants.CDATA &amp;&amp; isWhiteSpace())
// skip whitespace
|| eventType == XMLStreamConstants.SPACE
|| eventType == XMLStreamConstants.PROCESSING_INSTRUCTION
|| eventType == XMLStreamConstants.COMMENT
) {
eventType = next();
}
if (eventType != XMLStreamConstants.START_ELEMENT &amp;&amp; eventType != XMLStreamConstants.END_ELEMENT) {
throw new String XMLStreamException("expected start or end tag", getLocation());
}
return eventType;</span> </pre>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
读取的元素的事件类型START_ELEMENT或END_ELEMENT
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/xml/stream/XMLStreamException.html" title="class in javax.xml.stream">XMLStreamException</a></code> - 如果当前事件不是空格PROCESSING_INSTRUCTIONSTART_ELEMENT或END_ELEMENT
</dd>
<dd>
<code>NoSuchElementException</code> - 如果在hasNext返回false时调用
</dd>
</dl> </li>
</ul> <a name="hasNext--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>hasNext</h4> <pre>boolean hasNext()
throws <a href="../../../javax/xml/stream/XMLStreamException.html" title="class in javax.xml.stream">XMLStreamException</a></pre>
<div class="block">
<span>如果有更多的解析事件返回true如果没有更多的事件返回false。</span>
<span>如果XMLStreamReader的当前状态为END_DOCUMENT则此方法将返回false</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
如果有更多事件则为true否则为false
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/xml/stream/XMLStreamException.html" title="class in javax.xml.stream">XMLStreamException</a></code> - 如果检测到下一个状态存在致命错误
</dd>
</dl> </li>
</ul> <a name="close--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>close</h4> <pre>void close()
throws <a href="../../../javax/xml/stream/XMLStreamException.html" title="class in javax.xml.stream">XMLStreamException</a></pre>
<div class="block">
<span>释放与此Reader相关联的任何资源。</span>
<span>此方法不会关闭底层输入源。</span>
</div>
<dl>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/xml/stream/XMLStreamException.html" title="class in javax.xml.stream">XMLStreamException</a></code> - 如果有错误释放相关资源
</dd>
</dl> </li>
</ul> <a name="getNamespaceURI-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getNamespaceURI</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getNamespaceURI(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> prefix)</pre>
<div class="block">
<span>返回给定前缀的uri。</span>
<span>返回的uri取决于处理器的当前状态。</span>
<p> <span><strong>注意:</strong> “xml”前缀的绑定方式与“http://www.w3.org/XML/1998/namespace”的<a href="http://www.w3.org/TR/REC-xml-names/#ns-using">Namespaces in XML</a>规范中定义。</span> </p>
<p> <span><strong>注意:</strong> 'xmlns'前缀必须解析为以下命名<a href="http://www.w3.org/2000/xmlns/">空间http://www.w3.org/2000/xmlns/</a></span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>prefix</code> - 查找的前缀可能不为空
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
绑定到给定前缀的uri如果没有绑定则为null
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果前缀为空
</dd>
</dl> </li>
</ul> <a name="isStartElement--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>isStartElement</h4> <pre>boolean isStartElement()</pre>
<div class="block">
如果光标指向起始标记否则为false则返回true
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
如果光标指向起始标记则为true否则为false
</dd>
</dl> </li>
</ul> <a name="isEndElement--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>isEndElement</h4> <pre>boolean isEndElement()</pre>
<div class="block">
如果光标指向结束标记否则为false则返回true
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
如果光标指向结束标记则为true否则为false
</dd>
</dl> </li>
</ul> <a name="isCharacters--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>isCharacters</h4> <pre>boolean isCharacters()</pre>
<div class="block">
如果光标指向字符数据事件则返回true
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
如果光标指向字符数据则为true否则为false
</dd>
</dl> </li>
</ul> <a name="isWhiteSpace--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>isWhiteSpace</h4> <pre>boolean isWhiteSpace()</pre>
<div class="block">
如果游标指向由所有空格组成的字符数据事件则返回true
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
如果光标指向所有空格则为true否则为false
</dd>
</dl> </li>
</ul> <a name="getAttributeValue-java.lang.String-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAttributeValue</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getAttributeValue(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> namespaceURI,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> localName)</pre>
<div class="block">
返回具有命名空间和localName的属性的归一化属性值如果namespaceURI为空则不会检查命名空间是否相等
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>namespaceURI</code> - 属性的命名空间
</dd>
<dd>
<code>localName</code> -
<code>localName</code>的本地名称,不能为空
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
返回属性的值如果没有找到则返回null
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果这不是START_ELEMENT或ATTRIBUTE
</dd>
</dl> </li>
</ul> <a name="getAttributeCount--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAttributeCount</h4> <pre>int getAttributeCount()</pre>
<div class="block">
<span>返回此START_ELEMENT上的属性数量此方法仅适用于START_ELEMENT或ATTRIBUTE。</span>
<span>此计数不包括命名空间定义。</span>
<span>属性指数为零。</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
返回属性数
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果这不是START_ELEMENT或ATTRIBUTE
</dd>
</dl> </li>
</ul> <a name="getAttributeName-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAttributeName</h4> <pre><a href="../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a> getAttributeName(int index)</pre>
<div class="block">
返回提供的索引处的属性的qname
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>index</code> -
<code>index</code>的位置
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
属性的QName
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果这不是START_ELEMENT或ATTRIBUTE
</dd>
</dl> </li>
</ul> <a name="getAttributeNamespace-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAttributeNamespace</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getAttributeNamespace(int index)</pre>
<div class="block">
返回在提供的索引处的属性的命名空间
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>index</code> -
<code>index</code>的位置
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
命名空间URI可以为空
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果这不是START_ELEMENT或ATTRIBUTE
</dd>
</dl> </li>
</ul> <a name="getAttributeLocalName-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAttributeLocalName</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getAttributeLocalName(int index)</pre>
<div class="block">
返回提供的索引处的属性的localName
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>index</code> -
<code>index</code>的位置
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
该属性的localName
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果这不是START_ELEMENT或ATTRIBUTE
</dd>
</dl> </li>
</ul> <a name="getAttributePrefix-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAttributePrefix</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getAttributePrefix(int index)</pre>
<div class="block">
在提供的索引处返回此属性的前缀
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>index</code> -
<code>index</code>的位置
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
属性的前缀
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果这不是START_ELEMENT或ATTRIBUTE
</dd>
</dl> </li>
</ul> <a name="getAttributeType-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAttributeType</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getAttributeType(int index)</pre>
<div class="block">
返回提供的索引处的属性的XML类型
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>index</code> -
<code>index</code>的位置
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
属性的XML类型
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果这不是START_ELEMENT或ATTRIBUTE
</dd>
</dl> </li>
</ul> <a name="getAttributeValue-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAttributeValue</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getAttributeValue(int index)</pre>
<div class="block">
返回索引处的属性值
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>index</code> -
<code>index</code>的位置
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
属性值
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果这不是START_ELEMENT或ATTRIBUTE
</dd>
</dl> </li>
</ul> <a name="isAttributeSpecified-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>isAttributeSpecified</h4> <pre>boolean isAttributeSpecified(int index)</pre>
<div class="block">
返回一个布尔值,表示此属性是否默认创建
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>index</code> -
<code>index</code>的位置
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
如果这是默认属性则为true
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果这不是START_ELEMENT或ATTRIBUTE
</dd>
</dl> </li>
</ul> <a name="getNamespaceCount--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getNamespaceCount</h4> <pre>int getNamespaceCount()</pre>
<div class="block">
<span>返回在此START_ELEMENT或END_ELEMENT上声明的命名空间数此方法仅适用于START_ELEMENTEND_ELEMENT或NAMESPACE。</span>
<span>在END_ELEMENT上计数是将要超出范围的命名空间。</span>
<span>这相当于SAX回调对终端元素事件报告的信息。</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
返回此特定元素上的命名空间声明的数量
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果这不是START_ELEMENTEND_ELEMENT或NAMESPACE
</dd>
</dl> </li>
</ul> <a name="getNamespacePrefix-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getNamespacePrefix</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getNamespacePrefix(int index)</pre>
<div class="block">
<span>返回在索引处声明的命名空间的前缀。</span>
<span>如果这是默认命名空间声明则返回null</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>index</code> - 命名空间声明的位置
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
返回命名空间前缀
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果这不是START_ELEMENTEND_ELEMENT或NAMESPACE
</dd>
</dl> </li>
</ul> <a name="getNamespaceURI-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getNamespaceURI</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getNamespaceURI(int index)</pre>
<div class="block">
返回在索引处声明的命名空间的uri。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>index</code> - 命名空间声明的位置
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
返回命名空间uri
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果这不是START_ELEMENTEND_ELEMENT或NAMESPACE
</dd>
</dl> </li>
</ul> <a name="getNamespaceContext--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getNamespaceContext</h4> <pre><a href="../../../javax/xml/namespace/NamespaceContext.html" title="interface in javax.xml.namespace">NamespaceContext</a> getNamespaceContext()</pre>
<div class="block">
<span>返回当前位置的只读命名空间上下文。</span>
<span>上下文是短暂的只有在对next的调用才能更改读取器的状态时才有效。</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
返回一个命名空间上下文
</dd>
</dl> </li>
</ul> <a name="getEventType--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getEventType</h4> <pre>int getEventType()</pre>
<div class="block">
返回指示光标指向的事件类型的整数代码。
</div> </li>
</ul> <a name="getText--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getText</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getText()</pre>
<div class="block">
<span>以字符串形式返回解析事件的当前值返回CHARACTERS事件的字符串值返回COMMENT的值ENTITY_REFERENCE的替换值CDATA部分的字符串值SPACE的字符串值事件或DTD的内部子集的String值。</span>
<span>如果ENTITY_REFERENCE已解决任何字符数据将被报告为CHARACTERS事件。</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
当前文本或null
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果此状态不是有效的文本状态。
</dd>
</dl> </li>
</ul> <a name="getTextCharacters--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getTextCharacters</h4> <pre>char[] getTextCharacters()</pre>
<div class="block">
<span>返回一个包含此事件中的字符的数组。</span>
<span>这个数组应该被视为只读和暂时的。</span>
<span>数组将包含文本字符直到XMLStreamReader移动到下一个事件。</span>
<span>尝试在该时间之后保持字符阵列或修改数组的内容是违反该接口的合同。</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
当前文本或空数组
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果此状态不是有效的文本状态。
</dd>
</dl> </li>
</ul> <a name="getTextCharacters-int-char:A-int-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getTextCharacters</h4> <pre>int getTextCharacters(int sourceStart,
char[] target,
int targetStart,
int length)
throws <a href="../../../javax/xml/stream/XMLStreamException.html" title="class in javax.xml.stream">XMLStreamException</a></pre>
<div class="block">
<span>获取与CHARACTERSSPACE或CDATA事件关联的文本。</span>
<span>启动“sourceStart”的文本将从“targetStart”开始复制到“target”中。</span>
<span>最多可以复制“长度”字符。</span>
<span>返回实际复制的字符数。</span>
<span>“sourceStart”参数必须大于或等于0且小于或等于与事件关联的字符数。</span>
<span>通常一个请求文本从“sourceStart”开始为0.如果实际复制的字符数小于“length”则不再有文本。</span>
<span>否则,需要进行后续调用,直到检索到所有文本。</span>
<span>例如: <code>int length = 1024; char[] myBuffer = new char[ length ]; for ( int sourceStart = 0 ; ; sourceStart += length ) { int nCopied = stream.getTextCharacters( sourceStart, myBuffer, 0, length ); if (nCopied &lt; length) break; }</code>如果底层源中存在任何XML错误则可能会抛出XMLStreamException。</span>
<span>“targetStart”参数必须大于或等于0且小于“target”的长度Length必须大于0“targetStart + length”必须小于或等于“target”的长度。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>sourceStart</code> - 要复制的源数组中的第一个字符的索引
</dd>
<dd>
<code>target</code> - 目标数组
</dd>
<dd>
<code>targetStart</code> - 目标数组中的起始偏移量
</dd>
<dd>
<code>length</code> - 要复制的字符数
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
实际复制的字符数
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/xml/stream/XMLStreamException.html" title="class in javax.xml.stream">XMLStreamException</a></code> - 如果底层的XML源码格式不正确
</dd>
<dd>
<code><a href="../../../java/lang/IndexOutOfBoundsException.html" title="class in java.lang">IndexOutOfBoundsException</a></code> - 如果targetStart &lt;0或&gt;比目标的长度
</dd>
<dd>
<code><a href="../../../java/lang/IndexOutOfBoundsException.html" title="class in java.lang">IndexOutOfBoundsException</a></code> - 如果长度&lt;0或targetStart + length&gt;目标的长度
</dd>
<dd>
<code><a href="../../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果不支持此方法
</dd>
<dd>
<code><a href="../../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</a></code> - 如果target为null
</dd>
</dl> </li>
</ul> <a name="getTextStart--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getTextStart</h4> <pre>int getTextStart()</pre>
<div class="block">
返回文本字符数组中存在第一个字符(该文本事件)的偏移量。
</div>
<dl>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果此状态不是有效的文本状态。
</dd>
</dl> </li>
</ul> <a name="getTextLength--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getTextLength</h4> <pre>int getTextLength()</pre>
<div class="block">
返回文本字符数组中此Text事件的字符序列长度。
</div>
<dl>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果此状态不是有效的文本状态。
</dd>
</dl> </li>
</ul> <a name="getEncoding--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getEncoding</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getEncoding()</pre>
<div class="block">
如果已知返回输入编码如果未知则返回null。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
该实例的编码或null
</dd>
</dl> </li>
</ul> <a name="hasText--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>hasText</h4> <pre>boolean hasText()</pre>
<div class="block">
如果当前事件有文本则返回true否则返回false以下事件具有文本CHARACTERSDTDENTITY_REFERENCECOMMENTSPACE
</div> </li>
</ul> <a name="getLocation--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getLocation</h4> <pre><a href="../../../javax/xml/stream/Location.html" title="interface in javax.xml.stream">Location</a> getLocation()</pre>
<div class="block">
<span>返回处理器的当前位置。</span>
<span>如果位置未知则处理器应返回Location的实现该位置返回-1的位置对于publicId和systemId为null。</span>
<span>位置信息仅在调用next时有效。</span>
</div> </li>
</ul> <a name="getName--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getName</h4> <pre><a href="../../../javax/xml/namespace/QName.html" title="class in javax.xml.namespace">QName</a> getName()</pre>
<div class="block">
返回当前START_ELEMENT或END_ELEMENT活动的QName
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
当前START_ELEMENT或END_ELEMENT活动的QName
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果这不是START_ELEMENT或END_ELEMENT
</dd>
</dl> </li>
</ul> <a name="getLocalName--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getLocalName</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getLocalName()</pre>
<div class="block">
<span>返回当前事件的(本地)名称。</span>
<span>START_ELEMENT或END_ELEMENT返回当前元素的本地名称。</span>
<span>对于ENTITY_REFERENCE它返回实体名称。</span>
<span>目前的活动必须是START_ELEMENT或END_ELEMENT或ENTITY_REFERENCE</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
localName
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果这不是START_ELEMENTEND_ELEMENT或ENTITY_REFERENCE
</dd>
</dl> </li>
</ul> <a name="hasName--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>hasName</h4> <pre>boolean hasName()</pre>
<div class="block">
如果当前事件有一个名称是START_ELEMENT或END_ELEMENT返回false则返回true
</div> </li>
</ul> <a name="getNamespaceURI--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getNamespaceURI</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getNamespaceURI()</pre>
<div class="block">
<span>如果当前事件是START_ELEMENT或END_ELEMENT则此方法返回前缀或缺省命名空间的URI。</span>
<span>如果事件没有前缀则返回null。</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
绑定到此元素前缀的URI默认命名空间或null
</dd>
</dl> </li>
</ul> <a name="getPrefix--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getPrefix</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getPrefix()</pre>
<div class="block">
返回当前事件的前缀如果事件没有前缀则返回null
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
前缀或null
</dd>
</dl> </li>
</ul> <a name="getVersion--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getVersion</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getVersion()</pre>
<div class="block">
获取在xml声明中声明的xml版本如果没有声明则返回null
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
XML版本或null
</dd>
</dl> </li>
</ul> <a name="isStandalone--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>isStandalone</h4> <pre>boolean isStandalone()</pre>
<div class="block">
从xml声明获取独立声明
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
如果这是独立的则为true否则为false
</dd>
</dl> </li>
</ul> <a name="standaloneSet--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>standaloneSet</h4> <pre>boolean standaloneSet()</pre>
<div class="block">
检查文档中是否设置了独立的
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
如果在文档中设置了独立则为true否则为false
</dd>
</dl> </li>
</ul> <a name="getCharacterEncodingScheme--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getCharacterEncodingScheme</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getCharacterEncodingScheme()</pre>
<div class="block">
返回在xml声明中声明的字符编码如果没有声明则返回null
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
在文档中声明的编码或空值
</dd>
</dl> </li>
</ul> <a name="getPITarget--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getPITarget</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getPITarget()</pre>
<div class="block">
获取处理指令的目标
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
目标或null
</dd>
</dl> </li>
</ul> <a name="getPIData--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>getPIData</h4> <pre><a href="../../../java/lang/String.html" title="class in java.lang">String</a> getPIData()</pre>
<div class="block">
获取处理指令的数据部分
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
数据或null
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>