it.polimi.dima.mediatracker.external_services.services

Class MediaItemService

java.lang.Object

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

Direct Known Subclasses:

BookService, MovieService, TVShowService, VideogameService

public abstract class MediaItemService
extends java.lang.Object

Abstract service for a generic media item that allows to connect to an external API to retrieve data Uses Retrofit external library to manage the connection

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	MediaItemService.MediaItemInfoCallback Callback called when the external service media item details are available
static interface	MediaItemService.MediaItemSearchCallback Callback called when the external service search results are available

Field Summary

Fields

Modifier and Type	Field and Description
static int	MAX_SEARCH_RESULTS

Method Summary

Modifier and Type	Method and Description
protected abstract java.lang.String	getBaseUrl() Get the external API base URL
abstract void	getMediaItemInfo(java.lang.String externalServiceId, MediaItemService.MediaItemInfoCallback mediaItemInfoCallback) Allows to get information about a specific media item
protected abstract void	initializeRestInterface(retrofit2.Retrofit retrofit) Allows the subclasses to initialize the REST interface with the given retrofit instance
abstract 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

Field Detail

MAX_SEARCH_RESULTS

public static final int MAX_SEARCH_RESULTS

See Also:

Constant Field Values

Method Detail

getBaseUrl

protected abstract java.lang.String getBaseUrl()

Get the external API base URL

Returns:

the base url

initializeRestInterface

protected abstract void initializeRestInterface(retrofit2.Retrofit retrofit)

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

Parameters:

retrofit - the retrofit instance

searchMediaItems

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

Allows to search for media items

Parameters:

query - the title to search

mediaItemSearchCallback - the callback that will receive the results

getMediaItemInfo

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

Allows to get information about a specific media item

Parameters:

externalServiceId - the external service ID linked with the media item

mediaItemInfoCallback - the callback that will receive the results