me.tobiadeyinka.itunessearch.lookup

Class MusicLookup

java.lang.Object

me.tobiadeyinka.itunessearch.lookup.MusicLookup

public abstract class MusicLookup
extends Object

This class manages looking up podcasts with different attributes Created by Tobi Adeyinka on 2018. 04. 07..

Field Summary

Fields

Modifier and Type	Field and Description
protected static String	BASE_LOOKUP_URL
protected static com.neovisionaries.i18n.CountryCode	DEFAULT_COUNTRY
protected static int	DEFAULT_LIMIT

Constructor Summary

Constructors

Constructor and Description
MusicLookup()

Method Summary

Modifier and Type	Method and Description
protected static org.json.JSONObject	executeQuery(String urlString)
static org.json.JSONObject	getAlbumById(long id) get an album by it's id
protected static org.json.JSONObject	getById(long id) retrieve a media item by its id
static org.json.JSONObject	getSongById(long id) get a song by it's id
static org.json.JSONObject	hotTracks() get the top 100 hot tracks in the default iTunes store
static org.json.JSONObject	hotTracks(com.neovisionaries.i18n.CountryCode countryCode) get the top 100 hot tracks in the specified iTunes store
static org.json.JSONObject	hotTracks(com.neovisionaries.i18n.CountryCode countryCode, int limit) get the top (limit) hot tracks in the specified iTunes store
static org.json.JSONObject	hotTracks(int limit) get the top (limit) hot tracks in the default iTunes store
static org.json.JSONObject	newMusic() get the top 100 new songs in the default iTunes store
static org.json.JSONObject	newMusic(com.neovisionaries.i18n.CountryCode countryCode) get the top 100 new songs in the specified iTunes store
static org.json.JSONObject	newMusic(com.neovisionaries.i18n.CountryCode countryCode, int limit) get the top (limit) new songs in the specified iTunes store
static org.json.JSONObject	newMusic(int limit) get the top (limit) new songs in the default iTunes store
static org.json.JSONObject	recentReleases() get the top 100 recent releases in the default iTunes store
static org.json.JSONObject	recentReleases(com.neovisionaries.i18n.CountryCode countryCode) get the top 100 recent releases in the specified iTunes store
static org.json.JSONObject	recentReleases(com.neovisionaries.i18n.CountryCode countryCode, int limit) get the top (limit) recent releases in the specified iTunes store
static org.json.JSONObject	recentReleases(int limit) get the top (limit) recent releases in the default iTunes store
static org.json.JSONObject	topAlbums() get the top 100 top albums in the default iTunes store
static org.json.JSONObject	topAlbums(com.neovisionaries.i18n.CountryCode countryCode) get the top 100 top albums in the specified iTunes store
static org.json.JSONObject	topAlbums(com.neovisionaries.i18n.CountryCode countryCode, int limit) get the top (limit) top albums in the specified iTunes store
static org.json.JSONObject	topAlbums(int limit) get the top (limit) top albums in the default iTunes store
static org.json.JSONObject	topSongs() get the top 100 songs in the default iTunes store
static org.json.JSONObject	topSongs(com.neovisionaries.i18n.CountryCode countryCode) get the top 100 songs in the specified iTunes store
static org.json.JSONObject	topSongs(com.neovisionaries.i18n.CountryCode countryCode, int limit) get the top (limit) songs in the specified iTunes store
static org.json.JSONObject	topSongs(int limit) get the top (limit) songs in the default iTunes store

Methods inherited from class java.lang.Object

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

Field Detail

BASE_LOOKUP_URL

protected static final String BASE_LOOKUP_URL

See Also:

Constant Field Values

DEFAULT_LIMIT

protected static final int DEFAULT_LIMIT

See Also:

Constant Field Values

DEFAULT_COUNTRY

protected static final com.neovisionaries.i18n.CountryCode DEFAULT_COUNTRY

Constructor Detail

MusicLookup

public MusicLookup()

Method Detail

getSongById

public static org.json.JSONObject getSongById(long id)
                                       throws NoMatchFoundException

get a song by it's id

Parameters:

id - The id of the song

Returns:

a JSONObject of the song

Throws:

NoMatchFoundException - if no song is found with the passed id

topSongs

public static org.json.JSONObject topSongs()

get the top 100 songs in the default iTunes store

Returns:

a JSONObject containing a list of the top songs

topSongs

public static org.json.JSONObject topSongs(int limit)

get the top (limit) songs in the default iTunes store

Parameters:

limit - the maximum number of songs to return

Returns:

a JSONObject containing a list of the top songs

topSongs

public static org.json.JSONObject topSongs(com.neovisionaries.i18n.CountryCode countryCode)

get the top 100 songs in the specified iTunes store

Parameters:

countryCode - country code of the itunes store to search

Returns:

a JSONObject containing a list of the top songs

topSongs

public static org.json.JSONObject topSongs(com.neovisionaries.i18n.CountryCode countryCode,
                                           int limit)

get the top (limit) songs in the specified iTunes store

Parameters:

countryCode - country code of the itunes store to search

limit - the maximum number of songs to return

Returns:

a JSONObject containing a list of the top songs

hotTracks

public static org.json.JSONObject hotTracks()

get the top 100 hot tracks in the default iTunes store

Returns:

a JSONObject containing a list of the tracks

hotTracks

public static org.json.JSONObject hotTracks(int limit)

get the top (limit) hot tracks in the default iTunes store

Parameters:

limit - the maximum number of songs to return

Returns:

a JSONObject containing a list of the tracks

hotTracks

public static org.json.JSONObject hotTracks(com.neovisionaries.i18n.CountryCode countryCode)

get the top 100 hot tracks in the specified iTunes store

Parameters:

countryCode - country code of the itunes store to search

Returns:

a JSONObject containing a list of the tracks

hotTracks

public static org.json.JSONObject hotTracks(com.neovisionaries.i18n.CountryCode countryCode,
                                            int limit)

get the top (limit) hot tracks in the specified iTunes store

Parameters:

countryCode - country code of the itunes store to search

limit - the maximum number of tracks to return

Returns:

a JSONObject containing a list of the tracks

newMusic

public static org.json.JSONObject newMusic()

get the top 100 new songs in the default iTunes store

Returns:

a JSONObject containing a list of the songs

newMusic

public static org.json.JSONObject newMusic(int limit)

get the top (limit) new songs in the default iTunes store

Parameters:

limit - the maximum number of songs to return

Returns:

a JSONObject containing a list of the songs

newMusic

public static org.json.JSONObject newMusic(com.neovisionaries.i18n.CountryCode countryCode)

get the top 100 new songs in the specified iTunes store

Parameters:

countryCode - country code of the itunes store to search

Returns:

a JSONObject containing a list of the songs

newMusic

public static org.json.JSONObject newMusic(com.neovisionaries.i18n.CountryCode countryCode,
                                           int limit)

get the top (limit) new songs in the specified iTunes store

Parameters:

countryCode - country code of the itunes store to search

limit - the maximum number of songs to return

Returns:

a JSONObject containing a list of the songs

recentReleases

public static org.json.JSONObject recentReleases()

get the top 100 recent releases in the default iTunes store

Returns:

a JSONObject containing a list of the songs

recentReleases

public static org.json.JSONObject recentReleases(int limit)

get the top (limit) recent releases in the default iTunes store

Parameters:

limit - the maximum number of songs to return

Returns:

a JSONObject containing a list of the songs

recentReleases

public static org.json.JSONObject recentReleases(com.neovisionaries.i18n.CountryCode countryCode)

get the top 100 recent releases in the specified iTunes store

Parameters:

countryCode - country code of the itunes store to search

Returns:

a JSONObject containing a list of the songs

recentReleases

public static org.json.JSONObject recentReleases(com.neovisionaries.i18n.CountryCode countryCode,
                                                 int limit)

get the top (limit) recent releases in the specified iTunes store

Parameters:

countryCode - country code of the itunes store to search

limit - the maximum number of songs to return

Returns:

a JSONObject containing a list of the songs

getAlbumById

public static org.json.JSONObject getAlbumById(long id)
                                        throws NoMatchFoundException

get an album by it's id

Parameters:

id - The id of the album

Returns:

a JSONObject of the album

Throws:

NoMatchFoundException - if no album is found with the passed id

topAlbums

public static org.json.JSONObject topAlbums()

get the top 100 top albums in the default iTunes store

Returns:

a JSONObject containing a list of the albums

topAlbums

public static org.json.JSONObject topAlbums(int limit)

get the top (limit) top albums in the default iTunes store

Parameters:

limit - the maximum number of songs to return

Returns:

a JSONObject containing a list of the albums

topAlbums

public static org.json.JSONObject topAlbums(com.neovisionaries.i18n.CountryCode countryCode)

get the top 100 top albums in the specified iTunes store

Parameters:

countryCode - country code of the itunes store to search

Returns:

a JSONObject containing a list of the albums

topAlbums

public static org.json.JSONObject topAlbums(com.neovisionaries.i18n.CountryCode countryCode,
                                            int limit)

get the top (limit) top albums in the specified iTunes store

Parameters:

countryCode - country code of the itunes store to search

limit - the maximum number of songs to return

Returns:

a JSONObject containing a list of the songs

getById

protected static org.json.JSONObject getById(long id)
                                      throws NoMatchFoundException

retrieve a media item by its id

Parameters:

id - the itunes id for the item

Returns:

a JSONObject representation of the item

Throws:

NoMatchFoundException - if no matching item is found

executeQuery

protected static org.json.JSONObject executeQuery(String urlString)