Класс AudioFileReader

java.lang.Object
- javax.sound.sampled.spi.AudioFileReader

public abstract class AudioFileReader
extends Object

Поставщик для чтения аудиофайлов. Классы, предоставляющие конкретные реализации, могут анализировать информацию о формате из одного или нескольких типов аудиофайлов и могут создавать потоки аудиоввода из файлов этих типов.

Since:: 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.

Parameters:: stream - входной поток, из которого должна быть извлечена информация о формате файла
Returns:: объект AudioFileFormat, описывающий формат аудиофайла
Throws:: UnsupportedAudioFileException - если поток не указывает на данные валидного аудиофайла, распознанного системой; IOException - если произошла ошибка ввода-вывода; NullPointerException - если stream является null
See Also:: InputStream.markSupported(), InputStream.mark(int)

getAudioFileFormat

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

Получает формат аудиофайла предоставленного URL. URL должен указывать на данные валидного аудиофайла.

Parameters:: url - URL, из которого должна быть извлечена информация о формате файла
Returns:: объект AudioFileFormat, описывающий формат аудиофайла
Throws:: UnsupportedAudioFileException - если URL не указывает на данные валидного аудиофайла, распознанного системой; IOException - если произошла ошибка ввода-вывода; NullPointerException - если url является null

getAudioFileFormat

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

Получает формат аудиофайла предоставленного File. File должен указывать на данные валидного аудиофайла.

Parameters:: file - File, из которого должна быть извлечена информация о формате файла
Returns:: объект AudioFileFormat, описывающий формат аудиофайла
Throws:: UnsupportedAudioFileException - если File не указывает на данные валидного аудиофайла, распознанного системой; IOException - если произошла ошибка ввода-вывода; NullPointerException - если file является null

getAudioInputStream

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

Получает поток аудиоввода из предоставленного входного потока. Поток должен указывать на данные валидного аудиофайла. В общем случае, читатели аудиофайлов могут потребовать прочитать некоторые данные из потока, прежде чем определить, поддерживают ли они его. Эти парсеры должны уметь помечать поток, прочитать достаточное количество данных, чтобы определить, поддерживают ли они поток, и сбросить указатель чтения потока в его исходное положение. Если входной поток не поддерживает это, этот метод может завершиться ошибкой IOException.

Parameters:: stream - входной поток, из которого должен быть построен AudioInputStream
Returns:: объект AudioInputStream, основанный на данных аудиофайла, содержащихся в входном потоке
Throws:: UnsupportedAudioFileException - если поток не указывает на данные валидного аудиофайла, распознанного системой; IOException - если произошла ошибка ввода-вывода; NullPointerException - если stream является null
See Also:: InputStream.markSupported(), InputStream.mark(int)

getAudioInputStream

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

Получает поток аудиоввода из предоставленного URL. URL должен указывать на данные валидного аудиофайла.

Parameters:: url - URL, для которого должен быть построен AudioInputStream
Returns:: объект AudioInputStream, основанный на данных аудиофайла, на которые указывает URL
Throws:: UnsupportedAudioFileException - если URL не указывает на данные валидного аудиофайла, распознанного системой; IOException - если произошла ошибка ввода-вывода; NullPointerException - если url является null

getAudioInputStream

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

Получает поток аудиоввода из предоставленного File. File должен указывать на данные валидного аудиофайла.

Parameters:: file - File, для которого должен быть построен AudioInputStream
Returns:: объект AudioInputStream, основанный на данных аудиофайла, на которые указывает файл
Throws:: UnsupportedAudioFileException - если File не указывает на данные валидного аудиофайла, распознанного системой; IOException - если произошла ошибка ввода-вывода; NullPointerException - если file является null