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

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

Все Суперинтерфейсы:

java.util. EventListener

Все Известные Классы с реализацией:

BeanValidator, DoubleRangeValidator, LengthValidator, LongRangeValidator, MethodExpressionValidator, RegexValidator, RequiredValidator

public interface Validator
расширяет java.util. EventListener

Реализацией Блока проверки допустимости является class, который может выполнить проверку допустимости (проверки правильности) на a EditableValueHolder. Нуль или больше Validators может быть связан с каждым EditableValueHolder в представлении, и вызываются во время фазы Проверок допустимости Процесса жизненного цикла обработки запросов.

Человек Validators должен исследовать значение и компонент, что их передают, и бросают a ValidatorException содержа a FacesMessage, документирование любых отказов соответствовать необходимым правилам.

Для максимальной общности, Validator экземпляры могут быть конфигурируемы основанный на свойствах Validator реализация class. Например, проверка принадлежности к диапазону Validator мог бы поддерживать конфигурацию минимальных и максимальных значений, которые будут использоваться.

Validator у реализаций должен быть конструктор общественности нулевых параметров. Кроме того, если Validator class хочет сохранить значения свойств конфигурации и восстановленный с представлением, реализация должна также реализовать StateHolder.

Если реализация class Validator имеет a ResourceDependency аннотация, действие, описанное в ResourceDependency должен быть взят когда EditableValueHolder.addValidator(javax.faces.validator.Validator) вызывается. Если реализация class Validator имеет a ResourceDependencies аннотация, действие, описанное в ResourceDependencies должен быть взят когда EditableValueHolder.addValidator(javax.faces.validator.Validator) вызывается.

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

static java.lang.String

NOT_IN_RANGE_MESSAGE_ID Осуждаемый. Использовать DoubleRangeValidator#NOT_IN_RANGE_MESSAGE_ID или LongRangeValidator#NOT_IN_RANGE_MESSAGE_ID вместо этого.

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

void	validate(FacesContext context, UIComponent component, java.lang.Object value) Выполните проверки правильности, реализованные этим Validator против указанного UIComponent.

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

NOT_IN_RANGE_MESSAGE_ID

static final java.lang.String NOT_IN_RANGE_MESSAGE_ID

Осуждаемый. Использовать DoubleRangeValidator#NOT_IN_RANGE_MESSAGE_ID или LongRangeValidator#NOT_IN_RANGE_MESSAGE_ID вместо этого.

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

См. Также:

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

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

проверить

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

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

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

Параметры:

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

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

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

Броски:

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

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