MySQL АРI.

Может пригодиться:

Реклама:

Pазличные прикладные программные интерфейсы позволяют использовать базы данных MySQL в программах, написанных на разных языках. Даже если API не предусмотрен для конкретного языка, можно организовать взаимодействие c сервером MySQL средствами ODBC (Open Database Connectivity). B данной главе будут рассмотрены простые примеры работы c базами данных: установка соединения, выполнение запросов и получение результатов посредством наиболее распространенных API.



АРI для языка C

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

Для использования C API надо связать программу с библиотекой 1ibmysq1 с1iеnt.so, которая автоматически инсталлируется при компиляции MySQL. Двоичные же файлы, используемые для установки MySQL, делятся на несколько компонентов. Пакет, содержащий библиотеки и файлы заголовков для конкретной платформы, называется MySQL-devel-*.

Программа на языке C, работающая c MySQL API, должна использовать файл mysgl . h, который располагается в системном каталоге включаемых файлов, принимаемом по умолчанию. Соответствующая директива #include имеет следующий вид:

#include mysgl/mysgl.h

Связывание с 1ibmysq1 с1iеnt.so происходит поразному в зависимости от компилятора. Следующий пример демонстрирует компиляцию файла mytest.c, использующего MySQL API, c помощью компилятора gcc:

shell> gcc -o mytest mytest.c -lmysglclient

Если в процессе компиляции генерируются сообщения oб ошибке, вы можете c помощью утилиты mysgl_config выяснить, какие опции требуются компилятору. Опции --cflags, --include и --libs указывают на необходимость отображения флагов и определений компиляторов, a также инфор­мации o включаемых файлах и библиотеках.

shell> mysgl config --cflags --include --libs
-I/usr/include/mysgl -mсрu=1486
-fno-strength-reduce
-I/usr/inсludе/mysgl
-L/usr/1ib/mysgl -lmysglclient -lcrypt
-1nsl -1m -1z -1с -lnss_files
-1nss dns -lresoly -1с -1nss_files -1nss_dns
-lresolv



Соединение c базой данных MySQL

MYSQL mysgl;
mysgl_init(&mysgl);
mysgl_real_connect(&mysgl, "узел",
"пользователь", "пароль", "имя_базы",
порт, сокет, клиентский флаг);

Для установления соединения c базой данных MySQL необходимо вызвать две функции. Сначала нaдо инициализировать объект типа MYSQL, a затем использовать этот объект как параметр при вызове функции mysgl_real_connect () . Данный объект также применяется в последующих обращениях к API как параметр, определяющий ресурс, в частности, указывающий на соединение c базой данных.

Параметр порт задает порт ТСР/IP, используемый для взаимодействия c базой данных. При соединении c локальным узлом это значение должно быть установлено равным нулю. Значение параметра сокет должен быть равным NULL. Значения, отличные от NULL, используются только в том случае, когда следует специaльно определить сокет или именованный канaл для использования в рамках соединения.

Значение параметра клиентский_флаг также должно оставаться равным NULL. Он принимает другое значение, только если необходимо использовать специальные средства библиотеки клиента MySQL, которые в данной главе рассматриваться не будут.

Если соединение установлено успешно, значение, возвращаемое функцией mуsgl_rеаl_ соnnесt (), представляет собой объект МУSQL. Значение этого объекта совпадает со значением, передаваемым функции в качестве первого параметра, поэтому присваивать его переменной не нужно. Если по какимто причинам соединение не может быть установлено, функция возвращает значение NULL.






Пер. с англ. - М.: ООО "И.Д.Вильямс", 2006.

Спонсор сайта:

Реклама: