org.apache.drill.exec.expr.fn.registry

Class LocalFunctionRegistry

java.lang.Object

org.apache.drill.exec.expr.fn.registry.LocalFunctionRegistry

public class LocalFunctionRegistry
extends Object

Registry of Drill functions.

Field Summary

Fields

Modifier and Type	Field and Description
static String	BUILT_IN

Constructor Summary

Constructors

Constructor and Description
LocalFunctionRegistry(ScanResult classpathScan) Registers all functions present in Drill classpath on start-up.

Method Summary

Methods

Modifier and Type	Method and Description
List<String>	getAllJarNames() Returns list of jar names registered in function registry.
List<DrillFuncHolder>	getMethods(String name)
List<DrillFuncHolder>	getMethods(String name, AtomicLong version)
long	getVersion()
void	register(DrillOperatorTable operatorTable) Registers all functions present in DrillOperatorTable, also sets sync registry version used at the moment of function registration.
void	register(List<JarScan> jars, long version) Registers all functions present in jar and updates registry version.
int	size()
void	unregister(String jarName) Removes all function associated with the given jar name.
List<String>	validate(String jarName, ScanResult scanResult) Validates all functions, present in jars.

Methods inherited from class java.lang.Object

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

Field Detail

BUILT_IN

public static final String BUILT_IN

See Also:

Constant Field Values

Constructor Detail

LocalFunctionRegistry

public LocalFunctionRegistry(ScanResult classpathScan)

Registers all functions present in Drill classpath on start-up. All functions will be marked as built-in. Built-in functions are not allowed to be unregistered. Initially sync registry version will be set to 0.

Method Detail

getVersion

public long getVersion()

Returns:

remote function registry version number with which local function registry is synced

validate

public List<String> validate(String jarName,
                    ScanResult scanResult)

Validates all functions, present in jars. Will throw FunctionValidationException if:

1. Jar with the same name has been already registered.
2. Conflicting function with the similar signature is found.
3. Aggregating function is not deterministic.

Parameters:

jarName - jar name to be validated

scanResult - scan of all classes present in jar

Returns:

list of validated function signatures

register

public void register(List<JarScan> jars,
            long version)

Registers all functions present in jar and updates registry version. If jar name is already registered, all jar related functions will be overridden. To prevent classpath collisions during loading and unloading jars, each jar is shipped with its own class loader.

Parameters:

jars - list of jars to be registered

version - remote function registry version number with which local function registry is synced

unregister

public void unregister(String jarName)

Removes all function associated with the given jar name. Functions marked as built-in is not allowed to be unregistered. If user attempts to unregister built-in functions, logs warning and does nothing. Jar name is case-sensitive.

Parameters:

jarName - jar name to be unregistered

getAllJarNames

public List<String> getAllJarNames()

Returns list of jar names registered in function registry.

Returns:

list of jar names

size

public int size()

Returns:

quantity of all registered functions

getMethods

public List<DrillFuncHolder> getMethods(String name,
                               AtomicLong version)

Parameters:

name - function name

Returns:

all function holders associated with the function name. Function name is case insensitive.

getMethods

public List<DrillFuncHolder> getMethods(String name)

Parameters:

name - function name

Returns:

all function holders associated with the function name. Function name is case insensitive.

register

public void register(DrillOperatorTable operatorTable)

Registers all functions present in DrillOperatorTable, also sets sync registry version used at the moment of function registration.

Parameters:

operatorTable - drill operator table