APCS_CH8_EasySound.java

import java.io.File;
import java.io.IOException;
import javax.sound.sampled.AudioFormat;
import javax.sound.sampled.AudioInputStream;
import javax.sound.sampled.AudioSystem;
import javax.sound.sampled.DataLine;
import javax.sound.sampled.LineUnavailableException;
import javax.sound.sampled.SourceDataLine;

/**
 * @author Gary Litvin
 * @version 1.6, 01/01/11
 *
 * Appendix to:
 *
 * <i>Java Methods: Object-Oriented Programming and Data Structures</i>
 * (Skylight Publishing 2011, ISBN 978-0-9824775-7-1)
 *
 * EasySound provides a simple way od playing a sound in an application.
 *
   <xmp>
   Example:
   =======

       EasySound bells = new EasySound("bells.wav");
       bells.play();

   </xmp>
 */
public class EasySound
{
  private SourceDataLine line = null;
  private byte[] audioBytes;
  private int numBytes;

  /**
   * Constructs an <code>EasySound</code> for a given audio file.
   * @param fileName the name or pathname of the audio clip file.
   */
  public EasySound(String fileName)
  {
    File  soundFile = new File(fileName);
    AudioInputStream audioInputStream = null;
    try
    {
      audioInputStream = AudioSystem.getAudioInputStream(soundFile);
    }
    catch (Exception ex)
    {
      System.out.println("*** Cannot find " + fileName + " ***");
      System.exit(1);
    }

    AudioFormat audioFormat = audioInputStream.getFormat();
    DataLine.Info info = new DataLine.Info(SourceDataLine.class,
                         audioFormat);
    try
    {
      line = (SourceDataLine)AudioSystem.getLine(info);
      line.open(audioFormat);
    }
    catch (LineUnavailableException ex)
    {
      System.out.println("*** Audio line unavailable ***");
      System.exit(1);
    }

    line.start();

    audioBytes = new byte[(int)soundFile.length()];

    try
    {
      numBytes = audioInputStream.read(audioBytes, 0, audioBytes.length);
    }
    catch (IOException ex)
    {
      System.out.println("*** Cannot read " + fileName + " ***");
      System.exit(1);
    }
  }

  /**
   * Plays this <code>EasySound</code>.
   */
  public void play()
  {
    line.write(audioBytes, 0, numBytes);
  }
}