- PVSM.RU - https://www.pvsm.ru -
[1] Здравствуйте. Эта статья — небольшой обзор инструмента, который помогает разбираться с устройством и структурой данных пакетов и классов внутри СУБД Caché.
Если кратко, его миссия — выполнить визуализацию класса или целого пакета, показать связи между классами и предоставить максимум информации будь-то программисту или тимлиду без надобности отправляться в Студию и смотреть там программный код.
Тех, кто обучается или ведёт обучение по технологиям InterSystems, днями просматривает или изменяет коды разных проектов и просто заинтересованным лицам — приглашаю ознакомиться с Caché Class Explorer!
Caché — мультимодельная СУБД. К ней можно обращаться как с помощью запросов на языке SQL с некоторыми расширениями, так и взаимодействовать с хранимыми объектами и процедурами через интерфейсы для различных языков программирования. Третий же вариант — это напрямую разрабатывать приложение на родном для СУБД языке — Caché ObjectScript (COS).
Caché поддерживает классы на уровне СУБД. Существует два основных типа классов: Persistent, которые могут хранится в базе данных, и Registered, которые не хранятся в БД, а выполняют роль программ и обработчиков. Так же есть ряд особых типов: Serial (классы, которые могут быть встроены в Persistent классы для создания сложных типов данных, таких как, например, адреса), DataType (создают пользовательский тип данных), Index, View и Stream.
Caché Class Explorer — инструмент, который визуализирует структуру классов Caché в диаграмму, показывает зависимости между классами и всю необходимую информацию, включая код методов, запросов, xData-блоков, комментарии, документацию и ключевые слова разных элементов класса. Для отображения Class Explorer использует модифицированную нотацию UML, потому что в Caché присутствует целое разнообразие сущностей, которые в стандартной нотации UML не предусмотрены, но имеют важное значение для Caché: запросы, xData-блоки, множество ключевых слов для методов и свойств (таких как System, ZenMethod, Hidden, ProcedureBlock и другие), отношения parent-child, one-many, типы классов и так далее.
Чтобы составить максимально правильное понимание того, о чём будет рассказываться дальше, следует сперва посмотреть, как выглядит отображённый пакет, и, заодно, интерфейс Class Explorer. Для примера, возьмём пакет Cinema из пространства имён SAMPLES:
В Caché Class Explorer (1.14.3) можно:
В левой части приложения находится дерево пакетов. Чтобы нарисовать весь пакет, нужно нажать на кнопку в правой части имени пакета при наведении на него. Чтобы отобразить отдельный класс и все зависимые от него классы, нужно в этом дереве его просто выбрать.
Class Explorer может отобразить несколько видов зависимостей между классами:
Если навести курсором на связь, то у класса будут подсвечены поля, которые эту связь и создают. Важно отметить, что Class Explorer не будет “углубляться” и рисовать зависимости тех классов, которые находятся вне текущего пакета, он нарисует только один класс. “Углубляться” без конца он будет только в классы, которые находятся в текущем пакете — если нужно это ограничить, воспользуйтесь настройкой “Dependency level”.
Сам класс отображается в виде прямоугольника, разделённого на 6 секций:
По-умолчанию класс отображается с множеством графических иконок, толкование которых вы можете посмотреть нажав на кнопку Help. Если же нужна более-менее строгая нотация UML, то их отображение, как и отображение любых секций класса можно отключить в настройках.
Если диаграмма достаточно большая и не знакомая, можно воспользоваться быстрым поиском по диаграмме. Класс, который содержит любую часть введённого ключевого слова будет выделен. Чтобы перейти к классу со следующим совпадением, просто ещё раз нажмите Enter или кнопку поиска.
Ну и напоследок, отредактировав диаграмму, удалив все ненужные связи и разместив элементы для достижения желаемого вида, её можно сохранить, нажав на самую левую нижнюю кнопку.
Для того, чтобы установить Caché Class Explorer, нужно всего лишь импортировать последний релиз [2] в любую область. После успешного импорта у вас должно появится веб-приложение hostname/ClassExplorer/
(косая черта в конце необходима).
Поиск по диаграмме:
Просмотр исходного кода методов:
Просмотр исходного кода xData-блоков:
Можно посмотреть, как Class Explorer работает в области SAMPLES/USER: демонстрация [3]. Так же есть небольшой видео-обзор [4] по проекту. Любые отзывы, предложения или комментарии приветствуются — оставляйте их в корпоративном репозитории [5]. Приятного использования!
Автор: InterSystems
Источник [6]
Сайт-источник PVSM.RU: https://www.pvsm.ru
Путь до страницы источника: https://www.pvsm.ru/vizualizatsiya-danny-h/110791
Ссылки в тексте:
[1] Image: https://habrahabr.ru/company/intersystems/blog/276003/
[2] последний релиз: https://github.com/intersystems-ru/UMLExplorer/releases
[3] демонстрация: http://37.139.4.54/ClassExplorer/
[4] видео-обзор: https://www.youtube.com/watch?v=j55fP2CnKpo
[5] корпоративном репозитории: https://github.com/intersystems-ru/UMLExplorer
[6] Источник: https://habrahabr.ru/post/276003/
Нажмите здесь для печати.