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

Техническая диаграмма классов

Техническая модель отвечает не на вопрос «какие понятия существуют в предметной области», а на вопрос «какие программные элементы реализуют нужное поведение и от чего они зависят». Поэтому OrderController, OrderRepository и PaymentGateway уместны здесь, но не в концептуальной модели заказа.

Операция задаёт доступное поведение классификатора. Её сигнатура может содержать имя, параметры, возвращаемые значения и свойства: подтвердить(код: String): Результат. Метод — реализация операции, поэтому на UML-диаграмме точнее говорить об операции.

Видимость показывает, кому доступен признак: + — общедоступный (public), - — закрытый (private), # — защищённый (protected), ~ — доступный в пакете (package). Если видимость на диаграмме не указана, это означает, что она не показана на данном уровне детализации, а не обязательно является общедоступной.

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

У свойства могут быть дополнительные характеристики. /{имя} обозначает производное значение, {readOnly} — значение только для чтения, {id} — часть идентификатора, а ordered и unique задают упорядоченность и уникальность коллекции. Важны только те характеристики, которые несут проверяемое правило:

Коллекция значений isOrdered isUnique
Мультимножество false false
Список true false
Множество false true
Упорядоченное множество true true

subsets фиксирует, что значения свойства входят в другое свойство, union — что производное свойство объединяет подмножества, а redefines — что свойство переопределяет унаследованное. Пример с допустимым и недопустимыми снимками разобран в расширенных отношениях классов.

Свойство Operation::isQuery = true обозначают {query} после сигнатуры:

+ total(): Money {query}

Такая операция не изменяет ни состояние получателя, ни состояние других элементов модели. Одного возвращаемого значения для этого недостаточно: withdraw(amount): Money может возвращать остаток и одновременно менять счёт, поэтому не является запросом. {query} также не задаёт скорость выполнения, кэширование или возможность безопасно использовать любой внешний API.

Свойство BehavioralFeature::concurrency уточняет перекрывающиеся вызовы на одном экземпляре:

Значение Кто обеспечивает согласование
sequential механизм управления конкуренцией не задан; вызывающие стороны должны согласовать обращения, чтобы не допустить конфликтующих одновременных вызовов
guarded перекрывающиеся обращения допустимы, но выполняется одно, а остальные блокируются до его завершения
concurrent несколько обращений могут выполняться одновременно

sequential — значение по умолчанию, а не обещание автоматической очереди или блокировки. guarded не определяет порядок ожидающих вызовов и не исключает взаимоблокировки. concurrent разрешает перекрытие, но не доказывает корректность работы с общими данными. Эти значения проверяют в свойствах операции редактора; не подменяйте их оператором par на диаграмме последовательности.

У активного класса Class::isActive = true. Его экземпляр при создании начинает выполнять собственное classifierBehavior: например, обработчик ожидает сигналы и выполняет задания. Пассивный объект выполняет поведение в контексте обращающегося к нему объекта.

Пассивный калькулятор показан обычным прямоугольником; активный обработчик — прямоугольником с дополнительными вертикальными линиями.

Активность обозначают дополнительной вертикальной линией у каждой боковой стороны прямоугольника. Это свойство классификатора, а не произвольный стереотип «active». Оно не требует отдельного процесса или потока ОС: отображение модели на среду выполнения является проектным решением.

Связь с поведением важна для асинхронных контрактов: в UML 2.5.1 класс, владеющий приёмами сигналов (Reception) или classifierBehavior, должен быть активным. Интерфейс может объявлять приёмы как часть контракта. Сигнал, переход по событию и реализация реакции при этом остаются разными элементами; подробнее — в справке о поведении.

Интерфейс, перечисление и тип данных — самостоятельные виды классификаторов. Стандартный профиль UML также определяет стереотипы, которые иногда встречаются на технических диаграммах: «utility» для класса-службы со статическими признаками, «auxiliary» для вспомогательного класса, «focus» для центрального класса предметной логики и «metaclass» для класса, экземплярами которого выступают классы. Эти обозначения используют, когда они добавляют смысл, а не ради маркировки каждого класса.

Интерфейс задаёт контракт. Реализация связывает класс с интерфейсом, который он выполняет; зависимость (Dependency) или «use» показывает, что другой класс зависит от контракта. Это позволяет показать, например, что NotificationService использует NotificationGateway, не зная конкретного провайдера.

Интерфейс или активный класс может объявлять приём (Reception): готовность обработать определённый сигнал. В секции приёмов его записывают подобно операции с ключевым словом «signal»; параметры соответствуют атрибутам сигнала. Приём фиксирует асинхронный контракт, но не раскрывает реализацию реакции.

Реализация интерфейса

Нотация «шарик и розетка» (lollipop) показывает предоставляемый интерфейс кружком, а требуемый — полукругом. Она особенно полезна на диаграммах компонентов, где важен внешний контракт, а не полный список операций.

Зависимость (Dependency) показывает, что изменение поставщика может повлиять на клиента: например, тип параметра операции или используемый интерфейс. Стрелка направлена от зависимого элемента к поставщику. Не стоит заменять зависимость ассоциацией только потому, что оба элемента «связаны» в коде.

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

Шаблонный класс или операция принимает параметры типа; связывание шаблона (TemplateBinding) с «bind» показывает подстановку конкретных параметров. Вложенный класс используют только когда вложенность действительно является частью публичной структуры реализации.

Шаблонный класс и связывание

Рисунки и проверку кратностей для этих случаев см. в расширенных отношениях классов.

Квалификатор уточняет, как найти объект на конце ассоциации по ключу: например, Каталог находит Товар по артикулу. N-арная ассоциация связывает более двух классификаторов одновременно. Оба средства нужны редко; если связь имеет собственные свойства и жизненный цикл, чаще понятнее выделить отдельный класс.

Свойства ассоциации могут иметь упорядоченность, уникальность, значение только для чтения, включение в другое свойство или переопределение; в UML для этого служат ordered, unique, readOnly, subsets и redefines. Их добавляют только когда это формальное свойство значимо для решения. Полный набор редких свойств не делает техническую диаграмму точнее сам по себе.

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

BookingControllercreate(command: CreateBooking): BookingResultBookingServicecreate(command: CreateBooking): BookingResultSchedulePortreserve(slotId: String): BooleanBookingRepositorysaveConfirmed(command: CreateBooking): BookingResultNotificationPortenqueue(result: BookingResult)ScheduleServiceSqlBookingRepositoryOutboxNotificationAdapter«dataType»CreateBookingstudentId: StringslotId: Stringquestion: String [0..1]«dataType»BookingResultbookingId: Stringstatus: BookingStatusBookingStatusCreatedConfirmedCompletedCancelledиспользуетиспользуетиспользует

Created, Confirmed, Completed, Cancelled соответствуют состояниям Создана, Подтверждена, Завершена, Отменена. reserve атомарно проверяет доступность и резервирует интервал: два конкурентных запроса не должны оба получить успех. В этой реализации резервирование, saveConfirmed и запись уведомления в outbox через enqueue выполняются в одной транзакции общей БД. Ошибка откатывает все три изменения; внешний сервис доставки в транзакцию не входит.

Outbox — сохранённое задание для фонового обработчика, а не уже доставленное уведомление. Эти же операции показаны в успешном взаимодействии, а классы свёрнуты в логические части на диаграмме компонентов.

Точная семантика свойств операций и конкурентных вызовов приведена в разделах 9.4 и 9.6, активных классов — в 11.4 UML 2.5.1.

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

Представление кода C4 может вести к этой диаграмме как к детализации одного важного компонента; оно не требует строить полную схему классов всей системы.