Класс Expression

@ConstructorProperties({"target","methodName","arguments"}) public Expression(Object target, String methodName, Object[] arguments)

Создаёт новый объект Expression для заданного целевого объекта, чтобы вызвать метод, указанный именем и массивом аргументов.

Значения target и methodName не должны быть null. В противном случае попытка выполнить это Expression приведёт к NullPointerException. Если значение arguments равно null, в качестве значения свойства arguments используется пустой массив.

public Expression(Object value, Object target, String methodName, Object[] arguments)

Создаёт новый объект Expression с указанным значением для заданного целевого объекта, чтобы вызвать метод, указанный именем и массивом аргументов. Значение value используется в качестве значения свойства value, поэтому метод getValue() вернёт его, не выполняя это Expression.

Значения target и methodName не должны быть null. В противном случае попытка выполнить это Expression приведёт к NullPointerException. Если значение arguments равно null, в качестве значения свойства arguments используется пустой массив.

public void execute() throws Exception

Метод execute находит метод, имя которого совпадает со свойством methodName, и вызывает его для целевого объекта. Если класс целевого объекта определяет несколько методов с заданным именем, реализация должна выбрать наиболее подходящий метод, используя алгоритм, описанный в спецификации языка Java (15.11). Вместо информации о типах времени компиляции используются динамические классы целевого объекта и аргументов; как и в самом классе Method, преобразование между примитивными значениями и соответствующими классами-обёртками выполняется внутри.

Особым образом обрабатываются следующие типы методов:

• Статические методы можно вызывать, передав в качестве целевого объекта объект класса.
• Зарезервированное имя метода "new" можно использовать для вызова конструктора класса, как если бы все классы определяли статические методы "new". Вызовы конструкторов обычно считаются Expressionами, а не Statementами, поскольку они возвращают значение.
• Имена методов "get" и "set", определённые в интерфейсе List, также можно применять к экземплярам массивов; они сопоставляются со статическими методами с теми же именами в классе Array.

Если вызванный метод завершается нормально, возвращаемое им значение копируется в свойство value. Обратите внимание, что свойству value присваивается значение null, если тип возвращаемого значения исходного метода — void.

public Object getValue() throws Exception

Если свойство value этого экземпляра ещё не задано, этот метод динамически находит у целевого объекта метод с указанным именем methodName и заданными аргументами, а затем вызывает его. Результат вызова метода сначала копируется в свойство value этого выражения, а затем возвращается в качестве результата getValue. Если свойство value уже было задано — вызовом setValue или предыдущим вызовом getValue, — оно возвращается без поиска или вызова метода.

По умолчанию свойству value объекта Expression присваивается уникальное закрытое значение (не-null); это значение используется как внутренний признак того, что метод ещё не вызывался. Возвращаемое значение null заменяет это значение по умолчанию так же, как и любое другое значение, гарантируя, что выражения вычисляются не более одного раза.

Сведения о том, как методы выбираются с учётом динамических типов целевого объекта и аргументов, см. в описании метода execute.

public void setValue(Object value)

Задаёт для этого выражения значение value. Метод getValue вернёт это значение, не вызывая метод, связанный с этим выражением.

public String toString()

Выводит значение этого выражения, используя синтаксис в стиле Java.