mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-07-06 00:32:44 +08:00
504 lines
30 KiB
HTML
504 lines
30 KiB
HTML
<div class="header">
|
||
<div class="subTitle">
|
||
compact2, compact3
|
||
</div>
|
||
<div class="subTitle">
|
||
javax.xml.transform
|
||
</div>
|
||
<h2 class="title" title="Class Transformer">Class Transformer</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.transform.Transformer</li>
|
||
</ul> </li>
|
||
</ul>
|
||
<div class="description">
|
||
<ul class="blockList">
|
||
<li class="blockList">
|
||
<hr/> <br/> <pre>public abstract class <span class="typeNameLabel">Transformer</span>
|
||
extends <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></pre>
|
||
<div class="block">
|
||
<span>这个抽象类的一个实例可以将一个源代码树转换成一个结果树。</span>
|
||
<p> <span>该类的一个实例可以使用<a href="../../../javax/xml/transform/TransformerFactory.html#newTransformer-javax.xml.transform.Source-"><code>TransformerFactory.newTransformer</code></a>方法获得。</span> <span>然后，该实例可用于从各种源处理XML，并将转换输出写入各种汇。</span> </p>
|
||
<p> <span>此类的对象可能不会同时运行在多个线程中。</span> <span>不同的线程可以同时使用不同的变压器。</span> </p>
|
||
<p> <span>A <code>Transformer</code>可以多次使用。</span> <span>跨转换保留参数和输出属性。</span> </p>
|
||
</div> </li>
|
||
</ul>
|
||
</div>
|
||
<div class="summary">
|
||
<ul class="blockList">
|
||
<li class="blockList">
|
||
<!-- ======== 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/transform/Transformer.html#Transformer--">Transformer</a></span>()</code>
|
||
<div class="block">
|
||
默认构造函数是有意保护的。
|
||
</div> </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="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>
|
||
</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 void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/transform/Transformer.html#clearParameters--">clearParameters</a></span>()</code>
|
||
<div class="block">
|
||
清除所有使用setParameter设置的参数。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i1">
|
||
<td class="colFirst"><code>abstract <a href="../../../javax/xml/transform/ErrorListener.html" title="interface in javax.xml.transform">ErrorListener</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/transform/Transformer.html#getErrorListener--">getErrorListener</a></span>()</code>
|
||
<div class="block">
|
||
获取有效转换的错误事件处理程序。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i2">
|
||
<td class="colFirst"><code>abstract <a href="../../../java/util/Properties.html" title="class in java.util">Properties</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/transform/Transformer.html#getOutputProperties--">getOutputProperties</a></span>()</code>
|
||
<div class="block">
|
||
获取转换的输出属性的副本。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i3">
|
||
<td class="colFirst"><code>abstract <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/transform/Transformer.html#getOutputProperty-java.lang.String-">getOutputProperty</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="i4">
|
||
<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/transform/Transformer.html#getParameter-java.lang.String-">getParameter</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)</code>
|
||
<div class="block">
|
||
获取使用setParameter显式设置的参数。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i5">
|
||
<td class="colFirst"><code>abstract <a href="../../../javax/xml/transform/URIResolver.html" title="interface in javax.xml.transform">URIResolver</a></code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/transform/Transformer.html#getURIResolver--">getURIResolver</a></span>()</code>
|
||
<div class="block">
|
||
获取一个用于解析document（）中使用的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/transform/Transformer.html#reset--">reset</a></span>()</code>
|
||
<div class="block">
|
||
将此
|
||
<code>Transformer</code>重置为原始配置。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i7">
|
||
<td class="colFirst"><code>abstract void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/transform/Transformer.html#setErrorListener-javax.xml.transform.ErrorListener-">setErrorListener</a></span>(<a href="../../../javax/xml/transform/ErrorListener.html" title="interface in javax.xml.transform">ErrorListener</a> listener)</code>
|
||
<div class="block">
|
||
设置变量生效的错误事件侦听器。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i8">
|
||
<td class="colFirst"><code>abstract void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/transform/Transformer.html#setOutputProperties-java.util.Properties-">setOutputProperties</a></span>(<a href="../../../java/util/Properties.html" title="class in java.util">Properties</a> oformat)</code>
|
||
<div class="block">
|
||
设置转换的输出属性。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="rowColor" id="i9">
|
||
<td class="colFirst"><code>abstract void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/transform/Transformer.html#setOutputProperty-java.lang.String-java.lang.String-">setOutputProperty</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> value)</code>
|
||
<div class="block">
|
||
设置一个对转换有效的输出属性。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i10">
|
||
<td class="colFirst"><code>abstract void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/transform/Transformer.html#setParameter-java.lang.String-java.lang.Object-">setParameter</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>
|
||
<tr class="rowColor" id="i11">
|
||
<td class="colFirst"><code>abstract void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/transform/Transformer.html#setURIResolver-javax.xml.transform.URIResolver-">setURIResolver</a></span>(<a href="../../../javax/xml/transform/URIResolver.html" title="interface in javax.xml.transform">URIResolver</a> resolver)</code>
|
||
<div class="block">
|
||
设置一个用于解析document（）中使用的URI的对象。
|
||
</div> </td>
|
||
</tr>
|
||
<tr class="altColor" id="i12">
|
||
<td class="colFirst"><code>abstract void</code></td>
|
||
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/transform/Transformer.html#transform-javax.xml.transform.Source-javax.xml.transform.Result-">transform</a></span>(<a href="../../../javax/xml/transform/Source.html" title="interface in javax.xml.transform">Source</a> xmlSource, <a href="../../../javax/xml/transform/Result.html" title="interface in javax.xml.transform">Result</a> outputTarget)</code>
|
||
<div class="block">
|
||
将XML
|
||
<code>Source</code>转换为
|
||
<code>Result</code> 。
|
||
</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">
|
||
<!-- ========= CONSTRUCTOR DETAIL ======== -->
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="constructor.detail">
|
||
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="Transformer--">
|
||
<!-- --> </a>
|
||
<ul class="blockListLast">
|
||
<li class="blockList"> <h4>Transformer</h4> <pre>protected Transformer()</pre>
|
||
<div class="block">
|
||
默认构造函数是有意保护的。
|
||
</div> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
<!-- ============ METHOD DETAIL ========== -->
|
||
<ul class="blockList">
|
||
<li class="blockList"><a name="method.detail">
|
||
<!-- --> </a> <h3>方法详细信息</h3> <a name="reset--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>reset</h4> <pre>public void reset()</pre>
|
||
<div class="block">
|
||
<p> <span>将此<code>Transformer</code>重置为原始配置。</span> </p>
|
||
<p> <span><code>Transformer</code>被重置为相同的状态，当它被用创建为<a href="../../../javax/xml/transform/TransformerFactory.html#newTransformer--"><code>TransformerFactory.newTransformer()</code></a> ， <a href="../../../javax/xml/transform/TransformerFactory.html#newTransformer-javax.xml.transform.Source-"><code>TransformerFactory.newTransformer(Source source)</code></a>或<a href="../../../javax/xml/transform/Templates.html#newTransformer--"><code>Templates.newTransformer()</code></a> 。</span> <span><code>reset()</code>旨在允许现有的<code>Transformer</code> s的重用，从而节省与创建新的<code>Transformer</code> s相关的资源。</span> </p>
|
||
<p> <span>复位<code>Transformer</code>不能保证具有相同的<a href="../../../javax/xml/transform/URIResolver.html" title="javax.xml.transform中的接口"><code>URIResolver</code></a>或<a href="../../../javax/xml/transform/ErrorListener.html" title="javax.xml.transform中的接口">Object的</a> <code>Object</code> ，例如<a href="../../../java/lang/Object.html#equals-java.lang.Object-"><code>Object.equals(Object obj)</code></a> 。</span> <span>保证功能相当于<code>URIResolver</code>和<code>ErrorListener</code> 。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/lang/UnsupportedOperationException.html" title="class in java.lang">UnsupportedOperationException</a></code> - 实现时不覆盖此方法。
|
||
</dd>
|
||
<dt>
|
||
<span class="simpleTagLabel">从以下版本开始：</span>
|
||
</dt>
|
||
<dd>
|
||
1.5
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="transform-javax.xml.transform.Source-javax.xml.transform.Result-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>transform</h4> <pre>public abstract void transform(<a href="../../../javax/xml/transform/Source.html" title="interface in javax.xml.transform">Source</a> xmlSource,
|
||
<a href="../../../javax/xml/transform/Result.html" title="interface in javax.xml.transform">Result</a> outputTarget)
|
||
throws <a href="../../../javax/xml/transform/TransformerException.html" title="class in javax.xml.transform">TransformerException</a></pre>
|
||
<div class="block">
|
||
<p> <span>将XML <code>Source</code>转换为<code>Result</code> 。</span> <span>具体的转换行为由TransformerFactory的设置<code>TransformerFactory</code> ，当<code>Transformer</code>被实例化并对<code>Transformer</code>实例进行任何修改时。</span> </p>
|
||
<p> <span>空<code>Source</code>由作为构成被表示为一个空文件<a href="../../../javax/xml/parsers/DocumentBuilder.html#newDocument--"><code>DocumentBuilder.newDocument()</code></a> 。</span> <span>转换空<code>Source</code>的结果取决于转换行为;</span> <span>它并不总是一个空的<code>Result</code> 。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>xmlSource</code> - 要转换的XML输入。
|
||
</dd>
|
||
<dd>
|
||
<code>outputTarget</code> -
|
||
<code>Result</code> xmlSource的
|
||
<code>xmlSource</code> 。
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../javax/xml/transform/TransformerException.html" title="class in javax.xml.transform">TransformerException</a></code> - 如果在转换过程中出现不可恢复的错误。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="setParameter-java.lang.String-java.lang.Object-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>setParameter</h4> <pre>public abstract void setParameter(<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)</pre>
|
||
<div class="block">
|
||
<span>添加转换参数。</span>
|
||
<p> <span>将限定名称作为两部分字符串传递，命名空间URI用大括号（{}）括起来，后跟本地名称。</span> <span>如果该名称具有空值URL，则该字符串仅包含本地名称。</span> <span>应用程序可以通过测试来查看名称的第一个字符是否为“{”字符，从而安全地检查非空URI。</span> </p>
|
||
<p> <span>例如，如果从使用<xyz：foo xmlns：xyz =“http://xyz.foo.com/yada/baz.html”/>定义的元素获取URI和本地名称，则限定名称将为“{http://xyz.foo.com/yada/baz.html}foo”。</span> <span>请注意，不使用前缀。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>name</code> - 参数的名称，可以以花括号（{}）中的命名空间URI开头。
|
||
</dd>
|
||
<dd>
|
||
<span><code>value</code> - 值对象。</span>
|
||
<span>这可以是任何有效的Java对象。</span>
|
||
<span>由处理器提供适当的对象沉浸或简单地传递对象以在扩展中使用。</span>
|
||
</dd>
|
||
<dt>
|
||
<span class="throwsLabel">异常</span>
|
||
</dt>
|
||
<dd>
|
||
<code><a href="../../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</a></code> - 如果值为空。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getParameter-java.lang.String-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getParameter</h4> <pre>public abstract <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> getParameter(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)</pre>
|
||
<div class="block">
|
||
<span>获取使用setParameter显式设置的参数。</span>
|
||
<p> <span>此方法不返回默认参数值，该参数值在转换过程中评估节点上下文之前无法确定。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>name</code> - 的
|
||
<code>Object</code>得到
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
使用setParameter设置的参数。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="clearParameters--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>clearParameters</h4> <pre>public abstract void clearParameters()</pre>
|
||
<div class="block">
|
||
清除所有使用setParameter设置的参数。
|
||
</div> </li>
|
||
</ul> <a name="setURIResolver-javax.xml.transform.URIResolver-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>setURIResolver</h4> <pre>public abstract void setURIResolver(<a href="../../../javax/xml/transform/URIResolver.html" title="interface in javax.xml.transform">URIResolver</a> resolver)</pre>
|
||
<div class="block">
|
||
<span>设置一个用于解析document（）中使用的URI的对象。</span>
|
||
<p> <span>如果解析器参数为空，则URIResolver值将被清除，变压器将不再具有解析器。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>resolver</code> - 实现URIResolver接口的对象，或null。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getURIResolver--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getURIResolver</h4> <pre>public abstract <a href="../../../javax/xml/transform/URIResolver.html" title="interface in javax.xml.transform">URIResolver</a> getURIResolver()</pre>
|
||
<div class="block">
|
||
获取一个用于解析document（）中使用的URI的对象。
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
实现URIResolver接口的对象，或者为空。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="setOutputProperties-java.util.Properties-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>setOutputProperties</h4> <pre>public abstract void setOutputProperties(<a href="../../../java/util/Properties.html" title="class in java.util">Properties</a> oformat)</pre>
|
||
<div class="block">
|
||
<span>设置转换的输出属性。</span>
|
||
<span>这些属性将覆盖使用xsl：output的Templates中设置的属性。</span>
|
||
<p> <span>如果此函数的参数为空，则将删除先前设置的任何属性，并将该值还原为在模板对象中定义的值。</span> </p>
|
||
<p> <span>将合格的属性密钥名称作为两部分字符串，命名空间URI以大括号（{}）括起，后跟本地名称。</span> <span>如果该名称具有空值URL，则该字符串仅包含本地名称。</span> <span>应用程序可以通过测试来查看名称的第一个字符是否为“{”字符，从而安全地检查非空URI。</span> </p>
|
||
<p> <span>例如，如果从使用<xyz：foo xmlns：xyz =“http://xyz.foo.com/yada/baz.html”/>定义的元素获取URI和本地名称，则限定名称将为“{http://xyz.foo.com/yada/baz.html}foo”。</span> <span>请注意，不使用前缀。</span> </p>
|
||
<span>一个<code>IllegalArgumentException</code>如果任何参数键不能识别被抛出，而不是名称空间限定的。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>oformat</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>
|
||
<dt>
|
||
<span class="seeLabel">另请参见：</span>
|
||
</dt>
|
||
<dd>
|
||
<span><a href="../../../javax/xml/transform/OutputKeys.html" title="javax.xml.transform中的类"><code>OutputKeys</code></a> ， <a href="../../../java/util/Properties.html" title="java.util中的类"><code>Properties</code></a></span>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getOutputProperties--">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getOutputProperties</h4> <pre>public abstract <a href="../../../java/util/Properties.html" title="class in java.util">Properties</a> getOutputProperties()</pre>
|
||
<div class="block">
|
||
<p> <span>获取转换的输出属性的副本。</span> </p>
|
||
<p> <span>返回的属性应包含用户设置的属性以及样式表设置的属性，并且这些属性由默认属性section 16 of the XSL Transformations (XSLT) W3C Recommendation <a href="http://www.w3.org/TR/xslt#output">指定</a> 。</span> <span>由用户或样式表专门设置的属性应位于基本属性列表中，而未特别设置的XSLT默认属性应为默认属性列表。</span> <span>因此，getOutputProperties（）。getProperty（String key）将获取由<a href="../../../javax/xml/transform/Transformer.html#setOutputProperty-java.lang.String-java.lang.String-">样式</a> <a href="../../../javax/xml/transform/Transformer.html#setOutputProperties-java.util.Properties-">表</a>中的<code>setOutputProperty(java.lang.String, java.lang.String)</code>,<code>setOutputProperties(java.util.Properties)</code> <em>或</em>默认属性设置的任何属性，而getOutputProperties（）。get（String key）将仅检索明确的属性通过设置<a href="../../../javax/xml/transform/Transformer.html#setOutputProperty-java.lang.String-java.lang.String-"><code>setOutputProperty(java.lang.String, java.lang.String)</code></a> ， <a href="../../../javax/xml/transform/Transformer.html#setOutputProperties-java.util.Properties-"><code>setOutputProperties(java.util.Properties)</code></a> ，或在样式表。</span> </p>
|
||
<p> <span>请注意，返回的Properties对象的变异将不会影响变量包含的属性。</span> </p>
|
||
<p> <span>如果任何参数键不被识别，并且没有命名空间限定，该属性将被忽略而不返回。</span> <span>换句话说，行为与<a href="../../../javax/xml/transform/Transformer.html#setOutputProperties-java.util.Properties-"><code>setOutputProperties</code></a>不<a href="../../../javax/xml/transform/Transformer.html#setOutputProperties-java.util.Properties-">正交</a> 。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
下一个转换的输出属性集的副本。
|
||
</dd>
|
||
<dt>
|
||
<span class="seeLabel">另请参见：</span>
|
||
</dt>
|
||
<dd>
|
||
<span><a href="../../../javax/xml/transform/OutputKeys.html" title="javax.xml.transform中的类"><code>OutputKeys</code></a> ， <a href="../../../java/util/Properties.html" title="java.util中的类"><code>Properties</code></a> ， <a href="http://www.w3.org/TR/xslt#output">XSL Transformations (XSLT) Version 1.0</a></span>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="setOutputProperty-java.lang.String-java.lang.String-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>setOutputProperty</h4> <pre>public abstract void setOutputProperty(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name,
|
||
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> value)
|
||
throws <a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></pre>
|
||
<div class="block">
|
||
<span>设置一个对转换有效的输出属性。</span>
|
||
<p> <span>将合格的属性名称作为两部分字符串传递，命名空间URI用大括号（{}）括起来，后跟本地名称。</span> <span>如果该名称具有空值URL，则该字符串仅包含本地名称。</span> <span>应用程序可以通过测试来查看名称的第一个字符是否为“{”字符，从而安全地检查非空URI。</span> </p>
|
||
<p> <span>例如，如果从使用<xyz：foo xmlns：xyz =“http://xyz.foo.com/yada/baz.html”/>定义的元素获取URI和本地名称，则限定名称将为“{http://xyz.foo.com/yada/baz.html}foo”。</span> <span>请注意，不使用前缀。</span> </p>
|
||
<p> <span>传递给<a href="../../../javax/xml/transform/Transformer.html#setOutputProperties-java.util.Properties-"><code>setOutputProperties(java.util.Properties)</code></a>的Properties对象将不会通过调用此方法来实现。</span> </p>
|
||
</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>
|
||
<dt>
|
||
<span class="seeLabel">另请参见：</span>
|
||
</dt>
|
||
<dd>
|
||
<span><a href="../../../javax/xml/transform/OutputKeys.html" title="javax.xml.transform中的类"><code>OutputKeys</code></a></span>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="getOutputProperty-java.lang.String-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>getOutputProperty</h4> <pre>public abstract <a href="../../../java/lang/String.html" title="class in java.lang">String</a> getOutputProperty(<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">
|
||
<p> <span>获取对变压器有效的输出属性。</span> </p>
|
||
<p> <span>如果使用<a href="../../../javax/xml/transform/Transformer.html#setOutputProperty-java.lang.String-java.lang.String-"><code>setOutputProperty(java.lang.String, java.lang.String)</code></a>设置了一个属性，则返回该值。</span> <span>否则，如果在样式表中明确指定了一个属性，则返回该值。</span> <span>如果属性的值已被默认，也就是说，如果没有使用<a href="../../../javax/xml/transform/Transformer.html#setOutputProperty-java.lang.String-java.lang.String-"><code>setOutputProperty(java.lang.String, java.lang.String)</code></a>或<a href="../../../javax/xml/transform/Transformer.html#setOutputProperty-java.lang.String-java.lang.String-">样式表显式</a>设置任何值，结果可能会因实现和输入样式表而异。</span> </p>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="paramLabel">参数</span>
|
||
</dt>
|
||
<dd>
|
||
<code>name</code> - 非空字符串，用于指定输出属性名称，可能是命名空间限定的。
|
||
</dd>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
output属性的字符串值，如果没有找到属性，则返回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>
|
||
<dt>
|
||
<span class="seeLabel">另请参见：</span>
|
||
</dt>
|
||
<dd>
|
||
<span><a href="../../../javax/xml/transform/OutputKeys.html" title="javax.xml.transform中的类"><code>OutputKeys</code></a></span>
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> <a name="setErrorListener-javax.xml.transform.ErrorListener-">
|
||
<!-- --> </a>
|
||
<ul class="blockList">
|
||
<li class="blockList"> <h4>setErrorListener</h4> <pre>public abstract void setErrorListener(<a href="../../../javax/xml/transform/ErrorListener.html" title="interface in javax.xml.transform">ErrorListener</a> listener)
|
||
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>listener</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="getErrorListener--">
|
||
<!-- --> </a>
|
||
<ul class="blockListLast">
|
||
<li class="blockList"> <h4>getErrorListener</h4> <pre>public abstract <a href="../../../javax/xml/transform/ErrorListener.html" title="interface in javax.xml.transform">ErrorListener</a> getErrorListener()</pre>
|
||
<div class="block">
|
||
<span>获取有效转换的错误事件处理程序。</span>
|
||
<span>实现必须提供一个默认错误侦听器。</span>
|
||
</div>
|
||
<dl>
|
||
<dt>
|
||
<span class="returnLabel">结果</span>
|
||
</dt>
|
||
<dd>
|
||
当前的错误处理程序，不应该为null。
|
||
</dd>
|
||
</dl> </li>
|
||
</ul> </li>
|
||
</ul> </li>
|
||
</ul>
|
||
</div>
|
||
</div> |