MidiFileReader (Java Platform SE 6)

概要

パッケージ

クラス

使用

階層ツリー

非推奨 API

索引

ヘルプ

Java^TM Platform
Standard Ed. 6

前のクラス 次のクラス

フレームあり フレームなし

概要: 入れ子 | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

javax.sound.midi.spi
クラス MidiFileReader

java.lang.Object
  javax.sound.midi.spi.MidiFileReader

public abstract class MidiFileReader
extends Object
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 - 入出力例外が発生した場合