Соединение с сервером баз данных

Для создания соединения с сервером в рамках технологии dbExpress приложение должно использовать компонент TSQLConnection. Это обязательный компонент, все остальные компоненты связаны с ним и используют его для получения данных.

После переноса этого компонента в модуль данных или на форму необходимо выбрать тип сервера и настроить параметры соединения.

Свойство

property ConnectionName: string;

позволяет выбрать из выпадающего списка конкретное настроенное соединение. По умолчанию разработчику доступно по одному настроенному соединению для каждого сервера БД. После выбора соединения автоматически устанавливаются значения свойств:

определяет используемый драйвер; 

задает динамическую библиотеку драйвера dbExpress;

определяет динамическую библиотеку клиентского ПО сервера (табл. 17.1); 

список этого свойства содержит настройки для выбранного соединения.

При необходимости все перечисленные свойства можно установить дополнительно.

Разработчик может дополнять и изменять список настроенных соединений. Для этого используется специализированный Редактор соединений dbExpress Connections (рис. 17.1). Он открывается после двойного щелчка на компоненте TSQLConnection или выбора команды Edit Connection Properties из всплывающего меню компонента.

Рис. 17.1. Окно редактора настроенных соединений компонента TSQLConnection

В списке слева располагаются существующие соединения. В правой части для выбранного соединения отображаются текущие настройки. При помощи кнопок на Панели инструментов можно создавать, переименовывать и удалять соединения. Настройки также можно редактировать.

Список соединений в левой части соответствует списку выбора свойства ConnectionName в Инспекторе объектов. Настройки соединения из правой части отображаютсяв свойствее Params.

Настроенные соединения и их параметры сохраняются в файле \Borland Shared\DBExpress\dbxconnections.ini.

Примечание

При установке Delphi 7 поверх Delphi 6 сведения о соединениях из старого файла dbxconnections.ini добавляются в новый.

Конкретные значения настроек соединений зависят от используемого сервера БД и требований приложения (табл. 17.2).

Таблица 17.2. Настройка соединения dbExpress

Параметр

Значение

Общие настройки

BlobSize

Задает ограничение на объем пакета данных для данных BLOB

DriverName

Имя драйвера

ErrorResourceFile

Файл сообщений об ошибках

LocaleCode

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

User Name

Имя пользователя

Password

Пароль

DB2

Database

Имя клиентского ядра

DB2 Translsolation

Уровень изоляции транзакций

Informix

HostName

Имя компьютера, на котором работает сервер Informix

Informix Translsolation

Уровень изоляции транзакции

Trim Char

Определяет, нужно ли удалять из строковых значений полей пробелы, дополняющие значение до полной строки, заданной размером поля данных

Interbase

CommitRetain

Задает поведение курсора по завершении транзакции. При значении True курсор обновляется, иначе — удаляется

Database

Имя файла базы данных (файл GDB)

InterBase Translsolation

Уровень изоляции транзакции

RoleName

Роль пользователя

SQLDialect

Используемый диалект SQL. Для IntreBase 5 возможно только одно значение -1

Trim Char

Определяет, нужно ли удалять из строковых значений полей пробелы, дополняющие значение до полной строки, заданной размером поля данных

WaitOnLocks

Разрешение на ожидание занятых ресурсов

Microsoft SQL Server 2000

Database

Имя базы данных

HostName

Имя компьютера, на котором работает сервер MS SQL Server 2000

MSSQL Translsolation

Уровень изоляции транзакции

OS Autenification

Использование учетной записи текущего пользователя операционной системы (домена или Active Directory) при доступе к ресурсам сервера

MySQL

Database

Имя базы данных

HostName

Имя компьютера, на котором работает сервер MySQL

Oracle

AutoCommit

Флаг завершения транзакции. Устанавливается только сервером

BlockingMode

Задает режим завершения запроса. При значении True соединение дожидается окончания запроса (синхронный режим), иначе — начинает выполнение следующего (асинхронный режим)

Database

Запись базы данных в файле TNSNames.ora

Multiple Transaction

Поддержка управлением несколькими транзакциями в одной сессии

Oracle Translsolation

Уровень изоляции транзакций

OS Autenification

Использование учетной записи текущего пользователя операционной системы (домена или Active Directory) при доступе к ресурсам сервера

Trim Char

Определяет, нужно ли удалять из строковых значений полей пробелы, дополняющие значение до полной  строки, заданной размером поля данных

После выыбора настроенного соединения или выбора типа сервера и настройки параметров соединения компонент TSQLConnection готов к работе.

Свойство

property Connected: Boolean;

открывает соединение с сервером при значении True. Аналогичную операцию выполняет метод

procedure Open;

После открытия соединения все компоненты dbExpress, инкапсулирующие наборы данных и связанные с открытым компонентом TSQLConnection, получают доступ к базе данных.

Соединение закрывается тем же свойством connected или методом

procedure Close;

При открытии и закрытии соединения разработчик может использовать обработчики событий

property BeforeConnect: TNotifyEvent; 

property AfterConnect: TNotifyEvent;

property BeforeDisconnect: TNotifyEvent; 

property AfterDisconnect: TNotifyEvent;

Например, на стороне клиента можно организовать проверку пользователя приложения:

procedure TForml.MyConnectionBeforeConnect(Sender: TObject);

begin

if MyConnection.Params.Values['User_Name']) <> DefaultUser then

begin

MessageDlg('Wrong user name', mtError, [mbOK], 0);

Abort; 

end; 

end;

Свойство

property LoginPrompt: Boolean;

определяет, нужно ли отображать диалог авторизации пользователя перед открытием соединения.

О текущем состоянии соединения можно судить по значению свойства

TConnectionState = (csStateClosed, csStateOpen, csStateConnecting, csStateExecuting, csStateFetching, csStateDisconnecting);

 property ConnectionState: TConnectionState;

Параметры соединения можно настраивать на этапе разработки в Инспекторе объектов или Редакторе соединений (см. рис. 17.1). Также это можно сделать и непосредственно перед открытием соединения, используя свойство Params или метод

 procedure LoadParamsFromlniFile(AFileName : String = '');

который загружает заранее подготовленные параметры из INI-файла. Проверить успешность этой операции можно при помощи свойства

property Params Loaded: Boolean;

значение True которого сигнализирует об успехе загрузки.

procedure TForml.StartBtnClickfSender: TObject);

 begin

if MyConnection.Params.Values['DriverName'] = " then

MyConnection.LoadParamsFromlniFile

('c:\Temp\dbxalarmconnections.ini');

if MyConnection.ParamsLoaded then

try MyConnection.Open;

except MessageDlgt'Database connection error', mtError, [mbOK], 0);

end; 

end;