io.druid.query.lookup

Class LookupExtractor

java.lang.Object

io.druid.query.lookup.LookupExtractor

Direct Known Subclasses:

LoadingLookup, MapLookupExtractor, PollingLookup

public abstract class LookupExtractor
extends Object

Constructor Summary

Constructors

Constructor and Description
LookupExtractor()

Method Summary

Modifier and Type	Method and Description
abstract String	apply(String key) Apply a particular lookup methodology to the input string
Map<String,String>	applyAll(Iterable<String> keys)
abstract byte[]	getCacheKey() Create a cache key for use in results caching
boolean	isOneToOne()
abstract List<String>	unapply(String value) Provide the reverse mapping from a given value to a list of keys
Map<String,List<String>>	unapplyAll(Iterable<String> values)

Methods inherited from class java.lang.Object

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

Constructor Detail

LookupExtractor

public LookupExtractor()

Method Detail

apply

@Nullable
public abstract String apply(@NotNull
                                       String key)

Apply a particular lookup methodology to the input string

Parameters:

key - The value to apply the lookup to. May not be null

Returns:

The lookup, or null key cannot have the lookup applied to it and should be treated as missing.

applyAll

public Map<String,String> applyAll(Iterable<String> keys)

Parameters:

keys - set of keys to apply lookup for each element

Returns:

Returns Map whose keys are the contents of keys and whose values are computed on demand using lookup function unapply(String) or empty map if values is `null` User can override this method if there is a better way to perform bulk lookup

unapply

public abstract List<String> unapply(String value)

Provide the reverse mapping from a given value to a list of keys

Parameters:

value - the value to apply the reverse lookup Null and empty are considered to be the same value = nullToEmpty(value)

Returns:

the list of keys that maps to value or empty list. Note that for the case of a none existing value in the lookup we have to cases either return an empty list OR list with null element. returning an empty list implies that user want to ignore such a lookup value. In the other hand returning a list with the null element implies user want to map the none existing value to the key null.

unapplyAll

public Map<String,List<String>> unapplyAll(Iterable<String> values)

Parameters:

values - Iterable of values for which will perform reverse lookup

Returns:

Returns Map whose keys are the contents of values and whose values are computed on demand using the reverse lookup function unapply(String) or empty map if values is `null` User can override this method if there is a better way to perform bulk reverse lookup

getCacheKey

public abstract byte[] getCacheKey()

Create a cache key for use in results caching

Returns:

A byte array that can be used to uniquely identify if results of a prior lookup can use the cached values

isOneToOne

public boolean isOneToOne()