study/uTools-Manuals
1
0
Fork 0
mirror of https://github.com/fofolee/uTools-Manuals.git synced 2025-07-04 07:42:45 +08:00
Code Issues Packages Projects Releases Wiki Activity
uTools-Manuals/docs/java/javax/xml/stream/XMLOutputFactory.html

678 lines
38 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="Class XMLOutputFactory">Class XMLOutputFactory</h2>
</div><div class="contentContainer">
<ul class="inheritance">
<li><a href="../../../java/lang/Object.html" title="class in java.lang">java.lang.Object</a></li>
<li>
<ul class="inheritance">
<li>javax.xml.stream.XMLOutputFactory</li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<hr/> <br/> <pre>public abstract class <span class="typeNameLabel">XMLOutputFactory</span>
extends <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></pre>
<div class="block">
<span>定义用于获取XMLEventWriters和XMLStreamWrit的工厂的抽象实现。</span>
<span>下表定义了本规范的标准属性。</span>
<span>每个财产的每个实施所需的支持水平各不相同。</span>
<span>所需的支持级别在“必需”列中描述。</span>
<span> Configuration parameters Property Name Behavior Return type Default Value Required javax.xml.stream.isRepairingNamespaces defaults prefixes on the output side Boolean False Yes </span>
<table border="2" cellpadding="4" rules="all">
</table>
<p> <span>以下段落描述了命名空间和前缀修复算法：</span> </p>
<p> <span>该属性可以使用以下代码行设置： <code>setProperty("javax.xml.stream.isRepairingNamespaces",new Boolean(true|false));</code></span> </p>
<p> <span>该属性指定作者默认命名空间前缀声明。</span> <span>默认值为false。</span> </p>
<p> <span>如果作者是ReepairingNamespaces，它将为当前的StartElement创建一个名称空间声明，该属性当前不具有范围内的命名空间声明。</span> <span>如果StartElement具有uri但未指定前缀，则将分配前缀，如果前缀尚未在当前StartElement的父项中声明，则它将在当前StartElement上声明。</span> <span>如果defaultNamespace被绑定并且在范围内，并且默认命名空间与属性的URI或StartElement QName匹配，则不会分配前缀。</span> </p>
<p> <span>如果元素或属性名称具有前缀但未绑定到任何命名空间URI，则在序列化期间前缀将被删除。</span> </p>
<p> <span>如果同一起始或空元素标签中的元素和/或属性名称绑定到不同的命名空间URI并且使用相同的前缀，则元素或第一个发生属性保留原始前缀，并且以下属性的前缀替换为绑定到这些属性的命名空间URI的新前缀。</span> </p>
<p> <span>如果元素或属性名称使用绑定到与该元素的父元素的命名空间上下文不同的URI的前缀，并且在当前元素的上下文中没有命名空间声明，则会添加这样的命名空间声明。</span> </p>
<p> <span>如果元素或属性名称绑定到前缀，并且有一个命名空间声明将该前缀绑定到不同的URI，那么如果正确的映射从该元素的父上下文继承，则该名称空间声明被删除，或者更改为使用该前缀的元素或属性的命名空间URI。</span> </p>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
1.6
</dd>
<dt>
<span class="simpleTagLabel">Version:</span>
</dt>
<dd>
1.2
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../../javax/xml/stream/XMLInputFactory.html" title="javax.xml.stream中的类"><code>XMLInputFactory</code></a> ， <a href="../../../javax/xml/stream/XMLEventWriter.html" title="javax.xml.stream中的接口"><code>XMLEventWriter</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>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Field Summary table, listing fields, and an explanation">
<caption>
<span>Fields</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Field and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static <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/XMLOutputFactory.html#IS_REPAIRING_NAMESPACES">IS_REPAIRING_NAMESPACES</a></span></code>
<div class="block">
用于在输出端设置前缀默认值的属性
</div> </td>
</tr>
</tbody>
</table> </li>
</ul>
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.summary">
<!-- --> </a> <h3>构造方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Constructor Summary table, listing constructors, and an explanation">
<caption>
<span>构造方法</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier</th>
<th class="colLast" scope="col">Constructor and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code>protected </code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLOutputFactory.html#XMLOutputFactory--">XMLOutputFactory</a></span>()</code> </td>
</tr>
</tbody>
</table> </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="t1"><span><a href="javascript:show(1);">静态方法</a></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>
<span class="tableTab" id="t4"><span><a href="javascript:show(8);">具体的方法</a></span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t6"><span><a href="javascript:show(32);">弃用的方法</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>abstract <a href="../../../javax/xml/stream/XMLEventWriter.html" title="interface in javax.xml.stream">XMLEventWriter</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLOutputFactory.html#createXMLEventWriter-java.io.OutputStream-">createXMLEventWriter</a></span>(<a href="../../../java/io/OutputStream.html" title="class in java.io">OutputStream</a> stream)</code>
<div class="block">
创建一个写入流的新XMLEventWriter
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code>abstract <a href="../../../javax/xml/stream/XMLEventWriter.html" title="interface in javax.xml.stream">XMLEventWriter</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLOutputFactory.html#createXMLEventWriter-java.io.OutputStream-java.lang.String-">createXMLEventWriter</a></span>(<a href="../../../java/io/OutputStream.html" title="class in java.io">OutputStream</a> stream, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> encoding)</code>
<div class="block">
创建一个写入流的新XMLEventWriter
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code>abstract <a href="../../../javax/xml/stream/XMLEventWriter.html" title="interface in javax.xml.stream">XMLEventWriter</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLOutputFactory.html#createXMLEventWriter-javax.xml.transform.Result-">createXMLEventWriter</a></span>(<a href="../../../javax/xml/transform/Result.html" title="interface in javax.xml.transform">Result</a> result)</code>
<div class="block">
创建一个写入JAXP结果的新的XMLEventWriter。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code>abstract <a href="../../../javax/xml/stream/XMLEventWriter.html" title="interface in javax.xml.stream">XMLEventWriter</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLOutputFactory.html#createXMLEventWriter-java.io.Writer-">createXMLEventWriter</a></span>(<a href="../../../java/io/Writer.html" title="class in java.io">Writer</a> stream)</code>
<div class="block">
创建一个写入作者的新的XMLEventWriter
</div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code>abstract <a href="../../../javax/xml/stream/XMLStreamWriter.html" title="interface in javax.xml.stream">XMLStreamWriter</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLOutputFactory.html#createXMLStreamWriter-java.io.OutputStream-">createXMLStreamWriter</a></span>(<a href="../../../java/io/OutputStream.html" title="class in java.io">OutputStream</a> stream)</code>
<div class="block">
创建一个写入流的新XMLStreamWriter
</div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code>abstract <a href="../../../javax/xml/stream/XMLStreamWriter.html" title="interface in javax.xml.stream">XMLStreamWriter</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLOutputFactory.html#createXMLStreamWriter-java.io.OutputStream-java.lang.String-">createXMLStreamWriter</a></span>(<a href="../../../java/io/OutputStream.html" title="class in java.io">OutputStream</a> stream, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> encoding)</code>
<div class="block">
创建一个写入流的新XMLStreamWriter
</div> </td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code>abstract <a href="../../../javax/xml/stream/XMLStreamWriter.html" title="interface in javax.xml.stream">XMLStreamWriter</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLOutputFactory.html#createXMLStreamWriter-javax.xml.transform.Result-">createXMLStreamWriter</a></span>(<a href="../../../javax/xml/transform/Result.html" title="interface in javax.xml.transform">Result</a> result)</code>
<div class="block">
创建一个写入JAXP结果的新XMLStreamWriter。
</div> </td>
</tr>
<tr class="rowColor" id="i7">
<td class="colFirst"><code>abstract <a href="../../../javax/xml/stream/XMLStreamWriter.html" title="interface in javax.xml.stream">XMLStreamWriter</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLOutputFactory.html#createXMLStreamWriter-java.io.Writer-">createXMLStreamWriter</a></span>(<a href="../../../java/io/Writer.html" title="class in java.io">Writer</a> stream)</code>
<div class="block">
创建一个写入作者的新XMLStreamWriter
</div> </td>
</tr>
<tr class="altColor" id="i8">
<td class="colFirst"><code>abstract <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/XMLOutputFactory.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="rowColor" id="i9">
<td class="colFirst"><code>abstract boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLOutputFactory.html#isPropertySupported-java.lang.String-">isPropertySupported</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="i10">
<td class="colFirst"><code>static <a href="../../../javax/xml/stream/XMLOutputFactory.html" title="class in javax.xml.stream">XMLOutputFactory</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLOutputFactory.html#newFactory--">newFactory</a></span>()</code>
<div class="block">
创建一个新的工厂实例。
</div> </td>
</tr>
<tr class="rowColor" id="i11">
<td class="colFirst"><code>static <a href="../../../javax/xml/stream/XMLOutputFactory.html" title="class in javax.xml.stream">XMLOutputFactory</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLOutputFactory.html#newFactory-java.lang.String-java.lang.ClassLoader-">newFactory</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> factoryId, <a href="../../../java/lang/ClassLoader.html" title="class in java.lang">ClassLoader</a> classLoader)</code>
<div class="block">
创建一个新的工厂实例。
</div> </td>
</tr>
<tr class="altColor" id="i12">
<td class="colFirst"><code>static <a href="../../../javax/xml/stream/XMLOutputFactory.html" title="class in javax.xml.stream">XMLOutputFactory</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLOutputFactory.html#newInstance--">newInstance</a></span>()</code>
<div class="block">
以与
<a href="../../../javax/xml/stream/XMLOutputFactory.html#newFactory--"><code>newFactory()</code></a>方法完全相同的方式创建工厂的新实例。
</div> </td>
</tr>
<tr class="rowColor" id="i13">
<td class="colFirst"><code>static <a href="../../../javax/xml/stream/XMLInputFactory.html" title="class in javax.xml.stream">XMLInputFactory</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLOutputFactory.html#newInstance-java.lang.String-java.lang.ClassLoader-">newInstance</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> factoryId, <a href="../../../java/lang/ClassLoader.html" title="class in java.lang">ClassLoader</a> classLoader)</code>
<div class="block">
<span><span class="deprecatedLabel">已弃用</span></span>
<div class="block">
<span><span class="deprecationComment">此方法已被弃用，因为它返回一个XMLInputFactory的实例，该实例是错误的类。</span></span>
<span><span class="deprecationComment">改用新方法<a href="../../../javax/xml/stream/XMLOutputFactory.html#newFactory-java.lang.String-java.lang.ClassLoader-"><code>newFactory(java.lang.String, java.lang.ClassLoader)</code></a> 。</span></span>
</div>
</div> </td>
</tr>
<tr class="altColor" id="i14">
<td class="colFirst"><code>abstract void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/stream/XMLOutputFactory.html#setProperty-java.lang.String-java.lang.Object-">setProperty</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name, <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> value)</code>
<div class="block">
允许用户在底层实现上设置特定的功能/属性。
</div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
<!-- --> </a> <h3>Methods inherited from class java.lang.<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></h3> <code><a href="../../../java/lang/Object.html#clone--">clone</a>, <a href="../../../java/lang/Object.html#equals-java.lang.Object-">equals</a>, <a href="../../../java/lang/Object.html#finalize--">finalize</a>, <a href="../../../java/lang/Object.html#getClass--">getClass</a>, <a href="../../../java/lang/Object.html#hashCode--">hashCode</a>, <a href="../../../java/lang/Object.html#notify--">notify</a>, <a href="../../../java/lang/Object.html#notifyAll--">notifyAll</a>, <a href="../../../java/lang/Object.html#toString--">toString</a>, <a href="../../../java/lang/Object.html#wait--">wait</a>, <a href="../../../java/lang/Object.html#wait-long-">wait</a>, <a href="../../../java/lang/Object.html#wait-long-int-">wait</a></code></li>
</ul> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ FIELD DETAIL =========== -->
<ul class="blockList">
<li class="blockList"><a name="field.detail">
<!-- --> </a> <h3>字段详细信息</h3> <a name="IS_REPAIRING_NAMESPACES">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>IS_REPAIRING_NAMESPACES</h4> <pre>public static final <a href="../../../java/lang/String.html" title="class in java.lang">String</a> IS_REPAIRING_NAMESPACES</pre>
<div class="block">
用于在输出端设置前缀默认值的属性
</div>
<dl>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../constant-values.html#javax.xml.stream.XMLOutputFactory.IS_REPAIRING_NAMESPACES">Constant Field Values</a>
</dd>
</dl> </li>
</ul> </li>
</ul>
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="XMLOutputFactory--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>XMLOutputFactory</h4> <pre>protected XMLOutputFactory()</pre> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="newInstance--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>newInstance</h4> <pre>public static <a href="../../../javax/xml/stream/XMLOutputFactory.html" title="class in javax.xml.stream">XMLOutputFactory</a> newInstance()
throws <a href="../../../javax/xml/stream/FactoryConfigurationError.html" title="class in javax.xml.stream">FactoryConfigurationError</a></pre>
<div class="block">
以与
<a href="../../../javax/xml/stream/XMLOutputFactory.html#newFactory--"><code>newFactory()</code></a>方法完全相同的方式创建工厂的新实例。
</div>
<dl>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/xml/stream/FactoryConfigurationError.html" title="class in javax.xml.stream">FactoryConfigurationError</a></code> - 如果此工厂的实例无法加载
</dd>
</dl> </li>
</ul> <a name="newFactory--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>newFactory</h4> <pre>public static <a href="../../../javax/xml/stream/XMLOutputFactory.html" title="class in javax.xml.stream">XMLOutputFactory</a> newFactory()
throws <a href="../../../javax/xml/stream/FactoryConfigurationError.html" title="class in javax.xml.stream">FactoryConfigurationError</a></pre>
<div class="block">
<span>创建一个新的工厂实例。</span>
<p> <span>这个静态方法创建一个新的工厂实例。</span> <span>此方法使用以下有序查找过程来确定要加载的XMLOutputFactory实现类：</span> </p>
<ul>
<li> <span>使用javax.xml.stream.XMLOutputFactory系统属性。</span> </li>
<li> <span>在JRE目录中使用属性文件“lib / stax.properties”。</span> <span>此配置文件采用标准的java.util.Properties格式，并包含实现类的完全限定名称，其中键为上面定义的系统属性。</span> </li>
<li> <span>使用由<a href="../../../java/util/ServiceLoader.html" title="java.util中的类"><code>ServiceLoader</code></a>类定义的服务提供商加载工具尝试使用default loading mechanism定位并加载服务的<a href="../../../java/util/ServiceLoader.html#load-java.lang.Class-">实现</a> ：服务提供商加载工具将使用<a href="../../../java/lang/Thread.html#getContextClassLoader--">current thread's context class loader</a>来尝试加载服务。</span> <span>如果上下文类加载器为null， <a href="../../../java/lang/ClassLoader.html#getSystemClassLoader--">那么</a>将使用<a href="../../../java/lang/ClassLoader.html#getSystemClassLoader--">system class loader</a> 。</span> </li>
<li> <span>否则，返回系统默认实现。</span> </li>
<p> <span>一旦应用程序获得了对XMLOutputFactory的引用，它可以使用工厂来配置和获取流实例。</span> </p>
<p> <span>请注意，这是一种替代不推荐使用的newInstance（）方法的新方法。</span> <span>相对于不推荐使用的方法，此替换方法没有定义行为更改。</span> </p>
</ul>
</div>
<dl>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../../javax/xml/stream/FactoryConfigurationError.html" title="class in javax.xml.stream">FactoryConfigurationError</a></code> -在以下情况下<a href="../../../java/util/ServiceConfigurationError.html" title="java.util中的类">service configuration error</a>或者如果实现不可用或不能被实例化。</span>
</dd>
</dl> </li>
</ul> <a name="newInstance-java.lang.String-java.lang.ClassLoader-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>newInstance</h4> <pre>public static <a href="../../../javax/xml/stream/XMLInputFactory.html" title="class in javax.xml.stream">XMLInputFactory</a> newInstance(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> factoryId,
<a href="../../../java/lang/ClassLoader.html" title="class in java.lang">ClassLoader</a> classLoader)
throws <a href="../../../javax/xml/stream/FactoryConfigurationError.html" title="class in javax.xml.stream">FactoryConfigurationError</a></pre>
<div class="block">
<span><span class="deprecatedLabel">已弃用</span></span>
<span><span class="deprecationComment">此方法已被弃用，因为它返回一个XMLInputFactory的实例，该实例是错误的类。</span></span>
<span><span class="deprecationComment">改用新方法<a href="../../../javax/xml/stream/XMLOutputFactory.html#newFactory-java.lang.String-java.lang.ClassLoader-"><code>newFactory(java.lang.String, java.lang.ClassLoader)</code></a> 。</span></span>
</div>
<div class="block">
创建一个新的工厂实例。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>factoryId</code> - 找到工厂的名称，与属性名称相同
</dd>
<dd>
<code>classLoader</code> - classLoader使用
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
工厂实施
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/xml/stream/FactoryConfigurationError.html" title="class in javax.xml.stream">FactoryConfigurationError</a></code> - 如果此工厂的实例无法加载
</dd>
</dl> </li>
</ul> <a name="newFactory-java.lang.String-java.lang.ClassLoader-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>newFactory</h4> <pre>public static <a href="../../../javax/xml/stream/XMLOutputFactory.html" title="class in javax.xml.stream">XMLOutputFactory</a> newFactory(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> factoryId,
<a href="../../../java/lang/ClassLoader.html" title="class in java.lang">ClassLoader</a> classLoader)
throws <a href="../../../javax/xml/stream/FactoryConfigurationError.html" title="class in javax.xml.stream">FactoryConfigurationError</a></pre>
<div class="block">
<span>创建一个新的工厂实例。</span>
<span>如果classLoader参数为空，则使用ContextClassLoader。</span>
<p> <span>此方法使用以下有序查找过程来确定要加载的XMLOutputFactory实现类：</span> </p>
<ul>
<li> <span>通过使用标识的系统属性的值<code>factoryId</code> 。</span> </li>
<li> <span>在JRE目录中使用属性文件“lib / stax.properties”。</span> <span>此配置文件采用标准的java.util.Properties格式，包含实现类的完全限定名称，其中的键为给定的<code>factoryId</code> 。</span> </li>
<li> <span>如果<code>factoryId</code>是“javax.xml.stream.XMLOutputFactory”，请使用由<a href="../../../java/util/ServiceLoader.html" title="java.util中的类"><code>ServiceLoader</code></a>类定义的服务提供程序加载工具来尝试使用指定的ClassLoader查找和加载服务的<code>ClassLoader</code> 。</span> <span>如果<code>classLoader</code>为空，则将适用<a href="../../../java/util/ServiceLoader.html#load-java.lang.Class-">default loading mechanism</a> ：即，服务提供商加载工具将使用<a href="../../../java/lang/Thread.html#getContextClassLoader--">current thread's context class loader</a>尝试加载服务。</span> <span>如果上下文类加载器为null， <a href="../../../java/lang/ClassLoader.html#getSystemClassLoader--">那么</a>将使用<a href="../../../java/lang/ClassLoader.html#getSystemClassLoader--">system class loader</a> 。</span> </li>
<li> <span>否则，抛出一个<a href="../../../javax/xml/stream/FactoryConfigurationError.html" title="javax.xml.stream中的类"><code>FactoryConfigurationError</code></a> 。</span> </li>
</ul>
</div>
<dl>
<dt>
<span class="simpleTagLabel">API Note:</span>
</dt>
<dd>
<span>这里定义的参数factoryId与其他JAXP工厂的参数factoryId不一致，其中第一个参数是提供工厂实现的完全限定的工厂类名称。</span>
<p> <span>请注意，这是一种替代已弃用的<a href="../../../javax/xml/stream/XMLOutputFactory.html#newInstance-java.lang.String-java.lang.ClassLoader-"><code>newInstance(String factoryId, ClassLoader classLoader)</code></a>方法的新方法。</span> <span>原始方法被错误地定义为返回XMLInputFactory。</span> </p>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>factoryId</code> - 找到工厂的名称，与属性名称相同
</dd>
<dd>
<code>classLoader</code> - classLoader使用
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
工厂实施
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../../javax/xml/stream/FactoryConfigurationError.html" title="class in javax.xml.stream">FactoryConfigurationError</a></code> -在以下情况下<a href="../../../java/util/ServiceConfigurationError.html" title="java.util中的类">service configuration error</a>或者如果实现不可用或不能被实例化。</span>
</dd>
</dl> </li>
</ul> <a name="createXMLStreamWriter-java.io.Writer-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createXMLStreamWriter</h4> <pre>public abstract <a href="../../../javax/xml/stream/XMLStreamWriter.html" title="interface in javax.xml.stream">XMLStreamWriter</a> createXMLStreamWriter(<a href="../../../java/io/Writer.html" title="class in java.io">Writer</a> stream)
throws <a href="../../../javax/xml/stream/XMLStreamException.html" title="class in javax.xml.stream">XMLStreamException</a></pre>
<div class="block">
创建一个写入作者的新XMLStreamWriter
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>stream</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="createXMLStreamWriter-java.io.OutputStream-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createXMLStreamWriter</h4> <pre>public abstract <a href="../../../javax/xml/stream/XMLStreamWriter.html" title="interface in javax.xml.stream">XMLStreamWriter</a> createXMLStreamWriter(<a href="../../../java/io/OutputStream.html" title="class in java.io">OutputStream</a> stream)
throws <a href="../../../javax/xml/stream/XMLStreamException.html" title="class in javax.xml.stream">XMLStreamException</a></pre>
<div class="block">
创建一个写入流的新XMLStreamWriter
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>stream</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="createXMLStreamWriter-java.io.OutputStream-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createXMLStreamWriter</h4> <pre>public abstract <a href="../../../javax/xml/stream/XMLStreamWriter.html" title="interface in javax.xml.stream">XMLStreamWriter</a> createXMLStreamWriter(<a href="../../../java/io/OutputStream.html" title="class in java.io">OutputStream</a> stream,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> encoding)
throws <a href="../../../javax/xml/stream/XMLStreamException.html" title="class in javax.xml.stream">XMLStreamException</a></pre>
<div class="block">
创建一个写入流的新XMLStreamWriter
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>stream</code> - 要写入的流
</dd>
<dd>
<code>encoding</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="createXMLStreamWriter-javax.xml.transform.Result-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createXMLStreamWriter</h4> <pre>public abstract <a href="../../../javax/xml/stream/XMLStreamWriter.html" title="interface in javax.xml.stream">XMLStreamWriter</a> createXMLStreamWriter(<a href="../../../javax/xml/transform/Result.html" title="interface in javax.xml.transform">Result</a> result)
throws <a href="../../../javax/xml/stream/XMLStreamException.html" title="class in javax.xml.stream">XMLStreamException</a></pre>
<div class="block">
<span>创建一个写入JAXP结果的新XMLStreamWriter。</span>
<span>此方法是可选的。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>result</code> - 要写的结果
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果此XMLOutputFactory不支持此方法
</dd>
<dd>
<code><a href="../../../javax/xml/stream/XMLStreamException.html" title="class in javax.xml.stream">XMLStreamException</a></code>
</dd>
</dl> </li>
</ul> <a name="createXMLEventWriter-javax.xml.transform.Result-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createXMLEventWriter</h4> <pre>public abstract <a href="../../../javax/xml/stream/XMLEventWriter.html" title="interface in javax.xml.stream">XMLEventWriter</a> createXMLEventWriter(<a href="../../../javax/xml/transform/Result.html" title="interface in javax.xml.transform">Result</a> result)
throws <a href="../../../javax/xml/stream/XMLStreamException.html" title="class in javax.xml.stream">XMLStreamException</a></pre>
<div class="block">
<span>创建一个写入JAXP结果的新的XMLEventWriter。</span>
<span>此方法是可选的。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>result</code> - 要写的结果
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 如果此XMLOutputFactory不支持此方法
</dd>
<dd>
<code><a href="../../../javax/xml/stream/XMLStreamException.html" title="class in javax.xml.stream">XMLStreamException</a></code>
</dd>
</dl> </li>
</ul> <a name="createXMLEventWriter-java.io.OutputStream-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createXMLEventWriter</h4> <pre>public abstract <a href="../../../javax/xml/stream/XMLEventWriter.html" title="interface in javax.xml.stream">XMLEventWriter</a> createXMLEventWriter(<a href="../../../java/io/OutputStream.html" title="class in java.io">OutputStream</a> stream)
throws <a href="../../../javax/xml/stream/XMLStreamException.html" title="class in javax.xml.stream">XMLStreamException</a></pre>
<div class="block">
创建一个写入流的新XMLEventWriter
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>stream</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="createXMLEventWriter-java.io.OutputStream-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createXMLEventWriter</h4> <pre>public abstract <a href="../../../javax/xml/stream/XMLEventWriter.html" title="interface in javax.xml.stream">XMLEventWriter</a> createXMLEventWriter(<a href="../../../java/io/OutputStream.html" title="class in java.io">OutputStream</a> stream,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> encoding)
throws <a href="../../../javax/xml/stream/XMLStreamException.html" title="class in javax.xml.stream">XMLStreamException</a></pre>
<div class="block">
创建一个写入流的新XMLEventWriter
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>stream</code> - 要写的流
</dd>
<dd>
<code>encoding</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="createXMLEventWriter-java.io.Writer-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createXMLEventWriter</h4> <pre>public abstract <a href="../../../javax/xml/stream/XMLEventWriter.html" title="interface in javax.xml.stream">XMLEventWriter</a> createXMLEventWriter(<a href="../../../java/io/Writer.html" title="class in java.io">Writer</a> stream)
throws <a href="../../../javax/xml/stream/XMLStreamException.html" title="class in javax.xml.stream">XMLStreamException</a></pre>
<div class="block">
创建一个写入作者的新的XMLEventWriter
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>stream</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="setProperty-java.lang.String-java.lang.Object-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setProperty</h4> <pre>public abstract void setProperty(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name,
<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> value)
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>
<dd>
<code>value</code> - 该属性的值
</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="getProperty-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getProperty</h4> <pre>public abstract <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> - 如果不支持该属性
</dd>
</dl> </li>
</ul> <a name="isPropertySupported-java.lang.String-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>isPropertySupported</h4> <pre>public abstract boolean isPropertySupported(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)</pre>
<div class="block">
查询此工厂支持的属性集。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 属性的名称（可能不为空）
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
如果属性被支持，则为true，否则为false
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>
Reference in New Issue View Git Blame Copy Permalink