モジュール java.desktop

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

クラスAudioFileWriter

java.lang.Object

javax.sound.sampled.spi.AudioFileWriter

public abstract class AudioFileWriter extends Object

オーディオ・ファイル書込みサービスのプロバイダです。 具象実装を提供するクラスは、オーディオ・ストリームから1種類かそれ以上のオーディオ・ファイルに書き込むことができます。

導入されたバージョン:

1.3

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

コンストラクタ

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

メソッドのサマリー

修飾子と型	メソッド	説明
abstract AudioFileFormat.Type[]	getAudioFileTypes()	このオーディオ・ファイル・ライターがファイル書込みサポートを提供するファイル・タイプを取得します。
abstract AudioFileFormat.Type[]	getAudioFileTypes(AudioInputStream stream)	指定されたオーディオ入力ストリームからこのオーディオ・ファイル・ライターが書込みできるファイル・タイプを取得します。
boolean	isFileTypeSupported(AudioFileFormat.Type fileType)	指定されたファイル・タイプのファイル書込みサポートをこのオーディオ・ファイル・ライターが提供しているかどうかを示します。
boolean	isFileTypeSupported(AudioFileFormat.Type fileType, AudioInputStream stream)	指定されたタイプのオーディオ・ファイルを示されたオーディオ入力ストリームから書込み可能かどうかを示します。
abstract int	write(AudioInputStream stream, AudioFileFormat.Type fileType, File out)	指定されたファイル形式のオーディオ・ファイルを表すバイト・ストリームを、指定された外部ファイルへ書き込みます。
abstract int	write(AudioInputStream stream, AudioFileFormat.Type fileType, OutputStream out)	指定されたファイル・タイプのオーディオ・ファイルを表すバイトのストリームを、指定された出力ストリームへ書き込みます。

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

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

コンストラクタの詳細

AudioFileWriter

protected AudioFileWriter()

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

メソッドの詳細

getAudioFileTypes

public abstract AudioFileFormat.Type[] getAudioFileTypes()

このオーディオ・ファイル・ライターがファイル書込みサポートを提供するファイル・タイプを取得します。

戻り値:

ファイル・タイプの配列。 サポートされているファイル・タイプがない場合、長さ0の配列が返される。

isFileTypeSupported

public boolean isFileTypeSupported(AudioFileFormat.Type fileType)

指定されたファイル・タイプのファイル書込みサポートをこのオーディオ・ファイル・ライターが提供しているかどうかを示します。

パラメータ:

fileType - 書込み機能が照会されるファイル・タイプ

戻り値:

ファイル・タイプがサポートされている場合はtrue、そうでない場合はfalse

例外:

NullPointerException - fileTypeがnullの場合

getAudioFileTypes

public abstract AudioFileFormat.Type[] getAudioFileTypes(AudioInputStream stream)

指定されたオーディオ入力ストリームからこのオーディオ・ファイル・ライターが書込みできるファイル・タイプを取得します。

パラメータ:

stream - オーディオ・ファイル・タイプのサポートが照会されるオーディオ入力ストリーム

戻り値:

ファイル・タイプの配列。 サポートされているファイル・タイプがない場合、長さ0の配列が返される。

例外:

NullPointerException - streamがnullの場合

isFileTypeSupported

public boolean isFileTypeSupported(AudioFileFormat.Type fileType, AudioInputStream stream)

指定されたタイプのオーディオ・ファイルを示されたオーディオ入力ストリームから書込み可能かどうかを示します。

パラメータ:

fileType - 書込み機能が照会されるファイル・タイプ

stream - ファイル書込みサポートの照会対象

戻り値:

ファイル・タイプがこのオーディオ入力ストリームに対してサポートされている場合はtrue、そうでない場合はfalse

例外:

NullPointerException - fileTypeまたはstreamがnullの場合

write

public abstract int write(AudioInputStream stream, AudioFileFormat.Type fileType, OutputStream out) throws IOException

指定されたファイル・タイプのオーディオ・ファイルを表すバイトのストリームを、指定された出力ストリームへ書き込みます。 ファイル・タイプによっては長さをファイル・ヘッダーに書き込む必要があり、あらかじめ長さがわかっていないと最初から最後まで書き込むことができません。 このようなファイル・タイプの書込みは、オーディオ・ファイル形式の長さがAudioSystem.NOT_SPECIFIEDの場合、IOExceptionで失敗します。

パラメータ:

stream - 出力ストリームに書き込まれるオーディオ・データを含むオーディオ入力ストリーム

fileType - 出力ストリームへ書き込まれるファイル・タイプ

out - ファイル・データが書き込まれるストリーム

戻り値:

出力ストリームへ書き込まれるバイト数

例外:

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

IllegalArgumentException - システムがそのファイル・タイプをサポートしていない場合

NullPointerException - streamまたはfileTypeまたはoutがnull

関連項目:

• isFileTypeSupported(Type, AudioInputStream)
• getAudioFileTypes()

write

public abstract int write(AudioInputStream stream, AudioFileFormat.Type fileType, File out) throws IOException

指定されたファイル形式のオーディオ・ファイルを表すバイト・ストリームを、指定された外部ファイルへ書き込みます。

パラメータ:

stream - ファイルに書き込まれるオーディオ・データを含むオーディオ入力ストリーム

fileType - ファイルへ書き込まれるファイル・タイプ

out - ファイル・データが書き込まれる外部ファイル

戻り値:

ファイルへ書き込まれるバイト数

例外:

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

IllegalArgumentException - システムがそのファイル形式をサポートしていない場合

NullPointerException - streamまたはfileTypeまたはoutがnull

関連項目:

• isFileTypeSupported(Type, AudioInputStream)
• getAudioFileTypes()