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

Пакет javax.servlet.jsp.el

Обеспечивает ELResolver классы, которые определяют объектные правила разрешения, которые должны поддерживаться контейнером JSP с новым объединенным Языком Выражения.

См.:
Описание

Сводка интерфейса

FunctionMapper	Осуждаемый. С JSP 2.1, замененный FunctionMapper
VariableResolver	Осуждаемый. С JSP 2.1, замененный ELResolver

Сводка класса

Выражение	Осуждаемый. С JSP 2.1, замененный ValueExpression
ExpressionEvaluator	Осуждаемый. С JSP 2.1, замененный ExpressionFactory
ImplicitObjectELResolver	Определяет переменное поведение разрешения для ЭЛЬ неявных объектов, определенных в спецификации JSP.
ScopedAttributeELResolver	Определяет переменное поведение разрешения для определяющих контекст атрибутов.

Сводка исключения

ELException	Осуждаемый. С JSP 2.1, замененный ELException
ELParseException	Осуждаемый. С JSP 2.1, замененный ELException

Пакет javax.servlet.jsp.el Описание

Обеспечивает ELResolver классы, которые определяют объектные правила разрешения, которые должны поддерживаться контейнером JSP с новым объединенным Языком Выражения.

Пакет также определяет программируемый доступ к старому средству анализа Языка Выражения (пред JSP 2.1).

Пожалуйста, отметьте, что с JSP 2.1, всех классов и интерфейсов, которые были в пакете javax.servlet.jsp.el были осуждены в пользу новых объединенных API Языка Выражения (javax.el). См. документ Спецификации языка Выражения для большего количества деталей.

В то время как контейнер JSP должен все еще поддерживать осуждаемые API, определенные в javax.servlet.jsp.el, разработчики должны только положиться на новое javax.el API для работы новой разработки.

Два класса ELResolver были добавлены в JSP 2.1, чтобы реализовать объектные правила разрешения, которые должны поддерживаться контейнером JSP с новым объединенным Языком Выражения: ImplicitObjectELResolver и ScopedAttributeELResolver.

Документация относительно старого и осуждаемого API

Страницы JavaServer (ТМ) (JSP) 2.0 спецификации обеспечивают переносимый API для того, чтобы он оценил "ЭЛЬ Выражения". С JSP 2.0, ЭЛЬ выражения могут быть помещены непосредственно в шаблонном тексте страниц JSP и файлов тега.

Этот пакет содержит много классов и интерфейсов, которые описывают и определяют программируемый доступ к средству анализа Языка Выражения. Этот API может также использоваться реализацией JSP, чтобы оценить выражения, но другие реализации, как открытое кодирование в Байт-коды Java, позволяются. Этот пакет предназначается, чтобы не иметь никаких зависимостей от других частей JSP 2.0 спецификации.

Средство анализа выражения

Программируемый доступ к ЭЛЬ Средству анализа Выражения обеспечивается через следующие типы:

• ExpressionEvaluator
• Expression
• FunctionMapper
• VariableResolver

ExpressionEvaluator объект может быть получен от объекта JspContext до getExpressionEvaluator метод. ExpressionEvaluator инкапсулирует процессор EL. ЭЛЬ Выражение, обеспеченное как Строка, может тогда быть оценено непосредственно, или оно может быть проанализировано сначала в Expression объект. Шаг синтаксического анализа, может использоваться, чтобы факторизовать стоимость парсинга выражения, или даже стоимости оптимизации реализации.

Парсинг строки выражения делается против целевого типа, префикс значения по умолчанию (который применяется, когда у функции нет никакого префикса), и a FunctionMapper. FunctionMapper возразите отображает префикс и локальную заглавную роль в a java.lang.reflect.Method объект.

Интерпретация или оценка проанализированного выражения делаются, используя a VariableResolver объект. Этот объект разрешает высокоуровневые имена объектов в Объекты. A VariableResolver может быть получен из a JspContext объект через getVariableResolver метод.

Исключения

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

Анализирующие ошибки передаются как исключения, чтобы упростить API. Ожидается, что много контейнеров JSP будут использовать дополнительные механизмы, чтобы проанализировать ЭЛЬ выражения и сообщить об их ошибках - API времени выполнения не может обеспечить точные коды ошибки строки без дополнительной машины.

Фрагмент кода

Ниже ненормативное выделение фрагмента кода, как API могут использоваться.

// Get an instance of an ExpressionEvaluator


ExpressionEvaluator ee = myJspContext.getExpressionEvaluator();
VariableResolver vr = myJspContext.getVariableResolver();

FunctionMapper fm; // we don't have a portable implementation yet

// Example of compiling an expression.  See [ISSUE-2]
// Errors detected this way may have higher quality than those
// found with a simple validate() invocation.

ExpressionCompilation ce;

try {
  ce = ee.prepareExpression(expr,
                            targetClass,
                            fm,
                            null // no prefixes
                            );
} catch (ELParseException e) {
        log (e.getMessage());
}

try {
  ce.evaluate(vr);
} catch (ElException e) {
        log (e);
}