study/uTools-Manuals
1
0
Fork 0
mirror of https://github.com/fofolee/uTools-Manuals.git synced 2025-07-05 16:22:43 +08:00
Code Issues Packages Projects Releases Wiki Activity
uTools-Manuals/docs/java/javax/xml/transform/TransformerFactory.html

664 lines
40 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.transform
</div>
<h2 class="title" title="Class TransformerFactory">Class TransformerFactory</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.TransformerFactory</li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
已知直接子类：
</dt>
<dd>
<span><a href="../../../javax/xml/transform/sax/SAXTransformerFactory.html" title="javax.xml.transform.sax中的类">SAXTransformerFactory</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public abstract class <span class="typeNameLabel">TransformerFactory</span>
extends <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></pre>
<div class="block">
<p> <span>TransformerFactory实例可用于创建<a href="../../../javax/xml/transform/Transformer.html" title="javax.xml.transform中的类"><code>Transformer</code></a>和<a href="../../../javax/xml/transform/Templates.html" title="javax.xml.transform中的接口"><code>Templates</code></a>对象。</span> </p>
<p> <span>确定要创建哪个Factory实现的系统属性命名为<code>"javax.xml.transform.TransformerFactory"</code> 。</span> <span>该属性命名为<code>TransformerFactory</code>抽象类的具体子类。</span> <span>如果未定义属性，则使用平台默认值。</span> </p>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
1.5
</dd>
</dl> </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/TransformerFactory.html#TransformerFactory--">TransformerFactory</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="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>
</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/transform/Source.html" title="interface in javax.xml.transform">Source</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/transform/TransformerFactory.html#getAssociatedStylesheet-javax.xml.transform.Source-java.lang.String-java.lang.String-java.lang.String-">getAssociatedStylesheet</a></span>(<a href="../../../javax/xml/transform/Source.html" title="interface in javax.xml.transform">Source</a> source, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> media, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> title, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> charset)</code>
<div class="block">
通过符合给定条件的
<a href="http://www.w3.org/TR/xml-stylesheet/">xml-stylesheet processing instruction</a>获取与XML
<code>Source</code>文档关联的样式
<code>Source</code>规范。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<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/TransformerFactory.html#getAttribute-java.lang.String-">getAttribute</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="i2">
<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/TransformerFactory.html#getErrorListener--">getErrorListener</a></span>()</code>
<div class="block">
获取TransformerFactory的错误事件处理程序。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code>abstract boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/transform/TransformerFactory.html#getFeature-java.lang.String-">getFeature</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="../../../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/TransformerFactory.html#getURIResolver--">getURIResolver</a></span>()</code>
<div class="block">
获取在转换过程中默认使用的对象来解析在document（），xsl：import或xsl：include中使用的URI。
</div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code>static <a href="../../../javax/xml/transform/TransformerFactory.html" title="class in javax.xml.transform">TransformerFactory</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/transform/TransformerFactory.html#newInstance--">newInstance</a></span>()</code>
<div class="block">
获得一个新的
<code>TransformerFactory</code>实例。
</div> </td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code>static <a href="../../../javax/xml/transform/TransformerFactory.html" title="class in javax.xml.transform">TransformerFactory</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/transform/TransformerFactory.html#newInstance-java.lang.String-java.lang.ClassLoader-">newInstance</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> factoryClassName, <a href="../../../java/lang/ClassLoader.html" title="class in java.lang">ClassLoader</a> classLoader)</code>
<div class="block">
从工厂类名称获取一个新的实例
<code>TransformerFactory</code> 。
</div> </td>
</tr>
<tr class="rowColor" id="i7">
<td class="colFirst"><code>abstract <a href="../../../javax/xml/transform/Templates.html" title="interface in javax.xml.transform">Templates</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/transform/TransformerFactory.html#newTemplates-javax.xml.transform.Source-">newTemplates</a></span>(<a href="../../../javax/xml/transform/Source.html" title="interface in javax.xml.transform">Source</a> source)</code>
<div class="block">
将源处理为一个Templates对象，它是源的编译表示。
</div> </td>
</tr>
<tr class="altColor" id="i8">
<td class="colFirst"><code>abstract <a href="../../../javax/xml/transform/Transformer.html" title="class in javax.xml.transform">Transformer</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/transform/TransformerFactory.html#newTransformer--">newTransformer</a></span>()</code>
<div class="block">
创建一个新的
<code>Transformer</code> ，执行
<code>Source</code>到
<code>Result</code> 。
</div> </td>
</tr>
<tr class="rowColor" id="i9">
<td class="colFirst"><code>abstract <a href="../../../javax/xml/transform/Transformer.html" title="class in javax.xml.transform">Transformer</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/transform/TransformerFactory.html#newTransformer-javax.xml.transform.Source-">newTransformer</a></span>(<a href="../../../javax/xml/transform/Source.html" title="interface in javax.xml.transform">Source</a> source)</code>
<div class="block">
将
<code>Source</code>为
<code>Transformer</code>
<code>Object</code> 。
</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/TransformerFactory.html#setAttribute-java.lang.String-java.lang.Object-">setAttribute</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/TransformerFactory.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">
设置TransformerFactory的错误事件侦听器，它用于处理转换指令，而不是转换本身。
</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/TransformerFactory.html#setFeature-java.lang.String-boolean-">setFeature</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name, boolean value)</code>
<div class="block">
设置此工厂创建的
<code>TransformerFactory</code>和
<code>Transformer</code> s或
<code>Template</code>的功能。
</div> </td>
</tr>
<tr class="rowColor" id="i13">
<td class="colFirst"><code>abstract void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/xml/transform/TransformerFactory.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（），xsl：import或xsl：include中使用的URI。
</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="TransformerFactory--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>TransformerFactory</h4> <pre>protected TransformerFactory()</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="newInstance--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>newInstance</h4> <pre>public static <a href="../../../javax/xml/transform/TransformerFactory.html" title="class in javax.xml.transform">TransformerFactory</a> newInstance()
throws <a href="../../../javax/xml/transform/TransformerFactoryConfigurationError.html" title="class in javax.xml.transform">TransformerFactoryConfigurationError</a></pre>
<div class="block">
<p> <span>获得一个新的<code>TransformerFactory</code>实例。</span> <span>这个静态方法创建一个新的工厂实例。</span> </p>
<p> <span>此方法使用以下有序查找过程来确定要加载的<code>TransformerFactory</code>实现类：</span> </p>
<ul>
<li> <span>使用<code>javax.xml.transform.TransformerFactory</code>系统属性。</span> </li>
<li> <span>在JRE目录中使用属性文件“lib / jaxp.properties”。</span> <span>此配置文件采用标准<code>java.util.Properties</code>格式，包含实现类的完全限定名称，其中键为上面定义的系统属性。</span> <br/> <span>jaxp.properties文件由JAXP实现只读一次，然后将其缓存以备将来使用。</span> <span>如果文件第一次尝试读取文件不存在，则不再进一步检查其存在。</span> <span>在第一次读取jaxp.properties之后，无法更改任何属性的值。</span> </li>
<li> <span>使用由<a href="../../../java/util/ServiceLoader.html" title="java.util中的类"><code>ServiceLoader</code></a>类定义的服务提供商加载工具，使用<a href="../../../java/util/ServiceLoader.html" title="java.util中的类">default loading mechanism</a>尝试定位和加载服务的<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>
</ul>
<p> <span>一旦应用程序获得了对TransformerFactory的<code>TransformerFactory</code>就可以使用工厂来配置和获取变压器实例。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
新的TransformerFactory实例，从不为null。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<span><code><a href="../../../javax/xml/transform/TransformerFactoryConfigurationError.html" title="class in javax.xml.transform">TransformerFactoryConfigurationError</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/transform/TransformerFactory.html" title="class in javax.xml.transform">TransformerFactory</a> newInstance(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> factoryClassName,
<a href="../../../java/lang/ClassLoader.html" title="class in java.lang">ClassLoader</a> classLoader)
throws <a href="../../../javax/xml/transform/TransformerFactoryConfigurationError.html" title="class in javax.xml.transform">TransformerFactoryConfigurationError</a></pre>
<div class="block">
<p> <span>从工厂类名称获取一个新的实例<code>TransformerFactory</code> 。</span> <span>在类路径中有多个提供程序时，此功能很有用。</span> <span>它可以更好地控制应用程序，因为它可以指定应该加载哪个提供程序。</span> </p>
<p> <span>一旦应用程序获得了对TransformerFactory的<code>TransformerFactory</code>就可以使用工厂来配置和获取变压器实例。</span> </p>
<h2> <span>提示进行故障排除</span> </h2>
<p> <span>设置<code>jaxp.debug</code>系统属性将导致此方法打印大量调试消息到<code>System.err</code>有关它在做什么和它在哪里看。</span> </p>
<p> <span>如果您有问题，请尝试：</span> </p>
<pre> <span>java -Djaxp.debug=1 YourProgram ....</span> </pre>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>factoryClassName</code> -完全限定工厂类名称，提供实施
<code>javax.xml.transform.TransformerFactory</code> 。
</dd>
<dd>
<span><code>classLoader</code> - <code>ClassLoader</code>用于加载工厂类。</span>
<span>如果<code>null</code>当前的<code>Thread</code>的上下文classLoader用于加载工厂类。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
新的TransformerFactory实例，从不为null。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/xml/transform/TransformerFactoryConfigurationError.html" title="class in javax.xml.transform">TransformerFactoryConfigurationError</a></code> - 如果
<code>factoryClassName</code>是
<code>null</code> ，或工厂类无法加载，实例化。
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
1.6
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../javax/xml/transform/TransformerFactory.html#newInstance--"><code>newInstance()</code></a>
</dd>
</dl> </li>
</ul> <a name="newTransformer-javax.xml.transform.Source-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>newTransformer</h4> <pre>public abstract <a href="../../../javax/xml/transform/Transformer.html" title="class in javax.xml.transform">Transformer</a> newTransformer(<a href="../../../javax/xml/transform/Source.html" title="interface in javax.xml.transform">Source</a> source)
throws <a href="../../../javax/xml/transform/TransformerConfigurationException.html" title="class in javax.xml.transform">TransformerConfigurationException</a></pre>
<div class="block">
<p> <span>将<code>Source</code>成<code>Transformer</code> <code>Object</code> 。</span> <span><code>Source</code>是符合<a href="http://www.w3.org/TR/xslt">XSL Transformations (XSLT) Version 1.0</a>的XSLT文档。</span> <span>必须注意不要使用这种<code>Transformer</code>多个<code>Thread</code>小号同时运行。</span> <span>不同的<code>TransformerFactories</code>可以同时使用不同的<code>Thread</code> s。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>source</code> - <code>Source</code>的XSLT文档用于创建<code>Transformer</code> 。</span>
<span>XML的例子<code>Source</code>小号包括<a href="../../../javax/xml/transform/dom/DOMSource.html" title="javax.xml.transform.dom中的类"><code>DOMSource</code></a> ， <a href="../../../javax/xml/transform/sax/SAXSource.html" title="javax.xml.transform.sax中的类"><code>SAXSource</code></a>和<a href="../../../javax/xml/transform/stream/StreamSource.html" title="javax.xml.transform.stream中的类"><code>StreamSource</code></a> 。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>Transformer</code>对象，可用于在单个
<code>Thread</code>中执行
<code>Thread</code> ，从不
<code>null</code> 。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/xml/transform/TransformerConfigurationException.html" title="class in javax.xml.transform">TransformerConfigurationException</a></code> - 如果在解析
<code>Source</code>时出现错误或者无法创建
<code>Transformer</code>实例，则
<code>Transformer</code> 。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="http://www.w3.org/TR/xslt">XSL Transformations (XSLT) Version 1.0</a>
</dd>
</dl> </li>
</ul> <a name="newTransformer--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>newTransformer</h4> <pre>public abstract <a href="../../../javax/xml/transform/Transformer.html" title="class in javax.xml.transform">Transformer</a> newTransformer()
throws <a href="../../../javax/xml/transform/TransformerConfigurationException.html" title="class in javax.xml.transform">TransformerConfigurationException</a></pre>
<div class="block">
<p> <span>创建一个新的<code>Transformer</code> ，执行<code>Source</code>的<code>Result</code> 。</span> <span>即“ <em>身份转换</em> ”。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
可用于在单个线程中执行转换的Transformer对象，从不为null。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/xml/transform/TransformerConfigurationException.html" title="class in javax.xml.transform">TransformerConfigurationException</a></code> - 当无法创建
<code>Transformer</code>实例时。
</dd>
</dl> </li>
</ul> <a name="newTemplates-javax.xml.transform.Source-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>newTemplates</h4> <pre>public abstract <a href="../../../javax/xml/transform/Templates.html" title="interface in javax.xml.transform">Templates</a> newTemplates(<a href="../../../javax/xml/transform/Source.html" title="interface in javax.xml.transform">Source</a> source)
throws <a href="../../../javax/xml/transform/TransformerConfigurationException.html" title="class in javax.xml.transform">TransformerConfigurationException</a></pre>
<div class="block">
<span>将源处理为一个Templates对象，它是源的编译表示。</span>
<span>然后可以在多个线程上同时使用此Templates对象。</span>
<span>创建一个Templates对象允许TransformerFactory对变换指令进行详细的性能优化，而不会影响运行时转换。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>source</code> - 保存URL，输入流等的对象
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个能够用于转换目的的模板对象，从不
<code>null</code> 。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/xml/transform/TransformerConfigurationException.html" title="class in javax.xml.transform">TransformerConfigurationException</a></code> - 解析构造Templates对象失败。
</dd>
</dl> </li>
</ul> <a name="getAssociatedStylesheet-javax.xml.transform.Source-java.lang.String-java.lang.String-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAssociatedStylesheet</h4> <pre>public abstract <a href="../../../javax/xml/transform/Source.html" title="interface in javax.xml.transform">Source</a> getAssociatedStylesheet(<a href="../../../javax/xml/transform/Source.html" title="interface in javax.xml.transform">Source</a> source,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> media,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> title,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> charset)
throws <a href="../../../javax/xml/transform/TransformerConfigurationException.html" title="class in javax.xml.transform">TransformerConfigurationException</a></pre>
<div class="block">
<p> <span>通过符合给定条件的<a href="http://www.w3.org/TR/xml-stylesheet/">xml-stylesheet processing instruction</a>获取与XML <code>Source</code>文档相关联的样式<code>Source</code>规范。</span> <span>请注意，可以返回多个样式表，在这种情况下，它们应用为单个样式表中的导入或级联列表。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>source</code> - XML源文档。
</dd>
<dd>
<span><code>media</code> - 要匹配的媒体属性。</span>
<span>可能为null，在这种情况下，将使用优先模板（即alternate = no）。</span>
</dd>
<dd>
<span><code>title</code> - 要匹配的title属性的值。</span>
<span>可能为null。</span>
</dd>
<dd>
<span><code>charset</code> - 要匹配的字符集属性的值。</span>
<span>可能为null。</span>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
A
<code>Source</code>
<code>Object</code>适合传递给
<code>TransformerFactory</code> 。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/xml/transform/TransformerConfigurationException.html" title="class in javax.xml.transform">TransformerConfigurationException</a></code> -一个
<code>异常</code>是的分析过程中，如果出现错误occurings抛出
<code>source</code> 。
</dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="http://www.w3.org/TR/xml-stylesheet/">Associating Style Sheets with XML documents Version 1.0</a>
</dd>
</dl> </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">
设置在转换期间默认使用的对象，以解析document（），xsl：import或xsl：include中使用的URI。
</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（），xsl：import或xsl：include中使用的URI。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
使用setURIResolver设置的URIResolver。
</dd>
</dl> </li>
</ul> <a name="setFeature-java.lang.String-boolean-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setFeature</h4> <pre>public abstract void setFeature(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name,
boolean value)
throws <a href="../../../javax/xml/transform/TransformerConfigurationException.html" title="class in javax.xml.transform">TransformerConfigurationException</a></pre>
<div class="block">
<p> <span>为这个工厂创建的<code>TransformerFactory</code>和<code>Transformer</code> s或<code>Template</code>设置了一个功能。</span> </p>
<p> <span>功能名称完全符合<a href="../../../java/net/URI.html" title="java.net中的类"><code>URI</code></a> s。</span> <span>实现可以定义自己的特征。</span> <span>如果这个<code>TransformerFactory</code>或<code>TransformerFactory</code>或<code>Transformer</code>或它们创建的<code>Template</code>不能支持该功能，则会抛出一个<a href="../../../javax/xml/transform/TransformerConfigurationException.html" title="javax.xml.transform中的类"><code>TransformerConfigurationException</code></a> 。</span> <span><code>TransformerFactory</code>可以公开特征值，但无法更改其状态。</span> </p>
<p> <span>所有实现都需要支持<a href="../../../javax/xml/XMLConstants.html#FEATURE_SECURE_PROCESSING"><code>XMLConstants.FEATURE_SECURE_PROCESSING</code></a>功能。</span> <span>当功能是：</span> </p>
<ul>
<li> <span><code>true</code> ：实现将限制XML处理以符合实现限制，并以实现所定义的安全方式进行操作。</span> <span>示例包括解析用户定义的样式表和功能。</span> <span>如果XML处理由于安全原因而受到限制，则通过对已注册的<a href="../../../javax/xml/transform/ErrorListener.html#fatalError-javax.xml.transform.TransformerException-"><code>ErrorListener.fatalError(TransformerException exception)</code></a>的呼叫进行报告。</span> <span>见<a href="../../../javax/xml/transform/TransformerFactory.html#setErrorListener-javax.xml.transform.ErrorListener-"><code>setErrorListener(ErrorListener listener)</code></a> 。</span> </li>
<li> <span><code>false</code> ：实现将根据XML规范处理XML，而不考虑可能的实现限制。</span> </li>
</ul>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 功能名称。
</dd>
<dd>
<code>value</code> - 是功能状态
<code>true</code>或
<code>false</code> 。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/xml/transform/TransformerConfigurationException.html" title="class in javax.xml.transform">TransformerConfigurationException</a></code> - 如果这
<code>TransformerFactory</code>或
<code>Transformer</code> s或
<code>Template</code>它创建不能支持此功能。
</dd>
<dd>
<code><a href="../../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</a></code> - 如果
<code>name</code>参数为空。
</dd>
</dl> </li>
</ul> <a name="getFeature-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getFeature</h4> <pre>public abstract boolean getFeature(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)</pre>
<div class="block">
<span>查找功能的值。</span>
<p> <span>功能名称完全符合<a href="../../../java/net/URI.html" title="java.net中的类"><code>URI</code></a> s。</span> <span>实现可以定义自己的特征。</span> <span><code>false</code>返回如果这<code>TransformerFactory</code>或<code>Transformer</code> S或<code>Template</code>的IT创建不支持该功能。</span> <span><code>TransformerFactory</code>可以公开特征值，但无法更改其状态。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 功能名称。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
当前状态的功能，
<code>true</code>或
<code>false</code> 。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/lang/NullPointerException.html" title="class in java.lang">NullPointerException</a></code> - 如果
<code>name</code>参数为空。
</dd>
</dl> </li>
</ul> <a name="setAttribute-java.lang.String-java.lang.Object-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setAttribute</h4> <pre>public abstract void setAttribute(<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>
<span>此上下文中的属性被定义为实现提供的选项。</span>
<span>一个<code>IllegalArgumentException</code>如果底层实现不识别该属性，则抛出。</span>
<p> <span>实现JAXP 1.5或更高版本的所有实现都需要支持<a href="../../../javax/xml/XMLConstants.html#ACCESS_EXTERNAL_DTD"><code>XMLConstants.ACCESS_EXTERNAL_DTD</code></a>和<a href="../../../javax/xml/XMLConstants.html#ACCESS_EXTERNAL_STYLESHEET"><code>XMLConstants.ACCESS_EXTERNAL_STYLESHEET</code></a>属性。</span> </p>
<ul>
<li><p> <span>访问源文件中的外部DTD仅限于<a href="../../../javax/xml/XMLConstants.html#ACCESS_EXTERNAL_DTD"><code>XMLConstants.ACCESS_EXTERNAL_DTD</code></a>属性指定的<a href="../../../javax/xml/XMLConstants.html#ACCESS_EXTERNAL_DTD">协议</a> 。</span> <span>如果由于此属性的限制，在转换期间访问被拒绝， <a href="../../../javax/xml/transform/TransformerException.html" title="javax.xml.transform中的类"><code>TransformerException</code></a>将被抛出<a href="../../../javax/xml/transform/Transformer.html#transform-javax.xml.transform.Source-javax.xml.transform.Result-"><code>Transformer.transform(Source, Result)</code></a> 。</span> </p><p> <span>访问样式表中的外部DTD仅限于<a href="../../../javax/xml/XMLConstants.html#ACCESS_EXTERNAL_DTD"><code>XMLConstants.ACCESS_EXTERNAL_DTD</code></a>属性指定的<a href="../../../javax/xml/XMLConstants.html#ACCESS_EXTERNAL_DTD">协议</a> 。</span> <span>如果由于此属性的限制，在创建新变压器期间访问被拒绝， <a href="../../../javax/xml/transform/TransformerConfigurationException.html" title="javax.xml.transform中的类"><code>TransformerConfigurationException</code></a>将被抛出<a href="../../../javax/xml/transform/TransformerFactory.html#newTransformer-javax.xml.transform.Source-"><code>newTransformer(Source)</code></a>方法。</span> </p><p> <span>通过样式表处理指令访问外部引用集，导入和包含元素仅限于<a href="../../../javax/xml/XMLConstants.html#ACCESS_EXTERNAL_STYLESHEET"><code>XMLConstants.ACCESS_EXTERNAL_STYLESHEET</code></a>属性指定的<a href="../../../javax/xml/XMLConstants.html#ACCESS_EXTERNAL_STYLESHEET">协议</a> 。</span> <span>如果由于此属性的限制，在创建新变压器期间访问被拒绝， <a href="../../../javax/xml/transform/TransformerConfigurationException.html" title="javax.xml.transform中的类"><code>TransformerConfigurationException</code></a>将被<a href="../../../javax/xml/transform/TransformerFactory.html#newTransformer-javax.xml.transform.Source-"><code>newTransformer(Source)</code></a>方法抛出。</span> </p><p> <span>通过XSLT文档功能访问外部文档仅限于属性指定的协议。</span> <span>如果由于此属性的限制，在转换期间访问被拒绝， <a href="../../../javax/xml/transform/TransformerException.html" title="javax.xml.transform中的类"><code>TransformerException</code></a>将被抛出<a href="../../../javax/xml/transform/Transformer.html#transform-javax.xml.transform.Source-javax.xml.transform.Result-"><code>Transformer.transform(Source, Result)</code></a>方法。</span> </p></li>
</ul>
</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="getAttribute-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getAttribute</h4> <pre>public abstract <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> getAttribute(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> name)</pre>
<div class="block">
<span>允许用户检索底层实现的特定属性。</span>
<span>一个<code>IllegalArgumentException</code>如果底层实现不识别该属性，则抛出。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>name</code> - 属性的名称。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
value属性的值。
</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="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)</pre>
<div class="block">
<span>设置TransformerFactory的错误事件侦听器，它用于处理转换指令，而不是转换本身。</span>
<span>一个<code>IllegalArgumentException</code>如果抛出<code>ErrorListener</code>监听器是<code>null</code> 。</span>
</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> -
<code>listener</code>为
<code>null</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">
获取TransformerFactory的错误事件处理程序。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
当前的错误处理程序，不应该为null。
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>
Reference in New Issue View Git Blame Copy Permalink