javax.sound.midi.spi

Class MidiFileReader

java.lang.Object

javax.sound.midi.spi.MidiFileReader

public abstract class MidiFileReader
extends Object

一个 MidiFileReader提供MIDI文件阅览服务。实现这个接口的类解析格式的信息从一个或多个类型的MIDI文件，并能够从这些类型文件的 Sequence对象。

从以下版本开始：

一点三

构造方法摘要

构造方法

Constructor and Description
MidiFileReader()

方法摘要

Modifier and Type	Method and Description
abstract MidiFileFormat	getMidiFileFormat(File file) 获得MIDI文件格式的 File提供。
abstract MidiFileFormat	getMidiFileFormat(InputStream stream) 获得MIDI文件格式的输入流提供。
abstract MidiFileFormat	getMidiFileFormat(URL url) 获得MIDI文件格式提供的URL。
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

Constructor Detail

MidiFileReader

public MidiFileReader()

方法详细信息

getMidiFileFormat

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

获得MIDI文件格式的输入流提供。流必须指向有效的MIDI文件中的数据。总的来说，MIDI文件的读者可能需要从流中读取一些数据之前，确定他们是否支持它。这些分析器必须能够标记流，读了足够的数据来确定他们是否支持流，如果不重置流的读到其原始位置的指针。如果输入流不支持这一点，这种方法可能会失败，一个 IOException。

参数

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

结果

一个 MidiFileFormat对象描述MIDI文件格式

异常

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

IOException如果发生I/O异常

另请参见：

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

getMidiFileFormat

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

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

参数

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

结果

一个 MidiFileFormat对象描述MIDI文件格式

异常

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

IOException如果发生I/O异常

getMidiFileFormat

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

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

参数

file - File从文件格式信息应提取

结果

一个 MidiFileFormat对象描述MIDI文件格式

异常

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

IOException如果发生I/O异常

getSequence

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

获得一个MIDI序列从输入流提供。流必须指向有效的MIDI文件中的数据。总的来说，MIDI文件的读者可能需要从流中读取一些数据之前，确定他们是否支持它。这些分析器必须能够标记流，读了足够的数据来确定他们是否支持流，如果不重置流的读到其原始位置的指针。如果输入流不支持这个，这种方法可能会失败，一次。

参数

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序列。URL必须指向有效的MIDI文件中的数据。

参数

url的URL， Sequence应构建

结果

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

异常

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

IOException如果发生I/O异常

getSequence

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

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

参数

file - File， Sequence应构建

结果

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

异常

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

IOException如果发生I/O异常