Spec-Zone .ru
спецификации, руководства, описания, API
|
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
java.lang.Object javax.faces.component. UIComponent javax.faces.component. UIComponentBase javax.faces.component. UIOutput javax.faces.component. UIInput javax.faces.component.UISelectMany
public class UISelectMany
UISelectMany является a UIComponent
это представляет выбор пользователем нуля или большего количества элементов из числа дискретного набора доступных параметров. Пользователь может изменить выбранные значения. Дополнительно, компонент может быть предварительно сконфигурирован с нулем или более в настоящий момент выбранными пунктами, храня их как массив или Collection
в value
свойство компонента.
Этот компонент обычно представляется как избранное поле или группа флажков.
По умолчанию, rendererType
свойство должно быть установлено в"javax.faces.Listbox
". Это значение может быть изменено, вызывая setRendererType()
метод.
Renderer
поскольку этот компонент должен выполнить следующую логику на getConvertedValue()
:
Получите Converter
использование следующего алгоритма:
Если у компонента есть присоединенный Converter
, используйте это.
В противном случае ищите a ValueExpression
для value
(если любой). ValueExpression
должен указать на что-то, что является:
Массив примитивов (такой как int[]
). Ищите зарегистрированный - class Converter
для этого типа примитива.
Массив объектов (такой как Integer[]
или String[]
). Ищите зарегистрированный - class Converter
для базового типа элемента.
A java.util.Collection
. Не преобразовывайте значения.
Если по любой причине a Converter
не может быть найден, предположить, что тип Строковый массив.
Используйте выбранный Converter
(если любой), чтобы преобразовать каждый элемент в значениях выстраивают от запроса до надлежащего типа, и сохранить результат каждого преобразования в структуре данных, названной targetForConvertedValues для обсуждения. Создайте targetForConvertedValues использование следующего алгоритма.
Если у компонента есть a ValueExpression
для value
и тип выражения является массивом, позвольте targetForConvertedValues быть новым массивом ожидаемого типа.
Если у компонента есть a ValueExpression
для value
, позвольте modelType быть типом выражения. Если modelType является a Collection
, сделайте следующий, чтобы достигнуть targetForConvertedValues:
Попросите у компонента его атрибут под ключом"collectionType
", без кавычек. Если есть значение для того ключа, значением должна быть Строка, которая является полностью определенным Java имя class, или a Class
объект, или a ValueExpression
это оценивает к Строке или a Class
. Во всех случаях значение служит, чтобы идентифицировать конкретный тип class, который реализует Collection
. Для обсуждения это вызывают collectionType. Позвольте targetForConvertedValues быть новым экземпляром Collection
реализованный конкретным class определяется в collectionType. Если, collectionType не может быть обнаружен, или экземпляр Collection
реализованный конкретным class, определенным в collectionType, не может быть создан, бросок a FacesException
с правильно локализованным сообщением об ошибке. Отметьте это FacesException
бросается вместо ConverterException
потому что этот случай только явился бы результатом ошибки разработчика, а не ошибки конечного пользователя.
Если есть не"collectionType
"атрибут, вызвать getValue()
на компоненте. Результат реализует Collection
. Если результат также реализует Cloneable
, позвольте targetForConvertedValues быть результатом вызова clone()
метод, затем вызывая clear()
на клонированном Collection
. Если неспособный, чтобы клонировать значение по любой причине, зарегистрируйте сообщение и продолжите к следующему шагу.
Если modelType является конкретный class, позвольте targetForConvertedValues быть новым экземпляром того class. Иначе, конкретный тип для targetForConvertedValues берется от следующей таблицы. Все классы находятся в java.util
пакет. Все наборы должны быть созданы с начальной емкостью, равной длине массива значений от запроса.
Если modelType является экземпляром | тогда targetForConvertedValues должен быть экземпляром |
---|---|
SortedSet |
TreeSet |
Queue |
LinkedList |
Set |
HashSet |
что-либо еще | ArrayList |
Если у компонента нет a ValueExpression
для value
, позвольте targetForConvertedValues быть массивом типа Object
.
Возвратите targetForConvertedValues после заполнения этого с преобразованными значениями.
Полевая Сводка | |
---|---|
static java.lang.String |
COMPONENT_FAMILY
Стандартное компонентное семейство для этого компонента. |
static java.lang.String |
COMPONENT_TYPE
Стандартный компонент вводит для этого компонента. |
static java.lang.String |
INVALID_MESSAGE_ID
Идентификатор сообщения FacesMessage создаваться, если значение, не соответствующее доступные параметры, определяется. |
Поля, наследованные от class javax.faces.component. UIInput |
---|
CONVERSION_MESSAGE_ID, REQUIRED_MESSAGE_ID, UPDATE_MESSAGE_ID, VALIDATE_EMPTY_FIELDS_PARAM_NAME |
Поля, наследованные от class javax.faces.component. UIComponent |
---|
ATTRS_WITH_DECLARED_DEFAULT_VALUES, BEANINFO_KEY, bindings, COMPOSITE_COMPONENT_TYPE_KEY, COMPOSITE_FACET_NAME, CURRENT_COMPONENT, CURRENT_COMPOSITE_COMPONENT, FACETS_KEY, HONOR_CURRENT_COMPONENT_ATTRIBUTES_PARAM_NAME, VIEW_LOCATION_KEY |
Сводка конструктора | |
---|---|
UISelectMany()
Создайте новое UISelectMany экземпляр со значениями свойств значения по умолчанию. |
Сводка метода | |
---|---|
protected boolean |
compareValues(java.lang.Object previous, java.lang.Object value)
Возвратиться true если новое значение отличается от предыдущего значения. |
java.lang.String |
getFamily()
Возвратите идентификатор компонентного семейства, которому принадлежит этот компонент. |
java.lang.Object[] |
getSelectedValues()
Возвратите в настоящий момент выбранные значения, или null если нет никаких в настоящий момент выбранных значений. |
ValueBinding |
getValueBinding(java.lang.String name)
Осуждаемый. это было заменено getValueExpression(java.lang.String) . |
ValueExpression |
getValueExpression(java.lang.String name)
Возвратите любого ValueExpression набор для value если a ValueExpression для selectedValues требуется; иначе, выполните обработку суперкласса значения по умолчанию для этого метода. |
void |
setSelectedValues(java.lang.Object[] selectedValues)
Установите в настоящий момент выбранные значения, или null указать, что нет никаких в настоящий момент выбранных значений. |
void |
setValueBinding(java.lang.String name, ValueBinding binding)
Осуждаемый. Это было заменено setValueExpression(java.lang.String, javax.el.ValueExpression) . |
void |
setValueExpression(java.lang.String name, ValueExpression binding)
Сохраните любого ValueExpression определенный для selectedValues под value вместо этого; иначе, выполните обработку суперкласса значения по умолчанию для этого метода. |
protected void |
validateValue(FacesContext context, java.lang.Object value)
В дополнение к стандартному поведению проверки допустимости, наследованному от UIInput , гарантируйте, что любые указанные значения равны одному из доступных параметров. |
Методы, наследованные от class javax.faces.component. UIOutput |
---|
getConverter, getLocalValue, getValue, setConverter |
Методы, наследованные от class java.lang. Объект |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Методы, наследованные от интерфейса javax.faces.component. ValueHolder |
---|
getConverter, getLocalValue, getValue, setConverter |
Полевая Деталь |
---|
public static final java.lang.String COMPONENT_TYPE
Стандартный компонент вводит для этого компонента.
public static final java.lang.String COMPONENT_FAMILY
Стандартное компонентное семейство для этого компонента.
public static final java.lang.String INVALID_MESSAGE_ID
Идентификатор сообщения FacesMessage
создаваться, если значение, не соответствующее доступные параметры, определяется.
Деталь конструктора |
---|
public UISelectMany()
Создайте новое UISelectMany
экземпляр со значениями свойств значения по умолчанию.
Деталь метода |
---|
public java.lang.String getFamily()
UIComponent
Возвратите идентификатор компонентного семейства, которому принадлежит этот компонент. Этот идентификатор, в соединении со значением rendererType
свойство, может использоваться, чтобы выбрать соответствующее Renderer
для этого компонентного экземпляра.
getFamily
в class UIInput
public java.lang.Object[] getSelectedValues()
Возвратите в настоящий момент выбранные значения, или null
если нет никаких в настоящий момент выбранных значений. Это - безопасный с точки зрения типов псевдоним для getValue()
.
public void setSelectedValues(java.lang.Object[] selectedValues)
Установите в настоящий момент выбранные значения, или null
указать, что нет никаких в настоящий момент выбранных значений. Это - безопасный с точки зрения типов псевдоним для setValue()
.
selectedValues
- Новые выбранные значения (если любой)public ValueBinding getValueBinding(java.lang.String name)
getValueExpression(java.lang.String)
.
Возвратите любого ValueBinding
набор для value
если a ValueBinding
для selectedValues
требуется; иначе, выполните обработку суперкласса значения по умолчанию для этого метода.
Этот метод полагается на суперкласс, чтобы обеспечить ValueExpression
к ValueBinding
обертывание.
getValueBinding
в class UIComponentBase
name
- Имя атрибута или свойства, для которого можно получить a ValueBinding
java.lang.NullPointerException
- если name
null
public void setValueBinding(java.lang.String name, ValueBinding binding)
setValueExpression(java.lang.String, javax.el.ValueExpression)
.
Сохраните любого ValueBinding
определенный для selectedValues
под value
вместо этого; иначе, выполните обработку суперкласса значения по умолчанию для этого метода.
Этот метод полагается на суперкласс, чтобы обернуть параметр ValueBinding
в a ValueExpression
.
setValueBinding
в class UIComponentBase
name
- Имя атрибута или свойства, для которого можно установить a ValueBinding
binding
- ValueBinding
установить, или null
удалить любого в настоящий момент набор ValueBinding
java.lang.NullPointerException
- если name
null
public ValueExpression getValueExpression(java.lang.String name)
Возвратите любого ValueExpression
набор для value
если a ValueExpression
для selectedValues
требуется; иначе, выполните обработку суперкласса значения по умолчанию для этого метода.
getValueExpression
в class UIComponent
name
- Имя атрибута или свойства, для которого можно получить a ValueExpression
java.lang.NullPointerException
- если name
null
public void setValueExpression(java.lang.String name, ValueExpression binding)
Сохраните любого ValueExpression
определенный для selectedValues
под value
вместо этого; иначе, выполните обработку суперкласса значения по умолчанию для этого метода.
setValueExpression
в class UIComponent
name
- Имя атрибута или свойства, для которого можно установить a ValueExpression
binding
- ValueExpression
установить, или null
удалить любого в настоящий момент набор ValueExpression
java.lang.NullPointerException
- если name
null
protected boolean compareValues(java.lang.Object previous, java.lang.Object value)
Возвратиться true
если новое значение отличается от предыдущего значения. Сравнение значения не должно быть чувствительным к порядку элемента.
compareValues
в class UIInput
previous
- старое значение этого компонентаvalue
- новое значение этого компонентаprotected void validateValue(FacesContext context, java.lang.Object value)
В дополнение к стандартному поведению проверки допустимости, наследованному от UIInput
, гарантируйте, что любые указанные значения равны одному из доступных параметров. Прежде, чем сравнить каждую опцию, принудите тип значения опции к типу значения этого компонента после правил приведения Языка Выражения. Если указанное значение не равно какой-либо из опций, ставьте в очередь сообщение об ошибке и установите valid
свойство к false
.
Этот метод должен явно поддерживать параметр значения, который является единственным значением или параметром значения, который является a Collection
или Массив значений.
Если UIInput.isRequired()
возвраты true
, и текущая стоимость равна значению внутреннего UISelectItem
чей UISelectItem#isNoSelectionOption
возвраты метода true
, ставьте в очередь сообщение об ошибке и установите valid
свойство к false
.
validateValue
в class UIInput
context
- FacesContext
для текущего запросаvalue
- Преобразованное значение, чтобы протестировать на членство. java.lang.NullPointerException
- если context
null
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается
Сгенерированный на 10-February-2011 12:41