com.soundhelix

Class SoundHelix

java.lang.Object

com.soundhelix.SoundHelix

All Implemented Interfaces:

Runnable

public class SoundHelix
extends Object
implements Runnable

Implements the main class. The main() method determines the configuration file and then waits for the next generated song and plays it. The configuration parsing and generation of songs is done in a separate thread to guarantee seamless playing. The thread priority for the song generator is set to a low value, the priority of the playing thread is set to a high value.

Author:

Thomas Schuerger (thomas@schuerger.com)

Constructor Summary

Constructors

Constructor and Description
SoundHelix(URL url, long randomSeed) Constructor.
SoundHelix(URL url, String songName) Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
SongContext	getNextSongFromQueue() Removes and returns the next SongContext from the queue.
static void	main(String[] args) The main method.
void	run() Implements the functionality of the thread that generates songs.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SoundHelix

public SoundHelix(URL url,
          long randomSeed)

Constructor.

Parameters:

url - the SoundHelix XML URL

randomSeed - the random seed

SoundHelix

public SoundHelix(URL url,
          String songName)

Constructor.

Parameters:

url - the SoundHelix XML URL

songName - the song name

Method Detail

main

public static void main(String[] args)
                 throws Exception

The main method.

Parameters:

args - the arguments

Throws:

Exception - in case of any problem

run

public void run()

Implements the functionality of the thread that generates songs. The method runs forever and generates a new song as soon as it detects the queue to be empty.

Specified by:

run in interface Runnable

getNextSongFromQueue

public SongContext getNextSongFromQueue()
                                 throws InterruptedException

Removes and returns the next SongContext from the queue. This method will block until an entry is available.

Returns:

the next SongContext

Throws:

InterruptedException - if interrupted