7. Использование конвертеров, слушателей и проверок

7.1.Использование стандартных преобразователей

Java Server Faces обеспечивает набор реализаций преобразователей, который выможетеиспользовать,чтобыпреобразовыватьданныедлякомпонент.Стандартные

преобразователи расположены в пакете javax.faces.convert. Среди них:

С каждым из этих преобразователей связано стандартное сообщение об ошибках. Например, если BigIntegerConverter не может преобразовать значение, то отображается сообщение:

{0} must be a number consisting of one or more digits

В этом случае параметр подстановки {0} будет заменён именем компонента

ввода, на котором зарегистрирован преобразователь.

Два стандартных преобразователя (DateTimeConverter и NumberConverter) имеют свои собственные теги, которые позволяют задавать формат данных компонента с

использованием атрибутов тега.

7.1.1. Преобразование данных

Чтобы использовать конкретный преобразователь значений компонент, нужно

зарегистрировать его для компонента одним из следующих четырёх способов:

1)поместить один из стандартных преобразователей convertDateTime и convertNumber в тег компонента;

2)связать значение компонента со свойством бина такого же типа, как преобразователь;

3) сослаться на преобразователь в атрибуте converter тега компонента;

4)поместить тег преобразователя внутрь тега компонента и использовать атрибут converterId или binding , чтобы сослаться на преобразователь.

65

Пример второго способа: если нужно данные компонента преобразовывать в

целое, можно связать значение компонента со свойством внешнего бина.

Integer age = 0;

public Integer getAge(){ return age;}

public void setAge(Integer age) { this.age = age;}

Если компонент не связан со свойством бина, то можно применить третий спо-

соб, используя атрибут converter непосредственно в теге компонента:

<h:inputText converter="javax.faces.convert.IntegerConverter" />

Этот пример показывает атрибут преобразователя, указывающий полное имя класса преобразователя. Атрибут преобразователя может также получить ID компонента.

Данные из тега inputText в этом примере будут преобразованы в java.lang.Integer.

convertNumber и если один из стандартных преобразователей достаточен, вы можете просто сослаться на этот преобразователь, используя атрибут converter компонента.

Если вы хотите использовать атрибут converterId или binding, чтобы сослаться на преобразователь, атрибут converterId должен ссылаться на ID преобразователя,

например:

<h:inputText value="#{LoginBean.Age}" /> <f:converter converterId="Integer" />

</h:inputText>

7.1.1.1. Использование DateTimeConverter

Вы можете преобразовать данные в тип Java.util.Date, вкладывая тег convertDateTime в тег компонента. Тег convertDateTime имеет несколько атрибутов, которые позволяют определять формат и тип данных. В табл. 7.1 перечислены атри-

буты тега convertDateTime.

66

Простой пример тега convertDateTime:

<h:outputText id= "shipDate" value="#{cashier.shipDate}"> <f:convertDateTime dateStyle="full" />

</h:outputText>

При встраивании преобразователя DateTime в компонент убедитесь, что свой-

ство внешнего бина, с которым компонент связан, имеет тип java.util.Date. В предыду-

щем примере свойство cashier.shipDate должно быть типа java.util.Date. Пример может

вернуть следующий текст:

Saturday, September 26, 2009

Вы можете также отобразить ту же дату и время, используя следующий тег с

определением формата даты:

<h:outputText value="#{cashier.shipDate}"> <f:convertDateTime

pattern="EEEEEEEE, MMM dd, yyyy" /> </h:outputText>

Если вы хотите отобразить дату по-испански, то можете использовать атрибут

места действия:

<h:inputText value="#{cashier.shipDate}"> <f:convertDateTime dateStyle="full" locale="Locale.SPAIN"

timeStyle="long" type="both" /> </h:inputText>

Этот тег должен отобразить следующий выход: sabado 26 de septiembre de 2009

7.1.1.2. Использование NumberConverter

Вы можете преобразовать данные в java.lang.Number, вкладывая тег convertNumber в тег компонента. Тег convertNumber имеет несколько атрибутов, кото-

рые позволяют определять формат и тип данных, приведённые в табл. 7.2.

67

Следующий пример использует тег convertNumber, чтобы разместить общую стоимость книг в корзине:

<h:outputText value="#{cart.total}" > <f:convertNumber type="currency"/>

</h:outputText>

При связывании преобразователя чисел с компонентом необходимо, чтобы тип свойствавнешнегобинабылjava.lang.Number.Впредыдущемпримеревыражениеcart. total должно быть типа java.lang.Number. Пример числа, отображаемого этим тегом:

$934

Этот результат может отображён следующим тегом, где определён валютный

шаблон:

<h:outputText id="cartTotal" value="#{cart.total}" > <f:convertNumber pattern=”$####”

/>

</h:outputText>

7.2. Регистрация слушателей для компонентов

Разработчик приложения может реализовать слушателей как классы или как методы бинов. Если слушатель является внешним методом, автор страницы ссылает-

ся на метод из атрибута valueChangeListener или actionListener. Если слушатель явля-

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

7.2.1. Регистрация слушателей изменений значений

Реализация AValueChangeListener может быть зарегистрирована в компоненте,

который реализует EditableValueHolder, вкладывая тег valueChangeListener в целевой

тег на странице. Тег valueChangeListener поддерживает два атрибута:

•type: ссылка на подходящее имя класса реализации интерфейса

ValueChangeListener с методом void processValueChange(ValueChangeEvent event);

•binding: ссылка на объект, который реализует интерфейс

ValueChangeListener.

Один из этих атрибутов должен быть использован для указания слушателя из-

менения значения. Атрибут типа может быть литералом или выражением. Атрибут

связи может быть только выражением, которое должно указать на свойство внешнего

бина, которое хранит и возвращает реализацию ValueChangeListener.

Следующий пример показывает слушателя изменений, зарегистрированного в

компоненте:

<h:inputText id="name" size="50" value="#{cashier.name}" required="true">

<f:valueChangeListener type="listeners.NameChanged" /> </h:inputText>

68

В данном примере атрибут type определяет слушателя NameChanged как реализацию интерфейса ValueChangeListener, который зарегистрирован для свойства name объекта cashier. После того как тег компонента будет обработан и локальные

данные от клиента будут проверены, соответствующий компонент поставится в оче-

редь ValueChangeEvent, который связан со слушателем событий ValueChangeListener

для компонента.

Атрибут связывания используется, чтобы связывать реализацию

ValueChangeListener со свойством внешнего бина. Это работает аналогично атрибуту

связывания, поддерживаемого стандартными тегами преобразователя.

7.2.2. Регистрация слушателей для операций

Автор приложения может зарегистрировать реализацию ActionListener в компоненте Command, вкладывая тег actionListener внутрь командного тега. Аналогично

тегу valueChangeListener, тег actionListener поддерживает как атрибуты type и binding.

Должен быть использован один из этих атрибутов, чтобы ссылаться на слушателя

действия. Пример тега commandLink с использованием класса реализации интер-

фейса ActionListener, а не метода внешнего бина:

<h:commandLink id="NAmerica" action="bookstore"> <f:actionListener type="listeners.LocaleChange" />

</h:commandLink>

Атрибут type тега actionListener задаёт полное имя класса реализации

ActionListener. Аналогично тегу valueChangeListener, тег actionListener также поддер-

живает атрибут binding.

7.2.3. Использование стандартных проверок (Standard Validators)

JavaServer Faces обеспечивает набор стандартных классов и связанных тегов,

которые авторы страниц и разработчики приложений могут использовать, чтобы проверять данные от компонент. В табл. 7.3 показаны все стандартные классы проверок и теги, которые позволяют использовать проверки на страницах.

69

Подобно стандартным преобразователям, каждая из этих проверок имеет одно

или более связанных с ней стандартных сообщений об ошибке. Например, сообщение

об ошибке, которое отображается, когда значение превышает максимум, допустимый в LongRangeValidator, выглядит следующим образом:

{1}: Validation Error: Value is greater than allowable maximum of "{0}"

В этом случае параметр подстановки {1} заменяется тегом компонента или id, а

параметр подстановки {0} заменяется максимально допустимой величиной.

7.2.3.1. Проверка вводимых значений компонента

Чтобы обеспечить автоматическую проверку поступающих от компонент дан-

ных с использованием конкретной проверки, ее нужно зарегистрировать в компоненте

одним из следующих способов:

•поместить соответствующий тег проверки (показанный в табл. 7.3) в тег ком-

понента;

•сослаться на метод, который выполняет проверку, из атрибута validator тега компонента;

•поместить тег validator внутрь тега компонента и использовать или его атрибут validatorId, или атрибут binding, чтобы ссылаться на проверку. Атрибут validatorId работает аналогично атрибуту converterId тега преобразователя.

Имейте в виду, что проверка может выполняться только для компонент, которые

реализуют интерфейс EditableValueHolder, поскольку только эти компоненты принимают от клиента данные, которые могут быть проверены.

7.2.3.2. Использование LongRangeValidator

Следующий пример показывает, как использовать проверку validateLongRange для компонента ввода числовых данных:

<h:inputText id="quantity" size="4" value= "#{item.quantity} " >

<f:validateLongRange minimum="1"/> </h:inputText>

<h:message for="quantity"/>

Тег inputText требует, чтобы пользователь вводил число, которое не меньше

единицы. Атрибут size определяет, что число может состоять не более чем из четырех

цифр. Тег validateLongRange также может иметь атрибут максимума, который вы можете установить для вводимого числа.

Атрибуты всех стандартных тегов проверок требуют EL-выражения. Это озна-

чает, что атрибуты могут ссылаться на свойства внешних бинов, а не определять кон-

станты. Например, тег validateLongRange в предыдущем примере может ссылаться на

свойство внешнего бина, задающее минимум, чтобы получать минимальное допусти-

мое значение в проверке:

<f:validateLongRange minimum="#{ShowCartBean.minimum}" />

Ссылки на метод внешнего бина

Тег компонента имеет набор атрибутов для ссылок на методы бинов, выпол-

няющих определённые функции для компонента, связанного с тегом. Эти атрибуты перечислены в табл. 7.4.

70

Таблица 7.4

valueChangeListener Ссылка на метод бина для обработки события изменения значения

Только компоненты, реализующие ActionSource, могут использовать атрибуты action и actionListener. Только компоненты, реализующие EditableValueHolder, могут

использовать атрибуты validator или valueChangeListener.

Тегкомпонентассылаетсяна методвнешнегобина,используявыражение-метод как значение одного из атрибутов. Метод, на который ссылается атрибут, должен удо-

влетворять конкретным требованиям сигнатуры (структуры параметров и тела), кото-

рая определена тегом в TLD. Например, определение атрибута validator тега inputText

в описании библиотеки в файле html_basic.tld следующее:

void validate(javax.faces.context.FacesContext, javax.faces.component.UIComponent, java.lang.Object)

7.2.4. Ссылки на методы навигации

Если ваша страница включает компоненты (как например, кнопки или гиперс-

сылки) для перехода приложения на другую страницу, когда компонент активирован,

тег соответствующего компонента должен включать атрибут действия action. Этот атрибут:

•определяет логическую строку-результат, которая сообщает навигатору при-

ложения страницу для последующего перехода;

•указывает метод внешнего бина, который выполняет некоторую обработку и возвращает логическую строку-результат навигатору.

Следующий пример показывает, как ссылаться на метод навигации:

<h:commandButton

value="#{bundle.Submit}" action="#{cashier.submit}" />

7.2.5. Ссылки на обработчик события

Если компонент на вашей странице генерирует событие action и если это событие обрабатывается внешним методом, то надо сослаться на метод, используя атри-

бут actionListener. Например:

<h:commandLink id="NAmerica" action="bookstore" actionListener="#{localeBean.chooseLocaleFromLink}">

Атрибут actionListener этого тега компонента ссылается на метод chooseLocaleFromLink с использованием выражения для метода. Метод chooseLocaleFromLink обрабатывает событие, когда пользователь щёлкает по гиперс-

сылке, предоставленной этим компонентом.

71

7.2.6. Обращение к методу проверки данных

Для проверки ввода компонентов на странице внешним методом нужна ссылка

на метод в теге, используя атрибут validator, например:

<h:inputText id="email" value="#{checkoutFormBean.email}" size="25" maxlength="125" validator="#{checkoutFormBean.validateEmail}"/>

7.2.7. Обращение к методу обработки события

Для обработки сообщения об изменении значения для компонента на вашей

странице внешним методом нужно сослаться на метод с использованием тега или

атрибута valueChangeListener, например:

<h:inputText

id="name"

size="50"

value="#{cashier.name}"

required="true">

<f:valueChangeListener type="listeners.NameChanged" /> </h:inputText>

<h:inputText

id="name"

size="50"

value="#{cashier.name}"

required="true" valueChangeListener="#{cashier.processValueChange}" />

</h:inputText>

72