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()