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


javax.faces.component
Класс UISelectMany

java.lang.Object
  расширенный javax.faces.component. UIComponent
      расширенный javax.faces.component. UIComponentBase
          расширенный javax.faces.component. UIOutput
              расширенный javax.faces.component. UIInput
                  расширенный javax.faces.component.UISelectMany
Все Реализованные Интерфейсы:
java.util. EventListener, EditableValueHolder, PartialStateHolder, StateHolder, TransientStateHolder, ValueHolder, ComponentSystemEventListener, FacesListener, SystemEventListenerHolder
Прямые Известные Подклассы:
HtmlSelectManyCheckbox, HtmlSelectManyListbox, HtmlSelectManyMenu

public class UISelectMany
расширяет UIInput

UISelectMany является a UIComponent это представляет выбор пользователем нуля или большего количества элементов из числа дискретного набора доступных параметров. Пользователь может изменить выбранные значения. Дополнительно, компонент может быть предварительно сконфигурирован с нулем или более в настоящий момент выбранными пунктами, храня их как массив или Collection в value свойство компонента.

Этот компонент обычно представляется как избранное поле или группа флажков.

По умолчанию, rendererType свойство должно быть установлено в"javax.faces.Listbox". Это значение может быть изменено, вызывая setRendererType() метод.

Renderer поскольку этот компонент должен выполнить следующую логику на getConvertedValue():


Полевая Сводка
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. UIInput
addValidator, addValueChangeListener, clearInitialState, decode, getConvertedValue, getConverterMessage, getRequiredMessage, getSubmittedValue, getValidator, getValidatorMessage, getValidators, getValueChangeListener, getValueChangeListeners, isEmpty, isImmediate, isLocalValueSet, isRequired, isValid, markInitialState, processDecodes, processUpdates, processValidators, removeValidator, removeValueChangeListener, resetValue, restoreState, saveState, setConverterMessage, setImmediate, setLocalValueSet, setRequired, setRequiredMessage, setSubmittedValue, setValid, setValidator, setValidatorMessage, setValue, setValueChangeListener, updateModel, validate
 
Методы, наследованные от class javax.faces.component. UIOutput
getConverter, getLocalValue, getValue, setConverter
 
Методы, наследованные от class javax.faces.component. UIComponentBase
addClientBehavior, addFacesListener, broadcast, encodeBegin, encodeChildren, encodeEnd, findComponent, getAttributes, getChildCount, getChildren, getClientBehaviors, getClientId, getDefaultEventName, getEventNames, getFacesContext, getFacesListeners, getFacet, getFacetCount, getFacets, getFacetsAndChildren, getId, getListenersForEventClass, getParent, getRenderer, getRendererType, getRendersChildren, invokeOnComponent, isRendered, isTransient, processRestoreState, processSaveState, queueEvent, removeFacesListener, restoreAttachedState, saveAttachedState, setId, setParent, setRendered, setRendererType, setTransient, subscribeToEvent, unsubscribeFromEvent
 
Методы, наследованные от class javax.faces.component. UIComponent
encodeAll, getClientId, getCompositeComponentParent, getContainerClientId, getCurrentComponent, getCurrentCompositeComponent, getNamingContainer, getResourceBundleMap, getStateHelper, getStateHelper, getTransientStateHelper, getTransientStateHelper, initialStateMarked, isCompositeComponent, isInView, isVisitable, popComponentFromEL, processEvent, pushComponentToEL, restoreTransientState, saveTransientState, setInView, visitTree
 
Методы, наследованные от class java.lang. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Методы, наследованные от интерфейса javax.faces.component. ValueHolder
getConverter, getLocalValue, getValue, setConverter
 

Полевая Деталь

COMPONENT_TYPE

public static final java.lang.String COMPONENT_TYPE

Стандартный компонент вводит для этого компонента.

См. Также:
Постоянные Значения полей

COMPONENT_FAMILY

public static final java.lang.String COMPONENT_FAMILY

Стандартное компонентное семейство для этого компонента.

См. Также:
Постоянные Значения полей

INVALID_MESSAGE_ID

public static final java.lang.String INVALID_MESSAGE_ID

Идентификатор сообщения FacesMessage создаваться, если значение, не соответствующее доступные параметры, определяется.

См. Также:
Постоянные Значения полей
Деталь конструктора

UISelectMany

public UISelectMany()

Создайте новое UISelectMany экземпляр со значениями свойств значения по умолчанию.

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

getFamily

public java.lang.String getFamily()
Описание скопировало с class: UIComponent

Возвратите идентификатор компонентного семейства, которому принадлежит этот компонент. Этот идентификатор, в соединении со значением rendererType свойство, может использоваться, чтобы выбрать соответствующее Renderer для этого компонентного экземпляра.

Переопределения:
getFamily в class UIInput

getSelectedValues

public java.lang.Object[] getSelectedValues()

Возвратите в настоящий момент выбранные значения, или null если нет никаких в настоящий момент выбранных значений. Это - безопасный с точки зрения типов псевдоним для getValue().


setSelectedValues

public void setSelectedValues(java.lang.Object[] selectedValues)

Установите в настоящий момент выбранные значения, или null указать, что нет никаких в настоящий момент выбранных значений. Это - безопасный с точки зрения типов псевдоним для setValue().

Параметры:
selectedValues - Новые выбранные значения (если любой)

getValueBinding

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

setValueBinding

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

getValueExpression

public ValueExpression getValueExpression(java.lang.String name)

Возвратите любого ValueExpression набор для value если a ValueExpression для selectedValues требуется; иначе, выполните обработку суперкласса значения по умолчанию для этого метода.

Переопределения:
getValueExpression в class UIComponent
Параметры:
name - Имя атрибута или свойства, для которого можно получить a ValueExpression
Броски:
java.lang.NullPointerException - если name null
С тех пор:
1.2

setValueExpression

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
С тех пор:
1.2

compareValues

protected boolean compareValues(java.lang.Object previous,
                                java.lang.Object value)

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

Переопределения:
compareValues в class UIInput
Параметры:
previous - старое значение этого компонента
value - новое значение этого компонента

validateValue

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


Представьте ошибку или функцию

Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается срокам действия лицензии.

Сгенерированный на 10-February-2011 12:41

free hit counter