モジュール java.desktop

パッケージ javax.sound.sampled.spi

クラスAudioFileReader

java.lang.Object

javax.sound.sampled.spi.AudioFileReader

public abstract class AudioFileReader extends Object

オーディオ・ファイル読込みサービスのプロバイダです。 具象実装を備えているクラスは、1種類以上のオーディオ・ファイルから形式情報を構文解析することができます。また、これらのタイプのファイルからオーディオ入力ストリームを生成することもできます。

導入されたバージョン:

1.3

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

コンストラクタ

修飾子	コンストラクタ	説明
protected	AudioFileReader()	サブクラスが呼び出すためのコンストラクタ。

メソッドのサマリー

修飾子と型	メソッド	説明
abstract AudioFileFormat	getAudioFileFormat(File file)	指定されたFileのオーディオ・ファイル形式を取得します。
abstract AudioFileFormat	getAudioFileFormat(InputStream stream)	指定された入力ストリームのオーディオ・ファイル形式を取得します。
abstract AudioFileFormat	getAudioFileFormat(URL url)	URLのオーディオ・ファイル形式を取得します。
abstract AudioInputStream	getAudioInputStream(File file)	指定されたFileからオーディオ入力ストリームを取得します。
abstract AudioInputStream	getAudioInputStream(InputStream stream)	指定された入力ストリームからオーディオ入力ストリームを取得します。
abstract AudioInputStream	getAudioInputStream(URL url)	URLからオーディオ入力ストリームを取得します。

クラスjava.lang.Objectで宣言されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

AudioFileReader

protected AudioFileReader()

サブクラスが呼び出すためのコンストラクタ。

メソッドの詳細

getAudioFileFormat

public abstract AudioFileFormat getAudioFileFormat(InputStream stream) throws UnsupportedAudioFileException, IOException

指定された入力ストリームのオーディオ・ファイル形式を取得します。 ストリームは有効なオーディオ・ファイル・データを示す必要があります。 一般的に、オーディオ・ファイル・リーダーは、そのストリームをサポートするかどうかを判定する前に一部のデータを読み込む必要があります。 これらのパーサーは、ストリームをマークし、ストリームをサポートしているかどうかを確認するために十分なデータを読み取り、ストリームの読み取りポインタを元の位置にリセットできる必要があります。 入力ストリームがこれをサポートしない場合、このメソッドはIOExceptionを表示して失敗することがあります。

パラメータ:

stream - ファイル形式情報を抽出する入力ストリーム

戻り値:

オーディオ・ファイル形式を記述するAudioFileFormatオブジェクト

例外:

UnsupportedAudioFileException - システムが認識した有効なオーディオ・ファイル・データをストリームが示さない場合

IOException - 入出力例外が発生した場合

NullPointerException - streamがnullの場合

関連項目:

• InputStream.markSupported()
• InputStream.mark(int)

getAudioFileFormat

public abstract AudioFileFormat getAudioFileFormat(URL url) throws UnsupportedAudioFileException, IOException

URLのオーディオ・ファイル形式を取得します。 URLは、有効なオーディオ・ファイル・データを指している必要があります。

パラメータ:

url - ファイル形式情報を抽出するURL

戻り値:

オーディオ・ファイル形式を記述するAudioFileFormatオブジェクト

例外:

UnsupportedAudioFileException - URLがシステムによって認識された有効なオーディオ・ファイル・データを指していない場合

IOException - 入出力例外が発生した場合

NullPointerException - urlがnullの場合

getAudioFileFormat

public abstract AudioFileFormat getAudioFileFormat(File file) throws UnsupportedAudioFileException, IOException

指定されたFileのオーディオ・ファイル形式を取得します。 Fileは有効なオーディオ・ファイル・データを示す必要があります。

パラメータ:

file - ファイル形式情報を抽出するFile

戻り値:

オーディオ・ファイル形式を記述するAudioFileFormatオブジェクト

例外:

UnsupportedAudioFileException - システムが認識した有効なオーディオ・ファイル・データをFileが示さない場合

IOException - 入出力例外が発生した場合

NullPointerException - fileがnullの場合

getAudioInputStream

public abstract AudioInputStream getAudioInputStream(InputStream stream) throws UnsupportedAudioFileException, IOException

指定された入力ストリームからオーディオ入力ストリームを取得します。 ストリームは有効なオーディオ・ファイル・データを示す必要があります。 一般的に、オーディオ・ファイル・リーダーは、そのストリームをサポートするかどうかを判定する前に一部のデータを読み込む必要があります。 これらのパーサーは、ストリームをマークし、ストリームをサポートしているかどうかを確認するために十分なデータを読み取り、ストリームの読み取りポインタを元の位置にリセットできる必要があります。 入力ストリームがこれをサポートしない場合、このメソッドはIOExceptionを表示して失敗することがあります。

パラメータ:

stream - AudioInputStreamを構築する入力ストリーム

戻り値:

入力ストリームに含まれるオーディオ・ファイル・データに基づくAudioInputStreamオブジェクト

例外:

UnsupportedAudioFileException - システムが認識した有効なオーディオ・ファイル・データをストリームが示さない場合

IOException - 入出力例外が発生した場合

NullPointerException - streamがnullの場合

関連項目:

• InputStream.markSupported()
• InputStream.mark(int)

getAudioInputStream

public abstract AudioInputStream getAudioInputStream(URL url) throws UnsupportedAudioFileException, IOException

URLからオーディオ入力ストリームを取得します。 URLは、有効なオーディオ・ファイル・データを指している必要があります。

パラメータ:

url - AudioInputStreamが構成されるべきURL

戻り値:

URLが指すオーディオ・ファイル・データに基づくAudioInputStreamオブジェクト

例外:

UnsupportedAudioFileException - URLがシステムによって認識された有効なオーディオ・ファイル・データを指していない場合

IOException - 入出力例外が発生した場合

NullPointerException - urlがnullの場合

getAudioInputStream

public abstract AudioInputStream getAudioInputStream(File file) throws UnsupportedAudioFileException, IOException

指定されたFileからオーディオ入力ストリームを取得します。 Fileは有効なオーディオ・ファイル・データを示す必要があります。

パラメータ:

file - AudioInputStreamを構築するFile

戻り値:

Fileが示すオーディオ・ファイル・データに基づくAudioInputStreamオブジェクト

例外:

UnsupportedAudioFileException - システムが認識した有効なオーディオ・ファイル・データをFileが示さない場合

IOException - 入出力例外が発生した場合

NullPointerException - fileがnullの場合