javax.sound.midi.spi

java.lang.Object
  继承者 javax.sound.midi.spi.MidiFileWriter

public abstract class MidiFileWriter
     
extends Object

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

从以下版本开始:
1.3

构造方法摘要
MidiFileWriter()
           
 
方法摘要
abstract  int[] getMidiFileTypes()
          获得此文件 writer 为其提供文件写入支持的 MIDI 文件类型的集合。
abstract  int[] getMidiFileTypes(Sequence sequence)
          获得此文件 writer 可从指定的序列写入的文件类型。
 boolean isFileTypeSupported(int fileType)
          指示此文件 writer 是否提供指定 MIDI 文件类型的文件写入支持。
 boolean isFileTypeSupported(int fileType, Sequence sequence)
          指示是否可从指示的序列写入指定文件类型的 MIDI 文件。
abstract  int write(Sequence in, int fileType, File out)
          写入表示指示为所提供外部文件的文件类型的 MIDI 文件的字节流。
abstract  int write(Sequence in, int fileType, OutputStream out)
          写入表示指示为所提供输出流的文件类型的 MIDI 文件的字节流。
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

构造方法详细信息

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)