Диаграмма внутренней структуры
Предположим, на диаграмме компонентов есть 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: Channelq: ~Channel| Порт | Предоставляет | Требует |
|---|---|---|
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 на уровне типов ролей: она описывает состав для одного экземпляра сервиса, но не является снимком конкретных именованных объектов. Прямоугольники внутри — типизированные роли с кратностями; квадратные порты и соединители показывают путь взаимодействия. Это учебная структура сервиса заказов, отдельная от технической модели консультаций.
| Порт | Контракт |
|---|---|
внешний 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.
К внутренней структуре переходят от диаграммы компонентов, когда внешнего контракта уже недостаточно для объяснения решения. Общая семантика свойств, типов и кратностей разобрана в статье о типах и значениях, кооперация как классификатор — в справке о классификаторах. Физическое размещение частей остаётся на диаграмме развёртывания.