uTools-Manuals/docs/java/javax/imageio/spi/IIOServiceProvider.html

395 lines
19 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">
javax.imageio.spi
</div>
<h2 class="title" title="Class IIOServiceProvider">Class IIOServiceProvider</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.imageio.spi.IIOServiceProvider</li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
All Implemented Interfaces:
</dt>
<dd>
<span><a href="../../../javax/imageio/spi/RegisterableService.html" title="javax.imageio.spi中的接口">RegisterableService</a></span>
</dd>
</dl>
<dl>
<dt>
已知直接子类:
</dt>
<dd>
<span><a href="../../../javax/imageio/spi/ImageInputStreamSpi.html" title="javax.imageio.spi中的类">ImageInputStreamSpi</a> <a href="../../../javax/imageio/spi/ImageOutputStreamSpi.html" title="javax.imageio.spi中的类">ImageOutputStreamSpi</a> <a href="../../../javax/imageio/spi/ImageReaderWriterSpi.html" title="javax.imageio.spi中的类">ImageReaderWriterSpi</a> <a href="../../../javax/imageio/spi/ImageTranscoderSpi.html" title="javax.imageio.spi中的类">ImageTranscoderSpi</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public abstract class <span class="typeNameLabel">IIOServiceProvider</span>
extends <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a>
implements <a href="../../../javax/imageio/spi/RegisterableService.html" title="interface in javax.imageio.spi">RegisterableService</a></pre>
<div class="block">
<span>所有Image I / O服务提供商接口SPI通用功能的超级界面。</span>
<span>有关服务提供程序类的更多信息,请参阅<code>IIORegistry</code>类的类注释。</span>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<span><a href="../../../javax/imageio/spi/IIORegistry.html" title="javax.imageio.spi中的类"><code>IIORegistry</code></a> <a href="../../../javax/imageio/spi/ImageReaderSpi.html" title="javax.imageio.spi中的类"><code>ImageReaderSpi</code></a> <a href="../../../javax/imageio/spi/ImageWriterSpi.html" title="javax.imageio.spi中的类"><code>ImageWriterSpi</code></a> <a href="../../../javax/imageio/spi/ImageTranscoderSpi.html" title="javax.imageio.spi中的类"><code>ImageTranscoderSpi</code></a> <a href="../../../javax/imageio/spi/ImageInputStreamSpi.html" title="javax.imageio.spi中的类"><code>ImageInputStreamSpi</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>protected <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/imageio/spi/IIOServiceProvider.html#vendorName">vendorName</a></span></code>
<div class="block">
A
<code>String</code>将从
<code>getVendorName</code>返回,最初为
<code>null</code>
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>protected <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/imageio/spi/IIOServiceProvider.html#version">version</a></span></code>
<div class="block">
A
<code>String</code>
<code>getVersion</code>返回最初为null。
</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="colOne" scope="col">Constructor and Description</th>
</tr>
<tr class="altColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../javax/imageio/spi/IIOServiceProvider.html#IIOServiceProvider--">IIOServiceProvider</a></span>()</code>
<div class="block">
构造一个空白
<code>IIOServiceProvider</code>
</div> </td>
</tr>
<tr class="rowColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../javax/imageio/spi/IIOServiceProvider.html#IIOServiceProvider-java.lang.String-java.lang.String-">IIOServiceProvider</a></span>(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> vendorName, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> version)</code>
<div class="block">
构造一个
<code>IIOServiceProvider</code>具有给定供应商名称和版本标识符。
</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 <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/imageio/spi/IIOServiceProvider.html#getDescription-java.util.Locale-">getDescription</a></span>(<a href="../../../java/util/Locale.html" title="class in java.util">Locale</a> locale)</code>
<div class="block">
返回此服务提供商及其相关实现的简短可读的描述。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code><a href="../../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/imageio/spi/IIOServiceProvider.html#getVendorName--">getVendorName</a></span>()</code>
<div class="block">
返回负责创建此服务提供商及其关联实施的供应商的名称。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code><a href="../../../java/lang/String.html" title="class in java.lang">String</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/imageio/spi/IIOServiceProvider.html#getVersion--">getVersion</a></span>()</code>
<div class="block">
返回描述此服务提供商及其关联实现的版本号的字符串。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/imageio/spi/IIOServiceProvider.html#onDeregistration-javax.imageio.spi.ServiceRegistry-java.lang.Class-">onDeregistration</a></span>(<a href="../../../javax/imageio/spi/ServiceRegistry.html" title="class in javax.imageio.spi">ServiceRegistry</a> registry, <a href="../../../java/lang/Class.html" title="class in java.lang"></a>&lt;?&gt; category)</code>
<div class="block">
每当Spi课程从
<code>ServiceRegistry</code>时,这个回调将是。
</div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/imageio/spi/IIOServiceProvider.html#onRegistration-javax.imageio.spi.ServiceRegistry-java.lang.Class-">onRegistration</a></span>(<a href="../../../javax/imageio/spi/ServiceRegistry.html" title="class in javax.imageio.spi">ServiceRegistry</a> registry, <a href="../../../java/lang/Class.html" title="class in java.lang"></a>&lt;?&gt; category)</code>
<div class="block">
一个回调在Spi类被实例化并在ServiceRegistry中
<code>ServiceRegistry</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">
<!-- ============ FIELD DETAIL =========== -->
<ul class="blockList">
<li class="blockList"><a name="field.detail">
<!-- --> </a> <h3>字段详细信息</h3> <a name="vendorName">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>vendorName</h4> <pre>protected <a href="../../../java/lang/String.html" title="class in java.lang">String</a> vendorName</pre>
<div class="block">
<span>A <code>String</code>将从<code>getVendorName</code>返回,最初为<code>null</code></span>
<span>构造函数应将其设置为非<code>null</code>值。</span>
</div> </li>
</ul> <a name="version">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>version</h4> <pre>protected <a href="../../../java/lang/String.html" title="class in java.lang">String</a> version</pre>
<div class="block">
<span>A <code>String</code><code>getVersion</code>返回最初为null。</span>
<span>构造函数应将其设置为非<code>null</code>值。</span>
</div> </li>
</ul> </li>
</ul>
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="IIOServiceProvider-java.lang.String-java.lang.String-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>IIOServiceProvider</h4> <pre>public IIOServiceProvider(<a href="../../../java/lang/String.html" title="class in java.lang">String</a> vendorName,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> version)</pre>
<div class="block">
构造一个
<code>IIOServiceProvider</code>具有给定供应商名称和版本标识符。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>vendorName</code> - 供应商名称。
</dd>
<dd>
<code>version</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>vendorName</code>
<code>null</code>
</dd>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果
<code>version</code>
<code>null</code>
</dd>
</dl> </li>
</ul> <a name="IIOServiceProvider--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>IIOServiceProvider</h4> <pre>public IIOServiceProvider()</pre>
<div class="block">
<span>构造一个空白<code>IIOServiceProvider</code></span>
<span>为了确保<code>getVendorName</code><code>getVersion</code>方法将返回非<code>null</code>值,由子类初始化实例变量和/或覆盖方法实现。</span>
</div> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="onRegistration-javax.imageio.spi.ServiceRegistry-java.lang.Class-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>onRegistration</h4> <pre>public void onRegistration(<a href="../../../javax/imageio/spi/ServiceRegistry.html" title="class in javax.imageio.spi">ServiceRegistry</a> registry,
<a href="../../../java/lang/Class.html" title="class in java.lang"></a>&lt;?&gt; category)</pre>
<div class="block">
<span>一个回调在Spi类已经被实例化并注册到<code>ServiceRegistry</code>之后将被调用一次。</span>
<span>这可以用于验证环境是否适合此服务,例如可以加载本机库。</span>
<span>如果服务在找到自己的环境中无法运行,则应该从注册表中注销自身。</span>
<p> <span>只有注册表应该调用这个方法。</span> </p>
<p> <span>默认实现什么都不做。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/imageio/spi/RegisterableService.html#onRegistration-javax.imageio.spi.ServiceRegistry-java.lang.Class-">onRegistration</a></code>中的
<code><a href="../../../javax/imageio/spi/RegisterableService.html" title="interface in javax.imageio.spi">RegisterableService</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>registry</code> - 一个
<code>ServiceRegistry</code>其中该对象已被注册。
</dd>
<dd>
<code>category</code> - 一个
<code></code>此对象已注册的注册表类别的
<code></code>对象。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/imageio/spi/ServiceRegistry.html#registerServiceProvider-java.lang.Object-"><code>ServiceRegistry.registerServiceProvider(Object provider)</code></a>
</dd>
</dl> </li>
</ul> <a name="onDeregistration-javax.imageio.spi.ServiceRegistry-java.lang.Class-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>onDeregistration</h4> <pre>public void onDeregistration(<a href="../../../javax/imageio/spi/ServiceRegistry.html" title="class in javax.imageio.spi">ServiceRegistry</a> registry,
<a href="../../../java/lang/Class.html" title="class in java.lang"></a>&lt;?&gt; category)</pre>
<div class="block">
<span>每当Spi课程从<code>ServiceRegistry</code>时,将会回调。</span>
<p> <span>只有注册表应该调用这个方法。</span> </p>
<p> <span>默认实现什么都不做。</span> </p>
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/imageio/spi/RegisterableService.html#onDeregistration-javax.imageio.spi.ServiceRegistry-java.lang.Class-">onDeregistration</a></code>在接口
<code><a href="../../../javax/imageio/spi/RegisterableService.html" title="interface in javax.imageio.spi">RegisterableService</a></code>
</dd>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>registry</code> -
<code>ServiceRegistry</code>从该对象(全部或部分)注销。
</dd>
<dd>
<code>category</code> - 一个
<code></code>对象,指示该对象正在注销的注册表类别。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/imageio/spi/ServiceRegistry.html#deregisterServiceProvider-java.lang.Object-"><code>ServiceRegistry.deregisterServiceProvider(Object provider)</code></a>
</dd>
</dl> </li>
</ul> <a name="getVendorName--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getVendorName</h4> <pre>public <a href="../../../java/lang/String.html" title="class in java.lang">String</a> getVendorName()</pre>
<div class="block">
<span>返回负责创建此服务提供商及其关联实施的供应商的名称。</span>
<span>由于供应商名称可能用于选择服务提供商,因此它不会本地化。</span>
<p> <span>默认实现返回<code>vendorName</code>实例变量的值。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个非
<code>null</code>
<code>String</code>包含供应商的名称。
</dd>
</dl> </li>
</ul> <a name="getVersion--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getVersion</h4> <pre>public <a href="../../../java/lang/String.html" title="class in java.lang">String</a> getVersion()</pre>
<div class="block">
<span>返回描述此服务提供商及其关联实现的版本号的字符串。</span>
<span>由于代码转换器可能会使用该版本来识别他们所理解的服务提供商,因此此方法不进行本地化。</span>
<p> <span>默认实现返回值为<code>version</code>实例变量。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个非
<code>null</code>
<code>String</code>包含该服务提供商的版本。
</dd>
</dl> </li>
</ul> <a name="getDescription-java.util.Locale-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>getDescription</h4> <pre>public abstract <a href="../../../java/lang/String.html" title="class in java.lang">String</a> getDescription(<a href="../../../java/util/Locale.html" title="class in java.util">Locale</a> locale)</pre>
<div class="block">
<span>返回此服务提供商及其相关实现的简短可读的描述。</span>
<span>如果可能的话,最终的字符串应该被本地化为所提供的<code>Locale</code></span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>locale</code> - 一个
<code>Locale</code> ,返回值应该对其进行本地化。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>String</code>包含该服务提供商的描述。
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>