net.roarsoftware.lastfm
Class Tag

java.lang.Object
  net.roarsoftware.lastfm.Tag

All Implemented Interfaces:

java.lang.Comparable<Tag>

public class Tag
extends java.lang.Object
implements java.lang.Comparable<Tag>

Bean for Tag data and provides methods for global tags.

Author:

Janni Kovacs

Method Summary

int	compareTo(Tag o)
static java.util.List<Tag>	filter(java.util.Collection<Tag> tags, double percentage) Filters tags from the given list; retains only those tags with a count higher than the given percentage of the total sum as from getTagCountSum(Collection).
int	getCount()
java.lang.String	getName()
static java.util.Collection<java.lang.String>	getSimilar(java.lang.String tag, java.lang.String apiKey)
static long	getTagCountSum(java.util.Collection<Tag> tags) Returns the sum of all count elements in the results.
static java.util.Collection<Album>	getTopAlbums(java.lang.String tag, java.lang.String apiKey)
static java.util.Collection<Artist>	getTopArtists(java.lang.String tag, java.lang.String apiKey)
static java.util.List<Tag>	getTopTags(java.lang.String apiKey)
static java.util.Collection<Track>	getTopTracks(java.lang.String tag, java.lang.String apiKey)
java.lang.String	getUrl()
static Chart<Artist>	getWeeklyArtistChart(java.lang.String tag, int limit, java.lang.String apiKey)
static Chart<Artist>	getWeeklyArtistChart(java.lang.String tag, java.lang.String apiKey)
static Chart<Artist>	getWeeklyArtistChart(java.lang.String tag, java.lang.String from, java.lang.String to, int limit, java.lang.String apiKey)
static java.util.LinkedHashMap<java.lang.String,java.lang.String>	getWeeklyChartList(java.lang.String tag, java.lang.String apiKey)
static java.util.Collection<Chart>	getWeeklyChartListAsCharts(java.lang.String tag, java.lang.String apiKey)
static java.util.Collection<java.lang.String>	search(java.lang.String tag, int limit, java.lang.String apiKey)
static java.util.Collection<java.lang.String>	search(java.lang.String tag, java.lang.String apiKey)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getCount

public int getCount()

getName

public java.lang.String getName()

getUrl

public java.lang.String getUrl()

getTagCountSum

public static long getTagCountSum(java.util.Collection<Tag> tags)

Returns the sum of all count elements in the results.

Parameters:

tags - a list of tags

Returns:

the total count of all tags

filter

public static java.util.List<Tag> filter(java.util.Collection<Tag> tags,
                                         double percentage)

Filters tags from the given list; retains only those tags with a count higher than the given percentage of the total sum as from getTagCountSum(Collection).

Parameters:

tags - list of tags

percentage - cut off percentage

Returns:

the filtered list of tags

getSimilar

public static java.util.Collection<java.lang.String> getSimilar(java.lang.String tag,
                                                                java.lang.String apiKey)

getTopTags

public static java.util.List<Tag> getTopTags(java.lang.String apiKey)

getTopAlbums

public static java.util.Collection<Album> getTopAlbums(java.lang.String tag,
                                                       java.lang.String apiKey)

getTopTracks

public static java.util.Collection<Track> getTopTracks(java.lang.String tag,
                                                       java.lang.String apiKey)

getTopArtists

public static java.util.Collection<Artist> getTopArtists(java.lang.String tag,
                                                         java.lang.String apiKey)

search

public static java.util.Collection<java.lang.String> search(java.lang.String tag,
                                                            java.lang.String apiKey)

search

public static java.util.Collection<java.lang.String> search(java.lang.String tag,
                                                            int limit,
                                                            java.lang.String apiKey)

getWeeklyArtistChart

public static Chart<Artist> getWeeklyArtistChart(java.lang.String tag,
                                                 java.lang.String apiKey)

getWeeklyArtistChart

public static Chart<Artist> getWeeklyArtistChart(java.lang.String tag,
                                                 int limit,
                                                 java.lang.String apiKey)

getWeeklyArtistChart

public static Chart<Artist> getWeeklyArtistChart(java.lang.String tag,
                                                 java.lang.String from,
                                                 java.lang.String to,
                                                 int limit,
                                                 java.lang.String apiKey)

getWeeklyChartList

public static java.util.LinkedHashMap<java.lang.String,java.lang.String> getWeeklyChartList(java.lang.String tag,
                                                                                            java.lang.String apiKey)

getWeeklyChartListAsCharts

public static java.util.Collection<Chart> getWeeklyChartListAsCharts(java.lang.String tag,
                                                                     java.lang.String apiKey)

compareTo

public int compareTo(Tag o)

Specified by:

compareTo in interface java.lang.Comparable<Tag>