StarUML. Руководство разработчика. Глава 11. Написание шаблонов |
118 / 139 |
Глава 11. Написание шаблонов
Эта глава представляет введение в композицию элементов, используемых для того, чтобы генерировать документы под Microsoft Word, Microsoft Excel, Microsoft PowerPoint, и текстовые файлы. Она показывает на примерах, как пользователь может создать, зарегистрировать и использовать собственный шаблон.
Компоненты шаблона
Шаблон StatUML включает текст двух типов. Фрагменты первого типа - область стиля, которая определяет стиль и формат документа, текст второго типа - область команд, определяющих, какие модельные элементы генератор получает из UML модели. Для представления команд шаблоны MS Office (Word, Excel, PowerPoint) используют комментарии MS Office, содержащие текстовый код определённого формата, заключённый в специальные символы. Область команд содержит команды типа циклов, сравнения, вычисления и прорисовки, обращающиеся к UML модели. Команды шаблонов под каждую платформу немного различаются, но в общем они подобны следующим.
•REPEAT ~ ENDREPEAT
•IF ~ ENDIF
•DISPLAY
•SCRIPT
Команда REPEAT
REPEAT - команда, которая выполняет перебор модельных элементов в соответствии со своими аргументами. Повторяется участок, расположенный между командами REPEAT И ENDREPEAT, генератор вставляет этот фрагмент в генерируемый документ на каждой итерации. Команда REPEAT имеет следующие четыре параметра.
Аргумент |
Описание |
Замечание |
Pathname |
Путь к перебираемым элементам |
Необязательный |
FilterType |
Перебираются элементы типа FilterType. |
Необязательный |
CollectionName |
Перебираются элементы коллекции CollectionName элементов, |
Необязательный |
|
расположенных в Pathname и удовлетворяющих FilterType. |
|
Condition |
Перебираются элементы, удовлетворяющие Condition. |
Необязательный |
Первый параметр "Pathname" определяет отправную точку итерирования в модели UML. Он имеет форму имени пути, с разделителями "::". Имя пути элемента показывается в строке состояния. Есть два вида Pathname (абсолютный и относительный). Абсолютный путь начинается с символов "::". Например, "::A" означает элемент с именем "А", находящийся на верхнем уровне проекта. "A" означает элемент с именем "A", находящийся в контексте текущего элемента. Строка "{R} " означает, что итерации выполняются рекурсивно для всех суб-путей указанного пути. Если имя пути опущено, перебираются элементы по пути, указанному последней командой.
Второй параметр "FilterType" определяет тип перебираемых элементов. Если значение параметра - "UMLClass", то выполняется перебор только тех элементов, тип которых - "UMLClass". Если параметр опущен, то выполняется перебор всех элементов, независимо от типа.