Alterator/module/types

Материал из ALT Linux Wiki

(Различия между версиями)
Перейти к: навигация, поиск
(→Типы параметров)
(→Список типов)
Строка 63: Строка 63:
!название типа || комментарии
!название типа || комментарии
|-
|-
-
|boolean||
+
|boolean||#t или #f
|-
|-
-
|date||
+
|date||YYYY-MM-DD, месяц от 01 до 12, день от 01 до 31
|-
|-
-
|hostname-list||
+
|time||HH:MM:SS
|-
|-
-
|hostname||
+
|ipv4-address||NNN.NNN.NNN.NNN
|-
|-
-
|ipv4-address-list||
+
|ipv4-address-list||список адресов, разделенный пробелами
|-
|-
-
|ipv4-address||
+
|ipv4-network||NNN.NNN.NNN.NNN/MM
|-
|-
-
|ipv4-network||
+
|hostname||^[.a-zA-Z0-9_-]*$
|-
|-
-
|iso-3166-alpha-2||
+
|hostname-list||список имен, разделенный пробелами
|-
|-
-
|system-account-name||
+
|tcp-port|| 0..65535
|-
|-
-
|tcp-port||
+
|iso-3166-alpha-2||двухбуквенный код страны
|-
|-
-
|time||
+
|system-account-name||^[a-z][a-z0-9_-]*$
|}
|}

Версия 18:03, 24 октября 2008

Содержание

Автоматическая проверка данных

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


Изменения в бакенде

Делается это следующим образом. В бакенде добавляется ответ на запрос "type". В нем перечисляются параметры, с которыми работает бакенд, и их типы. Для формирования правильного ответа стоит воспользоваться стандартной библиотекой, например для бакенда на shell объявление типов будет выглядить следующим образом. 

. alterator-sh-functions

on_message()
{
 case "$in_action" in
   type)
     write_type_item a ipv4-address
     write_type_item b tcp-port
     ;;
   read)
   ...
 esac
}

В примере выше объявлено что параметр 'a' будет иметь тип 'IP адрес', 'b' - 'TCP порт' и теперь пользователь не сможет передать в бакенд в качестве 'a' что-либо отличное IP адреса и в качестве 'b' что-либо отличное от целого числа находящегося в определённом диапазоне.

Изменения в интерфейсе

На этом возможности системы типов не исчерпываются. Предположим, что пользователь ввёл-таки неправильное значение в поле, соотвествующее параметру 'a'. Он увидит следующее сообщение об ошибке: 

a: недопустимый IP-адрес

Однако никакого 'a' на его экране не наблюдается. В каком именно поле случилась ошибка?

Система типов alterator в состоянии справиться с этим. Для этого всего-лишь необходимо, чтобы у названия поля был задан атрибут 'name' содержащий имя параметра бакенда, которому соответвует это поле.

Пример для qt: 

...
  (label text "Field" name "a")
  (edit name "a")
...

Теперь в случае ошибки, пользователь увидит следующее сообщение: 

 Field: недопустимый IP-адрес

Аналогичный пример для html: 

....
   <span name="a" translate="_">Field:</span>
   <input type="text" name="a"/>
...

Список типов

название типа комментарии
boolean#t или #f
dateYYYY-MM-DD, месяц от 01 до 12, день от 01 до 31
timeHH:MM:SS
ipv4-addressNNN.NNN.NNN.NNN
ipv4-address-listсписок адресов, разделенный пробелами
ipv4-networkNNN.NNN.NNN.NNN/MM
hostname^[.a-zA-Z0-9_-]*$
hostname-listсписок имен, разделенный пробелами
tcp-port 0..65535
iso-3166-alpha-2двухбуквенный код страны
system-account-name^[a-z][a-z0-9_-]*$
 
Личные инструменты