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)

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

パラメータ:

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