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