Подробности об интерфейсах

Данные требования определяют совокупность подробностей о ИФБО, которые должны быть предоставлены. В целях этих требований интерфейсы определяются (на различных уровнях детализации) в терминах их назначения, способа использования, параметров, описания параметров и сообщений об ошибках.

Назначение интерфейса представляет собой высоко уровневое описание основной цели интерфейса (например, команды графического интерфейса пользователя – GUI, прием сетевых пакетов, обеспечение выходных данных принтера и т.п.).

Способ использования интерфейса содержит описание того, как предполагается использовать интерфейс. Такое описание следует строить вокруг различных взаимодействий, доступных на этом интерфейсе. Например, если интерфейсом являются команды командной оболочки (shell) ОС Unix, тогда взаимодействиями для этого интерфейса будут команды ls, mv и cp. Для каждого взаимодействия в способе использования интерфейса указывается, что делает взаимодействие, как для режима работы видимым на интерфейсе (например, программист вызывающий интерфейс прикладных программ – API, пользователи в ОС семейства Windows, изменяющие параметры реестра и т.п), так и для режима работы на других интерфейсах (например, генерация записи аудита).

Параметры являются явными входными и выходными данными интерфейса, которые управляют режимом его работы. Например, параметрами являются аргументы, передаваемые на интерфейс прикладных программ – API; различные поля пакета данных для данного сетевого протокола; индивидуальные значения ключей реестра ОС семейства Windows; сигналы на множестве контактов микросхемы; параметры, которые могут быть заданы для команды ls и т.д. Параметры «определяются» простым списком того, чем они являются.

В описании параметра излагается в некоторой осмысленной форме, чем является параметр. Например, приемлемым описанием параметра для интерфейса foo(i) было бы следующим «параметр i является целым числом, указывающим число пользователей, вошедших в систему в данный момент». Описание типа «параметр i является целым числом» не приемлемо.

Описание действий интерфейса излагается, что интерфейс делает. Оно более подробно, чем описание назначения интерфейса в том, что «назначение» показывает, почему кто-то может захотеть его использовать, а «действия» показывают все, что он может делать. Эти действия могут относиться к ФТБ или нет. В случае, если действие интерфейса не относится к ФТБ, в его описании указывается «необходимо резюме», подразумевая, что описание только поясняет, что это действие на самом деле не относится к ФТБ.

Описание сообщений об ошибках определяет условия их генерации, что представляет собой сообщение и значение любых кодов ошибок. Сообщение об ошибке генерируется ФБО чтобы известить об обнаруженной в некоторой степени проблеме или неправильности. Требования этого семейства относятся к различным видам сообщений об ошибках:

· «явное» сообщение об ошибке является относящейся к безопасности реакции с помощью вызова специального ИФБО.

· «косвенная» ошибка не может быть связана с вызовом ИФБО, поскольку она возникает из общесистемных условий (например, исчерпание ресурсов, прерываний связи и т.д.). Сообщения об ошибках, которые не относятся к безопасности, также относятся к «косвенным».

· «остальные» ошибки – любые другие ошибки такие как те, которые могут возникать в программе. Например, использование фрагмента кода проверки условий, который проверяет условия, которые логически не возникают (например, конечный оператор «else» после списка операторов «case») вызовет генерацию сообщения об ошибке из функции «ловушки» всех (catch-all) ошибок; в функционирующем ОО такие сообщения об ошибках никогда не должны появляться.

Пример функциональной спецификации представлен в Приложении A.2.3.

Дата добавления: 2014-01-15