2. Документирование объектных разработок в среде Delphi

Документация простейших объектных разработок в среде Delphi должна включать:

• эскизы форм приложения с указанием типов визуальных интерфейсных компонентов;

• диаграммы состояний интерфейса в целом;

• диаграмму объектов приложения;

• диаграмму состояний каждой формы;

• диаграмму классов для каждой формы;

• диаграмму классов предметной области программы;

• диаграмма последовательностей действий для каждой функции, доступной пользователю.

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

Пример 1. В качестве примера рассмотрим описание разработки приложения «Записная книжка в среде». Приложение должно обеспечивать ввод имени, фамилии и телефона, а также поиск абонента по имени и/или фамилии.

Эскиз главной формы приложения приведен на рисунке 1.

Рисунке 1 - Внешний вид главного окна приложения

При нажатии кнопок приложение должно переходить в режимы добавления записей и поиска телефонов (см. рисунок 2)

Рисунок 2 - Диаграмма состояний интерфейса приложения

Если каждый режим реализован на своей форме, то получаем диаграмму объектов интерфейса, представленную на рисунке 3. (Если файл записей реализовывать как объект, то объектная декомпозиция будет включать объект Файл).

Рисунке 3 - Объектная декомпозиция приложения

1. Проектирование объекта Главная форма

Проектирование объекта Главная форма включает уточнение внешнего вида с указанием компонентов экранной формы (см. рисунок 4).

Рисунок 4 - Экранная форма Главное меню

Для объекта формы прорабатываем диаграмму состояний и привязываем изменение состояния к событиям Delphi (рисунок 5).

Рисунок 5 - Диаграмма состояний интерфейса формы Главное меню

Далее проектируем диаграмму классов формы (рисунок 6).

Рисунок 6 - Диаграмма классов для TMainForm

2. Проектирование вспомогательных форм

Проектирование вспомогательных форм выполняем аналогично. Так проектирование формы Поиск записей показано на рисунках 7–9.

Рисунок 7 - Экранная форма Поиск записей

Рисунок 8 - Диаграмма состояний формы Поиск записей

Рисунок 9 - Диаграмма класса TFindForm

Взаимодействие между объектами приложения покажем с помощью диаграммы последовательностей действий (см. рисунок 10).

Рисунок 10 - Диаграммы последовательностей действий при выполнении функций:

а – создать/открыть книжку; б – записать телефон; в – найти телефон

Для метода, обрабатывающего событие FindButtonClick(), приведем диаграмму деятельности с уточнением ответственности объектов (см. рисунок 11, а) и схему алгоритма (см. рисунок 11, б). Сравнение показывает очевидное сходство этих схем, хотя, как уже упоминалось ранее, диаграмма деятельностей более информативна. В качестве упражнения сравните эту диаграмму также с диаграммой состояний формы FindForm (см. рисунок 8) и диаграммой последовательностей действий для функции Найти (см. рисунок 10, в). Хорошо видно, что данные диаграммы уточняют друг друга.

Рисунок 11. Диаграмма активностей (а) и схема алгоритма (б) метода FindButtonClick()