Module  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)