org.musicontroller.songselection
Interface SongSelector

All Known Implementing Classes:

AdvancedRandomSongSelector

public interface SongSelector

Method Summary

void	addBandPlay(long bandid) Informs the SongSelector that a song of a certain Band has been played.
void	addBandSkip(long bandid) Informs the SongSelector that a song of a certain Band has been skipped.
void	addKeywordPlay(long keywordid) Informs the SongSelector that a song of a certain Keyword has been played.
void	addKeywordSkip(long keywordid) Informs the SongSelector that a song of a certain Keyword has been skipped.
Song	selectSong(java.util.List<Song> candidates, LastPlayedContainer lpc, IUser user) Returns one Song, which is selected using the Advanced Random algorithm.

Method Detail

selectSong

Song selectSong(java.util.List<Song> candidates,
                LastPlayedContainer lpc,
                IUser user)

Returns one Song, which is selected using the Advanced Random algorithm.

Parameters:

candidates - The list of Songs that are requested. If this parameter is null, the result is null. If the set of candidates is empty the result is null.

lpc - The collection of the last songs played

user - The User

Returns:

The Song that is best suitable to be played

addBandPlay

void addBandPlay(long bandid)

Informs the SongSelector that a song of a certain Band has been played.

Parameters:

bandid -

addBandSkip

void addBandSkip(long bandid)

Informs the SongSelector that a song of a certain Band has been skipped.

Parameters:

bandid -

addKeywordPlay

void addKeywordPlay(long keywordid)

Informs the SongSelector that a song of a certain Keyword has been played.

Parameters:

keywordid -

addKeywordSkip

void addKeywordSkip(long keywordid)

Informs the SongSelector that a song of a certain Keyword has been skipped.

Parameters:

keywordid -