uTools-Manuals/docs/java/javax/sound/midi/spi/MidiFileReader.html

<div class="header">
<div class="subTitle">
     javax.sound.midi.spi 
   </div>
<h2 class="title" title="Class MidiFileReader">Class MidiFileReader</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.sound.midi.spi.MidiFileReader</li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<hr/> <br/> <pre>public abstract class <span class="typeNameLabel">MidiFileReader</span>
extends <a href="../../../../java/lang/Object.html" title="class in java.lang">Object</a></pre>
<div class="block">
<span>A <code>MidiFileReader</code>提供MIDI文件阅读服务。</span>
<span>实现此界面的类可以从一种或多种类型的MIDI文件中解析格式信息，并可以从这些类型的文件生成一个<code>Sequence</code>对象。</span>
</div>
<dl>
<dt>
<span class="simpleTagLabel">从以下版本开始：</span>
</dt>
<dd>
         1.3 
       </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="colOne" scope="col">Constructor and Description</th>
</tr>
<tr class="altColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../../javax/sound/midi/spi/MidiFileReader.html#MidiFileReader--">MidiFileReader</a></span>()</code> </td>
</tr>
</tbody>
</table> </li>
</ul>
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method.summary">
<!-- --> </a> <h3>方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Method Summary table, listing methods, and an explanation">
<caption>
<span class="activeTableTab" id="t0"><span>所有方法</span><span class="tabEnd"> </span></span>
<span class="tableTab" id="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>
</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/sound/midi/MidiFileFormat.html" title="class in javax.sound.midi">MidiFileFormat</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sound/midi/spi/MidiFileReader.html#getMidiFileFormat-java.io.File-">getMidiFileFormat</a></span>(<a href="../../../../java/io/File.html" title="class in java.io">File</a> file)</code>
<div class="block">
              获取提供的 
             <code>File</code>的MIDI文件格式。 
            </div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code>abstract <a href="../../../../javax/sound/midi/MidiFileFormat.html" title="class in javax.sound.midi">MidiFileFormat</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sound/midi/spi/MidiFileReader.html#getMidiFileFormat-java.io.InputStream-">getMidiFileFormat</a></span>(<a href="../../../../java/io/InputStream.html" title="class in java.io">InputStream</a> stream)</code>
<div class="block">
              获取所提供的输入流的MIDI文件格式。 
            </div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code>abstract <a href="../../../../javax/sound/midi/MidiFileFormat.html" title="class in javax.sound.midi">MidiFileFormat</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sound/midi/spi/MidiFileReader.html#getMidiFileFormat-java.net.URL-">getMidiFileFormat</a></span>(<a href="../../../../java/net/URL.html" title="class in java.net">URL</a> url)</code>
<div class="block">
              获取提供的URL的MIDI文件格式。 
            </div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code>abstract <a href="../../../../javax/sound/midi/Sequence.html" title="class in javax.sound.midi">Sequence</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sound/midi/spi/MidiFileReader.html#getSequence-java.io.File-">getSequence</a></span>(<a href="../../../../java/io/File.html" title="class in java.io">File</a> file)</code>
<div class="block">
              从提供的 
             <code>File</code>获取MIDI序列。 
            </div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code>abstract <a href="../../../../javax/sound/midi/Sequence.html" title="class in javax.sound.midi">Sequence</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sound/midi/spi/MidiFileReader.html#getSequence-java.io.InputStream-">getSequence</a></span>(<a href="../../../../java/io/InputStream.html" title="class in java.io">InputStream</a> stream)</code>
<div class="block">
              从提供的输入流中获取MIDI序列。 
            </div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code>abstract <a href="../../../../javax/sound/midi/Sequence.html" title="class in javax.sound.midi">Sequence</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../javax/sound/midi/spi/MidiFileReader.html#getSequence-java.net.URL-">getSequence</a></span>(<a href="../../../../java/net/URL.html" title="class in java.net">URL</a> url)</code>
<div class="block">
              从提供的URL获取MIDI序列。 
            </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="MidiFileReader--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>MidiFileReader</h4> <pre>public MidiFileReader()</pre> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="getMidiFileFormat-java.io.InputStream-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getMidiFileFormat</h4> <pre>public abstract <a href="../../../../javax/sound/midi/MidiFileFormat.html" title="class in javax.sound.midi">MidiFileFormat</a> getMidiFileFormat(<a href="../../../../java/io/InputStream.html" title="class in java.io">InputStream</a> stream)
                                          throws <a href="../../../../javax/sound/midi/InvalidMidiDataException.html" title="class in javax.sound.midi">InvalidMidiDataException</a>,
                                                 <a href="../../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>获取所提供的输入流的MIDI文件格式。</span>
<span>流必须指向有效的MIDI文件数据。</span>
<span>一般来说，MIDI文件读取器可能需要从流中读取一些数据，然后再确定它们是否支持它。</span>
<span>这些解析器必须能够标记流，读取足够的数据以确定它们是否支持流，如果不是，则将流的读指针重置为其原始位置。</span>
<span>如果输入流不支持，则该方法可能会失败，并带有<code>IOException</code> 。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>stream</code> - 应提取文件格式信息的输入流 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>MidiFileFormat</code> MIDI文件格式的 
            <code>MidiFileFormat</code>对象 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../javax/sound/midi/InvalidMidiDataException.html" title="class in javax.sound.midi">InvalidMidiDataException</a></code> - 如果流不指向系统识别的有效的MIDI文件数据 
           </dd>
<dd>
<code><a href="../../../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果发生I / O异常 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../../java/io/InputStream.html#markSupported--"><code>InputStream.markSupported()</code></a> ， 
            <a href="../../../../java/io/InputStream.html#mark-int-"><code>InputStream.mark(int)</code></a>
</dd>
</dl> </li>
</ul> <a name="getMidiFileFormat-java.net.URL-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getMidiFileFormat</h4> <pre>public abstract <a href="../../../../javax/sound/midi/MidiFileFormat.html" title="class in javax.sound.midi">MidiFileFormat</a> getMidiFileFormat(<a href="../../../../java/net/URL.html" title="class in java.net">URL</a> url)
                                          throws <a href="../../../../javax/sound/midi/InvalidMidiDataException.html" title="class in javax.sound.midi">InvalidMidiDataException</a>,
                                                 <a href="../../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>获取提供的URL的MIDI文件格式。</span>
<span>网址必须指向有效的MIDI文件数据。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>url</code> - 应提取文件格式信息的URL 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>MidiFileFormat</code> MIDI文件格式的 
            <code>MidiFileFormat</code>对象 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../javax/sound/midi/InvalidMidiDataException.html" title="class in javax.sound.midi">InvalidMidiDataException</a></code> - 如果URL不指向系统识别的有效的MIDI文件数据 
           </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="getMidiFileFormat-java.io.File-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getMidiFileFormat</h4> <pre>public abstract <a href="../../../../javax/sound/midi/MidiFileFormat.html" title="class in javax.sound.midi">MidiFileFormat</a> getMidiFileFormat(<a href="../../../../java/io/File.html" title="class in java.io">File</a> file)
                                          throws <a href="../../../../javax/sound/midi/InvalidMidiDataException.html" title="class in javax.sound.midi">InvalidMidiDataException</a>,
                                                 <a href="../../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>获得提供的<code>File</code>的MIDI文件格式。</span>
<span><code>File</code>必须指向有效的MIDI文件数据。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>file</code> - 
            <code>File</code>提取文件格式信息的File 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>MidiFileFormat</code> MIDI文件格式的 
            <code>MidiFileFormat</code>对象 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../javax/sound/midi/InvalidMidiDataException.html" title="class in javax.sound.midi">InvalidMidiDataException</a></code> - 如果 
            <code>File</code>没有指向系统识别的有效的MIDI文件数据 
           </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="getSequence-java.io.InputStream-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getSequence</h4> <pre>public abstract <a href="../../../../javax/sound/midi/Sequence.html" title="class in javax.sound.midi">Sequence</a> getSequence(<a href="../../../../java/io/InputStream.html" title="class in java.io">InputStream</a> stream)
                              throws <a href="../../../../javax/sound/midi/InvalidMidiDataException.html" title="class in javax.sound.midi">InvalidMidiDataException</a>,
                                     <a href="../../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>从提供的输入流中获取MIDI序列。</span>
<span>流必须指向有效的MIDI文件数据。</span>
<span>一般来说，MIDI文件读取器可能需要从流中读取一些数据，然后再确定它们是否支持它。</span>
<span>这些解析器必须能够标记流，读取足够的数据以确定它们是否支持流，如果不是，则将流的读指针重置为其原始位置。</span>
<span>如果输入流不支持此操作，则此方法可能会失败，并出现IOException异常。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>stream</code> -从该输入流 
            <code>Sequence</code>应当被构造 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个基于输入流中包含的MIDI文件数据的 
            <code>Sequence</code>对象。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../javax/sound/midi/InvalidMidiDataException.html" title="class in javax.sound.midi">InvalidMidiDataException</a></code> - 如果流不指向系统识别的有效的MIDI文件数据 
           </dd>
<dd>
<code><a href="../../../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果发生I / O异常 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../../../java/io/InputStream.html#markSupported--"><code>InputStream.markSupported()</code></a> ， 
            <a href="../../../../java/io/InputStream.html#mark-int-"><code>InputStream.mark(int)</code></a>
</dd>
</dl> </li>
</ul> <a name="getSequence-java.net.URL-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getSequence</h4> <pre>public abstract <a href="../../../../javax/sound/midi/Sequence.html" title="class in javax.sound.midi">Sequence</a> getSequence(<a href="../../../../java/net/URL.html" title="class in java.net">URL</a> url)
                              throws <a href="../../../../javax/sound/midi/InvalidMidiDataException.html" title="class in javax.sound.midi">InvalidMidiDataException</a>,
                                     <a href="../../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>从提供的URL获取MIDI序列。</span>
<span>网址必须指向有效的MIDI文件数据。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>url</code> -对于其中的URL 
            <code>Sequence</code>应当建立 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个基于URL指向的MIDI文件数据的 
            <code>Sequence</code>对象 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../javax/sound/midi/InvalidMidiDataException.html" title="class in javax.sound.midi">InvalidMidiDataException</a></code> - 如果URL不指向系统识别的有效的MIDI文件数据 
           </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="getSequence-java.io.File-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>getSequence</h4> <pre>public abstract <a href="../../../../javax/sound/midi/Sequence.html" title="class in javax.sound.midi">Sequence</a> getSequence(<a href="../../../../java/io/File.html" title="class in java.io">File</a> file)
                              throws <a href="../../../../javax/sound/midi/InvalidMidiDataException.html" title="class in javax.sound.midi">InvalidMidiDataException</a>,
                                     <a href="../../../../java/io/IOException.html" title="class in java.io">IOException</a></pre>
<div class="block">
<span>从提供的<code>File</code>获取MIDI序列。</span>
<span><code>File</code>必须指向有效的MIDI文件数据。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>file</code> - 
            <code>File</code>应从其中 
            <code>Sequence</code> Sequence 
           </dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             一个 
            <code>Sequence</code>对象基于由 
            <code>File</code>指向的MIDI文件数据 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../../javax/sound/midi/InvalidMidiDataException.html" title="class in javax.sound.midi">InvalidMidiDataException</a></code> - 如果 
            <code>File</code>未指向系统识别的有效MIDI文件数据 
           </dd>
<dd>
<code><a href="../../../../java/io/IOException.html" title="class in java.io">IOException</a></code> - 如果发生I / O异常 
           </dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>