Класс 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.