Класс 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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, является ли какой-либо другой объект «равным» этому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Метод финализации устарел и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает значение хеш-кода для этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо истечения определённого промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате уведомления или прерывания, либо истечения определённого промежутка реального времени.

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

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.