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

javax.el
Класс ExpressionFactory

java.lang.Object
  javax.el.ExpressionFactory

public abstract class ExpressionFactory
расширяет java.lang. Объект

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

ExpressionFactory()

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

abstract java.lang.Object	coerceToType(java.lang.Object obj, java.lang.Class<?> targetType) Принуждает объект к определенному типу согласно ЭЛЬ правилам преобразования типов.
abstract MethodExpression	createMethodExpression(ELContext context, java.lang.String expression, java.lang.Class<?> expectedReturnType, java.lang.Class<?>[] expectedParamTypes) Анализирует выражение в a MethodExpression для более поздней оценки.
abstract ValueExpression	createValueExpression(ELContext context, java.lang.String expression, java.lang.Class<?> expectedType) Анализирует выражение в a ValueExpression для более поздней оценки.
abstract ValueExpression	createValueExpression(java.lang.Object instance, java.lang.Class<?> expectedType) Создает ValueExpression, который обертывает объектный экземпляр.
static ExpressionFactory	newInstance() Создает новый экземпляр a ExpressionFactory.
static ExpressionFactory	newInstance(java.util.Properties properties) Создайте новый экземпляр a ExpressionFactory, с дополнительными свойствами.

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

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

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

ExpressionFactory

public ExpressionFactory()

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

newInstance

public static ExpressionFactory newInstance()

Создает новый экземпляр a ExpressionFactory. Этот метод использует следующую упорядоченную процедуру поиска, чтобы определить ExpressionFactory реализация class, чтобы загрузиться:

• Используйте API Служб (как детализировано в спецификации JAR). Если ресурс с именем META-INF/services/javax.el.ExpressionFactory существует, тогда его первая строка, если есть используется в качестве UTF-8 закодированное имя реализации class.
• Используйте файл свойств "lib/el.properties" в каталоге JRE. Если этот файл существует, и это читаемо java.util.Properties.load(InputStream) метод, и это содержит запись, ключ которой "javax.el. ExpressionFactory", тогда значение той записи используется в качестве имени реализации class.
• Используйте javax.el.ExpressionFactory системное свойство. Если системное свойство с этим именем определяется, то его значение используется в качестве имени реализации class.
• Используйте реализацию по умолчанию платформы.

newInstance

public static ExpressionFactory newInstance(java.util.Properties properties)

Создайте новый экземпляр a ExpressionFactory, с дополнительными свойствами. Этот метод использует ту же самую процедуру поиска в качестве того, используемого в newInstance().

Если параметр properties не нуль, и если реализация содержит конструктора с единственным параметром типа java.util.Properties, тогда конструктор используется, чтобы создать экземпляр.

Свойства являются дополнительными и могут быть проигнорированы реализацией.

Имя свойства должно запуститься с "javax.el".

Следующее является некоторыми предложенными именами для свойств.

• javax.el.cacheSize

Параметры:

properties - Свойства, которые передают к реализации. Если ноль, тогда никакие свойства.

createValueExpression

public abstract ValueExpression createValueExpression(ELContext context,
                                                      java.lang.String expression,
                                                      java.lang.Class<?> expectedType)

Анализирует выражение в a ValueExpression для более поздней оценки. Используйте этот метод для выражений, которые обращаются к значениям.

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

Параметры:

context - ЭЛЬ контекст, используемый, чтобы проанализировать выражение. FunctionMapper и VariableMapper сохраненный в ELContext используются, чтобы разрешить функции и переменные, найденные в выражении. Они могут быть null, когда функции или переменные не поддерживаются для этого выражения. Возвращенный объект должен вызвать те же самые функции и получить доступ к тем же самым переменным отображениям независимо от ли отображения в обеспеченном FunctionMapper и VariableMapper экземпляры изменяются между вызовом ExpressionFactory.createValueExpression() и любой метод на ValueExpression.

Отметьте, что в пределах ЭЛЬ, $ {} и # {} синтаксисы обрабатываются тождественно. Это включает использование VariableMapper и FunctionMapper во время создания выражения. Каждый вызывается, если не нуль, независимый от того, используется ли # {} или $ {} синтаксис для выражения.

expression - Выражение, чтобы проанализировать

expectedType - Тип результат выражения будет принужден к после оценки.

Возвраты:

Проанализированное выражение

Броски:

java.lang.NullPointerException - Брошенный, если expectedType является нулем.

ELException - Брошенный, если есть синтаксические ошибки в обеспеченном выражении.

createValueExpression

public abstract ValueExpression createValueExpression(java.lang.Object instance,
                                                      java.lang.Class<?> expectedType)

Создает ValueExpression, который обертывает объектный экземпляр. Этот метод может использоваться, чтобы передать любой объект как ValueExpression. Обертка ValueExpression только для чтения, и возвращает обернутый объект через getValue() метод, дополнительно принужденный.

Параметры:

instance - Объектный экземпляр, который будет обернут.

expectedType - Тип результат выражения будет принужден к после оценки. Не будет никакого приведения, если это будет Объект. class,

Броски:

java.lang.NullPointerException - Брошенный, если expectedType является нулем.

createMethodExpression

public abstract MethodExpression createMethodExpression(ELContext context,
                                                        java.lang.String expression,
                                                        java.lang.Class<?> expectedReturnType,
                                                        java.lang.Class<?>[] expectedParamTypes)

Анализирует выражение в a MethodExpression для более поздней оценки. Используйте этот метод для выражений, которые обращаются к методам.

Если выражением является Строковый литерал, a MethodExpression создается, который когда вызвано, возвращает Строковый литерал, принужденный к expectedReturnType. ELException бросается, если expectedReturnType пустой или если приведение Строкового литерала к expectedReturnType приводит к ошибке (см. Раздел "1.16 Преобразования типов").

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

Параметры:

context - ЭЛЬ контекст, используемый, чтобы проанализировать выражение. FunctionMapper и VariableMapper сохраненный в ELContext используются, чтобы разрешить функции и переменные, найденные в выражении. Они могут быть null, когда функции или переменные не поддерживаются для этого выражения. Возвращенный объект должен вызвать те же самые функции и получить доступ к тем же самым переменным отображениям независимо от ли отображения в обеспеченном FunctionMapper и VariableMapper экземпляры изменяются между вызовом ExpressionFactory.createMethodExpression() и любой метод на MethodExpression.

Отметьте, что в пределах ЭЛЬ, $ {} и # {} синтаксисы обрабатываются тождественно. Это включает использование VariableMapper и FunctionMapper во время создания выражения. Каждый вызывается, если не нуль, независимый от того, используется ли # {} или $ {} синтаксис для выражения.

expression - Выражение, чтобы проанализировать

expectedReturnType - Тип ожидаемого дохода для метода, который будет найден. После оценки выражения, MethodExpression должен проверить, что тип возврата фактического метода соответствует этот тип. Передача в значении null указывает, что вызывающая сторона не заботится, что тип возврата, и проверка отключается.

expectedParamTypes - Ожидаемый параметр вводит для метода, который будет найден. Должен быть массив без элементов, если нет никаких ожидаемых параметров. Это недопустимо, чтобы передать null, если метод не определяется с arugments в ЭЛЬ выражении, когда эти параметры используются для выбора метода, и этот параметр игнорируется.

Возвраты:

Проанализированное выражение

Броски:

ELException - Брошенный, если есть синтаксические ошибки в обеспеченном выражении.

java.lang.NullPointerException - если paramTypes null.

coerceToType

public abstract java.lang.Object coerceToType(java.lang.Object obj,
                                              java.lang.Class<?> targetType)

Принуждает объект к определенному типу согласно ЭЛЬ правилам преобразования типов.

ELException бросается, если ошибка следует из применения правил преобразования.

Параметры:

obj - Объект принудить.

targetType - Целевой тип для приведения.

Броски:

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