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 - 如果 streamnull
        另请参见:
        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 - 如果 streamnull
        另请参见:
        InputStream.markSupported()InputStream.mark(int)