Учебное пособие (1075724), страница 41
Текст из файла (страница 41)
В нашем примере файл называется «module.xqm».Этот модуль используется в каждом XQuery-сценарии.Для каждой сущности (в нашем примере для сущностей «Тип процессора» и«Компьютер») создается три XQuery-сценария:1. list_*.xql – сценарий возвращает список (таблицу) объектов.2. edit_*.xql – редактирование одного объекта.3. data_*.xql – работа с данными (сохранение, удаление и т.д.).Здесь «*» - название сущности.
Такую совокупность сценариев будемназывать предметным «модулем» (только это не XQuery-модуль, а «модуль»сценариев, соответствующих одной сущности предметной области). Все сценариипредметного модуля содержат в имени файла название сущности (модуля).Дальше мы несколько расширим эту схему, и «*» будет включать не тольконазвание, но и версию модуля.3907.3.5.2 Использование шаблона проектирования «модель-вид-контроллер»Шаблон проектирования «модель-вид-контроллер» (Model-View-Controller,MVC) позволяет при проектировании системы различать: Данные приложения (модель). Пользовательский интерфейс (вид). Управляющую логику (контроллер).Частоиспользуютсявариацииэтогошаблонапроектирования,адаптированные для конкретной технологии или приложения [MVC, 2007].Мы будем использовать разновидность этого шаблона при разработке XRXприложения.list_*.xqledit_*.xqlВидКонтроллерdata_*.xqlМодельБаза данныхРис.
7.5. Использование шаблона проектирования «модель-вид-контроллер».Наше приложение не является «строгой» реализацией этого шаблона, мыиспользовали только основные принципы шаблона «модель-вид-контроллер».Функцию модели выполняют XML-данные, хранящиеся в БД.Функцию контроллера выполняет сценарий «data_*.xql», реализующийработусданными(добавление,обновление,удаление,формированиевспомогательных данных и т.д.).391Используется два «вида» (что допускается шаблоном MVC). Сценарий«list_*.xql» возвращает список (таблицу) объектов, а сценарий «edit_*.xql»осуществляет редактирование одного объекта.«Виды» могут взаимодействовать друг с другом, с контроллером, с моделью.7.3.5.3 Использование редактора XQuery-сценариевВ качестве редактора XQuery-сценариев используется Notepad++.
Так как вNotepad++ нет стандартной подсветки синтаксиса для XQuery, то можноиспользовать подсветку синтаксиса XML.Для «eXist» важно, чтобы в XQuery-сценариях в качестве кодировкисимволовиспользовалсявариант«UTF-8безBOM».XQuery-сценарии,сохраненные в другой кодировке, могут вызывать ошибки.Более подробно с особенностями кодировки UTF-8 и использованием BOM(ByteOrderMark)можноознакомитьсянасайтестандартаUnicode(http://www.unicode.org).7.3.5.4 Справочник «Тип процессора»Так как справочник содержит только одно поле ввода (наименованиепроцессора), то будем использовать вариант архитектуры I, то есть технологияXForms использоваться не будет, данные будут вводиться с помощью обычныхформ HTML.Для реализации справочника необходимо разработать три сценария: list_processor_1.2.xql – список типов процессоров (вид). edit_processor_1.2.xql – редактирование типа процессора (вид). data_processor_1.2.xql – редактирование типа процессора (контроллер).Именафайловсценариевимеютследующуюструктуру:«тип_название модуля_версия модуля.xql».Тип может содержать значения «list», «edit» или «data».
Название модуля –«processor» Версия модуля – «1.2».В нашем примере мы предусмотрим возможность хранения сценариевмодуля в нескольких версиях в одном каталоге, поэтому версия модуля входит в392наименование файлов. То есть, если в дальнейшем мы разработаем версию «1.3»,то удалять файлы версии «1.2» нет необходимости, они могут храниться в том жекаталоге. Если в дальнейшем версия «1.3» будет признана неудачной, то возврат кверсии «1.2» будет простым.
Эта простейшая «система контроля версий» полезна,если мы не используем какую-либо полноценную систему версионного контроля,например SVN.7.3.5.4.1 Сценарий list_processor_1.2.xqlСценарийпредназначен длявывода списка процессоров икнопокдобавления, редактирования, удаления.Рис.
7.6. Сценарий list_processor_1.2.xqlСценарий содержит три стандартные части:1. Пролог сценария.2. Локальные функции (вспомогательные функции, которые вызываются изосновного запроса).3. Основной запрос.Пролог сценария:393xquery version "1.0";(: Импорт стандартных модулей eXist :)declare namespace request="http://exist-db.org/xquery/request";declare namespace session="http://exist-db.org/xquery/session";(: Импорт модуля приложения :)import module namespace xrx_example ="http://iu5.bmstu.ru/edu/xrx_example" at "module.xqm";Здесь задается префикс пространства имен «xrx_example» (который будетиспользоватьсядляобращениякпеременнымифункцияммодуля),идентификатор пространства имен «http://iu5.bmstu.ru/edu/xrx_example» (которыйдалее в сценарии не используется, он просто «обозначает» пространство именмодуля) и название файла модуля «module.xqm».(: Формат в котором результат должен отображаться в браузере :)declare option exist:serialize "method=xhtml media-type=text/htmlindent=no";Здесь указано, что результат, сгенерированный сценарием, должен быть вформате html.(: Идентификатор модуля :)declare variable $module_id {"processor"};(: Версия модуля :)declare variable $module_ver {"1.2"};Глобальные переменные сценария, которые определяют название модуля($module_id)иверсиюмодуля($module_ver).Этипеременныедалееиспользуются как параметры при вызове различных функций (прежде всего этофункции, которые формируют гиперссылки на другие сценарии модуля«edit_processor_1.2.xql» и «data_processor_1.2.xql»).394Для того чтобы наш «версионный контроль» работал корректно, необходимочтобы переменные $module_id и $module_ver были правильно установлены вовсех сценариях модуля и соответствовали имени файла.Основной запрос сценария:(: ++++++++++++++++++++++++++++++++++++++++++++++ :)(: Основной запрос :)(: ++++++++++++++++++++++++++++++++++++++++++++++ :)<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF8"/><style type="text/css"><xi:include xmlns:xi="http://www.w3.org/2001/XInclude"href="{xrx_example:PathURI_current_css()}"/></style></head><body><h1>Справочник типов процессоров</h1>{ local:main() }</body></html>(: ++++++++++++++++++++++++++++++++++++++++++++++ :)Основной запрос сценария формирует структуру выходного HTMLдокумента.В элементе <style> мы вставляем таблицу стилей CSS с использованиеммеханизмаXInclude.Функцияxrx_example:PathURI_current_css()(котораяопределена в библиотечном модуле) возвращает путь к таблице стилей.Таблица стилей используется не совсем обычная, так как она вставляется спомощью XInclude, то она должна быть правильным XML-документом.
Болееподробно содержимое таблиц стилей рассмотрено в следующих разделах.В элементе <body> вызывается локальная функция local:main(), котораявыполняет основные действия.395Локальные функции (они располагаются между прологом и основнымзапросом):(: ++++++++++++++++++++++++++++++++++++++++++++++ :)(: Основная функция :)(: ++++++++++++++++++++++++++++++++++++++++++++++ :)declare function local:main() as node(){<div>{(local:ShowHeader()),(local:ShowList()),(local:ShowFooter())}</div>};Функция объявляется с помощью ключевых слов «declare function». Передназванием функции «main» через двоеточие указывается префикс пространстваимен.
Префикс «local» означает, что это локальная функция.Входных параметров у функции нет (после названия функции стоят пустыескобки). После скобок указывается тип возвращаемого значения « as тип». Тип«node()» означает, что функция возвращает один элемент XML.Если бы функция возвращала строку, то было бы указано «as xs:string».Дляуказаниямножественности(по-английски«кардинальности»–cardinality) параметров и возвращаемого значения используются специальныесимволы (которые используются в DTD) – «*»,«+» и «?».Если необходимо, чтобы функция возвращала множество элементов (0 илиболее), то после типа ставится «*», например «node()*» или «as xs:string*».Также можно использовать «?» (0 или 1) и «+» (1 или более), например«node()+» или «node()?».Кардинальность параметров может показаться несколько непривычной сточки зрения традиционных языков программирования.
Наверное, наиболее396близким аналогом кардинальности в традиционных языках можно считатьмассивы.Рассмотрим тело функции.Тело функции ограничено фигурными скобками, после закрывающей скобкиставится точка с запятой.В нашем случае функция возвращает элемент <div>. Если внутри HTMLэлемента необходимо вызвать XQuery-блок, то этот блок также ограничиваетсяфигурными скобками. Если бы вместо<div>{(local:ShowHeader()),(local:ShowList()),(local:ShowFooter())}</div>мы написали без фигурных скобок<div>(local:ShowHeader()),(local:ShowList()),(local:ShowFooter())</div>то содержимое элемента <div> было бы воспринято как текст, а не какфрагмент программы на XQuery.Еще одним непривычным моментом является то, что последовательныеконструкции (которые должны выполняться друг за другом) необходимоперечислять через запятую.
Конструкции можно группировать с помощьюкруглых скобок. Например:(local:ShowHeader()),(local:ShowList()),(local:ShowFooter())илиlocal:ShowHeader(),local:ShowList(),397local:ShowFooter()или(local:ShowHeader()),(local:ShowList()),(local:ShowFooter())далее мы будем достаточно часто использовать этот способ.Вместо вызова функций здесь могли быть использованы любые конструкцииXQuery, например, IF или FLWOR.Таким же образом можно группировать тэги, например, мы могли быопределить следующую функцию:declare function local:taggroup() as node()*{<hr/>,<hr/>,<hr/>};Эта функция формирует на выходе три элемента «<hr/>». Тип возвращаемогозначения этой функции «node()*» – множество узлов. Если бы в качестве типавозвращаемого значения мы указали «node()», то получили бы сообщение обошибке (несоответствие кардинальности), так как функция возвращает множествоузлов (три элемента), а в соответствии с объявлением «node()» должна была бывозвращать один элемент.Рассмотрим другие локальные функции.(: ++++++++++++++++++++++++++++++++++++++++++++++ :)(:Вывод данных в виде списка:)(: ++++++++++++++++++++++++++++++++++++++++++++++ :)declare function local:ShowList() as node()Локальная функция, возвращает один узел.398{<div><table align="center" border="1">Формирование таблицы.<tr><th>Тип процессора</th><th colspan="2">Действия</th></tr>Первая строка таблицы определяет заголовок.
![](https://s.studizba.com/z.php?f=/templates/si/i/noavatar.png&w=100&h=100&t=1"){kind=avatar}
