/*
 * Copyright (c) 1999, 2020, Oracle and/or its affiliates. All rights reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * This code is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software Foundation.  Oracle designates this
 * particular file as subject to the "Classpath" exception as provided
 * by Oracle in the LICENSE file that accompanied this code.
 *
 * This code is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
 * version 2 for more details (a copy is included in the LICENSE file that
 * accompanied this code).
 *
 * You should have received a copy of the GNU General Public License version
 * 2 along with this work; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 *
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
 * or visit www.oracle.com if you need additional information or have any
 * questions.
 */

package javax.sound.sampled.spi;

import java.io.File;
import java.io.IOException;
import java.io.OutputStream;
import java.util.Arrays;

import javax.sound.sampled.AudioInputStream;
import javax.sound.sampled.AudioSystem;

import static javax.sound.sampled.AudioFileFormat.Type;

Provider for audio file writing services. Classes providing concrete implementations can write one or more types of audio file from an audio stream.
Author:Kara Kytle
Since:1.3
/** * Provider for audio file writing services. Classes providing concrete * implementations can write one or more types of audio file from an audio * stream. * * @author Kara Kytle * @since 1.3 */
public abstract class AudioFileWriter {
Constructor for subclasses to call.
/** * Constructor for subclasses to call. */
protected AudioFileWriter() {}
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.
/** * Obtains the file types for which file writing support is provided by this * audio file writer. * * @return array of file types. If no file types are supported, an array of * length 0 is returned. */
public abstract Type[] getAudioFileTypes();
Indicates whether file writing support for the specified file type is provided by this audio file writer.
Params:
  • fileType – the file type for which write capabilities are queried
Throws:
Returns:true if the file type is supported, otherwise false
/** * Indicates whether file writing support for the specified file type is * provided by this audio file writer. * * @param fileType the file type for which write capabilities are queried * @return {@code true} if the file type is supported, otherwise * {@code false} * @throws NullPointerException if {@code fileType} is {@code null} */
public boolean isFileTypeSupported(final Type fileType) { return Arrays.stream(getAudioFileTypes()).anyMatch(fileType::equals); }
Obtains the file types that this audio file writer can write from the audio input stream specified.
Params:
  • stream – the audio input stream for which audio file type support is queried
Throws:
Returns:array of file types. If no file types are supported, an array of length 0 is returned.
/** * Obtains the file types that this audio file writer can write from the * audio input stream specified. * * @param stream the audio input stream for which audio file type support * is queried * @return array of file types. If no file types are supported, an array of * length 0 is returned. * @throws NullPointerException if {@code stream} is {@code null} */
public abstract Type[] getAudioFileTypes(AudioInputStream stream);
Indicates whether an audio file of the type specified can be written from the audio input stream indicated.
Params:
  • fileType – file type for which write capabilities are queried
  • stream – for which file writing support is queried
Throws:
Returns:true if the file type is supported for this audio input stream, otherwise false
/** * Indicates whether an audio file of the type specified can be written from * the audio input stream indicated. * * @param fileType file type for which write capabilities are queried * @param stream for which file writing support is queried * @return {@code true} if the file type is supported for this audio input * stream, otherwise {@code false} * @throws NullPointerException if {@code fileType} or {@code stream} are * {@code null} */
public boolean isFileTypeSupported(final Type fileType, final AudioInputStream stream) { return Arrays.stream(getAudioFileTypes(stream)) .anyMatch(fileType::equals); }
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 is AudioSystem.NOT_SPECIFIED.
Params:
  • stream – the audio input stream containing audio data to be written to the output stream
  • fileType – file type to be written to the output stream
  • out – stream to which the file data should be written
Throws:
See Also:
Returns:the number of bytes written to the output stream
/** * 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 {@code IOException} if the length in the * audio file format is {@link AudioSystem#NOT_SPECIFIED}. * * @param stream the audio input stream containing audio data to be written * to the output stream * @param fileType file type to be written to the output stream * @param out stream to which the file data should be written * @return the number of bytes written to the output stream * @throws IOException if an I/O exception occurs * @throws IllegalArgumentException if the file type is not supported by the * system * @throws NullPointerException if {@code stream} or {@code fileType} or * {@code out} are {@code null} * @see #isFileTypeSupported(Type, AudioInputStream) * @see #getAudioFileTypes */
public abstract int write(AudioInputStream stream, Type fileType, OutputStream out) throws IOException;
Writes a stream of bytes representing an audio file of the file format indicated to the external file provided.
Params:
  • stream – the audio input stream containing audio data to be written to the file
  • fileType – file type to be written to the file
  • out – external file to which the file data should be written
Throws:
See Also:
Returns:the number of bytes written to the file
/** * Writes a stream of bytes representing an audio file of the file format * indicated to the external file provided. * * @param stream the audio input stream containing audio data to be written * to the file * @param fileType file type to be written to the file * @param out external file to which the file data should be written * @return the number of bytes written to the file * @throws IOException if an I/O exception occurs * @throws IllegalArgumentException if the file format is not supported by * the system * @throws NullPointerException if {@code stream} or {@code fileType} or * {@code out} are {@code null} * @see #isFileTypeSupported(Type, AudioInputStream) * @see #getAudioFileTypes */
public abstract int write(AudioInputStream stream, Type fileType, File out) throws IOException; }