模块 java.desktop

软件包 javax.sound.sampled.spi

Class AudioFileReader

java.lang.Object

javax.sound.sampled.spi.AudioFileReader

public abstract class AudioFileReaderextends Object

音频文件阅读服务提供商。 提供具体实现的类可以解析来自一种或多种类型的音频文件的格式信息，并且可以从这些类型的文件产生音频输入流。

从以下版本开始：

1.3

构造方法摘要

构造方法

构造器	描述
AudioFileReader()

方法摘要

变量和类型	方法	描述
abstract AudioFileFormat	getAudioFileFormat(File file)	获得所提供的 File的音频文件格式。
abstract AudioFileFormat	getAudioFileFormat(InputStream stream)	获得提供的输入流的音频文件格式。
abstract AudioFileFormat	getAudioFileFormat(URL url)	获得所提供的 URL的音频文件格式。
abstract AudioInputStream	getAudioInputStream(File file)	从提供的 File获取音频输入流。
abstract AudioInputStream	getAudioInputStream(InputStream stream)	从提供的输入流中获取音频输入流。
abstract AudioInputStream	getAudioInputStream(URL url)	从提供的 URL获取音频输入流。

声明方法的类 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造方法详细信息

AudioFileReader

public AudioFileReader()

方法详细信息

getAudioFileFormat

public abstract AudioFileFormat getAudioFileFormat(InputStream stream)                                            throws UnsupportedAudioFileException,                                                   IOException

获得提供的输入流的音频文件格式。 流必须指向有效的音频文件数据。 通常，音频文件读取器可能需要在确定它们是否支持它之前从流中读取一些数据。 这些解析器必须能够标记流，读取足够的数据以确定它们是否支持流，并将流的读指针重置为其原始位置。 如果输入流不支持此方法，则此方法可能会失败，并显示IOException 。

参数

stream - 应从中提取文件格式信息的输入流

结果

描述音频文件格式的 AudioFileFormat对象

异常

UnsupportedAudioFileException - 如果流未指向系统识别的有效音频文件数据

IOException - 如果发生I / O异常

NullPointerException - 如果 stream是 null

另请参见：

InputStream.markSupported() ， InputStream.mark(int)

getAudioFileFormat

public abstract AudioFileFormat getAudioFileFormat(URL url)                                            throws UnsupportedAudioFileException,                                                   IOException

获得所提供的URL的音频文件格式。 URL必须指向有效的音频文件数据。

参数

url - 应从中提取文件格式信息的 URL

结果

描述音频文件格式的 AudioFileFormat对象

异常

UnsupportedAudioFileException - 如果 URL未指向系统识别的有效音频文件数据

IOException - 如果发生I / O异常

NullPointerException - 如果 url是 null

getAudioFileFormat

public abstract AudioFileFormat getAudioFileFormat(File file)                                            throws UnsupportedAudioFileException,                                                   IOException

获得所提供的File的音频文件格式。 File必须指向有效的音频文件数据。

参数

file - 应从中提取文件格式信息的 File

结果

描述音频文件格式的 AudioFileFormat对象

异常

UnsupportedAudioFileException - 如果 File未指向系统识别的有效音频文件数据

IOException - 如果发生I / O异常

NullPointerException - 如果 file是 null

getAudioInputStream

public abstract AudioInputStream getAudioInputStream(InputStream stream)                                              throws UnsupportedAudioFileException,                                                     IOException

从提供的输入流中获取音频输入流。 流必须指向有效的音频文件数据。 通常，音频文件读取器可能需要在确定它们是否支持它之前从流中读取一些数据。 这些解析器必须能够标记流，读取足够的数据以确定它们是否支持流，并将流的读指针重置为其原始位置。 如果输入流不支持此方法，则此方法可能会失败，并显示IOException 。

参数

stream -从该输入流 AudioInputStream应当被构造

结果

基于输入流中包含的音频文件数据的 AudioInputStream对象

异常

UnsupportedAudioFileException - 如果流未指向系统识别的有效音频文件数据

IOException - 如果发生I / O异常

NullPointerException - 如果 stream是 null

另请参见：

InputStream.markSupported() ， InputStream.mark(int)

getAudioInputStream

public abstract AudioInputStream getAudioInputStream(URL url)                                              throws UnsupportedAudioFileException,                                                     IOException

从提供的URL获得音频输入流。 URL必须指向有效的音频文件数据。

参数

url -所述 URL的量， AudioInputStream应当被构造

结果

一个 AudioInputStream基于音频文件数据对象指向的 URL

异常

UnsupportedAudioFileException - 如果 URL未指向系统识别的有效音频文件数据

IOException - 如果发生I / O异常

NullPointerException - 如果 url是 null

getAudioInputStream

public abstract AudioInputStream getAudioInputStream(File file)                                              throws UnsupportedAudioFileException,                                                     IOException

从提供的File获得音频输入流。 File必须指向有效的音频文件数据。

参数

file -所述 File的量， AudioInputStream应当被构造

结果

一个 AudioInputStream对象，基于File指向的音频文件数据

异常

UnsupportedAudioFileException - 如果 File未指向系统识别的有效音频文件数据

IOException - 如果发生I / O异常

NullPointerException - 如果 file是 null