Диссертация (Методы и инструменты декларативного программирования динамических Web-узлов и приложений), страница 11

Исключением из этого правила составляет атрибут «name», являющийся идентификатором блока. К выходным атрибутамотносятся такие, значения которых передается непосредственно шаблонизатору и может быть задействовано при вёрстке шаблонов документа.Таблица 2.2. Общие атрибуты блоковАтрибутОписаниеПоПрименениеумолч.aliasУстанавливает альтернативное имя (синоним) блока при приёме данных извне.

НетModel,LocationdefaultУстанавливает значение по умолчанию у блока, если при добавлении или из- НетModel,менении (см. ниже) экземпляра не указано иное. Допустимо указание значенияLocation@current для блоков типа date, time, datetime, ip.

В этом случае будут установлены текущие дата, время, клиентский IP-адрес соответственно. Для файловыхтипов необходимо указать имя файла.nameModel,Состоит из символов латинского алфавита, цифр и нижнего подчёркивания.LocationСпециальные имена: _login, _password, _groupname, _priority.продолжение следует56Уникальное имя блока, идентифицирующее его в контексте модели и локации. Нет(продолжение)АтрибутОписаниеПоПрименениеумолч.requiredУказывает группу, обязательную для заполнения. 0 — блок не обязателен для 0Model,заполнения, в другом случае указывается число или пара целых чисел, раз-Locationделённых точкой. Если хотя бы один из блоков в группе не был заполнен впроцессе запроса, то вся группа игнорируется целиком. Он может приниматьдва типа значений: целое число или пара целых чисел, разделенных точкой.В первом случае каждая последующая группа обрабатывается только послекорректной обработки предыдущей – если все данные для первой группы были переданы и затем корректно обработаны, то только после этого начнется57обработка данных второй группы и т.д.

Во втором случае можно создаватьнесколько независимых друг от друга групп на одном уровне, из чего следует,что даже если для одной группы обработка закончится неудачно, то для другихпроцесс не прервётся.typeУказывает на тип блока. Перечень допустимых типов указан ниже.stringModel(строка)продолжение следует(продолжение)АтрибутОписаниеПоПрименениеумолч.conditionУстанавливает условие выборки экземпляров набора в контексте своего блока. noneModel,Формат атрибута зависит от типа блока, однако общая структура представляетLocationсобой перечень условий, перечисленных через запятую.

Условие записывается в префиксной форме: сначала устанавливается одна из операций сравнения(см. табл. 2.3), затем записывается значение, с которым будет производитьсясравнение значений в блоке. Значение может быть получено также путём пользовательского ввода из HTML-формы (опция @input). Если установленныйатрибут вступает в противоречие с подстановками из атрибута base локации,58то атрибут локации перекрывает одно или несколько условий, перечисленныхатрибуте condition.

Использование ключевого слова @current аналогично использованию в атрибуте default.oncreateУстанавливает правила записи значений блока при добавлении нового экзем- Нет,Model,пляра набора. Они могут быть получены либо путём пользовательского ввода @defaultLocation(опция @input), либо через значение атрибута default (опция @default). Данные опции могут быть заданы совместно через запятую, а их порядок, в такомслучае, будет указывать приоритет. Опция @none запретит установку значения. При этом значения @default и @input могут комбинироваться с другимистроками, образуя шаблон.продолжение следует(продолжение)АтрибутОписаниеПоПрименениеумолч.onupdateondeleteonreadАналогично oncreate, но правила задаются для обновления существующего НетModel,экземпляра набора.LocationАналогично oncreate, но правила задаются для удаления существующего эк- НетModel,земпляра набора.LocationЗадаёт условия выборки.

Если не задан ни один из атрибутов правил (oncreate, @inputModel,ondelete, onupdate, onauth), то производится выборка экземпляров набора наLocationоснове условия данного атрибута. В противном случае выполняется действиес учётом значения данного атрибута.Задаётся правило изменения блока при авторизации.НетModel,Location59onauth602.5.3Разработка базовых и составных блоков с их атрибутамиВ таблицах 2.4 и 2.5 представлен перечень базовых и составных блоков, соответственно.Таблица 2.3. Перечень математических операций, применяемых ватрибуте condition.Обозначение= или пустоНазваниеоперацииРавноБлоки(все)numberСтрогое соответствие значению. Допустимо не указывать.Исключение из выборки. Символ «=»допустимо не указывать (обе операциивыполняют эквивалентную функцию).Значение в блоке меньше заданного.numberЗначение в блоке больше заданного.numberЗначение в блоке меньше или эквивалентно заданному.Значение в блоке больше или эквивалентно заданному.!= или !Не равно, (все)отрицание<«Меньше,чем»«Больше,чем»«Меньшеили равно»«Большеили равно»><=>=ОписаниеnumberТаблица 2.4.

Перечень базовых блоковБлокЧислоДробьСтрокаДатаВремяДата и времяЗначениеатрибутаTypenumberfloatstringdatetimedatetimeОписаниеЛюбое целое число от min до max (см. таблицу2.6). Размерность вычисляется из значений верхнего и нижнего пределов.Десятичная дробь.Строка или текст.Дата.Время.Дата и время.Каждому блоку, помимо общих атрибутов, соответствует индивидуальные, имеющие смысл только в контексте своего блока. В таблице 2.6 представлены атрибуты длябазовых и составных блоков. Стоит отметить, что атрибуты с одинаковыми именамив зависимости от типа блока могут иметь различные свойства. Обратное также верно.61Таблица 2.5. Перечень составных блоковБлокЗначениеОписаниеатрибутаTypeПраваpermissions Устанавливает права доступа на набор, его экземдоступапляры и потомки или блок текущего набора.Парольpassword Хранит в зашифрованном виде пароль пользователя.

Применяется в авторизационном наборе. Подробнее см. 2.6.1.Электронная emailСтрока, соответствующая адресу электронной попочтачты вида: username@domain.tld. Где username —имя пользователя, domain — доменное имя, tld — домен верхнего уровня.

Пример: dummy@blockset.ruТелефонphoneСтрока, соответствующая телефонному номеру вида: +код_страны(код_города)номер_телефона.Адрес URL urlСтрока, соответствующая URL-адресу в форматеscheme://domain:port/path?query_string#fragment_id.Пример: https://pavel:TestPassword@example.ru:8080/dir/document.html?act=edit&id=1IP-адресipВозвращает строку, содержащую IP-адрес в формате X.X.X.X, где X — число от 0 до 255.РейтингratingРейтинг экземпляра набора (например, рейтинг статьи). Пользователь, у которого есть доступ к этомутипу, может ставить оценку, учитывающуюся приформировании конечного результата рейтинга.ЗащитныйcaptchaОтображает защитный код на картинке с цельюкодпредотвращения автоматических добавлений, изме(CAPTCHA)нений или просмотров набора.

В шаблонизатор приобращении к блоку данного типа отправляется URLкартинки. Вводимое значение не сохраняется.62Несмотря на свою атомарность, некоторые блоки могут иметь достаточно сложнуюлогику обработки данных. Например, часть из них позволяют получить дополнительную информацию о себе. Так, блок ip позволяет получить информацию об организации, обслуживающей тот или иной IP-адрес. Блок email использует внутреннююбазу данных для проверки того или иного адреса электронной почты на предмет нахождения оного в чёрном списке. Блок rating имеет сложную структуру внутри себядля учета проголосовавших пользователей.

Именно подобные характеристики отличают составной блок от простого, границы между которыми, тем не менее, весьмаразмыты.Таблица 2.6. Перечень атрибутов базовых и составных блоковБлок(и)АтрибутОписаниеПо умолча- ПрименениениюnumberminНижняя граница числа.maxВерхняя граница числа.−231231 − 1minНижняя граница числа.Зависит от Model, LocationfloatModel, LocationModel, LocationсистемыmaxВерхняя граница числа.Зависит от Model, Locationсистемыnumber,precisionТочность, количество знаков после запятой.conditionЧерез запятую в префиксной форме задаётся одно или несколь- noneModel, LocationModel, Location63float2ко условий с числовыми значениями (для number —только целочисленные, для float могут задаваться в виде десятичной дроби), перед которыми ставится один из операторов из таблицы 2.3.Несколько условий связаны логическим И.

Например, запись >10, <100, !0 означает, что значение в блоке должно находиться в интервале (-10;100) не включая ноль.regexpЗадаёт строгое соответствие строки регулярному выражению, ука- noneModel, Locationзанному в значении атрибута. Значение none означает отсутствиеstringрегулярного выражения.charsЗадаёт перечень символов, допустимых для данного блока. Диа- НетModel, Locationпазоны символов могут задаваться дефисом. Пример: А-Я0-9продолжение следует(продолжение)Блок(и)АтрибутОписаниеПо умолча- ПрименениениюreplacesrcЗадаёт блок в формате #имя_набора:имя_блока, значения которого НетModel, Locationсовпадают с подстрокой данного блокаreplacedstЗадаёт блок в формате #имя_набора:имя_блока, на значение ко- НетModel, Locationторого происходит замена при нахождении подстроки из блокаreplacesrc.string,lengthМаксимальная длина строки.

Если применяется для Location, то 0 (не огра- Model, Locationвсе строки, выходящие за указанное значение, обрезаются. Не ничено)phone,имеет смысла, если атрибут в Location больше аналогичного ат-url,рибута в Model.ip64email,продолжение следует(продолжение)Блок(и)АтрибутОписаниеПо умолча- Применениениюtruncate-typeТип обрезки строки (текста) в документе.

Допустимые значения:straightModel, Locationstraight — посимвольная обрезка (обрезка происходит в позицииlength, при этом слово может разорваться).upper — обрезка по концу слова (если позиция length в строке соответствует непробельному символу, то обрезка произойдёт в томместе, где встретится первый пробельный символ после позицииlength)lower — обрезка по началу слова (если позиция length в строке65соответствует непробельному символу, то обрезка произойдёт втом месте, где встретится первый пробельный символ до позицииlength).more-stringСтрока или символ, выставляемые в конце исходной строки при . .