Класс 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, основанный на данных аудиофайла, на которые указывает File
Throws:: 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/sound/sampled/spi/AudioFileReader.html