org.elasticsearch.painless

Class Locals

java.lang.Object

org.elasticsearch.painless.Locals

public final class Locals
extends java.lang.Object

Tracks user defined methods and variables across compilation phases.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Locals.Parameter
static class	Locals.Variable

Field Summary

Fields

Modifier and Type	Field and Description
static java.util.Set<java.lang.String>	KEYWORDS Set of reserved keywords.
static java.lang.String	LOOP Reserved word: loop counter
static java.lang.String	THIS Reserved word: unused

Method Summary

Modifier and Type	Method and Description
Locals.Variable	addVariable(Location location, Definition.Type type, java.lang.String name, boolean readonly) Creates a new variable.
Definition	getDefinition() Whitelist against which this script is being compiled.
Definition.Method	getMethod(Definition.MethodKey key) Looks up a method.
Locals	getProgramScope() Returns the top-level program scope.
Definition.Type	getReturnType() Return type of this scope (e.g.
Locals.Variable	getVariable(Location location, java.lang.String name) Accesses a variable.
boolean	hasVariable(java.lang.String name) Checks if a variable exists or not, in this scope or any parents.
static Locals	newFunctionScope(Locals programScope, Definition.Type returnType, java.util.List<Locals.Parameter> parameters, int maxLoopCounter) Creates a new function scope inside the current scope
static Locals	newLambdaScope(Locals programScope, Definition.Type returnType, java.util.List<Locals.Parameter> parameters, int captureCount, int maxLoopCounter) Creates a new lambda scope inside the current scope
static Locals	newLocalScope(Locals currentScope) Creates a new local variable scope (e.g.
static Locals	newMainMethodScope(ScriptClassInfo scriptClassInfo, Locals programScope, int maxLoopCounter) Creates a new main method scope
static Locals	newProgramScope(Definition definition, java.util.Collection<Definition.Method> methods) Creates a new program scope: the list of methods.

Methods inherited from class java.lang.Object

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

Field Detail

LOOP

public static final java.lang.String LOOP

Reserved word: loop counter

See Also:

Constant Field Values

THIS

public static final java.lang.String THIS

Reserved word: unused

See Also:

Constant Field Values

KEYWORDS

public static final java.util.Set<java.lang.String> KEYWORDS

Set of reserved keywords.

Method Detail

newLocalScope

public static Locals newLocalScope(Locals currentScope)

Creates a new local variable scope (e.g. loop) inside the current scope

newLambdaScope

public static Locals newLambdaScope(Locals programScope,
                                    Definition.Type returnType,
                                    java.util.List<Locals.Parameter> parameters,
                                    int captureCount,
                                    int maxLoopCounter)

Creates a new lambda scope inside the current scope

This is just like newFunctionScope(org.elasticsearch.painless.Locals, org.elasticsearch.painless.Definition.Type, java.util.List<org.elasticsearch.painless.Locals.Parameter>, int), except the captured parameters are made read-only.

newFunctionScope

public static Locals newFunctionScope(Locals programScope,
                                      Definition.Type returnType,
                                      java.util.List<Locals.Parameter> parameters,
                                      int maxLoopCounter)

Creates a new function scope inside the current scope

newMainMethodScope

public static Locals newMainMethodScope(ScriptClassInfo scriptClassInfo,
                                        Locals programScope,
                                        int maxLoopCounter)

Creates a new main method scope

newProgramScope

public static Locals newProgramScope(Definition definition,
                                     java.util.Collection<Definition.Method> methods)

Creates a new program scope: the list of methods. It is the parent for all methods

hasVariable

public boolean hasVariable(java.lang.String name)

Checks if a variable exists or not, in this scope or any parents.

getVariable

public Locals.Variable getVariable(Location location,
                                   java.lang.String name)

Accesses a variable. This will throw IAE if the variable does not exist

getMethod

public Definition.Method getMethod(Definition.MethodKey key)

Looks up a method. Returns null if the method does not exist.

addVariable

public Locals.Variable addVariable(Location location,
                                   Definition.Type type,
                                   java.lang.String name,
                                   boolean readonly)

Creates a new variable. Throws IAE if the variable has already been defined (even in a parent) or reserved.

getReturnType

public Definition.Type getReturnType()

Return type of this scope (e.g. int, if inside a function that returns int)

getProgramScope

public Locals getProgramScope()

Returns the top-level program scope.

getDefinition

public Definition getDefinition()

Whitelist against which this script is being compiled.