Package de.umass.lastfm

Class Library

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

    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static Result addAlbum​(java.lang.String artist, java.lang.String album, Session session)
      Add an album to a user's Last.fm library
      static Result addArtist​(java.lang.String artist, Session session)
      Add an artist to a user's Last.fm library
      static Result addTrack​(java.lang.String artist, java.lang.String track, Session session)
      Add a track to a user's Last.fm library
      static PaginatedResult<Album> getAlbums​(java.lang.String user, int page, int limit, java.lang.String apiKey)
      Retrieves a paginated list of all the albums in a user's library.
      static PaginatedResult<Album> getAlbums​(java.lang.String user, int page, java.lang.String apiKey)
      Retrieves a paginated list of all the albums in a user's library.
      static PaginatedResult<Album> getAlbums​(java.lang.String user, java.lang.String apiKey)
      Retrieves a paginated list of all the albums in a user's library.
      static java.util.Collection<Album> getAllAlbums​(java.lang.String user, java.lang.String apiKey)
      Retrieves all albums in a user's library.
      static java.util.Collection<Artist> getAllArtists​(java.lang.String user, java.lang.String apiKey)
      Retrieves all artists in a user's library.
      static java.util.Collection<Track> getAllTracks​(java.lang.String user, java.lang.String apiKey)
      Retrieves all tracks in a user's library.
      static PaginatedResult<Artist> getArtists​(java.lang.String user, int page, int limit, java.lang.String apiKey)
      Retrieves a paginated list of all the artists in a user's library.
      static PaginatedResult<Artist> getArtists​(java.lang.String user, int page, java.lang.String apiKey)
      Retrieves a paginated list of all the artists in a user's library.
      static PaginatedResult<Artist> getArtists​(java.lang.String user, java.lang.String apiKey)
      Retrieves a paginated list of all the artists in a user's library.
      static PaginatedResult<Track> getTracks​(java.lang.String user, int page, int limit, java.lang.String apiKey)
      Retrieves a paginated list of all the tracks in a user's library.
      static PaginatedResult<Track> getTracks​(java.lang.String user, int page, java.lang.String apiKey)
      Retrieves a paginated list of all the tracks in a user's library.
      static PaginatedResult<Track> getTracks​(java.lang.String user, java.lang.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​(java.lang.String user,
                                                 java.lang.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​(java.lang.String user,
                                                 int page,
                                                 java.lang.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​(java.lang.String user,
                                                 int page,
                                                 int limit,
                                                 java.lang.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 java.util.Collection<Artist> getAllArtists​(java.lang.String user,
                                                         java.lang.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​(java.lang.String user,
                                               java.lang.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​(java.lang.String user,
                                               int page,
                                               java.lang.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​(java.lang.String user,
                                               int page,
                                               int limit,
                                               java.lang.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 java.util.Collection<Album> getAllAlbums​(java.lang.String user,
                                                       java.lang.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​(java.lang.String user,
                                               java.lang.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​(java.lang.String user,
                                               int page,
                                               java.lang.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​(java.lang.String user,
                                               int page,
                                               int limit,
                                               java.lang.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 java.util.Collection<Track> getAllTracks​(java.lang.String user,
                                                       java.lang.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​(java.lang.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​(java.lang.String artist,
                              java.lang.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​(java.lang.String artist,
                              java.lang.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