mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-07-04 07:42:45 +08:00
343 lines
18 KiB
HTML
343 lines
18 KiB
HTML
<div class="header">
|
||
<div class="subTitle">
|
||
compact2, compact3
|
||
</div>
|
||
<div class="subTitle">
|
||
javax.xml.stream
|
||
</div>
|
||
<h2 class="title" title="Interface XMLEventWriter">Interface XMLEventWriter</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/util/XMLEventConsumer.html" title="javax.xml.stream.util中的接口">XMLEventConsumer</a></span>
|
||
</dd>
|
||
</dl>
|
||
<hr/> <br/> <pre>public interface <span class="typeNameLabel">XMLEventWriter</span>
|
||
extends <a href="../../../javax/xml/stream/util/XMLEventConsumer.html" title="interface in javax.xml.stream.util">XMLEventConsumer</a></pre>
|
||
<div class="block">
|
||
<span>这是编写XML文档的顶级界面。</span>
|
||
<span>此接口的实例不需要验证XML的形式。</span>
|
||
</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/XMLEventReader.html" title="javax.xml.stream中的接口"><code>XMLEventReader</code></a> ， <a href="../../../javax/xml/stream/events/XMLEvent.html" title="javax.xml.stream.events中的接口"><code>XMLEvent</code></a> ， <a href="../../../javax/xml/stream/events/Characters.html" title="javax.xml.stream.events中的接口"><code>Characters</code></a> ， <a href="../../../javax/xml/stream/events/ProcessingInstruction.html" title="javax.xml.stream.events中的接口"><code>ProcessingInstruction</code></a> ， <a href="../../../javax/xml/stream/events/StartElement.html" title="javax.xml.stream.events中的接口"><code>StartElement</code></a> ， <a href="../../../javax/xml/stream/events/EndElement.html" title="javax.xml.stream.events中的接口"><code>EndElement</code></a></span>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul>
|
||
</div>
|
||
<div class="summary">
|
||
<ul class="blockList">
|
||
<li class="blockList">
|
||
<!-- ========== 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/XMLEventWriter.html#add-javax.xml.stream.events.XMLEvent-">add</a></span>(<a href="../../../javax/xml/stream/events/XMLEvent.html" title="interface in javax.xml.stream.events">XMLEvent</a> event)</code>
|
||
<div class="block">
|
||
将事件添加到输出流添加START_ELEMENT将打开一个新的命名空间范围，当对应的END_ELEMENT被写入时将被关闭。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i1">
|
||
<td class="colFirst"><code>void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLEventWriter.html#add-javax.xml.stream.XMLEventReader-">add</a></span>(<a href="../../../javax/xml/stream/XMLEventReader.html" title="interface in javax.xml.stream">XMLEventReader</a> reader)</code>
|
||
<div class="block">
|
||
将一个整个流添加到输出流，在inputStream参数上调用next（），直到hasNext（）返回false这应被视为一种方便的方法，将对事件读取器中的所有事件执行以下循环，并在每个事件中调用add事件。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i2">
|
||
<td class="colFirst"><code>void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLEventWriter.html#close--">close</a></span>()</code>
|
||
<div class="block">
|
||
释放与此流相关联的任何资源
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i3">
|
||
<td class="colFirst"><code>void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLEventWriter.html#flush--">flush</a></span>()</code>
|
||
<div class="block">
|
||
将任何缓存的事件写入基础输出机制
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i4">
|
||
<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/XMLEventWriter.html#getNamespaceContext--">getNamespaceContext</a></span>()</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/XMLEventWriter.html#getPrefix-java.lang.String-">getPrefix</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> uri)</code>
|
||
<div class="block">
|
||
获取uri绑定的前缀
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i6">
|
||
<td class="colFirst"><code>void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLEventWriter.html#setDefaultNamespace-java.lang.String-">setDefaultNamespace</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> uri)</code>
|
||
<div class="block">
|
||
将URI绑定到默认命名空间此URI绑定在当前START_ELEMENT / END_ELEMENT对的范围内。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i7">
|
||
<td class="colFirst"><code>void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLEventWriter.html#setNamespaceContext-javax.xml.namespace.NamespaceContext-">setNamespaceContext</a></span>(<a href="../../../javax/xml/namespace/NamespaceContext.html" title="interface in javax.xml.namespace">NamespaceContext</a> context)</code>
|
||
<div class="block">
|
||
设置前缀和uri绑定的当前命名空间上下文。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i8">
|
||
<td class="colFirst"><code>void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLEventWriter.html#setPrefix-java.lang.String-java.lang.String-">setPrefix</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> prefix, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> uri)</code>
|
||
<div class="block">
|
||
设置uri所绑定的前缀。
|
||
</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="flush--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>flush</h4> <pre>void flush()
|
||
throws <a href="../../../javax/xml/stream/XMLStreamException.html" title="class in javax.xml.stream">XMLStreamException</a></pre>
|
||
<div class="block">
|
||
将任何缓存的事件写入基础输出机制
|
||
</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="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">
|
||
释放与此流相关联的任何资源
|
||
</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="add-javax.xml.stream.events.XMLEvent-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>add</h4> <pre>void add(<a href="../../../javax/xml/stream/events/XMLEvent.html" title="interface in javax.xml.stream.events">XMLEvent</a> event)
|
||
throws <a href="../../../javax/xml/stream/XMLStreamException.html" title="class in javax.xml.stream">XMLStreamException</a></pre>
|
||
<div class="block">
|
||
<span>将事件添加到输出流添加START_ELEMENT将打开一个新的命名空间范围，当对应的END_ELEMENT被写入时将被关闭。</span>
|
||
<span> Required and optional fields for events added to the writer Event Type Required Fields Optional Fields Required Behavior START_ELEMENT QName name namespaces , attributes A START_ELEMENT will be written by writing the name, namespaces, and attributes of the event in XML 1.0 valid syntax for START_ELEMENTs. The name is written by looking up the prefix for the namespace uri. The writer can be configured to respect prefixes of QNames. If the writer is respecting prefixes it must use the prefix set on the QName. The default behavior is to lookup the value for the prefix on the EventWriter's internal namespace context. Each attribute (if any) is written using the behavior specified in the attribute section of this table. Each namespace (if any) is written using the behavior specified in the namespace section of this table. END_ELEMENT Qname name None A well formed END_ELEMENT tag is written. The name is written by looking up the prefix for the namespace uri. The writer can be configured to respect prefixes of QNames. If the writer is respecting prefixes it must use the prefix set on the QName. The default behavior is to lookup the value for the prefix on the EventWriter's internal namespace context. If the END_ELEMENT name does not match the START_ELEMENT name an XMLStreamException is thrown. ATTRIBUTE QName name , String value QName type An attribute is written using the same algorithm to find the lexical form as used in START_ELEMENT. The default is to use double quotes to wrap attribute values and to escape any double quotes found in the value. The type value is ignored. NAMESPACE String prefix, String namespaceURI, boolean isDefaultNamespaceDeclaration None A namespace declaration is written. If the namespace is a default namespace declaration (isDefault is true) then xmlns="$namespaceURI" is written and the prefix is optional. If isDefault is false, the prefix must be declared and the writer must prepend xmlns to the prefix and write out a standard prefix declaration. PROCESSING_INSTRUCTION None String target, String data The data does not need to be present and may be null. Target is required and many not be null. The writer will write data section directly after the target, enclosed in appropriate XML 1.0 syntax COMMENT None String comment If the comment is present (not null) it is written, otherwise an an empty comment is written START_DOCUMENT None String encoding , boolean standalone, String version A START_DOCUMENT event is not required to be written to the stream. If present the attributes are written inside the appropriate XML declaration syntax END_DOCUMENT None None Nothing is written to the output DTD String DocumentTypeDefinition None The DocumentTypeDefinition is written to the output </span>
|
||
<table border="2" cellpadding="4" rules="all">
|
||
</table>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="overrideSpecifyLabel">Specified by:</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../javax/xml/stream/util/XMLEventConsumer.html#add-javax.xml.stream.events.XMLEvent-">add</a></code>在接口
|
||
<code><a href="../../../javax/xml/stream/util/XMLEventConsumer.html" title="interface in javax.xml.stream.util">XMLEventConsumer</a></code>
|
||
</dd>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>event</code> - 要添加的事件
|
||
</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="add-javax.xml.stream.XMLEventReader-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>add</h4> <pre>void add(<a href="../../../javax/xml/stream/XMLEventReader.html" title="interface in javax.xml.stream">XMLEventReader</a> reader)
|
||
throws <a href="../../../javax/xml/stream/XMLStreamException.html" title="class in javax.xml.stream">XMLStreamException</a></pre>
|
||
<div class="block">
|
||
将一个整个流添加到输出流，在inputStream参数上调用next（），直到hasNext（）返回false这应被视为一种方便的方法，将对事件读取器中的所有事件执行以下循环，并在每个事件中调用add事件。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>reader</code> - 事件流添加到输出
|
||
</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="getPrefix-java.lang.String-">
|
||
<!-- --> </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(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> uri)
|
||
throws <a href="../../../javax/xml/stream/XMLStreamException.html" title="class in javax.xml.stream">XMLStreamException</a></pre>
|
||
<div class="block">
|
||
获取uri绑定的前缀
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>uri</code> - 要查找的uri
|
||
</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="setPrefix-java.lang.String-java.lang.String-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>setPrefix</h4> <pre>void setPrefix(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> prefix,
|
||
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> uri)
|
||
throws <a href="../../../javax/xml/stream/XMLStreamException.html" title="class in javax.xml.stream">XMLStreamException</a></pre>
|
||
<div class="block">
|
||
<span>设置uri所绑定的前缀。</span>
|
||
<span>此前缀绑定在当前START_ELEMENT / END_ELEMENT对的范围内。</span>
|
||
<span>如果在编写START_ELEMENT之前调用此方法，则前缀将绑定到根目录中。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>prefix</code> - 绑定到uri的前缀
|
||
</dd>
|
||
<dd>
|
||
<code>uri</code> - 绑定到前缀的uri
|
||
</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="setDefaultNamespace-java.lang.String-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>setDefaultNamespace</h4> <pre>void setDefaultNamespace(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> uri)
|
||
throws <a href="../../../javax/xml/stream/XMLStreamException.html" title="class in javax.xml.stream">XMLStreamException</a></pre>
|
||
<div class="block">
|
||
<span>将URI绑定到默认命名空间此URI绑定在当前START_ELEMENT / END_ELEMENT对的范围内。</span>
|
||
<span>如果在写入START_ELEMENT之前调用此方法，则uri将绑定到根范围中。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>uri</code> - 绑定到默认命名空间的uri
|
||
</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="setNamespaceContext-javax.xml.namespace.NamespaceContext-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>setNamespaceContext</h4> <pre>void setNamespaceContext(<a href="../../../javax/xml/namespace/NamespaceContext.html" title="interface in javax.xml.namespace">NamespaceContext</a> context)
|
||
throws <a href="../../../javax/xml/stream/XMLStreamException.html" title="class in javax.xml.stream">XMLStreamException</a></pre>
|
||
<div class="block">
|
||
<span>设置前缀和uri绑定的当前命名空间上下文。</span>
|
||
<span>此上下文成为写入的根命名空间上下文，并将替换当前根命名空间上下文。</span>
|
||
<span>对setPrefix和setDefaultNamespace的后续调用将使用传递给方法的上下文作为解析命名空间的根上下文来绑定命名空间。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>context</code> - 用于此作者的命名空间上下文
|
||
</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="getNamespaceContext--">
|
||
<!-- --> </a>
|
||
<ul class="blockListLast">
|
||
<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">
|
||
返回当前的命名空间上下文。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
当前命名空间上下文
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
</div>
|
||
</div> |