JavaTM 2 Platform
Standard Ed. 5.0

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

JavaTM 2 Platform
Standard Ed. 5.0

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java 2 SDK SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。