Module java.desktop

软件包 javax.sound.sampled.spi

Class AudioFileReader

java.lang.Object

javax.sound.sampled.spi.AudioFileReader

public abstract class AudioFileReader
extends Object

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

从以下版本开始：

1.3

构造方法摘要

构造方法

Constructor	描述
AudioFileReader()

方法摘要

Modifier and Type	方法	描述
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获取音频输入流。

Methods inherited from class 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应当建立

结果

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

异常

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

IOException - 如果发生I / O异常

NullPointerException - 如果 url是 null

getAudioInputStream

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

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

参数

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

结果

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

异常

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

IOException - 如果发生I / O异常

NullPointerException - 如果 file是 null