public class Artist extends MusicEntry
id, listeners, mbid, name, percentageChange, playcount, streamable, tags, url, userPlaycount
imageUrls
Modifier | Constructor and Description |
---|---|
protected |
Artist(java.lang.String name,
java.lang.String url) |
protected |
Artist(java.lang.String name,
java.lang.String url,
java.lang.String mbid,
int playcount,
int listeners,
boolean streamable) |
Modifier and Type | Method and Description |
---|---|
static Result |
addTags(java.lang.String artist,
java.lang.String tags,
Session session)
Tag an artist with one or more user supplied tags.
|
static Artist |
getCorrection(java.lang.String artist,
java.lang.String apiKey)
Use the last.fm corrections data to check whether the supplied artist has a correction to a canonical artist.
|
static java.util.Collection<Event> |
getEvents(java.lang.String artist,
java.lang.String apiKey)
Returns a list of upcoming events for an artist.
|
static PaginatedResult<Image> |
getImages(java.lang.String artist,
int page,
int limit,
java.lang.String apiKey)
Get
Image s for this artist in a variety of sizes. |
static PaginatedResult<Image> |
getImages(java.lang.String artist,
java.lang.String apiKey)
Get
Image s for this artist in a variety of sizes. |
static Artist |
getInfo(java.lang.String artistOrMbid,
java.util.Locale locale,
java.lang.String username,
java.lang.String apiKey)
Retrieves detailed artist info for the given artist or mbid entry.
|
static Artist |
getInfo(java.lang.String artistOrMbid,
java.lang.String apiKey)
Retrieves detailed artist info for the given artist or mbid entry.
|
static Artist |
getInfo(java.lang.String artistOrMbid,
java.lang.String username,
java.lang.String apiKey)
Retrieves detailed artist info for the given artist or mbid entry.
|
static PaginatedResult<Event> |
getPastEvents(java.lang.String artist,
int page,
int limit,
java.lang.String apiKey)
Get a paginated list of all the events this artist has played at in the past.
|
static PaginatedResult<Event> |
getPastEvents(java.lang.String artist,
java.lang.String apiKey)
Get a paginated list of all the events this artist has played at in the past.
|
java.util.Collection<Artist> |
getSimilar()
Returns a list of similar
Artist s. |
static java.util.Collection<Artist> |
getSimilar(java.lang.String artist,
int limit,
java.lang.String apiKey)
Returns
limit similar artists to the given one. |
static java.util.Collection<Artist> |
getSimilar(java.lang.String artist,
java.lang.String apiKey)
Calls
getSimilar(String, int, String) with the default limit of 100. |
float |
getSimilarityMatch() |
static java.util.Collection<java.lang.String> |
getTags(java.lang.String artist,
Session session)
Get the tags applied by an individual user to an artist on Last.fm.
|
static java.util.Collection<Album> |
getTopAlbums(java.lang.String artist,
java.lang.String apiKey)
Returns a list of the given artist's top albums.
|
static java.util.Collection<User> |
getTopFans(java.lang.String artist,
java.lang.String apiKey)
Retrieves a list of the top fans of the given artist.
|
static java.util.Collection<Tag> |
getTopTags(java.lang.String artist,
java.lang.String apiKey)
Retrieves the top tags for the given artist.
|
static java.util.Collection<Track> |
getTopTracks(java.lang.String artist,
java.lang.String apiKey)
Get the top tracks by an artist on Last.fm, ordered by popularity
|
static Result |
removeTag(java.lang.String artist,
java.lang.String tag,
Session session)
Remove a user's tag from an artist.
|
static java.util.Collection<Artist> |
search(java.lang.String name,
java.lang.String apiKey)
Searches for an artist and returns a
Collection of possible matches. |
static Result |
share(java.lang.String artist,
java.lang.String recipients,
java.lang.String message,
Session session)
Share an artist with one or more Last.fm users or other friends.
|
static Result |
shout(java.lang.String artist,
java.lang.String message,
Session session)
Shout on this artist's shoutbox
|
getId, getListeners, getMbid, getName, getPercentageChange, getPlaycount, getTags, getUrl, getUserPlaycount, getWikiLastChanged, getWikiSummary, getWikiText, isStreamable, loadStandardInfo
availableSizes, getImageURL, loadImages
protected Artist(java.lang.String name, java.lang.String url)
protected Artist(java.lang.String name, java.lang.String url, java.lang.String mbid, int playcount, int listeners, boolean streamable)
public float getSimilarityMatch()
public java.util.Collection<Artist> getSimilar()
Artist
s. Note that this method does not retrieve this list from the server but instead returns
the result of an artist.getInfo
call.getSimilar(String, String)
method.getSimilar(String, String)
,
getSimilar(String, int, String)
public static Artist getInfo(java.lang.String artistOrMbid, java.lang.String apiKey)
artistOrMbid
- Name of the artist or an mbidapiKey
- The API keypublic static Artist getInfo(java.lang.String artistOrMbid, java.lang.String username, java.lang.String apiKey)
artistOrMbid
- Name of the artist or an mbidusername
- The username for the context of the request, or null
. If supplied, the user's playcount for this artist is
included in the responseapiKey
- The API keypublic static Artist getInfo(java.lang.String artistOrMbid, java.util.Locale locale, java.lang.String username, java.lang.String apiKey)
artistOrMbid
- Name of the artist or an mbidlocale
- The language to fetch info in, or null
username
- The username for the context of the request, or null
. If supplied, the user's playcount for this artist is
included in the responseapiKey
- The API keypublic static java.util.Collection<Artist> getSimilar(java.lang.String artist, java.lang.String apiKey)
getSimilar(String, int, String)
with the default limit of 100.artist
- Artist's nameapiKey
- The API keygetSimilar(String, int, String)
public static java.util.Collection<Artist> getSimilar(java.lang.String artist, int limit, java.lang.String apiKey)
limit
similar artists to the given one.artist
- Artist's namelimit
- Number of maximum resultsapiKey
- The API keypublic static java.util.Collection<Artist> search(java.lang.String name, java.lang.String apiKey)
Collection
of possible matches.name
- The artist name to look upapiKey
- The API keypublic static java.util.Collection<Album> getTopAlbums(java.lang.String artist, java.lang.String apiKey)
artist
- Artist's nameapiKey
- The API keypublic static java.util.Collection<User> getTopFans(java.lang.String artist, java.lang.String apiKey)
artist
- Artist's nameapiKey
- The API keypublic static java.util.Collection<Tag> getTopTags(java.lang.String artist, java.lang.String apiKey)
artist
- Artist's nameapiKey
- The API keypublic static java.util.Collection<Track> getTopTracks(java.lang.String artist, java.lang.String apiKey)
artist
- The artist name in questionapiKey
- A Last.fm API key.public static Result addTags(java.lang.String artist, java.lang.String tags, Session session)
artist
- The artist name in question.tags
- A comma delimited list of user supplied tags to apply to this artist. Accepts a maximum of 10 tags.session
- A Session instancepublic static Result removeTag(java.lang.String artist, java.lang.String tag, Session session)
artist
- The artist name in question.tag
- A single user tag to remove from this artist.session
- A Session instancepublic static Result share(java.lang.String artist, java.lang.String recipients, java.lang.String message, Session session)
artist
- The artist to share.recipients
- A comma delimited list of email addresses or Last.fm usernames. Maximum is 10.message
- An optional message to send with the recommendation.session
- A Session instancepublic static java.util.Collection<java.lang.String> getTags(java.lang.String artist, Session session)
artist
- The artist name in questionsession
- A Session instancepublic static java.util.Collection<Event> getEvents(java.lang.String artist, java.lang.String apiKey)
artist
- The artist name in questionapiKey
- A Last.fm API key.public static PaginatedResult<Event> getPastEvents(java.lang.String artist, java.lang.String apiKey)
artist
- The name of the artist you would like to fetch event listings forapiKey
- A Last.fm API keypublic static PaginatedResult<Event> getPastEvents(java.lang.String artist, int page, int limit, java.lang.String apiKey)
artist
- The name of the artist you would like to fetch event listings forpage
- The page of results to returnlimit
- The maximum number of results to return per pageapiKey
- A Last.fm API keypublic static PaginatedResult<Image> getImages(java.lang.String artist, java.lang.String apiKey)
Image
s for this artist in a variety of sizes.artist
- The artist name in questionapiKey
- A Last.fm API keyImage
spublic static PaginatedResult<Image> getImages(java.lang.String artist, int page, int limit, java.lang.String apiKey)
Image
s for this artist in a variety of sizes.artist
- The artist name in questionpage
- Which page of limit amount to displaylimit
- How many to return. Defaults and maxes out at 50apiKey
- A Last.fm API keyImage
spublic static Result shout(java.lang.String artist, java.lang.String message, Session session)
artist
- The name of the artist to shout onmessage
- The message to post to the shoutboxsession
- A Session instancepublic static Artist getCorrection(java.lang.String artist, java.lang.String apiKey)
Artist
object containing the corrected data, or null
if the supplied Artist was not found.artist
- The artist name to correctapiKey
- A Last.fm API keyArtist
, or null