javax.sound.sampled.spi

クラス AudioFileWriter

java.lang.Object

javax.sound.sampled.spi.AudioFileWriter

public abstract class AudioFileWriter
extends Object

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

導入されたバージョン:

1.3

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

コンストラクタ

コンストラクタと説明
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

public AudioFileWriter()

メソッドの詳細

getAudioFileTypes

public abstract AudioFileFormat.Type[] getAudioFileTypes()

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

戻り値:

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

isFileTypeSupported

public boolean isFileTypeSupported(AudioFileFormat.Type fileType)

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

パラメータ:

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

戻り値:

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

getAudioFileTypes

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

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

パラメータ:

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

戻り値:

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

isFileTypeSupported

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

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

パラメータ:

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

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

戻り値:

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

write

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

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

パラメータ:

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

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

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

戻り値:

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

例外:

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

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

関連項目:

isFileTypeSupported(AudioFileFormat.Type, AudioInputStream), getAudioFileTypes()

write

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

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

パラメータ:

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

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

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

戻り値:

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

例外:

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

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

関連項目:

isFileTypeSupported(javax.sound.sampled.AudioFileFormat.Type), getAudioFileTypes()