Перейти к содержимому

Диаграмма пакетов

Пакет удобно использовать после определения слоёв и крупных модулей. Например, пакеты Предметная область, Приложение, Инфраструктура показывают архитектурные области, а не папки в репозитории сами по себе.

Пакет

Зависимость (Dependency) между пакетами показывает её направление. Она полезнее одной большой диаграммы классов, когда нужно увидеть, что предметная логика не зависит от веб-интерфейса, а модуль уведомлений не знает внутренних классов модуля заказов.

Импорт элемента (ElementImport) добавляет в пространство имён один выбранный пакетируемый элемент. Импортирующий пакет может обращаться к нему по короткому имени, не становясь его владельцем. Публичный импорт позволяет дальше экспортировать это имя, приватный оставляет его доступным только внутри импортирующего пространства имён.

Импорт пакета (PackageImport) делает доступными публичные элементы импортируемого пакета. Ключевые слова «import» и «access» различают публичный и приватный импорт. Импорт не переносит элементы и не меняет их полные имена; при совпадении коротких имён требуется квалификация.

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

Слияние пакетов (PackageMerge) с «merge» позволяет дополнить определения одного пакета определениями другого, включая слияние одноимённых элементов. Оно нужно главным образом при построении профилей и метамоделей. В прикладной архитектуре чаще достаточно обычных зависимостей между пакетами.

Пакет, как и класс, может быть шаблонным. Шаблонный пакет принимает параметры, а связывание шаблона (TemplateBinding) подставляет в него конкретные значения. Это средство полезно при повторном использовании метамоделей и профилей, но для группировки прикладных модулей обычно не требуется.

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

Пакеты фиксируют программную архитектуру и слои. Общие правила пространств имён раскрыты в статье о классификаторах и именах, а виды зависимостей — в справке об отношениях. Контракты крупных частей показывают на диаграмме компонентов, а расширения UML — в материале о профилях.