io.druid.query.extraction

Class LowerExtractionFn

java.lang.Object

io.druid.query.extraction.LowerExtractionFn

All Implemented Interfaces:

ExtractionFn

public class LowerExtractionFn
extends Object
implements ExtractionFn

Nested Class Summary

Nested classes/interfaces inherited from interface io.druid.query.extraction.ExtractionFn

ExtractionFn.ExtractionType

Constructor Summary

Constructors

Constructor and Description
LowerExtractionFn(String localeString)

Method Summary

Modifier and Type	Method and Description
String	apply(long value)
String	apply(Object value) The "extraction" function.
String	apply(String key)
byte[]	getCacheKey() Returns a byte[] unique to all concrete implementations of DimExtractionFn.
ExtractionFn.ExtractionType	getExtractionType() A dim extraction can be of one of two types, renaming or rebucketing.
boolean	preservesOrdering() Offers information on whether the extraction will preserve the original ordering of the values.

Methods inherited from class java.lang.Object

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

Constructor Detail

LowerExtractionFn

public LowerExtractionFn(String localeString)

Method Detail

apply

@Nullable
public String apply(String key)

Specified by:

apply in interface ExtractionFn

Parameters:

key - string input of extraction function

Returns:

new string with all of the characters in key as an lower case or null if key is empty or null

apply

public String apply(long value)

Specified by:

apply in interface ExtractionFn

preservesOrdering

public boolean preservesOrdering()

Description copied from interface: ExtractionFn

Offers information on whether the extraction will preserve the original ordering of the values.

Some optimizations of queries is possible if ordering is preserved. Null values *do* count towards ordering.

Specified by:

preservesOrdering in interface ExtractionFn

Returns:

true if ordering is preserved, false otherwise

getExtractionType

public ExtractionFn.ExtractionType getExtractionType()

Description copied from interface: ExtractionFn

A dim extraction can be of one of two types, renaming or rebucketing. In the `ONE_TO_ONE` case, a unique values is modified into another unique value. In the `MANY_TO_ONE` case, there is no longer a 1:1 relation between old dimension value and new dimension value

Specified by:

getExtractionType in interface ExtractionFn

Returns:

ExtractionFn.ExtractionType declaring what kind of manipulation this function does

getCacheKey

public byte[] getCacheKey()

Description copied from interface: ExtractionFn

Returns a byte[] unique to all concrete implementations of DimExtractionFn. This byte[] is used to generate a cache key for the specific query.

Specified by:

getCacheKey in interface ExtractionFn

Returns:

a byte[] unit to all concrete implements of DimExtractionFn

apply

public String apply(Object value)

Description copied from interface: ExtractionFn

The "extraction" function. This should map a value into some other String value.

In order to maintain the "null and empty string are equivalent" semantics that Druid provides, the empty string is considered invalid output for this method and should instead return null. This is a contract on the method rather than enforced at a lower level in order to eliminate a global check for extraction functions that do not already need one.

Specified by:

apply in interface ExtractionFn

Parameters:

value - the original value of the dimension

Returns:

a value that should be used instead of the original