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

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

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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/sound/sampled/spi/AudioFileWriter.html