Module java.desktop

软件包 javax.sound.sampled.spi

Class AudioFileWriter

java.lang.Object

javax.sound.sampled.spi.AudioFileWriter

public abstract class AudioFileWriter
extends Object

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

从以下版本开始：

1.3

构造方法摘要

构造方法

Constructor	描述
AudioFileWriter()

方法摘要

Modifier and Type	方法	描述
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)	写入表示所提供的输出流的文件类型的音频文件的字节流。

Methods inherited from class 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

写入表示所提供的输出流的文件类型的音频文件的字节流。 某些文件类型要求将长度写入文件头，并且不能从头到尾写入，除非事先知道长度。 如果音频文件格式的长度为AudioSystem.NOT_SPECIFIED ，则写入此类文件类型的尝试将失败，并导致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()