com.intentsoftware.addapptr

Class BannerCache

java.lang.Object

com.intentsoftware.addapptr.BannerCache

public final class BannerCache
extends Object

A cache of automatically preloaded banner ads. The cache will always try to have a defined amount of banners available for immediate handout to the app whenever they are needed. The BannerCache needs to be destroyed when no longer needed.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	BannerCache.CacheDelegate Optional delegate informing about events in BannerCache.

Constructor Summary

Constructors

Constructor and Description
BannerCache(BannerCacheConfiguration cacheConfiguration) Creates a cache of automatically preloaded banner ads.

Method Summary

Modifier and Type	Method and Description
BannerPlacementLayout	consume() Returns an instance of BannerPlacementLayout to be used within the app.
BannerPlacementLayout	consume(boolean force) Returns an instance of BannerPlacementLayout to be used within the app.
void	destroy() Destroys the BannerCache, clearing all preloaded banner ads and canceling pending reload requests.
String	toString()
void	updateRequestConfiguration(BannerRequest requestConfiguration, boolean shouldRefresh) Updates the configuration that will be used when requesting new banners.

Methods inherited from class java.lang.Object

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

Constructor Detail

BannerCache

public BannerCache(BannerCacheConfiguration cacheConfiguration)

Creates a cache of automatically preloaded banner ads.

Parameters:

cacheConfiguration - BannerCacheConfiguration instance used to configure the cache.

Method Detail

updateRequestConfiguration

public void updateRequestConfiguration(BannerRequest requestConfiguration,
                                       boolean shouldRefresh)

Updates the configuration that will be used when requesting new banners.

Parameters:

requestConfiguration - BannerRequest instance. Can not be null.

shouldRefresh - True if the whole cache should be re-loaded with new banner request configuration, false if new configuration should only be used for new requests.

consume

public BannerPlacementLayout consume()

Returns an instance of BannerPlacementLayout to be used within the app. Also automatically counts an ad space.

BannerCache will no longer hold any references to returned banners, and they need to be destroyed manually by the app.

This method respects the frequency capping, set by BannerCacheConfiguration.setMinimumDelay(int)

Returns:

BannerPlacementLayout instance.

consume

public BannerPlacementLayout consume(boolean force)

Returns an instance of BannerPlacementLayout to be used within the app. Also automatically counts an ad space. BannerCache will no longer hold any references to returned banners, and they need to be destroyed manually by the app.

Parameters:

force - true if cache should try to return banner ignoring the frequency capping set by BannerCacheConfiguration.setMinimumDelay(int)

Returns:

BannerPlacementLayout instance.

destroy

public void destroy()

Destroys the BannerCache, clearing all preloaded banner ads and canceling pending reload requests. For proper memory management, it needs to be called when the BannerCache is no longer needed. Destroyed BannerCache can no longer be used.

toString

public String toString()

Overrides:

toString in class Object