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

619 lines
39 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 ImageReaderSpi">Class ImageReaderSpi</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><a href="../../../javax/imageio/spi/IIOServiceProvider.html" title="class in javax.imageio.spi">javax.imageio.spi.IIOServiceProvider</a></li>
<li>
<ul class="inheritance">
<li><a href="../../../javax/imageio/spi/ImageReaderWriterSpi.html" title="class in javax.imageio.spi">javax.imageio.spi.ImageReaderWriterSpi</a></li>
<li>
<ul class="inheritance">
<li>javax.imageio.spi.ImageReaderSpi</li>
</ul> </li>
</ul> </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>
<hr/> <br/> <pre>public abstract class <span class="typeNameLabel">ImageReaderSpi</span>
extends <a href="../../../javax/imageio/spi/ImageReaderWriterSpi.html" title="class in javax.imageio.spi">ImageReaderWriterSpi</a></pre>
<div class="block">
<span>服务提供者接口SPI<code>ImageReader</code>秒。</span>
<span>有关服务提供程序类的更多信息,请参阅<code>IIORegistry</code>类的类注释。</span>
<p> <span>每个<code>ImageReaderSpi</code>提供了与它相关联的<code>ImageReader</code>类的几种类型的信息。</span> </p>
<p> <span>谁定义的SPI类和类的简要说明供应商的名称通过可<code>getVendorName</code> <code>getDescription</code><code>getVersion</code>方法。</span> <span>这些方法可以被国际化以提供特定于区域的输出。</span> <span>这些方法主要用于提供可用于组织弹出菜单或其他列表的简短的,可读的信息。</span> </p>
<p> <span>格式名称文件后缀以及与该服务相关联MIME类型的列表可通过的方式获得<code>getFormatNames</code> <code>getFileSuffixes</code><code>getMIMETypes</code>方法。</span> <span>这些方法可以被用于识别候选<code>ImageReader</code> S表示基于手动格式选择文件命名或MIME关联例如通过HTTP访问或作为电子邮件附件的文件时进行解码的特定文件或流。</span> </p>
<p> <span>通过<code>canDecodeInput</code>方法提供了一种更可靠的方法来确定哪些<code>ImageReader</code>可能能够解析特定的数据流。</span> <span>此方法允许服务提供商检查实际的流内容。</span> </p>
<p> <span>最后,可以通过调用<code>createReaderInstance</code>方法获得与该服务提供商相关<code>ImageReader</code>类的实例。</span> <span>任何重量级的初始化(如加载本机库或创建大型表)至少应该延迟至首次调用此方法为止。</span> </p>
</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/ImageReader.html" title="javax.imageio中的类"><code>ImageReader</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/Class.html" title="class in java.lang"></a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/imageio/spi/ImageReaderSpi.html#inputTypes">inputTypes</a></span></code>
<div class="block">
<code>getInputTypes</code>返回的一组
<code></code>对象,最初是
<code>null</code>
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static <a href="../../../java/lang/Class.html" title="class in java.lang"></a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/imageio/spi/ImageReaderSpi.html#STANDARD_INPUT_TYPE">STANDARD_INPUT_TYPE</a></span></code>
<div class="block">
<span><span class="deprecatedLabel">已弃用</span></span>
<div class="block">
<span><span class="deprecationComment">而不是使用这个字段,直接创建等效的数组<code>{ ImageInputStream.class }</code></span></span>
</div>
</div> </td>
</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/ImageReaderSpi.html#writerSpiNames">writerSpiNames</a></span></code>
<div class="block">
<code>getImageWriterSpiNames</code>返回的字符串数组,最初为
<code>null</code>
</div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="fields.inherited.from.class.javax.imageio.spi.ImageReaderWriterSpi">
<!-- --> </a> <h3>Fields inherited from class javax.imageio.spi.<a href="../../../javax/imageio/spi/ImageReaderWriterSpi.html" title="class in javax.imageio.spi">ImageReaderWriterSpi</a></h3> <code><a href="../../../javax/imageio/spi/ImageReaderWriterSpi.html#extraImageMetadataFormatClassNames">extraImageMetadataFormatClassNames</a>, <a href="../../../javax/imageio/spi/ImageReaderWriterSpi.html#extraImageMetadataFormatNames">extraImageMetadataFormatNames</a>, <a href="../../../javax/imageio/spi/ImageReaderWriterSpi.html#extraStreamMetadataFormatClassNames">extraStreamMetadataFormatClassNames</a>, <a href="../../../javax/imageio/spi/ImageReaderWriterSpi.html#extraStreamMetadataFormatNames">extraStreamMetadataFormatNames</a>, <a href="../../../javax/imageio/spi/ImageReaderWriterSpi.html#MIMETypes">MIMETypes</a>, <a href="../../../javax/imageio/spi/ImageReaderWriterSpi.html#names">names</a>, <a href="../../../javax/imageio/spi/ImageReaderWriterSpi.html#nativeImageMetadataFormatClassName">nativeImageMetadataFormatClassName</a>, <a href="../../../javax/imageio/spi/ImageReaderWriterSpi.html#nativeImageMetadataFormatName">nativeImageMetadataFormatName</a>, <a href="../../../javax/imageio/spi/ImageReaderWriterSpi.html#nativeStreamMetadataFormatClassName">nativeStreamMetadataFormatClassName</a>, <a href="../../../javax/imageio/spi/ImageReaderWriterSpi.html#nativeStreamMetadataFormatName">nativeStreamMetadataFormatName</a>, <a href="../../../javax/imageio/spi/ImageReaderWriterSpi.html#pluginClassName">pluginClassName</a>, <a href="../../../javax/imageio/spi/ImageReaderWriterSpi.html#suffixes">suffixes</a>, <a href="../../../javax/imageio/spi/ImageReaderWriterSpi.html#supportsStandardImageMetadataFormat">supportsStandardImageMetadataFormat</a>, <a href="../../../javax/imageio/spi/ImageReaderWriterSpi.html#supportsStandardStreamMetadataFormat">supportsStandardStreamMetadataFormat</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="fields.inherited.from.class.javax.imageio.spi.IIOServiceProvider">
<!-- --> </a> <h3>Fields inherited from class javax.imageio.spi.<a href="../../../javax/imageio/spi/IIOServiceProvider.html" title="class in javax.imageio.spi">IIOServiceProvider</a></h3> <code><a href="../../../javax/imageio/spi/IIOServiceProvider.html#vendorName">vendorName</a>, <a href="../../../javax/imageio/spi/IIOServiceProvider.html#version">version</a></code></li>
</ul> </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/imageio/spi/ImageReaderSpi.html#ImageReaderSpi--">ImageReaderSpi</a></span>()</code>
<div class="block">
构造一个空白
<code>ImageReaderSpi</code>
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code> </code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/imageio/spi/ImageReaderSpi.html#ImageReaderSpi-java.lang.String-java.lang.String-java.lang.String:A-java.lang.String:A-java.lang.String:A-java.lang.String-java.lang.Class:A-java.lang.String:A-boolean-java.lang.String-java.lang.String-java.lang.String:A-java.lang.String:A-boolean-java.lang.String-java.lang.String-java.lang.String:A-java.lang.String:A-">ImageReaderSpi</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, <a href="../../../java/lang/String.html" title="class in java.lang">String</a>[] names, <a href="../../../java/lang/String.html" title="class in java.lang">String</a>[] suffixes, <a href="../../../java/lang/String.html" title="class in java.lang">String</a>[] MIMETypes, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> readerClassName, <a href="../../../java/lang/Class.html" title="class in java.lang"></a>[] inputTypes, <a href="../../../java/lang/String.html" title="class in java.lang">String</a>[] writerSpiNames, boolean supportsStandardStreamMetadataFormat, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> nativeStreamMetadataFormatName, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> nativeStreamMetadataFormatClassName, <a href="../../../java/lang/String.html" title="class in java.lang">String</a>[] extraStreamMetadataFormatNames, <a href="../../../java/lang/String.html" title="class in java.lang">String</a>[] extraStreamMetadataFormatClassNames, boolean supportsStandardImageMetadataFormat, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> nativeImageMetadataFormatName, <a href="../../../java/lang/String.html" title="class in java.lang">String</a> nativeImageMetadataFormatClassName, <a href="../../../java/lang/String.html" title="class in java.lang">String</a>[] extraImageMetadataFormatNames, <a href="../../../java/lang/String.html" title="class in java.lang">String</a>[] extraImageMetadataFormatClassNames)</code>
<div class="block">
构造具有给定值的
<code>ImageReaderSpi</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 boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/imageio/spi/ImageReaderSpi.html#canDecodeInput-java.lang.Object-">canDecodeInput</a></span>(<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> source)</code>
<div class="block">
返回
<code>true</code>如果提供的源对象看起来是读者支持的格式。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code><a href="../../../javax/imageio/ImageReader.html" title="class in javax.imageio">ImageReader</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/imageio/spi/ImageReaderSpi.html#createReaderInstance--">createReaderInstance</a></span>()</code>
<div class="block">
返回与此服务提供商
<code>ImageReader</code> ImageReader实现的实例。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code>abstract <a href="../../../javax/imageio/ImageReader.html" title="class in javax.imageio">ImageReader</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/imageio/spi/ImageReaderSpi.html#createReaderInstance-java.lang.Object-">createReaderInstance</a></span>(<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> extension)</code>
<div class="block">
返回与该服务提供商相关
<code>ImageReader</code> ImageReader实现的实例。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<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/ImageReaderSpi.html#getImageWriterSpiNames--">getImageWriterSpiNames</a></span>()</code>
<div class="block">
返回的数组
<code>String</code>包含所有的完全合格的名称小号
<code>ImageWriterSpi</code>类,可以理解由所使用的内部元数据表示
<code>ImageReader</code>与此服务提供商相关联,或
<code>null</code>如果没有这样
<code>ImageWriter</code>指定秒。
</div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code><a href="../../../java/lang/Class.html" title="class in java.lang"></a>[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/imageio/spi/ImageReaderSpi.html#getInputTypes--">getInputTypes</a></span>()</code>
<div class="block">
返回一个
<code></code>对象的数组,
<code></code>可以将什么类型的对象用作读者的
<code>setInput</code>方法的参数。
</div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/imageio/spi/ImageReaderSpi.html#isOwnReader-javax.imageio.ImageReader-">isOwnReader</a></span>(<a href="../../../javax/imageio/ImageReader.html" title="class in javax.imageio">ImageReader</a> reader)</code>
<div class="block">
如果
<code>true</code>
<code>ImageReader</code>对象是与此服务提供商
<code>ImageReader</code> ImageReader的一个实例
<code>ImageReader</code> true。
</div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.javax.imageio.spi.ImageReaderWriterSpi">
<!-- --> </a> <h3>Methods inherited from class javax.imageio.spi.<a href="../../../javax/imageio/spi/ImageReaderWriterSpi.html" title="class in javax.imageio.spi">ImageReaderWriterSpi</a></h3> <code><a href="../../../javax/imageio/spi/ImageReaderWriterSpi.html#getExtraImageMetadataFormatNames--">getExtraImageMetadataFormatNames</a>, <a href="../../../javax/imageio/spi/ImageReaderWriterSpi.html#getExtraStreamMetadataFormatNames--">getExtraStreamMetadataFormatNames</a>, <a href="../../../javax/imageio/spi/ImageReaderWriterSpi.html#getFileSuffixes--">getFileSuffixes</a>, <a href="../../../javax/imageio/spi/ImageReaderWriterSpi.html#getFormatNames--">getFormatNames</a>, <a href="../../../javax/imageio/spi/ImageReaderWriterSpi.html#getImageMetadataFormat-java.lang.String-">getImageMetadataFormat</a>, <a href="../../../javax/imageio/spi/ImageReaderWriterSpi.html#getMIMETypes--">getMIMETypes</a>, <a href="../../../javax/imageio/spi/ImageReaderWriterSpi.html#getNativeImageMetadataFormatName--">getNativeImageMetadataFormatName</a>, <a href="../../../javax/imageio/spi/ImageReaderWriterSpi.html#getNativeStreamMetadataFormatName--">getNativeStreamMetadataFormatName</a>, <a href="../../../javax/imageio/spi/ImageReaderWriterSpi.html#getPluginClassName--">getPluginClassName</a>, <a href="../../../javax/imageio/spi/ImageReaderWriterSpi.html#getStreamMetadataFormat-java.lang.String-">getStreamMetadataFormat</a>, <a href="../../../javax/imageio/spi/ImageReaderWriterSpi.html#isStandardImageMetadataFormatSupported--">isStandardImageMetadataFormatSupported</a>, <a href="../../../javax/imageio/spi/ImageReaderWriterSpi.html#isStandardStreamMetadataFormatSupported--">isStandardStreamMetadataFormatSupported</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.javax.imageio.spi.IIOServiceProvider">
<!-- --> </a> <h3>Methods inherited from class javax.imageio.spi.<a href="../../../javax/imageio/spi/IIOServiceProvider.html" title="class in javax.imageio.spi">IIOServiceProvider</a></h3> <code><a href="../../../javax/imageio/spi/IIOServiceProvider.html#getDescription-java.util.Locale-">getDescription</a>, <a href="../../../javax/imageio/spi/IIOServiceProvider.html#getVendorName--">getVendorName</a>, <a href="../../../javax/imageio/spi/IIOServiceProvider.html#getVersion--">getVersion</a>, <a href="../../../javax/imageio/spi/IIOServiceProvider.html#onDeregistration-javax.imageio.spi.ServiceRegistry-java.lang.Class-">onDeregistration</a>, <a href="../../../javax/imageio/spi/IIOServiceProvider.html#onRegistration-javax.imageio.spi.ServiceRegistry-java.lang.Class-">onRegistration</a></code></li>
</ul>
<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="STANDARD_INPUT_TYPE">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>STANDARD_INPUT_TYPE</h4> <pre><a href="../../../java/lang/Deprecated.html" title="annotation in java.lang">@Deprecated</a>
public static final <a href="../../../java/lang/Class.html" title="class in java.lang"></a>[] STANDARD_INPUT_TYPE</pre>
<div class="block">
<span><span class="deprecatedLabel">已弃用</span></span>
<span><span class="deprecationComment">而不是使用这个字段,直接创建等效的数组<code>{ ImageInputStream.class }</code></span></span>
</div>
<div class="block">
的单元素阵列,最初包含
<code>ImageInputStream.class</code> ,从返回
<code>getInputTypes</code>
</div> </li>
</ul> <a name="inputTypes">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>inputTypes</h4> <pre>protected <a href="../../../java/lang/Class.html" title="class in java.lang"></a>[] inputTypes</pre>
<div class="block">
<code></code>对象的数组将从
<code>getInputTypes</code>返回,最初为
<code>null</code>
</div> </li>
</ul> <a name="writerSpiNames">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>writerSpiNames</h4> <pre>protected <a href="../../../java/lang/String.html" title="class in java.lang">String</a>[] writerSpiNames</pre>
<div class="block">
要从
<code>getImageWriterSpiNames</code>返回的字符串数组,最初为
<code>null</code>
</div> </li>
</ul> </li>
</ul>
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="ImageReaderSpi--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>ImageReaderSpi</h4> <pre>protected ImageReaderSpi()</pre>
<div class="block">
<span>构造空白<code>ImageReaderSpi</code></span>
<span>初始化实例变量和/或覆盖方法实现的子类是为了提供所有方法的工作版本。</span>
</div> </li>
</ul> <a name="ImageReaderSpi-java.lang.String-java.lang.String-java.lang.String:A-java.lang.String:A-java.lang.String:A-java.lang.String-java.lang.Class:A-java.lang.String:A-boolean-java.lang.String-java.lang.String-java.lang.String:A-java.lang.String:A-boolean-java.lang.String-java.lang.String-java.lang.String:A-java.lang.String:A-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>ImageReaderSpi</h4> <pre>public ImageReaderSpi(<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,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a>[] names,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a>[] suffixes,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a>[] MIMETypes,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> readerClassName,
<a href="../../../java/lang/Class.html" title="class in java.lang"></a>[] inputTypes,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a>[] writerSpiNames,
boolean supportsStandardStreamMetadataFormat,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> nativeStreamMetadataFormatName,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> nativeStreamMetadataFormatClassName,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a>[] extraStreamMetadataFormatNames,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a>[] extraStreamMetadataFormatClassNames,
boolean supportsStandardImageMetadataFormat,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> nativeImageMetadataFormatName,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a> nativeImageMetadataFormatClassName,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a>[] extraImageMetadataFormatNames,
<a href="../../../java/lang/String.html" title="class in java.lang">String</a>[] extraImageMetadataFormatClassNames)</pre>
<div class="block">
构造具有给定值的
<code>ImageReaderSpi</code>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>vendorName</code> - 供应商名称,非
<code>null</code>
<code>String</code>
</dd>
<dd>
<code>version</code> - 版本标识符,作为非
<code>null</code>
<code>String</code>
</dd>
<dd>
<span><code>names</code> - 表示格式名称的非<code>null</code>数组<code>String</code> s。</span>
<span>必须至少有一个条目。</span>
</dd>
<dd>
<span><code>suffixes</code> - 表示公共文件后缀的<code>String</code> s的数组。</span>
<span>如果未定义后缀,则应提供<code>null</code></span>
<span>长度为0的数组将被归一<code>null</code></span>
</dd>
<dd>
<span><code>MIMETypes</code> -的阵列<code>String</code>指示格式的MIME类型。</span>
<span>如果未定义MIME类型则应提供<code>null</code></span>
<span>长度为0的数组将被归一<code>null</code></span>
</dd>
<dd>
<code>readerClassName</code> - 相关联的
<code>ImageReader</code>类的完全限定名称,作为非
<code>null</code>
<code>String</code>
</dd>
<dd>
<code>inputTypes</code> - 长度为至少为1的
<code></code>对象的非
<code>null</code>数组,
<code></code>合法输入类型。
</dd>
<dd>
<span><code>writerSpiNames</code> - 数组<code>String</code>命名所有关联的<code>ImageWriter</code> s或<code>null</code></span>
<span>长度为0的数组被归一<code>null</code></span>
</dd>
<dd>
<code>supportsStandardStreamMetadataFormat</code> - 一个
<code>boolean</code>流元数据对象是否可以使用由标准元数据格式描述的树的boolean。
</dd>
<dd>
<code>nativeStreamMetadataFormatName</code> - a
<code>String</code>
<code>null</code> ,将从
<code>getNativeStreamMetadataFormatName</code>返回。
</dd>
<dd>
<code>nativeStreamMetadataFormatClassName</code> - a
<code>String</code>
<code>null</code> ,用于实例化要从
<code>getNativeStreamMetadataFormat</code>返回的元数据格式对象。
</dd>
<dd>
<span><code>extraStreamMetadataFormatNames</code> - 要从<code>getExtraStreamMetadataFormatNames</code>返回的<code>String</code> s或<code>null</code>的数组。</span>
<span>长度为0的数组被归一<code>null</code></span>
</dd>
<dd>
<span><code>extraStreamMetadataFormatClassNames</code> - 用于实例化要从<code>getStreamMetadataFormat</code>返回的元数据格式对象的<code>String</code> s或<code>null</code>的数组。</span>
<span>长度为0的数组被归一<code>null</code></span>
</dd>
<dd>
<code>supportsStandardImageMetadataFormat</code> -
<code>boolean</code>图像元数据对象是否可以使用由标准元数据格式描述的树的boolean。
</dd>
<dd>
<code>nativeImageMetadataFormatName</code> - a
<code>String</code>
<code>null</code> ,将从
<code>getNativeImageMetadataFormatName</code>返回。
</dd>
<dd>
<code>nativeImageMetadataFormatClassName</code> - a
<code>String</code>
<code>null</code> ,用于实例化要从
<code>getNativeImageMetadataFormat</code>返回的元数据格式对象。
</dd>
<dd>
<span><code>extraImageMetadataFormatNames</code> -的阵列<code>String</code>从返回小号<code>getExtraImageMetadataFormatNames</code></span>
<span>长度为0的数组被归一<code>null</code></span>
</dd>
<dd>
<span><code>extraImageMetadataFormatClassNames</code> - 用于实例化要从<code>getImageMetadataFormat</code>返回的元数据格式对象的<code>String</code> s或<code>null</code>的数组。</span>
<span>长度为0的数组被归一<code>null</code></span>
</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>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果
<code>names</code>
<code>null</code>或长度为0。
</dd>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果
<code>readerClassName</code>
<code>null</code>
</dd>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果
<code>inputTypes</code>
<code>null</code>或长度为0。
</dd>
</dl> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="getInputTypes--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getInputTypes</h4> <pre>public <a href="../../../java/lang/Class.html" title="class in java.lang"></a>[] getInputTypes()</pre>
<div class="block">
<span>返回一个<code></code>对象的数组, <code></code>可以将什么类型的对象用作读者的<code>setInput</code>方法的参数。</span>
<p> <span>对于大多数阅读器,它只能从接受输入<code>ImageInputStream</code> ,含有单元素数组<code>ImageInputStream.class</code>应返回。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>null</code>数组的长度至少为1的
<code></code>对象。
</dd>
</dl> </li>
</ul> <a name="canDecodeInput-java.lang.Object-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>canDecodeInput</h4> <pre>public abstract boolean canDecodeInput(<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> source)
throws <a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>返回<code>true</code>如果提供的源对象看起来是这个读者支持的格式。</span>
<span>从这种方法返回<code>true</code>并不能保证阅读将成功,只是基于对流内容的简要检查,似乎有合理的成功机会。</span>
<span>如果源是<code>ImageInputStream</code> ,则实现将通常检查流的前几个字节与格式相关联的“魔术数”。</span>
<span>一旦实际读取开始,读取器可能仍然在解码完成之前的任何时间指示失败。</span>
<p> <span>重要的是,对象的状态不会受到干扰,以便其他<code>ImageReaderSpi</code>可以正确地确定它们是否能够解码该对象。</span> <span>特别是,如果该源为<code>ImageInputStream</code> ,一个<code>mark</code> / <code>reset</code>对应该用来保存流位置。</span> </p>
<p> <span>可能会尝试读取几乎任何流的“raw”格式应该返回<code>false</code> ,以避免被调用而不是更接近的匹配。</span> </p>
<p> <span>如果<code>source</code>不是由<code>getInputTypes</code>返回的一个类的<code>getInputTypes</code> ,则该方法应该简单地返回<code>false</code></span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>source</code> - 要解码的对象(通常为
<code>ImageInputStream</code> )。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>true</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>source</code>
<code>null</code>
</dd>
<dd>
<code><a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果在读取流时发生I / O错误。
</dd>
</dl> </li>
</ul> <a name="createReaderInstance--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createReaderInstance</h4> <pre>public <a href="../../../javax/imageio/ImageReader.html" title="class in javax.imageio">ImageReader</a> createReaderInstance()
throws <a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>返回与该服务提供商相关<code>ImageReader</code> ImageReader实现的实例。</span>
<span>返回的对象最初将处于初始状态,就像其<code>reset</code>方法已被调用一样。</span>
<p> <span>默认实现只是返回<code>createReaderInstance(null)</code></span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>ImageReader</code>例子。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果读取器类的加载或初始化期间或在读取器对象的实例化或初始化期间发生错误。
</dd>
</dl> </li>
</ul> <a name="createReaderInstance-java.lang.Object-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>createReaderInstance</h4> <pre>public abstract <a href="../../../javax/imageio/ImageReader.html" title="class in javax.imageio">ImageReader</a> createReaderInstance(<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> extension)
throws <a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>返回与该服务提供商相关<code>ImageReader</code> ImageReader实现的实例。</span>
<span>返回的对象最初将处于初始状态,就好像其<code>reset</code>方法已被调用一样。</span>
<p> <span>一个<code>Object</code>可以被提供给该插件在施工时间。</span> <span>对象的性质是完全插件具体的。</span> </p>
<p> <span>通常,插件将使用诸如<code>return new MyImageReader(this)</code>之类的代码实现此方法。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>extension</code> - 一个插件特定的扩展对象,可以是
<code>null</code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
一个
<code>ImageReader</code>例子。
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果尝试实例化读取器失败。
</dd>
<dd>
<code><a href="../../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果
<code>ImageReader</code>的构造函数抛出一个
<code>IllegalArgumentException</code>来表示扩展对象不合适。
</dd>
</dl> </li>
</ul> <a name="isOwnReader-javax.imageio.ImageReader-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>isOwnReader</h4> <pre>public boolean isOwnReader(<a href="../../../javax/imageio/ImageReader.html" title="class in javax.imageio">ImageReader</a> reader)</pre>
<div class="block">
<span>返回<code>true</code>如果<code>ImageReader</code>在传递的对象是的实例<code>ImageReader</code>与此服务提供者关联。</span>
<p> <span>默认实现将<code>reader</code>参数的完全限定类名与传递给<code>reader</code>函数的类名进行比较。</span> <span>如果需要更复杂的检查,该方法可能会被覆盖。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>reader</code> - 一个
<code>ImageReader</code>实例。
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>true</code>如果
<code>reader</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>reader</code>
<code>null</code>
</dd>
</dl> </li>
</ul> <a name="getImageWriterSpiNames--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>getImageWriterSpiNames</h4> <pre>public <a href="../../../java/lang/String.html" title="class in java.lang">String</a>[] getImageWriterSpiNames()</pre>
<div class="block">
<span>返回的数组<code>String</code>包含所有的完全合格的名称小号<code>ImageWriterSpi</code>类,可以理解由所使用的内部元数据表示<code>ImageReader</code>与此服务提供商相关联,或<code>null</code>如果没有这样<code>ImageWriter</code>指定秒。</span>
<span>如果返回非<code>null</code>值,则它必须具有非零长度。</span>
<p> <span>数组中的第一个项目必须是“首选”作者的服务提供商的名称,因为它将用于实例化由<code>ImageWriter</code>返回的<code>ImageIO.getImageWriter(ImageReader)</code></span> </p>
<p> <span>这种机制可以用来获得<code>ImageWriters</code>将理解非像素元数据(见的内部结构<code>IIOTreeInfo</code> )由生成的<code>ImageReader</code></span> <span>通过从获得该数据<code>ImageReader</code>并将其传递到所述的一个<code>ImageWriters</code>用这种方法获得的,客户端程序可以读取的图像,修改它以某种方式,并将其写回到出来,同时保留所有的元数据,而无需了解元数据的内部结构,甚至了解图像格式。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>String</code>的长度至少为1的数组
<code>String</code>
<code>ImageWriterSpi</code>
<code>null</code>
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/imageio/ImageIO.html#getImageWriter-javax.imageio.ImageReader-"><code>ImageIO.getImageWriter(ImageReader)</code></a>
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>