Класс AudioFileReader

java.lang.Object

javax.sound.sampled.spi.AudioFileReader

public abstract class AudioFileReader extends Object

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

Since:: 1.3

Краткое описание конструкторов

AudioFileReader()

Модификатор	Конструктор	Описание
`protected`	Конструктор для вызова подклассами.

Краткое описание методов

Модификатор и тип	Метод	Описание
`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

protected AudioFileReader()

Конструктор для вызова подклассами.

Подробное описание методов

getAudioFileFormat

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

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

Parameters:

stream - поток ввода, из которого должна быть извлечена информация о формате файла

Returns:

объект AudioFileFormat, описывающий формат аудиофайла

Throws:

UnsupportedAudioFileException - если поток не указывает на валидные данные аудиофайла, распознанные системой

IOException - если произошла ошибка ввода-вывода

NullPointerException - если stream является null

See Also:

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:

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

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.desktop/javax/sound/sampled/spi/AudioFileReader.html