Module java.desktop

Package javax.sound.sampled.spi

Class AudioFileReader

java.lang.Object

javax.sound.sampled.spi.AudioFileReader

       public abstract class AudioFileReader extends Object
      

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

自版本:

1.3

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AudioFileReader()	子类调用的构造函数。

Method Summary

Modifier and Type	Method	Description
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 declared in class java.lang.Object

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

Constructor Details

AudioFileReader

             protected AudioFileReader()
            

子类调用的构造函数。

Method Details

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 - 应构建AudioInputStream的URL

返回:

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

抛出:

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

IOException - 如果发生I/O异常

NullPointerException - 如果url为null

getAudioInputStream

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

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

参数:

file - 应构建AudioInputStream的File

返回:

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

抛出:

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

IOException - 如果发生I/O异常

NullPointerException - 如果file为null