de.umass.lastfm
Class Library

java.lang.Object
  extended by de.umass.lastfm.Library

public class Library
extends Object

Contains bindings for all methods in the "library" namespace.

Author:
Martin Chorley, Janni Kovacs

Method Summary
static Result addAlbum(String artist, String album, Session session)
          Add an album to a user's Last.fm library
static Result addArtist(String artist, Session session)
          Add an artist to a user's Last.fm library
static Result addTrack(String artist, String track, Session session)
          Add a track to a user's Last.fm library
static PaginatedResult<Album> getAlbums(String user, int page, int limit, String apiKey)
          Retrieves a paginated list of all the albums in a user's library.
static PaginatedResult<Album> getAlbums(String user, int page, String apiKey)
          Retrieves a paginated list of all the albums in a user's library.
static PaginatedResult<Album> getAlbums(String user, String apiKey)
          Retrieves a paginated list of all the albums in a user's library.
static Collection<Album> getAllAlbums(String user, String apiKey)
          Retrieves all albums in a user's library.
static Collection<Artist> getAllArtists(String user, String apiKey)
          Retrieves all artists in a user's library.
static Collection<Track> getAllTracks(String user, String apiKey)
          Retrieves all tracks in a user's library.
static PaginatedResult<Artist> getArtists(String user, int page, int limit, String apiKey)
          Retrieves a paginated list of all the artists in a user's library.
static PaginatedResult<Artist> getArtists(String user, int page, String apiKey)
          Retrieves a paginated list of all the artists in a user's library.
static PaginatedResult<Artist> getArtists(String user, String apiKey)
          Retrieves a paginated list of all the artists in a user's library.
static PaginatedResult<Track> getTracks(String user, int page, int limit, String apiKey)
          Retrieves a paginated list of all the tracks in a user's library.
static PaginatedResult<Track> getTracks(String user, int page, String apiKey)
          Retrieves a paginated list of all the tracks in a user's library.
static PaginatedResult<Track> getTracks(String user, String apiKey)
          Retrieves a paginated list of all the tracks in a user's library.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

getArtists

public static PaginatedResult<Artist> getArtists(String user,
                                                 String apiKey)
Retrieves a paginated list of all the artists in a user's library.

Parameters:
user - The user whose library you want to fetch.
apiKey - A Last.fm API key.
Returns:
a PaginatedResult of the artists

getArtists

public static PaginatedResult<Artist> getArtists(String user,
                                                 int page,
                                                 String apiKey)
Retrieves a paginated list of all the artists in a user's library.

Parameters:
user - The user whose library you want to fetch.
page - The page number you wish to scan to.
apiKey - A Last.fm API key.
Returns:
a PaginatedResult of the artists

getArtists

public static PaginatedResult<Artist> getArtists(String user,
                                                 int page,
                                                 int limit,
                                                 String apiKey)
Retrieves a paginated list of all the artists in a user's library.

Parameters:
user - The user whose library you want to fetch.
page - The page number you wish to scan to.
limit - Limit the amount of artists returned (maximum/default is 50).
apiKey - A Last.fm API key.
Returns:
a PaginatedResult of the artists

getAllArtists

public static Collection<Artist> getAllArtists(String user,
                                               String apiKey)
Retrieves all artists in a user's library. Pay attention if you use this method as it may produce a lot of network traffic and therefore may consume a long time.

Parameters:
user - The user whose library you want to fetch.
apiKey - A Last.fm API key.
Returns:
all artists in a user's library

getAlbums

public static PaginatedResult<Album> getAlbums(String user,
                                               String apiKey)
Retrieves a paginated list of all the albums in a user's library.

Parameters:
user - The user whose library you want to fetch.
apiKey - A Last.fm API key.
Returns:
a PaginatedResult of the albums

getAlbums

public static PaginatedResult<Album> getAlbums(String user,
                                               int page,
                                               String apiKey)
Retrieves a paginated list of all the albums in a user's library.

Parameters:
user - The user whose library you want to fetch.
page - The page number you wish to scan to.
apiKey - A Last.fm API key.
Returns:
a PaginatedResult of the albums

getAlbums

public static PaginatedResult<Album> getAlbums(String user,
                                               int page,
                                               int limit,
                                               String apiKey)
Retrieves a paginated list of all the albums in a user's library.

Parameters:
user - The user whose library you want to fetch.
page - The page number you wish to scan to.
limit - Limit the amount of albumss returned (maximum/default is 50).
apiKey - A Last.fm API key.
Returns:
a PaginatedResult of the albums

getAllAlbums

public static Collection<Album> getAllAlbums(String user,
                                             String apiKey)
Retrieves all albums in a user's library. Pay attention if you use this method as it may produce a lot of network traffic and therefore may consume a long time.

Parameters:
user - The user whose library you want to fetch.
apiKey - A Last.fm API key.
Returns:
all albums in a user's library

getTracks

public static PaginatedResult<Track> getTracks(String user,
                                               String apiKey)
Retrieves a paginated list of all the tracks in a user's library.

Parameters:
user - The user whose library you want to fetch.
apiKey - A Last.fm API key.
Returns:
a PaginatedResult of the tracks

getTracks

public static PaginatedResult<Track> getTracks(String user,
                                               int page,
                                               String apiKey)
Retrieves a paginated list of all the tracks in a user's library.

Parameters:
user - The user whose library you want to fetch.
page - The page number you wish to scan to.
apiKey - A Last.fm API key.
Returns:
a PaginatedResult of the tracks

getTracks

public static PaginatedResult<Track> getTracks(String user,
                                               int page,
                                               int limit,
                                               String apiKey)
Retrieves a paginated list of all the tracks in a user's library.

Parameters:
user - The user whose library you want to fetch.
page - The page number you wish to scan to.
limit - Limit the amount of albumss returned (maximum/default is 50).
apiKey - A Last.fm API key.
Returns:
a PaginatedResult of the tracks

getAllTracks

public static Collection<Track> getAllTracks(String user,
                                             String apiKey)
Retrieves all tracks in a user's library. Pay attention if you use this method as it may produce a lot of network traffic and therefore may consume a long time.

Parameters:
user - The user whose library you want to fetch.
apiKey - A Last.fm API key.
Returns:
all tracks in a user's library

addArtist

public static Result addArtist(String artist,
                               Session session)
Add an artist to a user's Last.fm library

Parameters:
artist - The artist name you wish to add
session - A Session instance
Returns:
the result of the operation

addAlbum

public static Result addAlbum(String artist,
                              String album,
                              Session session)
Add an album to a user's Last.fm library

Parameters:
artist - The artist that composed the track
album - The album name you wish to add
session - A Session instance
Returns:
the result of the operation

addTrack

public static Result addTrack(String artist,
                              String track,
                              Session session)
Add a track to a user's Last.fm library

Parameters:
artist - The artist that composed the track
track - The track name you wish to add
session - A Session instance
Returns:
the result of the operation