me.tobiadeyinka.itunessearch.lookup

Class BookLookup

java.lang.Object

me.tobiadeyinka.itunessearch.lookup.BookLookup

public class BookLookup
extends Object

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

Method Summary

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

BookLookup

public BookLookup()

Method Detail

getBookById

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

get a book by it's id

Parameters:

id - The id of the book

Returns:

a JSONObject of the book

Throws:

NoMatchFoundException - if no book is found with the passed id

topFree

public static org.json.JSONObject topFree()

get the top 100 free books in the default iTunes store

Returns:

a JSONObject containing a list of the top free books

topFree

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

get the top (limit) free books in the default iTunes store

Parameters:

limit - the maximum number of books to return

Returns:

a JSONObject containing a list of the top free books

topFree

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

get the top 100 free books in the specified iTunes store

Parameters:

countryCode - country code of the itunes store to search

Returns:

a JSONObject containing a list of the top free books

topFree

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

get the top (limit) free books in the specified iTunes store

Parameters:

countryCode - country code of the itunes store to search

limit - the maximum number of books to return

Returns:

a JSONObject containing a list of the top free books

topPaid

public static org.json.JSONObject topPaid()

get the top 100 paid books in the default iTunes store

Returns:

a JSONObject containing a list of the top paid books

topPaid

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

get the top (limit) paid books in the default iTunes store

Parameters:

limit - the maximum number of books to return

Returns:

a JSONObject containing a list of the top paid books

topPaid

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

get the top 100 paid books in the specified iTunes store

Parameters:

countryCode - country code of the itunes store to search

Returns:

a JSONObject containing a list of the top paid books

topPaid

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

get the top (limit) paid books in the specified iTunes store

Parameters:

countryCode - country code of the itunes store to search

limit - the maximum number of books to return

Returns:

a JSONObject containing a list of the top paid books

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)