com.evolution.player.core.media
Interface IStructuredLibrary


public interface IStructuredLibrary

An interface to the structured library. A structured library knows about the structure of local medias in the library, that is i.e. the albums from a given artist or the songs from a given album.

Clients must not implement.

Since:
0.6
See Also:
Album, Artist, LocalMediaInfo, EvolutionPlayerCore.getStructuredLibrary()

Method Summary
 Album[] getAlbums(IProgressMonitor monitor)
          Returns all known albums.
 Artist[] getArtists(IProgressMonitor monitor)
          Returns all known artists.
 LocalMediaInfo[] getSongs(Album album)
          Returns all songs from the given album.
 LocalMediaInfo[] getSongs(Artist artist)
          Returns all songs from the given artist.
 

Method Detail

getAlbums

Album[] getAlbums(IProgressMonitor monitor)
Returns all known albums. The method checks that all albums contain existing songs.

Parameters:
monitor - a monitor to report progress to
Returns:
all known albums in the library

getArtists

Artist[] getArtists(IProgressMonitor monitor)
Returns all known artists. The method checks that all artists contain albums with existing songs.

Parameters:
monitor - a monitor to report progress to
Returns:
all known artists in the library

getSongs

LocalMediaInfo[] getSongs(Artist artist)
Returns all songs from the given artist. The method checks that all medias exist.

Parameters:
artist - the artist for which to retrieve the songs for
Returns:
all songs from given artist

getSongs

LocalMediaInfo[] getSongs(Album album)
Returns all songs from the given album. The method checks that all medias exists.

Parameters:
album - the album for which to retrieve the songs for
Returns:
all songs from given album