Класс AudioFileWriter

java.lang.Object
- javax.sound.sampled.spi.AudioFileWriter

public abstract class AudioFileWriter
extends Object

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

С тех пор:: 1.3

Конструкторы

Конструктор	Описание
`AudioFileWriter()`

Методы

Модификатор и тип	Метод	Описание
`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

public 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
См. также:: isFileTypeSupported(Type, AudioInputStream), getAudioFileTypes()

write

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

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

Параметры:: stream - аудиовходной поток, содержащий аудиоданные, которые будут записаны в файл; fileType - тип файла, который должен быть записан в файл; out - внешний файл, в который должны быть записаны данные файла
Возвращает:: количество байтов, записанных в файл
Исключения:: IOException - если произошла ошибка ввода-вывода; IllegalArgumentException - если формат файла не поддерживается системой; NullPointerException - если stream или fileType или out являются null
См. также:: isFileTypeSupported(Type, AudioInputStream), getAudioFileTypes()