Class Song

java.lang.Object

Song

public class Song
extends java.lang.Object

The Song class represents a single recorded music track. A song has a length in minutes and seconds, and also a title.

Author:

Mark Porterfield - 2/10/02., J. Dalbey 11/02 Revised to use a TimeDuration

Constructor Summary

Constructors

Constructor and Description
Song(java.lang.String title, int songLength) Construct a song from its title and duration
Song(java.lang.String title, int songMinutes, int songSeconds) Construct a song from its title and duration

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(java.lang.Object x) Compares this Song with the specified Object for equality.
TimeDuration	getDuration() Returns the duration of this song.
static Song	parseSong(java.lang.String description) Factory method that builds a song using the given description.
java.lang.String	toString() Returns a printable representation of this song.

Methods inherited from class java.lang.Object

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

Constructor Detail

Song

public Song(java.lang.String title,
    int songLength)

Construct a song from its title and duration

Parameters:

title - the name of the song

songLength - the song length in seconds

Song

public Song(java.lang.String title,
    int songMinutes,
    int songSeconds)

Construct a song from its title and duration

Parameters:

title - the name of the song

songMinutes - the minutes portion of the song length

songSeconds - the seconds part of the song length

Precondition:

0 <= songMinutes <= 999, 0 <= songSeconds <= 59

Method Detail

parseSong

public static Song parseSong(java.lang.String description)

Factory method that builds a song using the given description. If the description fails to parse correctly, the song's length is set to 0:00 and the title to an empty string.

Parameters:

description - A string in the format "minutes:seconds name" where minutes and seconds are integers, and name is a string. A single blank separates the time from the song name.

Returns:

Song created from the given description

equals

public boolean equals(java.lang.Object x)

Compares this Song with the specified Object for equality.

Overrides:

equals in class java.lang.Object

Parameters:

x - Object to which this Song is to be compared.

Returns:

true if and only if the specified Object is a Song whose title and duration are equal to this Song.

toString

public java.lang.String toString()

Returns a printable representation of this song.

Overrides:

toString in class java.lang.Object

Returns:

song formatted as "MM:SS title". Examples:
0:55 Layla
1:23 Blackbird
11:42 Caravan
0:06 Shorty


getDuration

public TimeDuration getDuration()

Returns the duration of this song.

Returns:

The duration of this song.