Library

java.lang.Object
- de.umass.lastfm.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 and 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

Class Library

Method Summary

Methods inherited from class java.lang.Object

Method Detail

getArtists

getArtists

getArtists

getAllArtists

getAlbums

getAlbums

getAlbums

getAllAlbums

getTracks

getTracks

getTracks

getAllTracks

addArtist

addAlbum

addTrack