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

Диаграмма внутренней структуры

Предположим, на диаграмме компонентов есть OrderService с внешним контрактом OrderApi. Пока достаточно знать ответственность сервиса, его внутренности скрыты. Если нужно объяснить, как запрос проходит через проверку заказа, резервирование и сохранение, OrderService раскрывают как структурированный классификатор.

Структурированный классификатор может содержать роли и соединители между ними. Его специализация — инкапсулированный классификатор — дополнительно владеет портами на своей границе. Компонент является инкапсулированным классификатором, поэтому OrderService можно показать с внутренними ролями и внешними точками взаимодействия.

Добавим роль validator: OrderValidator. Эта запись не просто сообщает о существовании класса OrderValidator: она утверждает, что его экземпляр участвует внутри конкретного OrderService.

Роль может быть частью или ссылочным свойством. Часть имеет композитную агрегацию, поэтому экземпляр целого владеет экземплярами этой роли. Так processor: OrderProcessor может принадлежать сервису и разделять его жизненный цикл. Ссылочная роль указывает на экземпляр, которым сервис не владеет; например, общий catalog: ProductCatalog остаётся внешней зависимостью, даже если участвует во внутреннем взаимодействии.

Тип роли определяет допустимые экземпляры, кратность — их число в одной структуре:

validator: OrderValidator[1]
workers: ReservationWorker[1..*]
catalog: ProductCatalog[1]

Такой фрагмент описывает состав одного экземпляра OrderService, а не количество классов в модели.

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

Например, порт orders предоставляет OrderApi, а порт notifications требует NotificationGateway. Первый принимает запрос клиента, второй фиксирует внешний контракт, без которого сервис не сможет завершить обработку.

Порт с интерфейсами

Порт не является декоративным квадратом. Если интерфейс не относится к контракту этой точки, его нельзя сделать частью порта только ради удобного расположения линии.

Порт имеет тип и кратность как другие свойства. Запись p: Channel[1] задаёт одну точку взаимодействия типа Channel для каждого экземпляра владельца. Предоставляемые и требуемые интерфейсы определяются через тип порта и его обобщения.

Например, тип Channel реализует интерфейс Request и использует Reply. Обычный порт этого типа предоставляет Request и требует Reply. У сопряжённого порта (isConjugated = true) эти наборы меняются местами; перед именем типа ставят ~:

p: Channel
q: ~Channel

Обычный порт p предоставляет Request и требует Reply; сопряжённый q требует Request и предоставляет Reply. Ниже поведенческий порт связан с символом поведения своего владельца.

Порт Предоставляет Требует
p: Channel Request Reply
q: ~Channel Reply Request

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

Поведенческий порт, сервисный порт и протокол

Заголовок раздела «Поведенческий порт, сервисный порт и протокол»

Поведенческий порт (isBehavior = true) передаёт обращения поведению самого владельца, а не делегирует их внутренним частям. На схеме порт соединяют линией с маленьким символом состояния внутри владельца; этот символ обозначает его поведение. Он не означает отдельную внутреннюю часть. Если у владельца нет поведения, обращения, поступившие через такой порт, теряются по семантике UML.

isService = true означает, что порт относится к публикуемой функциональности владельца. При false он служит реализации и не входит в её существенный внешний контракт. Это свойство не назначает сетевую доступность или права доступа: такие решения требуют отдельных требований.

Интерфейсы перечисляют доступные операции и приёмы, а протокол порта (Port::protocol) ссылается на протокольный автомат и ограничивает допустимые последовательности обращений. Например, open → send* → close требует сначала открыть канал, допускает повторные отправки, а после закрытия запрещает следующую отправку без нового открытия.

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

Теперь запрос нужно провести от внешнего порта orders к внутреннему processor. Делегирующий соединитель (delegation connector) передаёт взаимодействие через границу классификатора внутренней роли или обратно. Ответственность перед внешним клиентом при этом остаётся у OrderService.

Когда processor требует интерфейс, который предоставляет validator или другая внутренняя часть, их связывает сборочный соединитель (assembly connector). Он собирает совместимые требуемый и предоставляемый контракты.

Делегирующий соединитель

Сборочный соединитель

У соединителя два или больше концов (ConnectorEnd). Каждый конец указывает на роль или порт. Если используется порт внутренней части, конец должен одновременно определить эту часть и принадлежащий ей порт: совпадения подписи недостаточно.

Соединитель можно типизировать ассоциацией. Тогда его роли должны быть совместимы с типами и кратностями концов ассоциации. Нетипизированный соединитель всё равно утверждает возможность взаимодействия, но не создаёт отсутствующий интерфейс и не исправляет несовместимые направления контрактов.

В результате модель читается последовательно: внешний клиент обращается к порту orders, делегирование передаёт запрос processor, сборка связывает его с validator, а требуемый порт notifications выводит обращение к внешнему шлюзу.

Следующая схема раскрывает внутреннюю структуру OrderService на уровне типов ролей: она описывает состав для одного экземпляра сервиса, но не является снимком конкретных именованных объектов. Прямоугольники внутри — типизированные роли с кратностями; квадратные порты и соединители показывают путь взаимодействия. Это учебная структура сервиса заказов, отдельная от технической модели консультаций.

OrderServiceprocessor : OrderProcessor [1]validator : OrderValidator [1]ordersnotificationsapivalidationvalidationКлиентВнешний шлюз уведомленийOrderApiделегированиесборка / IValidationделегированиеNotificationGateway
Порт Контракт
внешний orders, внутренний processor.api предоставляют OrderApi; соединены делегированием
processor.validation требует IValidation
validator.validation предоставляет IValidation; совместим с требуемым контрактом обработчика
роль processor, внешний порт notifications требуют NotificationGateway; делегирование выводит потребность роли через границу

Запрос проходит Клиент → orders → processor.api. Обработчик проверяет заказ через сборочный соединитель к валидатору, а уведомление направляет через внешний порт notifications к шлюзу. Делегирование может соединять внешний порт непосредственно с внутренней ролью: дополнительный порт на части не обязателен, если её тип уже задаёт требуемый контракт. Линии соединителей сами по себе не задают временного порядка сообщений: его нужно уточнить взаимодействием.

processor и validator здесь являются частями с композитным владением. Шлюз расположен снаружи: он не становится частью сервиса из-за наличия соединителя. В редакторе задавайте роли, порты, типы и виды соединителей свойствами модели; текстовые подписи на рисунке лишь помогают их прочитать.

Повторно использовать структуру взаимодействия

Заголовок раздела «Повторно использовать структуру взаимодействия»

Если сочетание ролей «обработчик — проверяющий — хранилище» повторяется в разных компонентах, его можно описать кооперацией (Collaboration). Кооперация задаёт формальные роли и соединители, необходимые для общего поведения, но не назначает им конкретные классы.

Использование кооперации (CollaborationUse) применяет этот шаблон внутри OrderService. Связывания ролей сопоставляют формальный validator с orderValidator, а формальный store — с orderRepository. Так повторно используется структура сотрудничества, а не набор конкретных реализаций.

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

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

Нотация и семантика типов, сопряжения, поведения и протоколов портов определены в разделе 11.3 UML 2.5.1.

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