java.lang.Object
javax.sound.midi.spi.MidiFileReader
public abstract class MidiFileReader extends Object
MidiFileReader
は、MIDIファイル読込みサービスを提供します。 このインタフェースを実装しているクラスは、1種類以上のMIDIファイルから形式情報を構文解析できます。また、これらの種類のファイルからSequence
オブジェクトを生成することもできます。 - 導入されたバージョン:
- 1.3
-
コンストラクタのサマリー
コンストラクタ -
メソッドのサマリー
修飾子と型メソッド説明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シーケンスを取得します。
-
コンストラクタの詳細
-
MidiFileReader
protected MidiFileReader()サブクラスが呼び出すためのコンストラクタ。
-
-
メソッドの詳細
-
getMidiFileFormat
public abstract MidiFileFormat getMidiFileFormat(InputStream stream) throws InvalidMidiDataException, IOException指定された入力ストリームのMIDIファイル形式を取得します。 ストリームは有効なMIDIファイル・データを示す必要があります。 一般的に、MIDIファイル・リーダーは、そのストリームをサポートするかどうかを判定する前に一部のデータを読み込む必要があります。 これらのパーサーは、ストリームをマークし、ストリームをサポートするかどうかを判定するのに十分なデータを読み込み、サポートしない場合はストリームの読込みポインタをもとの位置に戻す、という機能が必要です。 入力ストリームがこれをサポートしない場合、このメソッドはIOException
を表示して失敗することがあります。- パラメータ:
stream
- ファイル形式情報を抽出する入力ストリーム- 戻り値:
- MIDIファイル形式を記述する
MidiFileFormat
オブジェクト - 例外:
InvalidMidiDataException
- システムが認識した有効なMIDIファイル・データをストリームが示さない場合IOException
- 入出力例外が発生した場合NullPointerException
-stream
がnull
の場合- 関連項目:
InputStream.markSupported()
,InputStream.mark(int)
-
getMidiFileFormat
public abstract MidiFileFormat getMidiFileFormat(URL url) throws InvalidMidiDataException, IOExceptionURL
のMIDIファイル形式を取得します。URL
は有効なMIDIファイル・データを指している必要があります。- パラメータ:
url
- ファイル形式情報を抽出するURL
- 戻り値:
- MIDIファイル形式を記述する
MidiFileFormat
オブジェクト - 例外:
InvalidMidiDataException
-URL
がシステムによって認識された有効なMIDIファイル・データを指していない場合IOException
- 入出力例外が発生した場合NullPointerException
-url
がnull
の場合
-
getMidiFileFormat
public abstract MidiFileFormat getMidiFileFormat(File file) throws InvalidMidiDataException, IOException指定されたFile
のMIDIファイル形式を取得します。File
は有効なMIDIファイル・データを示す必要があります。- パラメータ:
file
- ファイル形式情報を抽出するFile
- 戻り値:
- MIDIファイル形式を記述する
MidiFileFormat
オブジェクト - 例外:
InvalidMidiDataException
- システムが認識した有効なMIDIファイル・データをFile
が示さない場合IOException
- 入出力例外が発生した場合NullPointerException
-file
がnull
の場合
-
getSequence
public abstract Sequence getSequence(InputStream stream) throws InvalidMidiDataException, IOException指定された入力ストリームからMIDIシーケンスを取得します。 ストリームは有効なMIDIファイル・データを示す必要があります。 一般的に、MIDIファイル・リーダーは、そのストリームをサポートするかどうかを判定する前に一部のデータを読み込む必要があります。 これらのパーサーは、ストリームをマークし、ストリームをサポートするかどうかを判定するのに十分なデータを読み込み、サポートしない場合はストリームの読込みポインタをもとの位置に戻す、という機能が必要です。 入力ストリームがこれをサポートしない場合、このメソッドはIOException
を表示して失敗することがあります。- パラメータ:
stream
-Sequence
を構築する入力ストリーム- 戻り値:
- 入力ストリームに含まれるMIDIファイル・データにもとづく
Sequence
オブジェクト - 例外:
InvalidMidiDataException
- システムが認識した有効なMIDIファイル・データをストリームが示さない場合IOException
- 入出力例外が発生した場合NullPointerException
-stream
がnull
の場合- 関連項目:
InputStream.markSupported()
,InputStream.mark(int)
-
getSequence
public abstract Sequence getSequence(URL url) throws InvalidMidiDataException, IOExceptionURL
からMIDIシーケンスを取得します。URL
は有効なMIDIファイル・データを指している必要があります。- パラメータ:
url
-Sequence
が構成されるべきURL
- 戻り値:
URL
が指すMIDIファイル・データに基づくSequence
オブジェクト- 例外:
InvalidMidiDataException
-URL
がシステムによって認識された有効なMIDIファイル・データを指していない場合IOException
- 入出力例外が発生した場合NullPointerException
-url
がnull
の場合
-
getSequence
public abstract Sequence getSequence(File file) throws InvalidMidiDataException, IOException指定されたFile
からMIDIシーケンスを取得します。File
は有効なMIDIファイル・データを示す必要があります。- パラメータ:
file
-Sequence
を構築するFile
- 戻り値:
File
が示すMIDIファイル・データに基づくSequence
オブジェクト- 例外:
InvalidMidiDataException
- システムが認識した有効なMIDIファイル・データをFile
が示さない場合IOException
- 入出力例外が発生した場合NullPointerException
-file
がnull
の場合
-