2018-04-17 15:16:08 -04:00
|
|
|
[[painless-lang-spec]]
|
2017-05-12 19:17:06 -04:00
|
|
|
== Painless Language Specification
|
|
|
|
|
2018-04-17 15:16:08 -04:00
|
|
|
Painless is a scripting language designed for security and performance.
|
|
|
|
Painless syntax is similar to Java syntax along with some additional
|
|
|
|
features such as dynamic typing, Map and List accessor shortcuts, and array
|
|
|
|
initializers. As a direct comparison to Java, there are some important
|
|
|
|
differences, especially related to the casting model. For more detailed
|
2017-05-12 19:17:06 -04:00
|
|
|
conceptual information about the basic constructs that Java and Painless share,
|
|
|
|
refer to the corresponding topics in the
|
|
|
|
https://docs.oracle.com/javase/specs/jls/se8/html/index.html[Java Language
|
|
|
|
Specification].
|
|
|
|
|
|
|
|
Painless scripts are parsed and compiled using the http://www.antlr.org/[ANTLR4]
|
2018-04-17 15:16:08 -04:00
|
|
|
and http://asm.ow2.org/[ASM] libraries. Scripts are compiled directly
|
|
|
|
into Java Virtual Machine (JVM) byte code and executed against a standard JVM.
|
|
|
|
This specification uses ANTLR4 grammar notation to describe the allowed syntax.
|
2017-05-12 19:17:06 -04:00
|
|
|
However, the actual Painless grammar is more compact than what is shown here.
|
|
|
|
|
2018-04-17 15:16:08 -04:00
|
|
|
include::painless-comments.asciidoc[]
|
2017-05-12 19:17:06 -04:00
|
|
|
|
2018-04-17 15:16:08 -04:00
|
|
|
include::painless-keywords.asciidoc[]
|
2017-05-12 19:17:06 -04:00
|
|
|
|
2018-04-17 15:16:08 -04:00
|
|
|
include::painless-literals.asciidoc[]
|
2017-05-12 19:17:06 -04:00
|
|
|
|
2018-04-25 12:38:41 -04:00
|
|
|
include::painless-identifiers.asciidoc[]
|
|
|
|
|
2018-04-17 15:16:08 -04:00
|
|
|
include::painless-variables.asciidoc[]
|
2017-05-12 19:17:06 -04:00
|
|
|
|
2018-04-17 15:16:08 -04:00
|
|
|
include::painless-types.asciidoc[]
|
2017-05-12 19:17:06 -04:00
|
|
|
|
2018-04-17 15:16:08 -04:00
|
|
|
include::painless-casting.asciidoc[]
|
2017-05-12 19:17:06 -04:00
|
|
|
|
|
|
|
include::painless-operators.asciidoc[]
|
2018-04-17 15:16:08 -04:00
|
|
|
|
|
|
|
include::painless-general-syntax.asciidoc[]
|