it.polimi.dima.mediatracker.external_services.services

Class BookService

java.lang.Object

it.polimi.dima.mediatracker.external_services.services.MediaItemService

it.polimi.dima.mediatracker.external_services.services.BookService

public class BookService
extends MediaItemService

Service for books that allows to connect to an external API to retrieve data Uses Retrofit external library to manage the connection

Nested Class Summary

Nested classes/interfaces inherited from class it.polimi.dima.mediatracker.external_services.services.MediaItemService

MediaItemService.MediaItemInfoCallback, MediaItemService.MediaItemSearchCallback

Field Summary

Fields inherited from class it.polimi.dima.mediatracker.external_services.services.MediaItemService

MAX_SEARCH_RESULTS

Method Summary

Modifier and Type	Method and Description
protected java.lang.String	getBaseUrl() Get the external API base URL
static BookService	getInstance(Context context) Singleton pattern
void	getMediaItemInfo(java.lang.String externalServiceId, MediaItemService.MediaItemInfoCallback mediaItemInfoCallback) Allows to get information about a specific media item
protected void	initializeRestInterface(retrofit2.Retrofit retrofit) Allows the subclasses to initialize the REST interface with the given retrofit instance
void	searchMediaItems(java.lang.String query, MediaItemService.MediaItemSearchCallback mediaItemSearchCallback) Allows to search for media items

Methods inherited from class java.lang.Object

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

Method Detail

getInstance

public static BookService getInstance(Context context)

Singleton pattern

getBaseUrl

protected java.lang.String getBaseUrl()

Get the external API base URL

Specified by:

getBaseUrl in class MediaItemService

Returns:

the base url

initializeRestInterface

protected void initializeRestInterface(retrofit2.Retrofit retrofit)

Allows the subclasses to initialize the REST interface with the given retrofit instance

Specified by:

initializeRestInterface in class MediaItemService

Parameters:

retrofit - the retrofit instance

searchMediaItems

public void searchMediaItems(java.lang.String query,
                             MediaItemService.MediaItemSearchCallback mediaItemSearchCallback)

Allows to search for media items

Specified by:

searchMediaItems in class MediaItemService

Parameters:

query - the title to search

mediaItemSearchCallback - the callback that will receive the results

getMediaItemInfo

public void getMediaItemInfo(java.lang.String externalServiceId,
                             MediaItemService.MediaItemInfoCallback mediaItemInfoCallback)

Allows to get information about a specific media item

Specified by:

getMediaItemInfo in class MediaItemService

Parameters:

externalServiceId - the external service ID linked with the media item

mediaItemInfoCallback - the callback that will receive the results