0N/A/*
2362N/A * Copyright (c) 1999, 2002, Oracle and/or its affiliates. All rights reserved.
0N/A * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
0N/A *
0N/A * This code is free software; you can redistribute it and/or modify it
0N/A * under the terms of the GNU General Public License version 2 only, as
2362N/A * published by the Free Software Foundation. Oracle designates this
0N/A * particular file as subject to the "Classpath" exception as provided
2362N/A * by Oracle in the LICENSE file that accompanied this code.
0N/A *
0N/A * This code is distributed in the hope that it will be useful, but WITHOUT
0N/A * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
0N/A * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
0N/A * version 2 for more details (a copy is included in the LICENSE file that
0N/A * accompanied this code).
0N/A *
0N/A * You should have received a copy of the GNU General Public License version
0N/A * 2 along with this work; if not, write to the Free Software Foundation,
0N/A * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
0N/A *
2362N/A * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
2362N/A * or visit www.oracle.com if you need additional information or have any
2362N/A * questions.
0N/A */
0N/A
0N/Apackage javax.sound.sampled.spi;
0N/A
0N/Aimport java.io.File;
0N/Aimport java.io.InputStream;
0N/Aimport java.io.IOException;
0N/Aimport java.net.URL;
0N/A
0N/Aimport javax.sound.sampled.AudioFileFormat;
0N/Aimport javax.sound.sampled.AudioInputStream;
0N/Aimport javax.sound.sampled.UnsupportedAudioFileException;
0N/A
0N/A/**
0N/A * Provider for audio file reading services. Classes providing concrete
0N/A * implementations can parse the format information from one or more types of
0N/A * audio file, and can produce audio input streams from files of these types.
0N/A *
0N/A * @author Kara Kytle
0N/A * @since 1.3
0N/A */
0N/Apublic abstract class AudioFileReader {
0N/A
0N/A /**
0N/A * Obtains the audio file format of the input stream provided. The stream must
0N/A * point to valid audio file data. In general, audio file readers may
0N/A * need to read some data from the stream before determining whether they
0N/A * support it. These parsers must
0N/A * be able to mark the stream, read enough data to determine whether they
0N/A * support the stream, and, if not, reset the stream's read pointer to its original
0N/A * position. If the input stream does not support this, this method may fail
0N/A * with an <code>IOException</code>.
0N/A * @param stream the input stream from which file format information should be
0N/A * extracted
0N/A * @return an <code>AudioFileFormat</code> object describing the audio file format
0N/A * @throws UnsupportedAudioFileException if the stream does not point to valid audio
0N/A * file data recognized by the system
0N/A * @throws IOException if an I/O exception occurs
0N/A * @see InputStream#markSupported
0N/A * @see InputStream#mark
0N/A */
0N/A public abstract AudioFileFormat getAudioFileFormat(InputStream stream) throws UnsupportedAudioFileException, IOException;
0N/A
0N/A /**
0N/A * Obtains the audio file format of the URL provided. The URL must
0N/A * point to valid audio file data.
0N/A * @param url the URL from which file format information should be
0N/A * extracted
0N/A * @return an <code>AudioFileFormat</code> object describing the audio file format
0N/A * @throws UnsupportedAudioFileException if the URL does not point to valid audio
0N/A * file data recognized by the system
0N/A * @throws IOException if an I/O exception occurs
0N/A */
0N/A public abstract AudioFileFormat getAudioFileFormat(URL url) throws UnsupportedAudioFileException, IOException;
0N/A
0N/A /**
0N/A * Obtains the audio file format of the <code>File</code> provided. The <code>File</code> must
0N/A * point to valid audio file data.
0N/A * @param file the <code>File</code> from which file format information should be
0N/A * extracted
0N/A * @return an <code>AudioFileFormat</code> object describing the audio file format
0N/A * @throws UnsupportedAudioFileException if the <code>File</code> does not point to valid audio
0N/A * file data recognized by the system
0N/A * @throws IOException if an I/O exception occurs
0N/A */
0N/A public abstract AudioFileFormat getAudioFileFormat(File file) throws UnsupportedAudioFileException, IOException;
0N/A
0N/A /**
0N/A * Obtains an audio input stream from the input stream provided. The stream must
0N/A * point to valid audio file data. In general, audio file readers may
0N/A * need to read some data from the stream before determining whether they
0N/A * support it. These parsers must
0N/A * be able to mark the stream, read enough data to determine whether they
0N/A * support the stream, and, if not, reset the stream's read pointer to its original
0N/A * position. If the input stream does not support this, this method may fail
0N/A * with an <code>IOException</code>.
0N/A * @param stream the input stream from which the <code>AudioInputStream</code> should be
0N/A * constructed
0N/A * @return an <code>AudioInputStream</code> object based on the audio file data contained
0N/A * in the input stream.
0N/A * @throws UnsupportedAudioFileException if the stream does not point to valid audio
0N/A * file data recognized by the system
0N/A * @throws IOException if an I/O exception occurs
0N/A * @see InputStream#markSupported
0N/A * @see InputStream#mark
0N/A */
0N/A public abstract AudioInputStream getAudioInputStream(InputStream stream) throws UnsupportedAudioFileException, IOException;
0N/A
0N/A /**
0N/A * Obtains an audio input stream from the URL provided. The URL must
0N/A * point to valid audio file data.
0N/A * @param url the URL for which the <code>AudioInputStream</code> should be
0N/A * constructed
0N/A * @return an <code>AudioInputStream</code> object based on the audio file data pointed
0N/A * to by the URL
0N/A * @throws UnsupportedAudioFileException if the URL does not point to valid audio
0N/A * file data recognized by the system
0N/A * @throws IOException if an I/O exception occurs
0N/A */
0N/A public abstract AudioInputStream getAudioInputStream(URL url) throws UnsupportedAudioFileException, IOException;
0N/A
0N/A /**
0N/A * Obtains an audio input stream from the <code>File</code> provided. The <code>File</code> must
0N/A * point to valid audio file data.
0N/A * @param file the <code>File</code> for which the <code>AudioInputStream</code> should be
0N/A * constructed
0N/A * @return an <code>AudioInputStream</code> object based on the audio file data pointed
0N/A * to by the File
0N/A * @throws UnsupportedAudioFileException if the <code>File</code> does not point to valid audio
0N/A * file data recognized by the system
0N/A * @throws IOException if an I/O exception occurs
0N/A */
0N/A public abstract AudioInputStream getAudioInputStream(File file) throws UnsupportedAudioFileException, IOException;
0N/A}