me.tobiadeyinka.itunessearch.lookup

Class MovieLookup

java.lang.Object

me.tobiadeyinka.itunessearch.lookup.MovieLookup

public class MovieLookup
extends Object

This class manages looking up movies. Created by Tobi Adeyinka on 2018. 05. 05..

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
MovieLookup()

Method Summary

Modifier and Type	Method and Description
protected static org.json.JSONObject	executeQuery(String urlString)
protected static org.json.JSONObject	getById(long id) retrieve a media item by its id
static org.json.JSONObject	getMovieById(long id) get a movie by it's id
static org.json.JSONObject	topMovies() get the top 100 movies in the default iTunes store
static org.json.JSONObject	topMovies(com.neovisionaries.i18n.CountryCode countryCode) get the top 100 movies in the specified iTunes store
static org.json.JSONObject	topMovies(com.neovisionaries.i18n.CountryCode countryCode, int limit) get the top (limit) movies in the specified iTunes store
static org.json.JSONObject	topMovies(int limit) get the top (limit) movies 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

MovieLookup

public MovieLookup()

Method Detail

getMovieById

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

get a movie by it's id

Parameters:

id - The id of the movie

Returns:

a JSONObject of the movie

Throws:

NoMatchFoundException - if no movie is found with the passed id

topMovies

public static org.json.JSONObject topMovies()

get the top 100 movies in the default iTunes store

Returns:

a JSONObject containing a list of the top movies

topMovies

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

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

Parameters:

limit - the maximum number of movies to return

Returns:

a JSONObject containing a list of the top movies

topMovies

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

get the top 100 movies in the specified iTunes store

Parameters:

countryCode - country code of the itunes store to search

Returns:

a JSONObject containing a list of the top movies

topMovies

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

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

Parameters:

countryCode - country code of the itunes store to search

limit - the maximum number of movies to return

Returns:

a JSONObject containing a list of the top 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)