sk.baka.ambient.stream.shoutcast
Class Radio

java.lang.Object
  sk.baka.ambient.stream.shoutcast.Radio

public final class Radio
extends java.lang.Object

A SHOUTcast radio station.

Author:

Martin Vysny

Field Summary

java.lang.String	currentTrack currently played track, null if not known.
java.lang.String	genre The radio genre.
java.lang.String	id the radio ID
java.lang.String	name The displayable radio station name.

Constructor Summary

Radio(java.lang.String name, java.lang.String id, java.lang.String genre, java.lang.String currentTrack)
Creates new radio

Method Summary

static Radio	fromXML(org.xml.sax.Attributes attrs) Parse the radio from given XML attributes.
java.net.URL	getPlaylistURL() Retrieves the radio playlist URL.
java.util.List<TrackMetadataBean>	getRadioURLs() Returns a list of URLs - radio sources.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

name

public final java.lang.String name

The displayable radio station name.

id

public final java.lang.String id

the radio ID

genre

public final java.lang.String genre

The radio genre.

currentTrack

public final java.lang.String currentTrack

currently played track, null if not known.

Constructor Detail

Radio

public Radio(java.lang.String name,
             java.lang.String id,
             java.lang.String genre,
             java.lang.String currentTrack)

Creates new radio

Parameters:

name - The displayable radio station name.

id - the radio ID

genre - The radio genre.

currentTrack - currently played track, null if not known.

Method Detail

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

getPlaylistURL

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

Retrieves the radio playlist URL.

Returns:

the URL

Throws:

java.net.MalformedURLException

getRadioURLs

public java.util.List<TrackMetadataBean> getRadioURLs()
                                               throws java.io.IOException,
                                                      java.text.ParseException

Returns a list of URLs - radio sources. Blocks until the list is retrieved.

Returns:

non-null list of radio sources, read-only.

Throws:

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

java.text.ParseException - if the playlist is not well formed.

fromXML

public static Radio fromXML(org.xml.sax.Attributes attrs)

Parse the radio from given XML attributes.

Parameters:

attrs - the attributes to parse

Returns:

radio instance, never null.