Class Library

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

public class Library extends Object
Contains bindings for all methods in the "library" namespace.
Author:
Martin Chorley, Janni Kovacs
  • Method Details

    • 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