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

类 MidiFileReader

java.lang.Object
javax.sound.midi.spi.MidiFileReader
public abstract class MidiFileReader extends Object
MidiFileReader 提供 MIDI 文件读取服务。实现此接口的类可以从一种或多种类型的 MIDI 文件中解析格式信息，并可以从这些类型的文件中生成 Sequence 对象。
自从：
1.3

  • 构造方法详细信息

    • MidiFileReader

      protected 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
      参见：

    • getMidiFileFormat

      public abstract MidiFileFormat  getMidiFileFormat(URL  url) throws InvalidMidiDataException , IOException
      获取提供的URL的MIDI文件格式。 URL 必须指向有效的 MIDI 文件数据。
      参数：
      url - 应从中提取文件格式信息的 URL
      返回：
      描述 MIDI 文件格式的 MidiFileFormat 对象
      抛出：
      InvalidMidiDataException - 如果 URL 没有指向系统识别的有效 MIDI 文件数据
      IOException - 如果发生 I/O 异常
      NullPointerException - 如果 url 是 null

    • getMidiFileFormat

      public abstract MidiFileFormat  getMidiFileFormat(File  file) throws InvalidMidiDataException , IOException
      获取提供的File的MIDI文件格式。 File 必须指向有效的 MIDI 文件数据。
      参数：
      file - 应从中提取文件格式信息的 File
      返回：
      描述 MIDI 文件格式的 MidiFileFormat 对象
      抛出：
      InvalidMidiDataException - 如果 File 没有指向系统识别的有效 MIDI 文件数据
      IOException - 如果发生 I/O 异常
      NullPointerException - 如果 file 是 null

    • 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
      参见：

    • getSequence

      public abstract Sequence  getSequence(URL  url) throws InvalidMidiDataException , IOException
      从提供的 URL 获取 MIDI 序列。 URL 必须指向有效的 MIDI 文件数据。
      参数：
      url - 应为其构建 Sequence 的 URL
      返回：
      基于 URL 指向的 MIDI 文件数据的 Sequence 对象
      抛出：
      InvalidMidiDataException - 如果 URL 没有指向系统识别的有效 MIDI 文件数据
      IOException - 如果发生 I/O 异常
      NullPointerException - 如果 url 是 null

    • getSequence

      public abstract Sequence  getSequence(File  file) throws InvalidMidiDataException , IOException
      从提供的 File 获取 MIDI 序列。 File 必须指向有效的 MIDI 文件数据。
      参数：
      file - 应该从中构建 Sequence 的 File
      返回：
      基于 File 指向的 MIDI 文件数据的 Sequence 对象
      抛出：
      InvalidMidiDataException - 如果 File 没有指向系统识别的有效 MIDI 文件数据
      IOException - 如果发生 I/O 异常
      NullPointerException - 如果 file 是 null