Разработка процедур
ABL-процедуры – это содержащие ABL-операторы блоки кода. Структура процедуры может быть простой с единственным блоком кода, или может содержать несколько блоков, которые могут быть вложенными. Процедура также может иметь входящие и исходящие параметры.
В приложениях, использующих OERA-архитектуру, процедуры полезны для создания сервисных интерфейсов для бизнес-сущностей (Business Entity). Кроме того, они могут использоваться для тестирования различных частей вашего приложения.
Имя файла процедуры состоит из имени файла и расширения “.p”. Вы можете создать этот файл в любом редакторе, но поскольку в этом пособии мы также изучаем Developer Studio for OpenEdge, посмотрим, как создать его в этой среде разработки.
Для создания файлы процедуры в Developer Studio следуйте инструкции:
- В первую очередь, необходимо определить, в каком каталоге проекта вы собираетесь создать файл. Обычно, это каталог с именем src. Щёлкните правой кнопкой мыши на выбранном каталоге. В открывшемся контекстном меню выберите File -> ABL Procedure.
Откроется мастер New ABL Procedure. - В поле File name введите имя файла процедуры. Имя файла должно заканчиваться расширением “.p”. Имя файла процедура не должно содержать пробелы.
- Вы также можете ввести необязательную информацию в полях Description, Purpose и Author.
- В качестве лучшей практике, оставьте установленным флаг Error-handling statement, и выбранным Block level – этого достаточно для большинства приложения.
- Щёлкните по кнопке Finish. Файл новой ABL-процедуры будет открыт в редакторе Developer Studio. Теперь можно добавить в него ABL-код.
Обратите внимание, мастер New ABL Procedure не просто создаёт новый файл ABL-процедуры, он также генерирует в нём некоторое содержимое – рассмотрим его назначение.
Мастер добавляет в начало файла в виде комментария поля, которые могут быть использованы вами для описания процедуры: имя файла, назначение процедуры, имя автора, время создания и прочее. Вы можете добавить сюда любую иную информацию, например, время последнего изменения и описание этого изменения. Эта информация позволит вам или другим разработчикам в будущем быстрее понять назначение процедуры.
Единственным ABL-оператором, добавленным мастером по мимо комментариев, является оператор обработки ошибок, который помещён в секцию Definitions. Этот оператор должен быть первым оператором ABL-процедуры. Весь текст оператора обработки ошибок подсвечен тёмно-бордовым цветом, поскольку он полностью состоит из ключевых слов ABL. Заканчивается оператор точкой.
Секция Definitions предназначена для описания параметров и переменных процедуры. Параметры – это данные, которые могут передаваться в процедуру или из неё во время выполнения. Переменные – содержат данные, которые используются процедурой.
Секция Preprocessor Definitions используется для определения как ABL-код будет компилироваться. В этом пособии мы не будем рассматривать как это работает. Используйте документацию к OpenEdge для получения дополнительной информации.
Секция Main Block предназначена для реализации функций процедуры.