模块 java.desktop

软件包 javax.sound.sampled.spi

Class AudioFileWriter

java.lang.Object

javax.sound.sampled.spi.AudioFileWriter

public abstract class AudioFileWriter
extends Object

音频文件写入服务的提供者。 提供具体实现的类可以从音频流中写入一种或多种类型的音频文件。

从以下版本开始：

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

异常

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

将表示所指示文件类型的音频文件的字节流写入所提供的输出流。 某些文件类型要求将长度写入文件头，并且不能从头到尾写入，除非事先知道长度。 如果音频文件格式的长度为IOException则尝试写入此类文件类型将失败并显示IOException 。

参数

stream - 包含要写入输出流的音频数据的音频输入流

fileType - 要写入输出流的文件类型

out - 应将文件数据写入的流

结果

写入输出流的字节数

异常

IOException - 如果发生I / O异常

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 - 如果发生I / O异常

IllegalArgumentException - 如果系统不支持文件格式

NullPointerException - 如果 stream或 fileType或 out是 null

另请参见：

isFileTypeSupported(Type, AudioInputStream) ， getAudioFileTypes()