模块 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

构造方法摘要

构造方法

构造器	描述
MidiFileWriter()

方法摘要

变量和类型	方法	描述
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文件的字节流写入提供的输出流。

声明方法的类 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 - 如果此文件 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 - 如果此文件 IllegalArgumentException器不支持该文件类型

NullPointerException - 如果 in或 out是 null

另请参见：

isFileTypeSupported(int, Sequence) ， getMidiFileTypes(Sequence)