Стандартная структура приложения
На рисунке показана стандартная структура приложения, написанного с использованием LinAPI.
Рисунок. Стандартная структура LinAPI-приложения
Рассмотрим эту структуру.
Для выполнения какого-либо запроса необходимо создать соединение и открыть курсор. Если запрос будет выполняться несколько раз или имеет параметры, то необходимо создать оператор. В случае наличия параметров производится их привязка.
Затем выполняется оператор. Если запрос был SELECT-запросом, то для получения ответа привязываются буфера полей ответа, в которые будет выводиться ответ при перемещении по выборке.
Оператор выполняется необходимое количество раз.
Если запрос не имеет параметров либо должен выполняться только один раз, то создавать оператор не имеет смысла. Запрос выполняется непосредственно функцией LINTER_ExecuteDirect
. Если это SELECT-запрос, то для получения ответа можно произвести действия, аналогичные действиям при работе с оператором.
Перед завершением работы приложения необходимо закрыть все курсоры, соединения, освободить операторы и функцией LINTER_CloseAPI
освободить все задействованные ресурсы.
Следует отметить, что приведенная последовательность действий не является единственно правильной. Так, например, регистрация буферов полей ответа может предшествовать выполнению оператора, и буфера для получения ответа регистрировать не обязательно, ответ можно получить еще двумя способами, в зависимости от специфики приложения.