com.soundhelix.util

Class SongUtils

java.lang.Object

com.soundhelix.util.SongUtils

public final class SongUtils
extends Object

Provides static convenience methods for creating songs.

Author:

Thomas Schuerger (thomas@schuerger.com)

Method Summary

Methods

Modifier and Type	Method and Description
static SongContext	generateSong(InputStream inputStream, String systemId, long randomSeed) Parses the XML file provided by the given input stream, creates an arrangement and a player and configures the player to use this arrangement.
static SongContext	generateSong(InputStream inputStream, String systemId, String songName) Parses the XML file provided by the given input stream, creates an arrangement and a player and configures the player to use this arrangement.
static SongContext	generateSong(URL url, long randomSeed) Parses the XML file provided by the given input stream, creates an arrangement and a player and configures the player to use this arrangement.
static SongContext	generateSong(URL url, String songName) Parses the XML file provided by the given input stream, creates an arrangement and a player and configures the player to use this arrangement.
static long	getSongRandomSeed(String title) Returns the random seed for the song title.

Methods inherited from class java.lang.Object

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

Method Detail

generateSong

public static SongContext generateSong(URL url,
                       long randomSeed)
                                throws Exception

Parses the XML file provided by the given input stream, creates an arrangement and a player and configures the player to use this arrangement.

Parameters:

url - the URL

randomSeed - the random seed

Returns:

the player

Throws:

Exception - in case of a problem

generateSong

public static SongContext generateSong(InputStream inputStream,
                       String systemId,
                       long randomSeed)
                                throws Exception

Parses the XML file provided by the given input stream, creates an arrangement and a player and configures the player to use this arrangement.

Parameters:

inputStream - the input stream

systemId - the system ID specifying the source of the input stream

randomSeed - the random seed

Returns:

the player

Throws:

Exception - in case of a problem

generateSong

public static SongContext generateSong(URL url,
                       String songName)
                                throws Exception

Parses the XML file provided by the given input stream, creates an arrangement and a player and configures the player to use this arrangement.

Parameters:

url - the URL

songName - the song name

Returns:

the player

Throws:

Exception - in case of a problem

generateSong

public static SongContext generateSong(InputStream inputStream,
                       String systemId,
                       String songName)
                                throws Exception

Parses the XML file provided by the given input stream, creates an arrangement and a player and configures the player to use this arrangement.

Parameters:

inputStream - the input stream

systemId - the system ID specifying the source of the input stream

songName - the song name

Returns:

the player

Throws:

Exception - in case of a problem

getSongRandomSeed

public static long getSongRandomSeed(String title)

Returns the random seed for the song title.

Parameters:

title - the song tile

Returns:

the random seed