Класс AudioFileWriter

java.lang.Object

javax.sound.sampled.spi.AudioFileWriter

public abstract class AudioFileWriter extends Object

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

Начиная с:: 1.3

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

AudioFileWriter()

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

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

Модификатор и тип	Метод	Описание
`abstract AudioFileFormat.Type[]`	`getAudioFileTypes()`	Возвращает типы файлов, для которых данный модуль записи аудиофайлов поддерживает запись файлов.
`abstract AudioFileFormat.Type[]`	`getAudioFileTypes(AudioInputStream stream)`	Возвращает типы файлов, которые данный модуль записи аудиофайлов может записать из указанного входного аудиопотока.
`boolean`	`isFileTypeSupported(AudioFileFormat.Type fileType)`	Указывает, поддерживает ли данный модуль записи аудиофайлов запись файлов указанного типа.
`boolean`	`isFileTypeSupported(AudioFileFormat.Type fileType, AudioInputStream stream)`	Указывает, можно ли записать аудиофайл указанного типа из указанного входного аудиопотока.
`abstract int`	`write(AudioInputStream stream, AudioFileFormat.Type fileType, File out)`	Записывает в указанный внешний файл поток байтов, представляющий аудиофайл указанного формата.
`abstract int`	`write(AudioInputStream stream, AudioFileFormat.Type fileType, OutputStream out)`	Записывает в указанный выходной поток поток байтов, представляющий аудиофайл указанного типа.

Методы, объявленные в классе 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()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или прерывания, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или прерывания, либо до истечения заданного промежутка реального времени.

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

AudioFileWriter

protected AudioFileWriter()

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

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

getAudioFileTypes

public abstract AudioFileFormat.Type[] getAudioFileTypes()

Возвращает типы файлов, для которых данный модуль записи аудиофайлов поддерживает запись файлов.

Возвращает:: массив типов файлов. Если ни один тип файла не поддерживается, возвращается массив длины 0.

isFileTypeSupported

public boolean isFileTypeSupported(AudioFileFormat.Type fileType)

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

Параметры:: fileType — тип файла, для которого запрашиваются возможности записи
Возвращает:: true, если тип файла поддерживается, иначе false
Вызывает исключение:: NullPointerException — если fileType имеет значение null

getAudioFileTypes

public abstract AudioFileFormat.Type[] getAudioFileTypes(AudioInputStream stream)

Возвращает типы файлов, которые данный модуль записи аудиофайлов может записать из указанного входного аудиопотока.

Параметры:: stream — входной аудиопоток, для которого запрашивается поддержка типов аудиофайлов
Возвращает:: массив типов файлов. Если ни один тип файла не поддерживается, возвращается массив длины 0.
Вызывает исключение:: NullPointerException — если stream имеет значение null

isFileTypeSupported

public boolean isFileTypeSupported(AudioFileFormat.Type fileType, AudioInputStream stream)

Указывает, можно ли записать аудиофайл указанного типа из указанного входного аудиопотока.

Параметры:: fileType — тип файла, для которого запрашиваются возможности записи; stream — поток, для которого запрашивается поддержка записи файлов
Возвращает:: true, если тип файла поддерживается для этого входного аудиопотока, иначе false
Вызывает исключение:: NullPointerException — если fileType или stream имеют значение null

write

public abstract int write(AudioInputStream stream, AudioFileFormat.Type fileType, OutputStream out) throws IOException

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

Параметры:

stream — входной аудиопоток, содержащий аудиоданные для записи в выходной поток

fileType — тип файла для записи в выходной поток

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

Возвращает:

количество байтов, записанных в выходной поток

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

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

IllegalArgumentException — если тип файла не поддерживается системой

NullPointerException — если stream, fileType или out имеют значение null

См. также:

write

public abstract int write(AudioInputStream stream, AudioFileFormat.Type fileType, File out) throws IOException

Записывает во внешний файл поток байтов, представляющий аудиофайл указанного формата.

Параметры:

stream — входной аудиопоток, содержащий аудиоданные для записи в файл

fileType — тип файла для записи в файл

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

Возвращает:

количество байтов, записанных в файл

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

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

IllegalArgumentException — если формат файла не поддерживается системой

NullPointerException — если stream, fileType или out имеют значение 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.