javax.sound.midi.spi
类 MidiFileWriter

java.lang.Object
  javax.sound.midi.spi.MidiFileWriter

public abstract class MidiFileWriter
     

      extends 
      Object
     

MidiFileWriter 提供 MIDI 文件写入服务。实现此接口的类可以从 Sequence 对象写入一种或多种类型的 MIDI 文件。

从以下版本开始：

1.3

MidiFileWriter

public MidiFileWriter()

getMidiFileTypes

public abstract int[] getMidiFileTypes()

获得此文件 writer 为其提供文件写入支持的 MIDI 文件类型的集合。

返回：

文件类型的数组。如果不支持任何文件类型，则返回长度为 0 的数组。

getMidiFileTypes

public abstract int[] getMidiFileTypes(Sequence sequence)

获得此文件 writer 可从指定的序列写入的文件类型。

参数：

sequence - 为其查询 MIDI 文件类型支持的序列

返回：

文件类型的数组。如果不支持任何文件类型，则返回长度为 0 的数组。

isFileTypeSupported

public boolean isFileTypeSupported(int fileType)

指示此文件 writer 是否提供指定 MIDI 文件类型的文件写入支持。

参数：

fileType - 查询其写入功能的文件类型

返回：

如果支持文件类型，则返回 true；否则返回 false

isFileTypeSupported

public boolean isFileTypeSupported(int fileType,
                                   Sequence sequence)

指示是否可从指示的序列写入指定文件类型的 MIDI 文件。

参数：

fileType - 查询其写入功能的文件类型

sequence - 查询其文件写入支持的序列

返回：

如果支持此序列的文件类型，则返回 true；否则返回 false

write

public abstract int write(Sequence in,
                          int fileType,
                          OutputStream out)
                   throws IOException

写入表示指示为所提供输出流的文件类型的 MIDI 文件的字节流。

参数：

in - 包含要写入文件的 MIDI 数据的序列

fileType - 要写入输出流的文件类型

out - 应将文件数据写入的流

返回：

写入输出流的字节数

抛出：

IOException - 如果发生 I/O 异常

IllegalArgumentException - 如果文件 writer 不支持文件类型

另请参见：

isFileTypeSupported(int, Sequence), getMidiFileTypes(Sequence)

write

public abstract int write(Sequence in,
                          int fileType,
                          File out)
                   throws IOException

写入表示指示为所提供外部文件的文件类型的 MIDI 文件的字节流。

参数：

in - 包含要写入外部文件的 MIDI 数据的序列

fileType - 要写入外部文件的文件类型

out - 应将文件数据写入的外部文件

返回：

写入文件的字节数

抛出：

IOException - 如果发生 I/O 异常

IllegalArgumentException - 如果此文件 writer 不支持文件类型

另请参见：

isFileTypeSupported(int, Sequence), getMidiFileTypes(Sequence)