模块  java.desktop
软件包  javax.sound.midi.spi

Class MidiFileReader

  • public abstract class MidiFileReader
extends Object
    A MidiFileReader提供MIDI文件读取服务。 实现此接口的类可以解析来自一种或多种类型的MIDI文件的格式信息，并可以从这些类型的文件生成Sequence对象。
    从以下版本开始：
    1.3

    • 构造方法详细信息

      • MidiFileReader

        public MidiFileReader()

    • 方法详细信息

      • getMidiFileFormat

        public abstract MidiFileFormat getMidiFileFormat​(InputStream stream)
                                          throws InvalidMidiDataException,
                                                 IOException
        获得提供的输入流的MIDI文件格式。 流必须指向有效的MIDI文件数据。 通常，MIDI文件读取器可能需要在确定它们是否支持它之前从流中读取一些数据。 这些解析器必须能够标记流，读取足够的数据以确定它们是否支持流，如果不支持，则将流的读指针重置为其原始位置。 如果输入流不支持此方法，则此方法可能会失败，并显示IOException 。
        参数
        stream - 应从中提取文件格式信息的输入流
        结果
        描述MIDI文件格式的 MidiFileFormat对象
        异常
        InvalidMidiDataException - 如果流未指向系统识别的有效MIDI文件数据
        IOException - 如果发生I / O异常
        NullPointerException - 如果 stream是 null
        另请参见：
        InputStream.markSupported() ， InputStream.mark(int)

      • getSequence

        public abstract Sequence getSequence​(InputStream stream)
                              throws InvalidMidiDataException,
                                     IOException
        从提供的输入流中获取MIDI序列。 流必须指向有效的MIDI文件数据。 通常，MIDI文件读取器可能需要在确定它们是否支持它之前从流中读取一些数据。 这些解析器必须能够标记流，读取足够的数据以确定它们是否支持流，如果不支持，则将流的读指针重置为其原始位置。 如果输入流不支持此方法，则此方法可能会失败，并显示IOException 。
        参数
        stream -从该输入流 Sequence应当被构造
        结果
        基于输入流中包含的MIDI文件数据的 Sequence对象
        异常
        InvalidMidiDataException - 如果流未指向系统识别的有效MIDI文件数据
        IOException - 如果发生I / O异常
        NullPointerException - 如果 stream是 null
        另请参见：
        InputStream.markSupported() ， InputStream.mark(int)