src/share/classes/javax/sound/sampled/spi/AudioFileReader.java

Print this page

        

*** 1,7 **** /* ! * Copyright (c) 1999, 2002, 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 --- 1,7 ---- /* ! * Copyright (c) 1999, 2014, 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
*** 43,137 **** * @since 1.3 */ public abstract class AudioFileReader { /** ! * Obtains the audio file format of the input stream provided. The stream must ! * point to valid audio file data. In general, audio file readers may * need to read some data from the stream before determining whether they ! * support it. These parsers must ! * be able to mark the stream, read enough data to determine whether they ! * support the stream, and, if not, reset the stream's read pointer to its original ! * position. If the input stream does not support this, this method may fail ! * with an <code>IOException</code>. ! * @param stream the input stream from which file format information should be ! * extracted ! * @return an <code>AudioFileFormat</code> object describing the audio file format ! * @throws UnsupportedAudioFileException if the stream does not point to valid audio ! * file data recognized by the system * @throws IOException if an I/O exception occurs * @see InputStream#markSupported * @see InputStream#mark */ ! public abstract AudioFileFormat getAudioFileFormat(InputStream stream) throws UnsupportedAudioFileException, IOException; /** ! * Obtains the audio file format of the URL provided. The URL must ! * point to valid audio file data. * @param url the URL from which file format information should be * extracted ! * @return an <code>AudioFileFormat</code> object describing the audio file format ! * @throws UnsupportedAudioFileException if the URL does not point to valid audio ! * file data recognized by the system * @throws IOException if an I/O exception occurs */ ! public abstract AudioFileFormat getAudioFileFormat(URL url) throws UnsupportedAudioFileException, IOException; /** ! * Obtains the audio file format of the <code>File</code> provided. The <code>File</code> must ! * point to valid audio file data. ! * @param file the <code>File</code> from which file format information should be ! * extracted ! * @return an <code>AudioFileFormat</code> object describing the audio file format ! * @throws UnsupportedAudioFileException if the <code>File</code> does not point to valid audio ! * file data recognized by the system * @throws IOException if an I/O exception occurs */ ! public abstract AudioFileFormat getAudioFileFormat(File file) throws UnsupportedAudioFileException, IOException; /** ! * Obtains an audio input stream from the input stream provided. The stream must ! * point to valid audio file data. In general, audio file readers may * need to read some data from the stream before determining whether they ! * support it. These parsers must ! * be able to mark the stream, read enough data to determine whether they ! * support the stream, and, if not, reset the stream's read pointer to its original ! * position. If the input stream does not support this, this method may fail ! * with an <code>IOException</code>. ! * @param stream the input stream from which the <code>AudioInputStream</code> should be ! * constructed ! * @return an <code>AudioInputStream</code> object based on the audio file data contained ! * in the input stream. ! * @throws UnsupportedAudioFileException if the stream does not point to valid audio ! * file data recognized by the system * @throws IOException if an I/O exception occurs * @see InputStream#markSupported * @see InputStream#mark */ ! public abstract AudioInputStream getAudioInputStream(InputStream stream) throws UnsupportedAudioFileException, IOException; /** ! * Obtains an audio input stream from the URL provided. The URL must ! * point to valid audio file data. ! * @param url the URL for which the <code>AudioInputStream</code> should be * constructed ! * @return an <code>AudioInputStream</code> object based on the audio file data pointed ! * to by the URL ! * @throws UnsupportedAudioFileException if the URL does not point to valid audio ! * file data recognized by the system * @throws IOException if an I/O exception occurs */ ! public abstract AudioInputStream getAudioInputStream(URL url) throws UnsupportedAudioFileException, IOException; /** ! * Obtains an audio input stream from the <code>File</code> provided. The <code>File</code> must ! * point to valid audio file data. ! * @param file the <code>File</code> for which the <code>AudioInputStream</code> should be ! * constructed ! * @return an <code>AudioInputStream</code> object based on the audio file data pointed ! * to by the File ! * @throws UnsupportedAudioFileException if the <code>File</code> does not point to valid audio ! * file data recognized by the system * @throws IOException if an I/O exception occurs */ ! public abstract AudioInputStream getAudioInputStream(File file) throws UnsupportedAudioFileException, IOException; } --- 43,150 ---- * @since 1.3 */ public abstract class AudioFileReader { /** ! * Obtains the audio file format of the input stream provided. The stream ! * must point to valid audio file data. In general, audio file readers may * need to read some data from the stream before determining whether they ! * support it. These parsers must be able to mark the stream, read enough ! * data to determine whether they support the stream, and, if not, reset the ! * stream's read pointer to its original position. If the input stream does ! * not support this, this method may fail with an {@code IOException}. ! * ! * @param stream the input stream from which file format information should ! * be extracted ! * @return an {@code AudioFileFormat} object describing the audio file ! * format ! * @throws UnsupportedAudioFileException if the stream does not point to ! * valid audio file data recognized by the system * @throws IOException if an I/O exception occurs * @see InputStream#markSupported * @see InputStream#mark */ ! public abstract AudioFileFormat getAudioFileFormat(InputStream stream) ! throws UnsupportedAudioFileException, IOException; /** ! * Obtains the audio file format of the URL provided. The URL must point to ! * valid audio file data. ! * * @param url the URL from which file format information should be * extracted ! * @return an {@code AudioFileFormat} object describing the audio file ! * format ! * @throws UnsupportedAudioFileException if the URL does not point to valid ! * audio file data recognized by the system * @throws IOException if an I/O exception occurs */ ! public abstract AudioFileFormat getAudioFileFormat(URL url) ! throws UnsupportedAudioFileException, IOException; /** ! * Obtains the audio file format of the {@code File} provided. ! * The {@code File} must point to valid audio file data. ! * ! * @param file the {@code File} from which file format information ! * should be extracted ! * @return an {@code AudioFileFormat} object describing the audio file ! * format ! * @throws UnsupportedAudioFileException if the {@code File} does not point ! * to valid audio file data recognized by the system * @throws IOException if an I/O exception occurs */ ! public abstract AudioFileFormat getAudioFileFormat(File file) ! throws UnsupportedAudioFileException, IOException; /** ! * Obtains an audio input stream from the input stream provided. The stream ! * must point to valid audio file data. In general, audio file readers may * need to read some data from the stream before determining whether they ! * support it. These parsers must be able to mark the stream, read enough ! * data to determine whether they support the stream, and, if not, reset the ! * stream's read pointer to its original position. If the input stream does ! * not support this, this method may fail with an {@code IOException}. ! * ! * @param stream the input stream from which the {@code AudioInputStream} ! * should be constructed ! * @return an {@code AudioInputStream} object based on the audio file data ! * contained in the input stream. ! * @throws UnsupportedAudioFileException if the stream does not point to ! * valid audio file data recognized by the system * @throws IOException if an I/O exception occurs * @see InputStream#markSupported * @see InputStream#mark */ ! public abstract AudioInputStream getAudioInputStream(InputStream stream) ! throws UnsupportedAudioFileException, IOException; /** ! * Obtains an audio input stream from the URL provided. The URL must point ! * to valid audio file data. ! * ! * @param url the URL for which the {@code AudioInputStream} should be * constructed ! * @return an {@code AudioInputStream} object based on the audio file data ! * pointed to by the URL ! * @throws UnsupportedAudioFileException if the URL does not point to valid ! * audio file data recognized by the system * @throws IOException if an I/O exception occurs */ ! public abstract AudioInputStream getAudioInputStream(URL url) ! throws UnsupportedAudioFileException, IOException; /** ! * Obtains an audio input stream from the {@code File} provided. ! * The {@code File} must point to valid audio file data. ! * ! * @param file the {@code File} for which the {@code AudioInputStream} ! * should be constructed ! * @return an {@code AudioInputStream} object based on the audio file data ! * pointed to by the File ! * @throws UnsupportedAudioFileException if the {@code File} does not point ! * to valid audio file data recognized by the system * @throws IOException if an I/O exception occurs */ ! public abstract AudioInputStream getAudioInputStream(File file) ! throws UnsupportedAudioFileException, IOException; }