org.apache.druid.query.extraction

Class RegexDimExtractionFn

java.lang.Object

org.apache.druid.query.extraction.DimExtractionFn

org.apache.druid.query.extraction.RegexDimExtractionFn

All Implemented Interfaces:

Cacheable, ExtractionFn

public class RegexDimExtractionFn
extends DimExtractionFn

Nested Class Summary

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

ExtractionFn.ExtractionType

Constructor Summary

Constructors

Constructor and Description
RegexDimExtractionFn(String expr, Boolean replaceMissingValue, String replaceMissingValueWith)
RegexDimExtractionFn(String expr, Integer index, Boolean replaceMissingValue, String replaceMissingValueWith)

Method Summary

Modifier and Type	Method and Description
String	apply(String dimValue) The "extraction" function.
boolean	equals(Object o)
byte[]	getCacheKey()
String	getExpr()
ExtractionFn.ExtractionType	getExtractionType() A dim extraction can be of one of two types, renaming or rebucketing.
int	getIndex()
String	getReplaceMissingValueWith()
int	hashCode()
boolean	isReplaceMissingValue()
boolean	preservesOrdering() Offers information on whether the extraction will preserve the original ordering of the values.
String	toString()

Methods inherited from class org.apache.druid.query.extraction.DimExtractionFn

apply, apply

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

RegexDimExtractionFn

public RegexDimExtractionFn(String expr,
                            Integer index,
                            Boolean replaceMissingValue,
                            String replaceMissingValueWith)

RegexDimExtractionFn

public RegexDimExtractionFn(String expr,
                            Boolean replaceMissingValue,
                            String replaceMissingValueWith)

Method Detail

getCacheKey

public byte[] getCacheKey()

apply

@Nullable
public String apply(@Nullable
                              String dimValue)

Description copied from interface: ExtractionFn

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

Like ExtractionFn.apply(Object), the empty string is considered invalid output for this method and it should instead return null.

Parameters:

dimValue - the original value of the dimension

Returns:

a value that should be used instead of the original

getExpr

public String getExpr()

getIndex

public int getIndex()

isReplaceMissingValue

public boolean isReplaceMissingValue()

getReplaceMissingValueWith

public String getReplaceMissingValueWith()

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.

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

Returns:

ExtractionFn.ExtractionType declaring what kind of manipulation this function does

toString

public String toString()

Overrides:

toString in class Object

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object