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

javax.faces.validator
Класс LengthValidator

java.lang.Object
  javax.faces.validator.LengthValidator

Все Реализованные Интерфейсы:

java.util. EventListener, PartialStateHolder, StateHolder, Блок проверки допустимости

public class LengthValidator
расширяет java.lang. Объект
Блок проверки допустимости реализаций, PartialStateHolder

LengthValidator является a Validator это проверяет число символов в Строковом представлении значения связанного компонента. Следующий алгоритм реализуется:

• Преобразуйте переданное значение в Строку, в случае необходимости, вызывая toString() метод.
• Если a maximum свойство было сконфигурировано на этом Validator, проверьте длину преобразованной Строки против этого предела. Если Строковая длина больше чем указанный максимум, бросок a ValidatorException содержа сообщение MAXIMUM_MESSAGE_ID.
• Если a minimum свойство было сконфигурировано на этом Validator, проверьте длину преобразованной Строки против этого предела. Если Строковая длина является меньше чем указанный минимум, бросок a ValidatorException содержа сообщение MINIMUM_MESSAGE_ID.

Для всех вышеупомянутых случаев та причина a ValidatorException чтобы быть брошенными, если есть параметры к сообщению, которые совпадают с параметрами блока проверки допустимости, значения этих параметров должны быть преобразованы, используя Converter зарегистрированный в приложении под идентификатором преобразователя javax.faces.Number. Это позволяет значениям быть локализованными согласно току Locale.

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

static java.lang.String	MAXIMUM_MESSAGE_ID Идентификатор сообщения FacesMessage создаваться, если максимальная проверка длины перестала работать.
static java.lang.String	MINIMUM_MESSAGE_ID Идентификатор сообщения FacesMessage создаваться, если минимальная проверка длины перестала работать.
static java.lang.String	VALIDATOR_ID Стандартный идентификатор блока проверки допустимости для этого блока проверки допустимости.

Поля, наследованные от интерфейса javax.faces.validator. Блок проверки допустимости

NOT_IN_RANGE_MESSAGE_ID

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

LengthValidator()
Создайте a Validator без предварительно сконфигурированных пределов.

LengthValidator(int maximum)
Создайте a Validator с указанным предварительно сконфигурированным пределом.

LengthValidator(int maximum, int minimum)
Создайте a Validator с указанными предварительно сконфигурированными пределами.

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

void	clearInitialState() Сбросьте PartialStateHolder к состоянию отслеживания недельты.
boolean	equals(java.lang.Object otherObj)
int	getMaximum() Возвратите максимальную длину, которая будет осуществлена этим Validator, или 0 если максимум не был установлен.
int	getMinimum() Возвратите минимальную длину, которая будет осуществлена этим Validator, или 0 если минимум не был установлен.
int	hashCode()
boolean	initialStateMarked() Возвратиться true если изменения состояния дельты прослеживаются, иначе false
boolean	isTransient() Если это правда, Объект, реализовывая этот интерфейс не должен участвовать в сохранении состояния или восстановлении.
void	markInitialState() Время выполнения должно гарантировать что PartialStateHolder.markInitialState() метод вызывают на каждом экземпляре этого интерфейса в представлении в подходящее время, чтобы указать, что компонент находится в своем начальном состоянии.
void	restoreState(FacesContext context, java.lang.Object state) Выполните любую обработку, требуемую восстановить состояние от записей в Объекте состояния.
java.lang.Object	saveState(FacesContext context) Получает состояние экземпляра как a Serializable Объект.
void	setMaximum(int maximum) Установите максимальную длину, которая будет осуществлена этим Validator.
void	setMinimum(int minimum) Установите минимальную длину, которая будет осуществлена этим Validator.
void	setTransient(boolean transientValue) Обозначает, должен ли Объект, реализовывая этот интерфейс или не должен участвовать в сохранении состояния или восстановлении.
void	validate(FacesContext context, UIComponent component, java.lang.Object value) Выполните проверки правильности, реализованные этим Validator против указанного UIComponent.

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

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

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

VALIDATOR_ID

public static final java.lang.String VALIDATOR_ID

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

См. Также:

Постоянные Значения полей

MAXIMUM_MESSAGE_ID

public static final java.lang.String MAXIMUM_MESSAGE_ID

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

• {0} замененный сконфигурированной максимальной длиной.
• {1} замененный a String чье значение является меткой входного компонента, который произвел это сообщение.

См. Также:

Постоянные Значения полей

MINIMUM_MESSAGE_ID

public static final java.lang.String MINIMUM_MESSAGE_ID

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

• {0} замененный сконфигурированной минимальной длиной.
• {1} замененный a String чье значение является меткой входного компонента, который произвел это сообщение.

См. Также:

Постоянные Значения полей

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

LengthValidator

public LengthValidator()

Создайте a Validator без предварительно сконфигурированных пределов.

LengthValidator

public LengthValidator(int maximum)

Создайте a Validator с указанным предварительно сконфигурированным пределом.

Параметры:

maximum - Максимальное значение, чтобы позволить

LengthValidator

public LengthValidator(int maximum,
                       int minimum)

Создайте a Validator с указанными предварительно сконфигурированными пределами.

Параметры:

maximum - Максимальное значение, чтобы позволить

minimum - Минимальное значение, чтобы позволить

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

getMaximum

public int getMaximum()

Возвратите максимальную длину, которая будет осуществлена этим Validator, или 0 если максимум не был установлен.

setMaximum

public void setMaximum(int maximum)

Установите максимальную длину, которая будет осуществлена этим Validator.

Параметры:

maximum - Новое максимальное значение

getMinimum

public int getMinimum()

Возвратите минимальную длину, которая будет осуществлена этим Validator, или 0 если минимум не был установлен.

setMinimum

public void setMinimum(int minimum)

Установите минимальную длину, которая будет осуществлена этим Validator.

Параметры:

minimum - Новое минимальное значение

проверить

public void validate(FacesContext context,
                     UIComponent component,
                     java.lang.Object value)
              throws ValidatorException

Описание скопировало с интерфейса: Validator

Выполните проверки правильности, реализованные этим Validator против указанного UIComponent. Если какие-либо нарушения находятся, a ValidatorException будет брошен содержащий FacesMessage описание отказа.

Для блока проверки допустимости, чтобы быть полностью совместимым с Версией 2 и позже спецификации, это не должно привести проверку допустимости к сбою на null или пустые значения, если это определенно не предназначается, чтобы адресоваться null или пустые значения. Всего приложения <context-param> обеспечивается, чтобы позволить блокам проверки допустимости, разработанным для JSF 1.2 работать с JSF 2 и позже. javax.faces.VALIDATE_EMPTY_FIELDS <context-param> должен быть установлен в false включать этому назад поведение совместимости.

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

validate в интерфейсе Validator

Параметры:

context - FacesContext для запроса мы обрабатываем

component - UIComponent мы проверяем на правильность

value - значение, чтобы проверить

Броски:

java.lang.NullPointerException - если context или component null

ValidatorException - если проверка допустимости перестала работать

равняется

public boolean equals(java.lang.Object otherObj)

Переопределения:

equals в class java.lang.Object

хэш-код

public int hashCode()

Переопределения:

hashCode в class java.lang.Object

saveState

public java.lang.Object saveState(FacesContext context)

Описание скопировало с интерфейса: StateHolder

Получает состояние экземпляра как a Serializable Объект.

Если у class, который реализует этот интерфейс, есть ссылки на экземпляры, которые реализуют StateHolder (такой как a UIComponent с обработчиками событий, блоками проверки допустимости, и т.д.), этот метод должен вызвать StateHolder.saveState(javax.faces.context.FacesContext) метод на всех тех экземплярах также. Этот метод не должен сохранить состояние дочерних элементов и фасетов. Это делается через StateManager

Этот метод не должен изменить состояние объекта реализации. Другими словами, после выполнения этого кода:

 Object state = component.saveState(facesContext);
 

component должно быть то же самое как прежде, чем выполнить это.

Возврат из этого метода должен быть Serializable

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

saveState в интерфейсе StateHolder

restoreState

public void restoreState(FacesContext context,
                         java.lang.Object state)

Описание скопировало с интерфейса: StateHolder

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

Если у class, который реализует этот интерфейс, есть ссылки на экземпляры, которые также реализуют StateHolder (такой как a UIComponent с обработчиками событий, блоками проверки допустимости, и т.д.), этот метод должен вызвать StateHolder.restoreState(javax.faces.context.FacesContext, java.lang.Object) метод на всех тех экземплярах также.

Если state параметр null, не предпримите меры и возврат.

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

restoreState в интерфейсе StateHolder

isTransient

public boolean isTransient()

Описание скопировало с интерфейса: StateHolder

Если это правда, Объект, реализовывая этот интерфейс не должен участвовать в сохранении состояния или восстановлении.

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

isTransient в интерфейсе StateHolder

setTransient

public void setTransient(boolean transientValue)

Описание скопировало с интерфейса: StateHolder

Обозначает, должен ли Объект, реализовывая этот интерфейс или не должен участвовать в сохранении состояния или восстановлении.

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

setTransient в интерфейсе StateHolder

Параметры:

transientValue - булева передача true если этот Объект не будет участвовать в сохранении состояния или восстановлении, иначе передайте false.

markInitialState

public void markInitialState()

Описание скопировало с интерфейса: PartialStateHolder

Время выполнения должно гарантировать что PartialStateHolder.markInitialState() метод вызывают на каждом экземпляре этого интерфейса в представлении в подходящее время, чтобы указать, что компонент находится в своем начальном состоянии. Конструктор интерфейса должен гарантировать это PartialStateHolder.initialStateMarked() возвраты true со времени markInitialState() до не вызывают PartialStateHolder.clearInitialState() вызывается, после который время initialStateMarked() должен возвратиться false. Кроме того, в течение времени, когда экземпляр возвращается true от initialStateMarked(), реализация должна возвратить только состояние, которое изменилось в его реализации StateHolder#saveState.

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

markInitialState в интерфейсе PartialStateHolder

initialStateMarked

public boolean initialStateMarked()

Описание скопировало с интерфейса: PartialStateHolder

Возвратиться true если изменения состояния дельты прослеживаются, иначе false

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

initialStateMarked в интерфейсе PartialStateHolder

clearInitialState

public void clearInitialState()

Описание скопировало с интерфейса: PartialStateHolder

Сбросьте PartialStateHolder к состоянию отслеживания недельты.

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

clearInitialState в интерфейсе PartialStateHolder