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

@@ -58,10 +58,11 @@
      * @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
+     * @throws NullPointerException if {@code stream} is {@code null}
      * @see InputStream#markSupported
      * @see InputStream#mark
      */
     public abstract AudioFileFormat getAudioFileFormat(InputStream stream)
             throws UnsupportedAudioFileException, IOException;

@@ -75,10 +76,11 @@
      * @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
+     * @throws NullPointerException if {@code url} is {@code null}
      */
     public abstract AudioFileFormat getAudioFileFormat(URL url)
             throws UnsupportedAudioFileException, IOException;
 
     /**

@@ -90,10 +92,11 @@
      * @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
+     * @throws NullPointerException if {@code file} is {@code null}
      */
     public abstract AudioFileFormat getAudioFileFormat(File file)
             throws UnsupportedAudioFileException, IOException;
 
     /**

@@ -110,10 +113,11 @@
      * @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
+     * @throws NullPointerException if {@code stream} is {@code null}
      * @see InputStream#markSupported
      * @see InputStream#mark
      */
     public abstract AudioInputStream getAudioInputStream(InputStream stream)
             throws UnsupportedAudioFileException, IOException;

@@ -127,10 +131,11 @@
      * @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
+     * @throws NullPointerException if {@code url} is {@code null}
      */
     public abstract AudioInputStream getAudioInputStream(URL url)
             throws UnsupportedAudioFileException, IOException;
 
     /**

@@ -142,9 +147,10 @@
      * @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
+     * @throws NullPointerException if {@code file} is {@code null}
      */
     public abstract AudioInputStream getAudioInputStream(File file)
             throws UnsupportedAudioFileException, IOException;
 }