Класс 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 возвращается без поиска или вызова метода.

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

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

public void setValue(Object value)

Устанавливает значение этого выражения в value. Это значение будет возвращено методом getValue без вызова метода, связанного с этим выражением.

public String toString()

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