91 * format
92 * @throws UnsupportedAudioFileException if the {@code File} does not point
93 * to valid audio file data recognized by the system
94 * @throws IOException if an I/O exception occurs
95 */
96 public abstract AudioFileFormat getAudioFileFormat(File file)
97 throws UnsupportedAudioFileException, IOException;
98
99 /**
100 * Obtains an audio input stream from the input stream provided. The stream
101 * must point to valid audio file data. In general, audio file readers may
102 * need to read some data from the stream before determining whether they
103 * support it. These parsers must be able to mark the stream, read enough
104 * data to determine whether they support the stream, and, if not, reset the
105 * stream's read pointer to its original position. If the input stream does
106 * not support this, this method may fail with an {@code IOException}.
107 *
108 * @param stream the input stream from which the {@code AudioInputStream}
109 * should be constructed
110 * @return an {@code AudioInputStream} object based on the audio file data
111 * contained in the input stream.
112 * @throws UnsupportedAudioFileException if the stream does not point to
113 * valid audio file data recognized by the system
114 * @throws IOException if an I/O exception occurs
115 * @see InputStream#markSupported
116 * @see InputStream#mark
117 */
118 public abstract AudioInputStream getAudioInputStream(InputStream stream)
119 throws UnsupportedAudioFileException, IOException;
120
121 /**
122 * Obtains an audio input stream from the URL provided. The URL must point
123 * to valid audio file data.
124 *
125 * @param url the URL for which the {@code AudioInputStream} should be
126 * constructed
127 * @return an {@code AudioInputStream} object based on the audio file data
128 * pointed to by the URL
129 * @throws UnsupportedAudioFileException if the URL does not point to valid
130 * audio file data recognized by the system
131 * @throws IOException if an I/O exception occurs
|
91 * format
92 * @throws UnsupportedAudioFileException if the {@code File} does not point
93 * to valid audio file data recognized by the system
94 * @throws IOException if an I/O exception occurs
95 */
96 public abstract AudioFileFormat getAudioFileFormat(File file)
97 throws UnsupportedAudioFileException, IOException;
98
99 /**
100 * Obtains an audio input stream from the input stream provided. The stream
101 * must point to valid audio file data. In general, audio file readers may
102 * need to read some data from the stream before determining whether they
103 * support it. These parsers must be able to mark the stream, read enough
104 * data to determine whether they support the stream, and, if not, reset the
105 * stream's read pointer to its original position. If the input stream does
106 * not support this, this method may fail with an {@code IOException}.
107 *
108 * @param stream the input stream from which the {@code AudioInputStream}
109 * should be constructed
110 * @return an {@code AudioInputStream} object based on the audio file data
111 * contained in the input stream
112 * @throws UnsupportedAudioFileException if the stream does not point to
113 * valid audio file data recognized by the system
114 * @throws IOException if an I/O exception occurs
115 * @see InputStream#markSupported
116 * @see InputStream#mark
117 */
118 public abstract AudioInputStream getAudioInputStream(InputStream stream)
119 throws UnsupportedAudioFileException, IOException;
120
121 /**
122 * Obtains an audio input stream from the URL provided. The URL must point
123 * to valid audio file data.
124 *
125 * @param url the URL for which the {@code AudioInputStream} should be
126 * constructed
127 * @return an {@code AudioInputStream} object based on the audio file data
128 * pointed to by the URL
129 * @throws UnsupportedAudioFileException if the URL does not point to valid
130 * audio file data recognized by the system
131 * @throws IOException if an I/O exception occurs
|