javax.sound.midi.spi

クラスMidiFileReader

java.lang.Object

javax.sound.midi.spi.MidiFileReader

public abstract class MidiFileReader
extends Object

MidiFileReaderは、MIDIファイル読込みサービスを提供します。このインタフェースを実装しているクラスは、1種類以上のMIDIファイルから形式情報を構文解析できます。また、これらの種類のファイルからSequenceオブジェクトを生成することもできます。

導入されたバージョン:

1.3

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

コンストラクタ

コンストラクタと説明
MidiFileReader()

メソッドのサマリー

修飾子と型	メソッドと説明
abstract MidiFileFormat	getMidiFileFormat(File file) 指定されたFileのMIDIファイル形式を取得します。
abstract MidiFileFormat	getMidiFileFormat(InputStream stream) 指定された入力ストリームのMIDIファイル形式を取得します。
abstract MidiFileFormat	getMidiFileFormat(URL url) 指定されたURLのMIDIファイル形式を取得します。
abstract Sequence	getSequence(File file) 指定されたFileからMIDIシーケンスを取得します。
abstract Sequence	getSequence(InputStream stream) 指定された入力ストリームからMIDIシーケンスを取得します。
abstract Sequence	getSequence(URL url) 指定されたURLのMIDIシーケンスを取得します。

クラス java.lang.Objectから継承されたメソッド

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

コンストラクタの詳細

MidiFileReader

public MidiFileReader()

メソッドの詳細

getMidiFileFormat

public abstract MidiFileFormat getMidiFileFormat(InputStream stream)
                                          throws InvalidMidiDataException,
                                                 IOException

指定された入力ストリームのMIDIファイル形式を取得します。ストリームは有効なMIDIファイル・データを示す必要があります。一般的に、MIDIファイル・リーダーは、そのストリームをサポートするかどうかを判定する前に一部のデータを読み込む必要があります。これらのパーサーは、ストリームをマークし、ストリームをサポートするかどうかを判定するのに十分なデータを読み込み、サポートしない場合はストリームの読込みポインタをもとの位置に戻す、という機能が必要です。入力ストリームがこれをサポートしない場合、このメソッドはIOExceptionを表示して失敗することがあります。

パラメータ:

stream - ファイル形式情報を抽出する入力ストリーム

戻り値:

MIDIファイル形式を記述するMidiFileFormatオブジェクト

例外:

InvalidMidiDataException - システムが認識した有効なMIDIファイル・データをストリームが示さない場合

IOException - 入出力例外が発生した場合

関連項目:

InputStream.markSupported(), InputStream.mark(int)

getMidiFileFormat

public abstract MidiFileFormat getMidiFileFormat(URL url)
                                          throws InvalidMidiDataException,
                                                 IOException

指定されたURLのMIDIファイル形式を取得します。URLは、有効なMIDIファイル・データを示す必要があります。

パラメータ:

url - ファイル形式情報を抽出するURL

戻り値:

MIDIファイル形式を記述するMidiFileFormatオブジェクト

例外:

InvalidMidiDataException - システムが認識した有効なMIDIファイル・データをURLが示さない場合

IOException - 入出力例外が発生した場合

getMidiFileFormat

public abstract MidiFileFormat getMidiFileFormat(File file)
                                          throws InvalidMidiDataException,
                                                 IOException

指定されたFileのMIDIファイル形式を取得します。Fileは有効なMIDIファイル・データを示す必要があります。

パラメータ:

file - ファイル形式情報を抽出するFile

戻り値:

MIDIファイル形式を記述するMidiFileFormatオブジェクト

例外:

InvalidMidiDataException - システムが認識した有効なMIDIファイル・データをFileが示さない場合

IOException - 入出力例外が発生した場合

getSequence

public abstract Sequence getSequence(InputStream stream)
                              throws InvalidMidiDataException,
                                     IOException

指定された入力ストリームからMIDIシーケンスを取得します。ストリームは有効なMIDIファイル・データを示す必要があります。一般的に、MIDIファイル・リーダーは、そのストリームをサポートするかどうかを判定する前に一部のデータを読み込む必要があります。これらのパーサーは、ストリームをマークし、ストリームをサポートするかどうかを判定するのに十分なデータを読み込み、サポートしない場合はストリームの読込みポインタをもとの位置に戻す、という機能が必要です。入力ストリームがこれをサポートしない場合、このメソッドはIOExceptionを表示して失敗することがあります。

パラメータ:

stream - Sequenceを構築する入力ストリーム

戻り値:

入力ストリームに含まれるMIDIファイル・データにもとづくSequenceオブジェクト。

例外:

InvalidMidiDataException - システムが認識した有効なMIDIファイル・データをストリームが示さない場合

IOException - 入出力例外が発生した場合

関連項目:

InputStream.markSupported(), InputStream.mark(int)

getSequence

public abstract Sequence getSequence(URL url)
                              throws InvalidMidiDataException,
                                     IOException

指定されたURLのMIDIシーケンスを取得します。URLは、有効なMIDIファイル・データを示す必要があります。

パラメータ:

url - Sequenceを構築するURL

戻り値:

URLが示すMIDIファイル・データに基づくSequenceオブジェクト

例外:

InvalidMidiDataException - システムが認識した有効なMIDIファイル・データをURLが示さない場合

IOException - 入出力例外が発生した場合

getSequence

public abstract Sequence getSequence(File file)
                              throws InvalidMidiDataException,
                                     IOException

指定されたFileからMIDIシーケンスを取得します。Fileは有効なMIDIファイル・データを示す必要があります。

パラメータ:

file - Sequenceを構築するFile

戻り値:

Fileが示すMIDIファイル・データに基づくSequenceオブジェクト

例外:

InvalidMidiDataException - システムが認識した有効なMIDIファイル・データをFileが示さない場合

IOException - 入出力例外が発生した場合