- java.lang.Object
-
- javax.sound.sampled.spi.AudioFileWriter
-
public abstract class AudioFileWriter extends Object
Provider for audio file writing services. Classes providing concrete implementations can write one or more types of audio file from an audio stream.- Since:
- 1.3
-
-
Constructor Summary
Constructors Constructor and Description AudioFileWriter()
-
Method Summary
Methods Modifier and Type Method and Description abstract AudioFileFormat.Type[]
getAudioFileTypes()
Obtains the file types for which file writing support is provided by this audio file writer.abstract AudioFileFormat.Type[]
getAudioFileTypes(AudioInputStream stream)
Obtains the file types that this audio file writer can write from the audio input stream specified.boolean
isFileTypeSupported(AudioFileFormat.Type fileType)
Indicates whether file writing support for the specified file type is provided by this audio file writer.boolean
isFileTypeSupported(AudioFileFormat.Type fileType, AudioInputStream stream)
Indicates whether an audio file of the type specified can be written from the audio input stream indicated.abstract int
write(AudioInputStream stream, AudioFileFormat.Type fileType, File out)
Writes a stream of bytes representing an audio file of the file format indicated to the external file provided.abstract int
write(AudioInputStream stream, AudioFileFormat.Type fileType, OutputStream out)
Writes a stream of bytes representing an audio file of the file type indicated to the output stream provided.
-
-
-
Method Detail
-
getAudioFileTypes
public abstract AudioFileFormat.Type[] getAudioFileTypes()
Obtains the file types for which file writing support is provided by this audio file writer.- Returns:
- array of file types. If no file types are supported, an array of length 0 is returned.
-
isFileTypeSupported
public boolean isFileTypeSupported(AudioFileFormat.Type fileType)
Indicates whether file writing support for the specified file type is provided by this audio file writer.- Parameters:
fileType
- the file type for which write capabilities are queried- Returns:
true
if the file type is supported, otherwisefalse
-
getAudioFileTypes
public abstract AudioFileFormat.Type[] getAudioFileTypes(AudioInputStream stream)
Obtains the file types that this audio file writer can write from the audio input stream specified.- Parameters:
stream
- the audio input stream for which audio file type support is queried- Returns:
- array of file types. If no file types are supported, an array of length 0 is returned.
-
isFileTypeSupported
public boolean isFileTypeSupported(AudioFileFormat.Type fileType, AudioInputStream stream)
Indicates whether an audio file of the type specified can be written from the audio input stream indicated.- Parameters:
fileType
- file type for which write capabilities are queriedstream
- for which file writing support is queried- Returns:
true
if the file type is supported for this audio input stream, otherwisefalse
-
write
public abstract int write(AudioInputStream stream, AudioFileFormat.Type fileType, OutputStream out) throws IOException
Writes a stream of bytes representing an audio file of the file type indicated to the output stream provided. Some file types require that the length be written into the file header, and cannot be written from start to finish unless the length is known in advance. An attempt to write such a file type will fail with an IOException if the length in the audio file format isAudioSystem.NOT_SPECIFIED
.- Parameters:
stream
- the audio input stream containing audio data to be written to the output streamfileType
- file type to be written to the output streamout
- stream to which the file data should be written- Returns:
- the number of bytes written to the output stream
- Throws:
IOException
- if an I/O exception occursIllegalArgumentException
- if the file type is not supported by the system- See Also:
isFileTypeSupported(AudioFileFormat.Type, AudioInputStream)
,getAudioFileTypes()
-
write
public abstract int write(AudioInputStream stream, AudioFileFormat.Type fileType, File out) throws IOException
Writes a stream of bytes representing an audio file of the file format indicated to the external file provided.- Parameters:
stream
- the audio input stream containing audio data to be written to the filefileType
- file type to be written to the fileout
- external file to which the file data should be written- Returns:
- the number of bytes written to the file
- Throws:
IOException
- if an I/O exception occursIllegalArgumentException
- if the file format is not supported by the system- See Also:
isFileTypeSupported(javax.sound.sampled.AudioFileFormat.Type)
,getAudioFileTypes()
-
-
Document created the 11/06/2005, last modified the 04/03/2020
Source of the printed document:https://www.gaudry.be/en/java-api-rf-javax/sound/sampled/spi/audiofilewriter.html
The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.
References
These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author This site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.