NOTE: You are looking at documentation for an older release. For the latest information, see the current release documentation.
Painless uses receiver, name, and arity
for method dispatch. For example,
s.foo(a, b) is resolved by first getting
the class of
s and then looking up the method
foo with two parameters. This
is different from Groovy which uses the
runtime types of the
parameters and Java which uses the compile time types of the parameters.
The consequence of this that Painless doesn’t support overloaded methods like
Java, leading to some trouble when it whitelists classes from the Java
standard library. For example, in Java and Groovy,
Matcher has two methods:
group(String). Painless can’t whitelist both of these methods
because they have the same name and the same number of parameters. So instead it
We have a few justifications for this different way of dispatching methods:
It makes operating on
deftypes simpler and, presumably, faster. Using receiver, name, and arity means that when Painless sees a call on a
defobject it can dispatch the appropriate method without having to do expensive comparisons of the types of the parameters. The same is true for invocations with
It keeps things consistent. It would be genuinely weird for Painless to
behave like Groovy if any
deftyped parameters were involved and Java otherwise. It’d be slow for it to behave like Groovy all the time.
- It keeps Painless maintainable. Adding the Java or Groovy like method dispatch feels like it’d add a ton of complexity which’d make maintenance and other improvements much more difficult.