Класс 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)`	Записывает поток байтов, представляющий аудиофайл указанного типа, в предоставленный выходной поток.

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

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

Parameters:

stream - поток аудиоданных, который необходимо записать в файл

fileType - тип файла, который необходимо записать в файл

out - внешний файл, в который необходимо записать данные файла

Returns:

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

Throws:

IOException - если возникает исключение I/O

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

NullPointerException - если stream или fileType или out являются null

See Also:

© 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/AudioFileWriter.html