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

Print this page




  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