Класс AudioFileReader

java.lang.Object

javax.sound.sampled.spi.AudioFileReader

public abstract class AudioFileReader extends Object

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

Начиная с:: 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`.

Методы, объявленные в классе 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.

Параметры:

stream — входной поток, из которого следует извлечь информацию о формате файла

Возвращает:

объект AudioFileFormat с описанием формата аудиофайла

Вызывает исключения:

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

IOException — если возникает исключение ввода-вывода

NullPointerException — если stream имеет значение null

См. также:

getAudioFileFormat

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

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

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

getAudioFileFormat

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

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

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

getAudioInputStream

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

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

Параметры:

stream — входной поток, на основе которого следует создать AudioInputStream

Возвращает:

объект AudioInputStream на основе данных аудиофайла, содержащихся во входном потоке

Вызывает исключения:

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

IOException — если возникает исключение ввода-вывода

NullPointerException — если stream имеет значение null

См. также:

getAudioInputStream

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

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

Параметры:: url — URL, для которого следует создать AudioInputStream
Возвращает:: объект AudioInputStream на основе данных аудиофайла, на которые указывает URL
Вызывает исключения:: UnsupportedAudioFileException — если URL не указывает на допустимые данные аудиофайла, распознаваемые системой; IOException — если возникает исключение ввода-вывода; NullPointerException — если url имеет значение null

getAudioInputStream

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

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

Параметры:: file — File, для которого следует создать AudioInputStream
Возвращает:: объект AudioInputStream на основе данных аудиофайла, на которые указывает File
Вызывает исключения:: UnsupportedAudioFileException — если File не указывает на допустимые данные аудиофайла, распознаваемые системой; IOException — если возникает исключение ввода-вывода; NullPointerException — если file имеет значение null

© 1993, 2025, 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/25/docs/api/java.desktop/javax/sound/sampled/spi/AudioFileReader.html