io.druid.query.lookup.namespace

Interface ExtractionNamespaceCacheFactory<T extends ExtractionNamespace>

All Known Implementing Classes:

JDBCExtractionNamespaceCacheFactory, StaticMapExtractionNamespaceCacheFactory, URIExtractionNamespaceCacheFactory

public interface ExtractionNamespaceCacheFactory<T extends ExtractionNamespace>

Method Summary

Modifier and Type

Method and Description

CacheScheduler.VersionedCache

populateCache(T namespace, CacheScheduler.EntryImpl<T> id, String lastVersion, CacheScheduler scheduler) If the lookup source, encapsulated by this ExtractionNamespaceCacheFactory, has data newer than identified by the given lastVersion (which is null at the first run of this method, or the version from the previous run), this method creates a new CacheScheduler.VersionedCache with CacheScheduler.createVersionedCache(io.druid.server.lookup.namespace.cache.CacheScheduler.EntryImpl<? extends io.druid.query.lookup.namespace.ExtractionNamespace>, java.lang.String), called on the given scheduler, with the version string identifying the current version of lookup source, populates the created VersionedCache and returns it.

Method Detail

populateCache

@Nullable
CacheScheduler.VersionedCache populateCache(T namespace,
                                                      CacheScheduler.EntryImpl<T> id,
                                                      String lastVersion,
                                                      CacheScheduler scheduler)
                                               throws Exception

If the lookup source, encapsulated by this ExtractionNamespaceCacheFactory, has data newer than identified by the given lastVersion (which is null at the first run of this method, or the version from the previous run), this method creates a new CacheScheduler.VersionedCache with CacheScheduler.createVersionedCache(io.druid.server.lookup.namespace.cache.CacheScheduler.EntryImpl<? extends io.druid.query.lookup.namespace.ExtractionNamespace>, java.lang.String), called on the given scheduler, with the version string identifying the current version of lookup source, populates the created VersionedCache and returns it. If the lookup source is up-to-date, this methods returns null.

Parameters:

namespace - The ExtractionNamespace for which to populate data.

id - An object uniquely corresponding to the CacheScheduler.Entry, for which this populateCache() method is called. Also it has the same toString() representation, that is useful for logging

lastVersion - The version which was last cached

scheduler - Should be used only to call CacheScheduler.createVersionedCache(io.druid.server.lookup.namespace.cache.CacheScheduler.EntryImpl<? extends io.druid.query.lookup.namespace.ExtractionNamespace>, java.lang.String).

Returns:

the new cache along with the new version, or null if the last version is up-to-date.

Throws:

Exception