クラスMidiFileReader

java.lang.Object
javax.sound.midi.spi.MidiFileReader
public abstract class MidiFileReader extends Object
MidiFileReaderは、MIDIファイル読込みサービスを提供します。 このインタフェースを実装しているクラスは、1種類以上のMIDIファイルから形式情報を構文解析できます。また、これらの種類のファイルからSequenceオブジェクトを生成することもできます。
導入されたバージョン:
1.3

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

    コンストラクタ
    修飾子
    コンストラクタ
    説明
    protected
    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シーケンスを取得します。

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    boolean
    equals(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    int
    hashCode()
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    String
    toString()
    オブジェクトの文字列表現を返します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • コンストラクタの詳細

    • 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の場合
      関連項目:

    • getMidiFileFormat

      public abstract MidiFileFormat getMidiFileFormat(URL url) throws InvalidMidiDataException, IOException
      URLの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の場合
      関連項目:

    • getSequence

      public abstract Sequence getSequence(URL url) throws InvalidMidiDataException, IOException
      URLから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の場合