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