sk.baka.ambient.lrc.lyrdb
Class LyrdbTrack

java.lang.Object
  sk.baka.ambient.lrc.lyrdb.LyrdbTrack

public final class LyrdbTrack
extends java.lang.Object

An immutable LyrDB track as returned by the LyrDB search.

Author:

Martin Vysny

Field Summary

java.lang.String	artist artist
java.lang.String	displayableString A displayable string
java.lang.String	id the LyrDB id.
java.lang.String	trackName The track name.

Constructor Summary

LyrdbTrack(java.lang.String id, java.lang.String trackName, java.lang.String artist)
Creates new track.

Method Summary

static LyrdbTrack	fromSearchLine(java.lang.String line) Parses the result line and returns the track.
java.net.URL	getKaraokeURL() Returns URL of the karaoke file for this track.
static java.util.List<LyrdbTrack>	search(TrackMetadataBean track, boolean relevantOnly) Search for a karaoke files for given track.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

id

public final java.lang.String id

the LyrDB id.

trackName

public final java.lang.String trackName

The track name.

artist

public final java.lang.String artist

artist

displayableString

public final java.lang.String displayableString

A displayable string

Constructor Detail

LyrdbTrack

public LyrdbTrack(java.lang.String id,
                  java.lang.String trackName,
                  java.lang.String artist)

Creates new track.

Parameters:

id - the LyrDB id.

trackName - the track name.

artist - artist

Method Detail

fromSearchLine

public static LyrdbTrack fromSearchLine(java.lang.String line)

Parses the result line and returns the track.

Parameters:

line - the line to parse

Returns:

non-null track instance or null if the line was not in a correct format.

getKaraokeURL

public java.net.URL getKaraokeURL()
                           throws java.net.MalformedURLException

Returns URL of the karaoke file for this track.

Returns:

the karaoke URL.

Throws:

java.net.MalformedURLException

search

public static java.util.List<LyrdbTrack> search(TrackMetadataBean track,
                                                boolean relevantOnly)
                                         throws java.io.IOException

Search for a karaoke files for given track. Fetches results synchronously from the Internet.

Parameters:

track - search for lyrics for this track.

relevantOnly - if true then only the most relevant results are returned.

Returns:

list of tracks, never null.

Throws:

java.io.IOException - if i/o error occurs.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object