net.roarsoftware.lastfm
Class Tag

java.lang.Object
  extended by 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>