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