com.gfycat.core.downloading

Interface FeedManager

All Known Implementing Classes:

FeedManagerAsyncWrapper, FeedManagerImpl

public interface FeedManager

Responsible for downloading Gfycat items.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	FeedManager.InternalGfycatException Indicate that there is an internal unhandled error inside Gfycat SDK.
static class	FeedManager.NoSearchResultException Indicates that there are no [more] results for requested search.

Method Summary

Modifier and Type	Method and Description
<any>	getCategories() Request categories list from cache.
<any>	getGfycat(java.lang.String gfyId) Look for a Gfycat in cache.
Completable	getGfycats(FeedIdentifier feedIdentifier) Perform a network request of Gfycat list for a specified .
Completable	getMoreGfycats(FeedDescription feedDescription) Perform a network request of more Gfycats for corresponding feed.
Completable	getNewGfycats(FeedDescription feedDescription) Perform a network request of new Gfycats for a specified .
<any>	observeGfycats(android.content.Context context, FeedIdentifier feedIdentifier) Deprecated.
<any>	observeGfycats(FeedIdentifier feedIdentifier) Subscribe for Gfycat changes in local DB.

Method Detail

getCategories

<any> getCategories()

Request categories list from cache. If none found, network request will be performed.

If found in cache but expired - will return cached one and perform network request for updates.

So, onNext may be called more than once!!!

Returns:

Returns GfycatCategoriesList observable.

observeGfycats

<any> observeGfycats(FeedIdentifier feedIdentifier)

Subscribe for Gfycat changes in local DB.

!!! Important: You should NOT forget to unsubscribe, otherwise memory leak will occur.

Parameters:

feedIdentifier - - to subscribe for.

Returns:

Returns FeedData flowable.

observeGfycats

@Deprecated
<any> observeGfycats(android.content.Context context,
                                 FeedIdentifier feedIdentifier)

Deprecated.

See observeGfycats(FeedIdentifier).

Deprecation reason: Context not required anymore. Target deprecation version: 0.9.0

getGfycats

Completable getGfycats(FeedIdentifier feedIdentifier)

Perform a network request of Gfycat list for a specified . FeedData containing this request result will be returned via observeGfycats(Context, FeedIdentifier) observable.

Parameters:

feedIdentifier - - to get gfycats for.

Returns:

Returns Completable calling onError in case of failure or onComplete in case of success.

getNewGfycats

Completable getNewGfycats(FeedDescription feedDescription)

Perform a network request of new Gfycats for a specified . FeedData containing this request result will be returned via observeGfycats(Context, FeedIdentifier) observable.

NOTE: This works only with FeedDescription obtained via PublicFeedIdentifier.trending().

Parameters:

feedDescription - from the latest FeedData received with observeGfycats(Context, FeedIdentifier)

Returns:

Returns Completable calling onError in case of failure or onComplete in case of success.

getMoreGfycats

Completable getMoreGfycats(FeedDescription feedDescription)

Perform a network request of more Gfycats for corresponding feed. Will download Gfycats and save to local DB if needed.

FeedData containing this request result will be returned via observeGfycats(Context, FeedIdentifier) observable.

Parameters:

feedDescription - from latest FeedData received with observeGfycats(Context, FeedIdentifier).

Returns:

Returns Completable calling onError in case of failure or onComplete in case of success

getGfycat

<any> getGfycat(java.lang.String gfyId)

Look for a Gfycat in cache. Request one from network, if not found.

Returns:

Returns Single emitting a Gfycat object or null, if not found neither in cache nor during network request.