Module java.desktop

软件包 javax.sound.midi.spi

Class MidiFileWriter

java.lang.Object

javax.sound.midi.spi.MidiFileWriter

public abstract class MidiFileWriter
extends Object

A MidiFileWriter提供MIDI文件写入服务。 实现此界面的类可以从Sequence对象写入一个或多个类型的MIDI文件。

从以下版本开始：

1.3

构造方法摘要

构造方法

Constructor	描述
MidiFileWriter()

方法摘要

Modifier and Type	方法	描述
abstract int[]	getMidiFileTypes()	获取此文件写入器提供文件写入支持的一组MIDI文件类型。
abstract int[]	getMidiFileTypes(Sequence sequence)	获取此文件写入器可以从指定的序列中写入的文件类型。
boolean	isFileTypeSupported(int fileType)	指示文件写入器是否为指定的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文件的字节流。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造方法详细信息

MidiFileWriter

public MidiFileWriter()

方法详细信息

getMidiFileTypes

public abstract int[] getMidiFileTypes()

获取此文件写入器提供文件写入支持的一组MIDI文件类型。

结果

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

getMidiFileTypes

public abstract int[] getMidiFileTypes(Sequence sequence)

获取此文件写入器可以从指定的序列中写入的文件类型。

参数

sequence - 查询MIDI文件类型支持的顺序

结果

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

异常

NullPointerException - 如果 sequence是 null

isFileTypeSupported

public boolean isFileTypeSupported(int fileType)

指示文件写入器是否为指定的MIDI文件类型提供文件写入。

参数

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

结果

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

isFileTypeSupported

public boolean isFileTypeSupported(int fileType,
                                   Sequence sequence)

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

参数

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

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

结果

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

异常

NullPointerException - 如果 sequence是 null

write

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

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

参数

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

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

out - 应写入文件数据的流

结果

写入输出流的字节数

异常

IOException - 如果发生I / O异常

IllegalArgumentException - 如果此文件写入程序不支持该文件类型

NullPointerException - 如果 in或 out是 null

另请参见：

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 - 如果此文件写入程序不支持该文件类型

NullPointerException - 如果 in或 out是 null

另请参见：

isFileTypeSupported(int, Sequence) ， getMidiFileTypes(Sequence)