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

javax.el
Класс MapELResolver

java.lang.Object
  javax.el.ELResolver
      javax.el.MapELResolver

public class MapELResolver
расширяет ELResolver

Определяет поведение разрешения свойства на экземплярах Map.

Этот преобразователь обрабатывает базовые объекты типа java.util.Map. Это принимает любой объект как свойство и использование, которое возражает как ключ в карте. Получающееся значение является значением в карте, которая связывается с тем ключом.

Этот преобразователь может быть создан в режиме только для чтения, что означает это isReadOnly будет всегда возвращаться true и setValue(javax.el.ELContext, java.lang.Object, java.lang.Object, java.lang.Object) будет всегда бросать PropertyNotWritableException.

ELResolvers объединяются, вместе используя CompositeELResolvers, чтобы определить богатую семантику для того, чтобы оценить выражение. См. javadocs для ELResolver для деталей.

С тех пор:

JSP 2.1

См. Также:

CompositeELResolver, ELResolver, Map

Полевая Сводка

Поля, наследованные от class javax.el. ELResolver

RESOLVABLE_AT_DESIGN_TIME, TYPE

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

MapELResolver()
Создает новое чтение-запись MapELResolver.

MapELResolver(boolean isReadOnly)
Создает новое MapELResolver чье состояние только для чтения определяется данным параметром.

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

java.lang.Class<?>	getCommonPropertyType(ELContext context, java.lang.Object base) Если базовый объект является картой, возвращает самый общий тип, который этот преобразователь принимает для property параметр.
java.util.Iterator<java.beans.FeatureDescriptor>	getFeatureDescriptors(ELContext context, java.lang.Object base) Если базовый объект является картой, возвраты Iterator содержа набор ключей, доступных в Map.
java.lang.Class<?>	getType(ELContext context, java.lang.Object base, java.lang.Object property) Если базовый объект является картой, возвращает самый общий приемлемый тип для значения в этой карте.
java.lang.Object	getValue(ELContext context, java.lang.Object base, java.lang.Object property) Если базовый объект является картой, возвращает значение, связанное с данным ключом, как определено property параметр.
boolean	isReadOnly(ELContext context, java.lang.Object base, java.lang.Object property) Если базовый объект является картой, возвраты ли звонок setValue(javax.el.ELContext, java.lang.Object, java.lang.Object, java.lang.Object) всегда перестанет работать.
void	setValue(ELContext context, java.lang.Object base, java.lang.Object property, java.lang.Object val) Если базовый объект является картой, попытки установить значение, связанное с данным ключом, как определено property параметр.

Методы, наследованные от class javax.el. ELResolver

вызвать

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

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

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

MapELResolver

public MapELResolver()

Создает новое чтение-запись MapELResolver.

MapELResolver

public MapELResolver(boolean isReadOnly)

Создает новое MapELResolver чье состояние только для чтения определяется данным параметром.

Параметры:

isReadOnly - true если этот преобразователь не может изменить карты; false иначе.

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

getType

public java.lang.Class<?> getType(ELContext context,
                                  java.lang.Object base,
                                  java.lang.Object property)

Если базовый объект является картой, возвращает самый общий приемлемый тип для значения в этой карте.

Если основа является a Map, propertyResolved свойство ELContext объект должен быть установлен в true этим преобразователем, перед возвратом. Если это свойство не true после того, как этот метод вызывают, вызывающая сторона должна проигнорировать возвращаемое значение.

Принятие основы является a Map, этот метод будет всегда возвращаться Object.class. Это то, потому что Maps принимают любой объект как значение для данного ключа.

Определенный:

getType в class ELResolver

Параметры:

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

base - Карта, чтобы проанализировать. Только основы типа Map обрабатываются этим преобразователем.

property - Ключ, чтобы возвратить приемлемый тип для. Проигнорированный этим преобразователем.

Возвраты:

Если propertyResolved свойство ELContext был установлен в true, тогда самый общий приемлемый тип; иначе неопределенный.

Броски:

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

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

getValue

public java.lang.Object getValue(ELContext context,
                                 java.lang.Object base,
                                 java.lang.Object property)

Если базовый объект является картой, возвращает значение, связанное с данным ключом, как определено property параметр. Если ключ не был найден, null возвращается.

Если основа является a Map, propertyResolved свойство ELContext объект должен быть установлен в true этим преобразователем, перед возвратом. Если это свойство не true после того, как этот метод вызывают, вызывающая сторона должна проигнорировать возвращаемое значение.

Так же, как в Map.get(java.lang.Object), только, потому что null возвращается не означает, что нет никакого отображения для ключа; также возможно что Map явно отображает ключ на null.

Определенный:

getValue в class ELResolver

Параметры:

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

base - Карта, которая будет проанализирована. Только основы типа Map обрабатываются этим преобразователем.

property - Ключ, присваиваемое значение которого должно быть возвращено.

Возвраты:

Если propertyResolved свойство ELContext был установлен в true, тогда значение, связанное с данным ключом или null если ключ не был найден. Иначе, неопределенный.

Броски:

java.lang.ClassCastException - если ключ имеет несоответствующий тип для этой карты (дополнительно брошенный базовым Map).

java.lang.NullPointerException - если контекст null, или если ключ является нулем, и эта карта не разрешает нулевые ключи (последний дополнительно бросается базовым Map).

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

setValue

public void setValue(ELContext context,
                     java.lang.Object base,
                     java.lang.Object property,
                     java.lang.Object val)

Если базовый объект является картой, попытки установить значение, связанное с данным ключом, как определено property параметр.

Если основа является a Map, propertyResolved свойство ELContext объект должен быть установлен в true этим преобразователем, перед возвратом. Если это свойство не true после того, как этот метод вызывают, вызывающая сторона может безопасно предположить, что никакое значение не было установлено.

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

Если a Map создавался, используя Collections.unmodifiableMap(java.util.Map<? extends K, ? extends V>), этот метод должен бросить PropertyNotWritableException. К сожалению, нет никакого метода API Наборов, чтобы обнаружить это. Однако, реализация может создать неподдающийся изменению прототип Map и запросите его тип времени выполнения, чтобы видеть, соответствует ли это тип времени выполнения базового объекта как обходное решение.

Определенный:

setValue в class ELResolver

Параметры:

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

base - Карта, которая будет изменена. Только основы типа Map обрабатываются этим преобразователем.

property - Ключ, с которым должно быть связано указанное значение.

val - Значение, которое будет связано с указанным ключом.

Броски:

java.lang.ClassCastException - если class указанного ключа или значения препятствует тому, чтобы это было сохранено в этой карте.

java.lang.NullPointerException - если контекст null, или если эта карта не разрешает null ключи или значения, и указанный ключ или значение null.

IllegalArgumentException - если некоторый аспект этого ключа или значения препятствует тому, чтобы это было сохранено в этой карте.

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

PropertyNotWritableException - если этот преобразователь был создан в режиме только для чтения, или если помещенная работа не поддерживается базовой картой.

isReadOnly

public boolean isReadOnly(ELContext context,
                          java.lang.Object base,
                          java.lang.Object property)

Если базовый объект является картой, возвраты ли звонок setValue(javax.el.ELContext, java.lang.Object, java.lang.Object, java.lang.Object) всегда перестанет работать.

Если основа является a Map, propertyResolved свойство ELContext объект должен быть установлен в true этим преобразователем, перед возвратом. Если это свойство не true после того, как этот метод вызывают, вызывающая сторона должна проигнорировать возвращаемое значение.

Если этот преобразователь был создан в режиме только для чтения, этот метод будет всегда возвращаться true.

Если a Map создавался, используя Collections.unmodifiableMap(java.util.Map<? extends K, ? extends V>), этот метод должен возвратиться true. К сожалению, нет никакого метода API Наборов, чтобы обнаружить это. Однако, реализация может создать неподдающийся изменению прототип Map и запросите его тип времени выполнения, чтобы видеть, соответствует ли это тип времени выполнения базового объекта как обходное решение.

Определенный:

isReadOnly в class ELResolver

Параметры:

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

base - Карта, чтобы проанализировать. Только основы типа Map обрабатываются этим преобразователем.

property - Ключ, чтобы возвратить состояние только для чтения для. Проигнорированный этим преобразователем.

Возвраты:

Если propertyResolved свойство ELContext был установлен в true, тогда true вызывая setValue метод всегда перестанет работать или false если возможно, что такой вызов может успешно выполниться; иначе неопределенный.

Броски:

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

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

getFeatureDescriptors

public java.util.Iterator<java.beans.FeatureDescriptor> getFeatureDescriptors(ELContext context,
                                                                              java.lang.Object base)

Если базовый объект является картой, возвраты Iterator содержа набор ключей, доступных в Map. Иначе, возвраты null.

Iterator возвращенный должен содержать нуль или больше экземпляров FeatureDescriptor. Каждый объект информации содержит информацию о ключе в Карте, и инициализируется следующим образом:

displayName - возвращаемое значение вызова toString метод на этом ключе, или "null" если ключ null.

имя - То же самое как displayName свойство.

shortDescription - Пустая строка

эксперт - false

скрытый - false

предпочтенный - true

Кроме того, следующие именованные атрибуты должны быть установлены в возвращенном FeatureDescriptors:

ELResolver#TYPE - Возвращаемое значение вызова getClass() метод на этом ключе, или null если ключ null.

ELResolver#RESOLVABLE_AT_DESIGN_TIME - true

Определенный:

getFeatureDescriptors в class ELResolver

Параметры:

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

base - Карта, ключи которой должны быть выполнены с помощью итераций. Только основы типа Map обрабатываются этим преобразователем.

Возвраты:

Iterator содержа нуль или больше (возможно бесконечно больше) FeatureDescriptor объекты, каждый представляющий ключ в этой карте, или null если базовый объект не является картой.

См. Также:

FeatureDescriptor

getCommonPropertyType

public java.lang.Class<?> getCommonPropertyType(ELContext context,
                                                java.lang.Object base)

Если базовый объект является картой, возвращает самый общий тип, который этот преобразователь принимает для property параметр. Иначе, возвраты null.

Принятие основы является a Map, этот метод будет всегда возвращаться Object.class. Это то, потому что Maps принимают любой объект как ключ.

Определенный:

getCommonPropertyType в class ELResolver

Параметры:

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

base - Карта, чтобы проанализировать. Только основы типа Map обрабатываются этим преобразователем.

Возвраты:

null если основа не является a Map; иначе Object.class.