Spec-Zone .ru спецификации, руководства, описания, API

javax.el
Класс ValueExpression

java.lang.Object
  javax.el.Expression
      javax.el.ValueExpression

Все Реализованные Интерфейсы:

java.io. Сериализуемый

Прямые Известные Подклассы:

IndexedValueExpression, IteratedValueExpression

public abstract class ValueExpression
расширяет Выражение

Expression это может получить или установить значение.

В предыдущих воплощениях этого API могли только быть считаны выражения. ValueExpression объекты могут теперь использоваться и чтобы получить значение и установить значение. Выражения, у которых может быть набор значений на них, упоминаются как l-выражения. Те, которые не могут, упоминаются как r-выражения. Не все r-выражения могут использоваться в качестве l-выражений (например. "${1+1}" или "${firstName} ${lastName}"). См. ЭЛЬ Спецификацию для деталей. Выражения, которые не могут использоваться в качестве l-значений, должны всегда возвращаться true от isReadOnly().

ExpressionFactory#createValueExpression метод может использоваться, чтобы проанализировать строку выражения и возвратить конкретный экземпляр ValueExpression это инкапсулирует проанализированное выражение. FunctionMapper используется во время синтаксического анализа, не время оценки, таким образом, каждый не необходим, чтобы оценить выражение, используя этот class. Однако, ELContext необходим во время оценки.

getValue(javax.el.ELContext), setValue(javax.el.ELContext, java.lang.Object), isReadOnly(javax.el.ELContext), getType(javax.el.ELContext) и getValueReference(javax.el.ELContext) методы оценят выражение каждый раз, когда их вызывают. ELResolver в ELContext используется, чтобы разрешить высокоуровневые переменные и определить поведение . и [] операторы. Для любого из этих пяти методов, ELResolver#getValue метод используется, чтобы разрешить все свойства до, но, исключая последний. Это обеспечивает base объект. Для всех методов кроме getValueReference(javax.el.ELContext) метод, в последнем разрешении, ValueExpression вызовет соответствие ELResolver#getValue, ELResolver#setValue, ELResolver#isReadOnly или ELResolver#getType метод, в зависимости от которого был обращен ValueExpression. Для getValueReference метод, (основа, свойство) не разрешается ELResolver, но экземпляром ValueReference создается, чтобы инкапсулировать это (основа, свойство), и возвращается.

См. примечания о сравнении, сериализации и неизменности в Expression javadocs.

С тех пор:

JSP 2.1

См. Также:

ELResolver, Expression, ExpressionFactory, Сериализированная Форма

Сводка конструктора

ValueExpression()

Сводка метода

abstract java.lang.Class<?>	getExpectedType() Возвращает тип, к которому будет принужден результат выражения после оценки.
abstract java.lang.Class<?>	getType(ELContext context) Оценивает выражение относительно обеспеченного контекста, и возвращает самый общий тип, который является приемлемым для объекта, который передадут как value параметр в будущем призывает setValue(javax.el.ELContext, java.lang.Object) метод.
abstract java.lang.Object	getValue(ELContext context) Оценивает выражение относительно обеспеченного контекста, и возвращает получающееся значение.
ValueReference	getValueReference(ELContext context) Возвраты a ValueReference для этого экземпляра выражения.
abstract boolean	isReadOnly(ELContext context) Оценивает выражение относительно обеспеченного контекста, и возвраты true если звонок setValue(javax.el.ELContext, java.lang.Object) всегда перестанет работать.
abstract void	setValue(ELContext context, java.lang.Object value) Оценивает выражение относительно обеспеченного контекста, и устанавливает результат в обеспеченное значение.

Методы, наследованные от class javax.el. Выражение

equals, getExpressionString, hashCode, isLiteralText

Методы, наследованные от class java.lang. Объект

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Деталь конструктора

ValueExpression

public ValueExpression()

Деталь метода

getValue

public abstract java.lang.Object getValue(ELContext context)

Оценивает выражение относительно обеспеченного контекста, и возвращает получающееся значение.

Получающееся значение автоматически принуждается к типу, возвращенному getExpectedType(), который был обеспечен для ExpressionFactory когда это выражение создавалось.

Параметры:

context - Контекст этой оценки.

Возвраты:

Результат вычисления выражения.

Броски:

java.lang.NullPointerException - если контекст null.

PropertyNotFoundException - если одно из разрешений свойства перестало работать, потому что указанная переменная или свойство не существуют или не читаемы.

ELException - если исключение было выдано, выполняя свойство или переменное разрешение. Выданное исключение должно быть включено как свойство причины этого исключения при наличии.

setValue

public abstract void setValue(ELContext context,
                              java.lang.Object value)

Оценивает выражение относительно обеспеченного контекста, и устанавливает результат в обеспеченное значение.

Параметры:

context - Контекст этой оценки.

value - Новое значение, которое будет установлено.

Броски:

java.lang.NullPointerException - если контекст null.

PropertyNotFoundException - если одно из разрешений свойства перестало работать, потому что указанная переменная или свойство не существуют или не читаемы.

PropertyNotWritableException - если заключительная переменная или разрешение свойства перестали работать, потому что указанная переменная или свойство не перезаписываемы.

ELException - если исключение было выдано, пытаясь установить свойство или переменную. Выданное исключение должно быть включено как свойство причины этого исключения при наличии.

isReadOnly

public abstract boolean isReadOnly(ELContext context)

Оценивает выражение относительно обеспеченного контекста, и возвраты true если звонок setValue(javax.el.ELContext, java.lang.Object) всегда перестанет работать.

Параметры:

context - Контекст этой оценки.

Возвраты:

true если выражение только для чтения или false если нет.

Броски:

java.lang.NullPointerException - если контекст null.

PropertyNotFoundException - если одно из разрешений свойства перестало работать, потому что указанная переменная или свойство не существуют или не читаемы.

ELException - если исключение было выдано, выполняя свойство или переменное разрешение. Выданное исключение должно быть включено как свойство причины этого исключения при наличии. * @throws NullPointerException, если контекст null

getType

public abstract java.lang.Class<?> getType(ELContext context)

Оценивает выражение относительно обеспеченного контекста, и возвращает самый общий тип, который является приемлемым для объекта, который передадут как value параметр в будущем призывает setValue(javax.el.ELContext, java.lang.Object) метод.

Это - не всегда то же самое как getValue().getClass(). Например, в случае выражения, которое ссылается на элемент массива, getType метод возвратит тип элемента массива, который мог бы быть суперклассом типа фактического элемента, который находится в настоящий момент в указанном элементе массива.

Параметры:

context - Контекст этой оценки.

Возвраты:

самый общий приемлемый тип; иначе неопределенный.

Броски:

java.lang.NullPointerException - если контекст null.

PropertyNotFoundException - если одно из разрешений свойства перестало работать, потому что указанная переменная или свойство не существуют или не читаемы.

ELException - если исключение было выдано, выполняя свойство или переменное разрешение. Выданное исключение должно быть включено как свойство причины этого исключения при наличии.

getExpectedType

public abstract java.lang.Class<?> getExpectedType()

Возвращает тип, к которому будет принужден результат выражения после оценки.

Возвраты:

expectedType переданный к ExpressionFactory.createValueExpression метод, который создал это ValueExpression.

getValueReference

public ValueReference getValueReference(ELContext context)

Возвраты a ValueReference для этого экземпляра выражения.

Параметры:

context - контекст этой оценки

Возвраты:

ValueReference для этого ValueExpression, или null если это ValueExpression не ссылка на основу (нуль или ненуль) и свойство. Если основа является нулем, и свойство является ЭЛЬ переменной, возвратитесь ValueReference для ValueExpression связанный с этой ЭЛЬ переменной.

С тех пор:

ЭЛЬ 2.2