javax.sound.midi.spi

Class MidiFileReader

java.lang.Object

javax.sound.midi.spi.MidiFileReader

public abstract class MidiFileReader
extends Object

A MidiFileReader提供MIDI文件阅读服务。 实现此界面的类可以从一种或多种类型的MIDI文件中解析格式信息，并可以从这些类型的文件生成一个Sequence对象。

从以下版本开始：

1.3

构造方法摘要

构造方法

Constructor and Description
MidiFileReader()

方法摘要

Modifier and Type	Method and Description
abstract MidiFileFormat	getMidiFileFormat(File file) 获取提供的 File的MIDI文件格式。
abstract MidiFileFormat	getMidiFileFormat(InputStream stream) 获取所提供的输入流的MIDI文件格式。
abstract MidiFileFormat	getMidiFileFormat(URL url) 获取提供的URL的MIDI文件格式。
abstract Sequence	getSequence(File file) 从提供的 File获取MIDI序列。
abstract Sequence	getSequence(InputStream stream) 从提供的输入流中获取MIDI序列。
abstract Sequence	getSequence(URL url) 从提供的URL获取MIDI序列。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造方法详细信息

MidiFileReader

public MidiFileReader()

方法详细信息

getMidiFileFormat

public abstract MidiFileFormat getMidiFileFormat(InputStream stream)
                                          throws InvalidMidiDataException,
                                                 IOException

获取所提供的输入流的MIDI文件格式。 流必须指向有效的MIDI文件数据。 一般来说，MIDI文件读取器可能需要从流中读取一些数据，然后再确定它们是否支持它。 这些解析器必须能够标记流，读取足够的数据以确定它们是否支持流，如果不是，则将流的读指针重置为其原始位置。 如果输入流不支持，则该方法可能会失败，并带有IOException 。

参数

stream - 应提取文件格式信息的输入流

结果

MidiFileFormat MIDI文件格式的 MidiFileFormat对象

异常

InvalidMidiDataException - 如果流不指向系统识别的有效的MIDI文件数据

IOException - 如果发生I / O异常

另请参见：

InputStream.markSupported() ， InputStream.mark(int)

getMidiFileFormat

public abstract MidiFileFormat getMidiFileFormat(URL url)
                                          throws InvalidMidiDataException,
                                                 IOException

获取提供的URL的MIDI文件格式。 网址必须指向有效的MIDI文件数据。

参数

url - 应提取文件格式信息的URL

结果

MidiFileFormat MIDI文件格式的 MidiFileFormat对象

异常

InvalidMidiDataException - 如果URL不指向系统识别的有效的MIDI文件数据

IOException - 如果发生I / O异常

getMidiFileFormat

public abstract MidiFileFormat getMidiFileFormat(File file)
                                          throws InvalidMidiDataException,
                                                 IOException

获得提供的File的MIDI文件格式。 File必须指向有效的MIDI文件数据。

参数

file - File提取文件格式信息的File

结果

MidiFileFormat MIDI文件格式的 MidiFileFormat对象

异常

InvalidMidiDataException - 如果 File没有指向系统识别的有效的MIDI文件数据

IOException - 如果发生I / O异常

getSequence

public abstract Sequence getSequence(InputStream stream)
                              throws InvalidMidiDataException,
                                     IOException

从提供的输入流中获取MIDI序列。 流必须指向有效的MIDI文件数据。 一般来说，MIDI文件读取器可能需要从流中读取一些数据，然后再确定它们是否支持它。 这些解析器必须能够标记流，读取足够的数据以确定它们是否支持流，如果不是，则将流的读指针重置为其原始位置。 如果输入流不支持此操作，则此方法可能会失败，并出现IOException异常。

参数

stream -从该输入流 Sequence应当被构造

结果

一个基于输入流中包含的MIDI文件数据的 Sequence对象。

异常

InvalidMidiDataException - 如果流不指向系统识别的有效的MIDI文件数据

IOException - 如果发生I / O异常

另请参见：

InputStream.markSupported() ， InputStream.mark(int)

getSequence

public abstract Sequence getSequence(URL url)
                              throws InvalidMidiDataException,
                                     IOException

从提供的URL获取MIDI序列。 网址必须指向有效的MIDI文件数据。

参数

url -对于其中的URL Sequence应当建立

结果

一个基于URL指向的MIDI文件数据的 Sequence对象

异常

InvalidMidiDataException - 如果URL不指向系统识别的有效的MIDI文件数据

IOException - 如果发生I / O异常

getSequence

public abstract Sequence getSequence(File file)
                              throws InvalidMidiDataException,
                                     IOException

从提供的File获取MIDI序列。 File必须指向有效的MIDI文件数据。

参数

file - File应从其中 Sequence Sequence

结果

一个 Sequence对象基于由 File指向的MIDI文件数据

异常

InvalidMidiDataException - 如果 File未指向系统识别的有效MIDI文件数据

IOException - 如果发生I / O异常