|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectnet.roarsoftware.lastfm.ImageHolder
net.roarsoftware.lastfm.MusicEntry
net.roarsoftware.lastfm.Artist
public class Artist
Bean that contains artist information.
This class contains static methods that executes API methods relating to artists.
Method names are equivalent to the last.fm API method names.
Field Summary |
---|
Fields inherited from class net.roarsoftware.lastfm.MusicEntry |
---|
listeners, mbid, name, playcount, streamable, tags, url |
Fields inherited from class net.roarsoftware.lastfm.ImageHolder |
---|
imageUrls |
Constructor Summary | |
---|---|
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)
|
Method Summary | |
---|---|
static Result |
addTags(java.lang.String artist,
java.lang.String tags,
Session session)
Tag an artist with one or more user supplied tags. |
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 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. |
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<java.lang.String> |
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 |
Methods inherited from class net.roarsoftware.lastfm.MusicEntry |
---|
getListeners, getMbid, getName, getPlaycount, getTags, getUrl, getWikiLastChanged, getWikiSummary, getWikiText, isStreamable, loadStandardInfo |
Methods inherited from class net.roarsoftware.lastfm.ImageHolder |
---|
availableSizes, getImageURL, loadImages |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
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)
Method Detail |
---|
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 key
public static Artist getInfo(java.lang.String artistOrMbid, java.util.Locale locale, java.lang.String apiKey)
artistOrMbid
- Name of the artist or an mbidlocale
- The language to fetch info inapiKey
- The API key
public 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 key
getSimilar(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 key
public 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 key
public static java.util.Collection<Album> getTopAlbums(java.lang.String artist, java.lang.String apiKey)
artist
- Artist's nameapiKey
- The API key
public static java.util.Collection<User> getTopFans(java.lang.String artist, java.lang.String apiKey)
artist
- Artist's nameapiKey
- The API key
public static java.util.Collection<java.lang.String> getTopTags(java.lang.String artist, java.lang.String apiKey)
artist
- Artist's nameapiKey
- The API key
public 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 instance
public 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 instance
public 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 instance
public static java.util.Collection<java.lang.String> getTags(java.lang.String artist, Session session)
artist
- The artist name in questionsession
- A Session instance
public 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<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 key
Image
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 key
Image
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 instance
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |