モジュール java.desktop

パッケージ javax.sound.midi.spi

クラスMidiFileWriter

java.lang.Object

javax.sound.midi.spi.MidiFileWriter

public abstract class MidiFileWriter extends Object

MidiFileWriterは、MIDIファイル書込みサービスを提供します。 このインタフェースを実装するクラスは、Sequenceオブジェクトから1種類以上のMIDIファイルを書き込むことができます。

導入されたバージョン:

1.3

コンストラクタのサマリー

コンストラクタ

修飾子	コンストラクタ	説明
protected	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

protected 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 - 入出力例外が発生した場合

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 - 入出力例外が発生した場合

IllegalArgumentException - このファイル・ライターがそのファイル・タイプをサポートしていない場合

NullPointerException - inまたはoutがnullの場合

関連項目:

• isFileTypeSupported(int, Sequence)
• getMidiFileTypes(Sequence)