|
|||||||||
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.Track
public class Track
Bean that contains information related to Track
s and provides bindings to methods
in the track.
namespace.
Field Summary | |
---|---|
protected java.lang.String |
album
|
static java.lang.String |
ALBUM_PAGE
|
protected java.lang.String |
albumMbid
|
protected java.lang.String |
artist
|
static java.lang.String |
ARTIST_PAGE
|
protected java.lang.String |
artistMbid
|
protected int |
duration
|
protected boolean |
fullTrackAvailable
|
protected java.util.Map<java.lang.String,java.lang.String> |
lastFmExtensionInfos
|
protected java.lang.String |
location
|
protected boolean |
nowPlaying
|
protected java.util.Date |
playedWhen
|
protected int |
position
|
static java.lang.String |
TRACK_PAGE
|
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 |
Track(java.lang.String name,
java.lang.String url,
java.lang.String artist)
|
protected |
Track(java.lang.String name,
java.lang.String url,
java.lang.String mbid,
int playcount,
int listeners,
boolean streamable,
java.lang.String artist,
java.lang.String artistMbid,
boolean fullTrackAvailable,
boolean nowPlaying)
|
Method Summary | |
---|---|
static Result |
addTags(java.lang.String artist,
java.lang.String track,
java.lang.String tags,
Session session)
Tag an album using a list of user supplied tags. |
static Result |
ban(java.lang.String artist,
java.lang.String track,
Session session)
Ban a track for a given user profile. |
java.lang.String |
getAlbum()
|
java.lang.String |
getAlbumMbid()
|
java.lang.String |
getArtist()
|
java.lang.String |
getArtistMbid()
|
int |
getDuration()
Returns the duration of the song, if available, in seconds. |
static Track |
getInfo(java.lang.String artist,
java.lang.String trackOrMbid,
java.lang.String apiKey)
Get the metadata for a track on Last.fm using the artist/track name or a musicbrainz id. |
java.lang.String |
getLastFmInfo(java.lang.String key)
Returns last.fm specific information about this Track. |
java.lang.String |
getLocation()
Returns the location (URL) of this Track. |
java.util.Date |
getPlayedWhen()
Returns the time when the track was played, if this data is available (e.g. |
int |
getPosition()
Returns the position of this track in its associated album, or -1 if not available. |
static java.util.Collection<Track> |
getSimilar(java.lang.String artist,
java.lang.String track,
java.lang.String mbid,
java.lang.String apiKey)
Get the similar tracks for this track on Last.fm, based on listening data. You have to provide either an artist and a track name or an mbid. |
static java.util.Collection<java.lang.String> |
getTags(java.lang.String artist,
java.lang.String track,
Session session)
Get the tags applied by an individual user to an track on Last.fm. |
static java.util.Collection<User> |
getTopFans(java.lang.String artist,
java.lang.String trackOrMbid,
java.lang.String apiKey)
Retrieves the top fans for the given track. |
static java.util.List<Tag> |
getTopTags(java.lang.String artist,
java.lang.String trackOrMbid,
java.lang.String apiKey)
Retrieves the top tags for the given track. |
boolean |
isFullTrackAvailable()
|
boolean |
isNowPlaying()
|
static Result |
love(java.lang.String artist,
java.lang.String track,
Session session)
Love a track for a user profile. |
static Result |
removeTag(java.lang.String artist,
java.lang.String track,
java.lang.String tag,
Session session)
Remove a user's tag from a track. |
static java.util.Collection<Track> |
search(java.lang.String track,
java.lang.String apiKey)
Searches for a track with the given name and returns a list of possible matches. |
static java.util.Collection<Track> |
search(java.lang.String artist,
java.lang.String track,
int limit,
java.lang.String apiKey)
Searches for a track with the given name and returns a list of possible matches. |
static Result |
share(java.lang.String artist,
java.lang.String track,
java.lang.String message,
java.lang.String recipient,
Session session)
Share a track twith one or more Last.fm users or other friends. |
static Track |
trackFromElement(DomElement e)
|
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 |
Field Detail |
---|
public static final java.lang.String ARTIST_PAGE
public static final java.lang.String ALBUM_PAGE
public static final java.lang.String TRACK_PAGE
protected java.lang.String artist
protected java.lang.String artistMbid
protected java.lang.String album
protected java.lang.String albumMbid
protected int position
protected boolean fullTrackAvailable
protected boolean nowPlaying
protected java.util.Date playedWhen
protected int duration
protected java.lang.String location
protected java.util.Map<java.lang.String,java.lang.String> lastFmExtensionInfos
Constructor Detail |
---|
protected Track(java.lang.String name, java.lang.String url, java.lang.String artist)
protected Track(java.lang.String name, java.lang.String url, java.lang.String mbid, int playcount, int listeners, boolean streamable, java.lang.String artist, java.lang.String artistMbid, boolean fullTrackAvailable, boolean nowPlaying)
Method Detail |
---|
public int getDuration()
Playlist.fetch
and
Track.getInfo
.
public java.lang.String getArtist()
public java.lang.String getArtistMbid()
public java.lang.String getAlbum()
public java.lang.String getAlbumMbid()
public boolean isFullTrackAvailable()
public boolean isNowPlaying()
public java.lang.String getLocation()
Radio
services.
public java.lang.String getLastFmInfo(java.lang.String key)
key
- A key
ARTIST_PAGE
,
ALBUM_PAGE
,
TRACK_PAGE
public java.util.Date getPlayedWhen()
null
,
if this data is not available.
null
public int getPosition()
public static java.util.Collection<Track> search(java.lang.String track, java.lang.String apiKey)
track
- Track nameapiKey
- The API key
search(String, String, int, String)
public static java.util.Collection<Track> search(java.lang.String artist, java.lang.String track, int limit, java.lang.String apiKey)
null
for the artist parameter if you want to specify a limit but don't want
to define an artist.
artist
- Artist's name or null
track
- Track namelimit
- Number of maximum resultsapiKey
- The API key
public static java.util.List<Tag> getTopTags(java.lang.String artist, java.lang.String trackOrMbid, java.lang.String apiKey)
null
for the first parameter.
artist
- Artist name or null
if an MBID is specifiedtrackOrMbid
- Track name or MBIDapiKey
- The API key
public static java.util.Collection<User> getTopFans(java.lang.String artist, java.lang.String trackOrMbid, java.lang.String apiKey)
null
for the first parameter.
artist
- Artist name or null
if an MBID is specifiedtrackOrMbid
- Track name or MBIDapiKey
- The API key
public static Result addTags(java.lang.String artist, java.lang.String track, java.lang.String tags, Session session)
artist
- The artist name in questiontrack
- The track name in questiontags
- A comma delimited list of user supplied tags to apply to this track. Accepts a maximum of 10 tags.session
- A Session instance.
public static Result removeTag(java.lang.String artist, java.lang.String track, java.lang.String tag, Session session)
artist
- The artist name in questiontrack
- The track name in questiontag
- A single user tag to remove from this track.session
- A Session instance.
public static Result share(java.lang.String artist, java.lang.String track, java.lang.String message, java.lang.String recipient, Session session)
artist
- An artist name.track
- A track name.message
- A message to send with the recommendation or null
. If not supplied a default message will be used.recipient
- A comma delimited list of email addresses or Last.fm usernames. Maximum is 10.session
- A Session instance
public static Result love(java.lang.String artist, java.lang.String track, Session session)
artist
- An artist nametrack
- A track namesession
- A Session instance
public static Result ban(java.lang.String artist, java.lang.String track, Session session)
artist
- An artist nametrack
- A track namesession
- A Session instance
public static java.util.Collection<Track> getSimilar(java.lang.String artist, java.lang.String track, java.lang.String mbid, java.lang.String apiKey)
null
for parameters you don't need.
artist
- The artist name in questiontrack
- The track name in questionmbid
- The musicbrainz id for the trackapiKey
- A Last.fm API key.
Track
spublic static java.util.Collection<java.lang.String> getTags(java.lang.String artist, java.lang.String track, Session session)
artist
- The artist name in questiontrack
- The track name in questionsession
- A Session instance
public static Track getInfo(java.lang.String artist, java.lang.String trackOrMbid, java.lang.String apiKey)
artist
- The artist name in question or null
if an mbid is specifiedtrackOrMbid
- The track name in question or the musicbrainz id for the trackapiKey
- A Last.fm API key.
public static Track trackFromElement(DomElement e)
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |