public class Album extends MusicEntry
Modifier and Type | Class and Description |
---|---|
private static class |
Album.AlbumFactory |
Modifier and Type | Field and Description |
---|---|
private String |
artist |
(package private) static ItemFactory<Album> |
FACTORY |
private static DateFormat |
RELEASE_DATE_FORMAT |
private static DateFormat |
RELEASE_DATE_FORMAT_2 |
private Date |
releaseDate |
private Collection<Track> |
tracks |
id, listeners, mbid, name, percentageChange, playcount, streamable, tags, url, userPlaycount
imageUrls
Modifier | Constructor and Description |
---|---|
private |
Album(String name,
String url,
String artist) |
private |
Album(String name,
String url,
String mbid,
int playcount,
int listeners,
boolean streamable,
String artist) |
Modifier and Type | Method and Description |
---|---|
static Result |
addTags(String artist,
String album,
String tags,
Session session)
Tag an album using a list of user supplied tags.
|
String |
getArtist() |
static Collection<BuyLink> |
getBuylinks(String artist,
String albumOrMbid,
String country,
String apiKey)
Get a list of Buy Links for a particular Album.
|
static Album |
getInfo(String artist,
String albumOrMbid,
String apiKey)
Get the metadata for an album on Last.fm using the album name or a musicbrainz id.
|
static Album |
getInfo(String artist,
String albumOrMbid,
String username,
String apiKey)
Get the metadata for an album on Last.fm using the album name or a musicbrainz id.
|
Date |
getReleaseDate() |
static PaginatedResult<Shout> |
getShouts(String artist,
String albumOrMbid,
int page,
int limit,
String apiKey)
Get shouts for an album.
|
static PaginatedResult<Shout> |
getShouts(String artist,
String albumOrMbid,
int page,
String apiKey)
Get shouts for an album.
|
static PaginatedResult<Shout> |
getShouts(String artist,
String albumOrMbid,
String apiKey)
Get shouts for an album.
|
static Collection<String> |
getTags(String artist,
String album,
Session session)
Get the tags applied by an individual user to an album on Last.fm.
|
static Collection<Tag> |
getTopTags(String artist,
String albumOrMbid,
String apiKey)
Get the top tags for an album on Last.fm, ordered by popularity.
|
Collection<Track> |
getTracks()
Returns the list of
Track s on this album. |
static Result |
removeTag(String artist,
String album,
String tag,
Session session)
Remove a user's tag from an album.
|
static Collection<Album> |
search(String album,
String apiKey)
Search for an album by name.
|
getId, getListeners, getMbid, getName, getPercentageChange, getPlaycount, getSimilarityMatch, getTags, getUrl, getUserPlaycount, getWikiLastChanged, getWikiSummary, getWikiText, isStreamable, loadStandardInfo, maybeParseInt, toString
availableSizes, getImageURL, loadImages
static final ItemFactory<Album> FACTORY
private static final DateFormat RELEASE_DATE_FORMAT
private static final DateFormat RELEASE_DATE_FORMAT_2
private Date releaseDate
private Collection<Track> tracks
public Date getReleaseDate()
public Collection<Track> getTracks()
Track
s on this album. This information is only available in
getInfo(String, String, String)
responses.getInfo(String, String, String)
public static Album getInfo(String artist, String albumOrMbid, String apiKey)
artist
- Artist's namealbumOrMbid
- Album name or MBIDapiKey
- The API keypublic static Album getInfo(String artist, String albumOrMbid, String username, String apiKey)
artist
- Artist's namealbumOrMbid
- Album name or MBIDusername
- The username for the context of the request. If supplied, the user's playcount for this album is included in the response.apiKey
- The API keypublic static Result addTags(String artist, String album, String tags, Session session)
artist
- The artist name in questionalbum
- The album name in questiontags
- A comma delimited list of user supplied tags to apply to this album. Accepts a maximum of 10 tags.session
- The Session instanceAuthenticator
public static Result removeTag(String artist, String album, String tag, Session session)
artist
- The artist name in questionalbum
- The album name in questiontag
- A single user tag to remove from this album.session
- The Session instanceAuthenticator
public static Collection<String> getTags(String artist, String album, Session session)
artist
- The artist name in questionalbum
- The album name in questionsession
- A Session instancepublic static Collection<Album> search(String album, String apiKey)
album
- The album name in question.apiKey
- A Last.fm API key.public static Collection<BuyLink> getBuylinks(String artist, String albumOrMbid, String country, String apiKey)
artist
- The artist name in questionalbumOrMbid
- Album name or MBIDcountry
- A country name, as defined by the ISO 3166-1 country names standardapiKey
- A Last.fm API keyBuyLink
spublic static Collection<Tag> getTopTags(String artist, String albumOrMbid, String apiKey)
null
for the first parameter.artist
- The artist namealbumOrMbid
- Album name or MBIDapiKey
- A Last.fm API keypublic static PaginatedResult<Shout> getShouts(String artist, String albumOrMbid, String apiKey)
artist
- The artist namealbumOrMbid
- The album name or a mausicbrainz idapiKey
- A Last.fm API key.Shout
spublic static PaginatedResult<Shout> getShouts(String artist, String albumOrMbid, int page, String apiKey)
artist
- The artist namealbumOrMbid
- The album name or a mausicbrainz idpage
- The page number to fetchapiKey
- A Last.fm API key.Shout
spublic static PaginatedResult<Shout> getShouts(String artist, String albumOrMbid, int page, int limit, String apiKey)
artist
- The artist namealbumOrMbid
- The album name or a mausicbrainz idpage
- The page number to fetchlimit
- An integer used to limit the number of shouts returned per page or -1 for defaultapiKey
- A Last.fm API key.Shout
sWebARTS Library Licensed Under the GNU - General Public License. Other Libraries licensed under their respective Open Source Licenses