MySQL: Руководство разработчика. Версия 1.0. 20 апреля 2004 г.

2004 г

MySQL: Руководство разработчика. Версия 1.0. 20 апреля 2004 г.

Алексей Паутов,
Все о MySQL на русском: http://www.botik.ru/~rldp/mysql.htm, ftp://ftp.botik.ru/rented/rldp/www/pub
Russian LDP: http://www.botik.ru/~rldp, ftp://ftp.botik.ru/rented/rldp

содержание

Глава 3. C++ API

Mysql++ представляет собой полноценный C++ API для Mysql (а в скором времени и для других баз данных на SQL также). Цель этого API: сделать работу с запросами столь же простой, как работа с другими STL Контейнерами

3.1.2 Получение Mysql++

Последняя версия Mysql++ лежит на web-сайте mysql++ по адресу http://www.mysql.com/download_mysql++.html

3.1.3 Список рассылки Mysql++

Инструкции по присоединению к списку рассылки (и архив списка рассылки) могут быть найдены на домашней страничке Mysql++ по адресу http://www.mysql.com/download_mysql++.html. Если Вы желаете только задать вопрос, можете писать на mysql-plusplus@lists.mysql.com.

3.2. Обзор

Mysql++ API очень сложен и обладает большой мощностью. В этом разделе обеспечивается краткий обзор многих различных компонентов этой библиотеки.

Подобно работе с большинством других SQL API, процесс выполнения запросов тот же самый: 1) Вы открываете подключение, 2) Вы формируете и выполняете запросы, 3) Вы выполняете итерации через набор результатов. Однако имеется много дополнительных функциональных возможностей.

Основной дескриптор базы данных

Это тот класс, который обрабатывает подключение к серверу Mysql. Вы всегда нуждаетесь по крайней мере в одном из этих объектов, чтобы делать что-нибудь с сервером. Этот класс может создать отдельный объект запросов или непосредственно выполнять запросы. Отдельный объект запроса является рекомендуемым путем, поскольку это дает Вам гораздо больше мощности.

Объект запроса

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

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

Вы можете также использовать специализированные структуры и даже динамические (на сайте разработчиков они почему-то названы драматическими) наборы результатов, чтобы упростить создание и обработку запросов.

Объект Query возвращает объект с информацией относительно успеха запроса для запросов не-select (запросы, которые не возвращают набор результатов).

Наборы результатов

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

Динамический набор результатов

Динамический набор результатов представляет собой такой набор результатов, в котором имена столбцов и тип информации столбцов не должны быть определены во времени компиляции. Набор результатов может быть полностью постоянным, в нем жанные будут возвращены Вам в классе constant string link class, частично постоянным, тогда Вы можете изменять данные по одной строке за раз, или полностью переменным, в этом случае Вы можете менять данные как угодно.

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

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

Частично постоянный набор результатов почти то же самое, что и постоянный набор результатов. Единственное различие в том, что когда Вы запрашиваете строку из результата, Вы можете объявить ее изменяемой явно. Это означает, что Вы можете получать некоторые строки как постоянные, а другие как изменчивые.

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

Строки во всех динамических наборах результатов очень близки к контейнеру произвольного доступа из Standard Template Library (STL). Это означает, что они имеют iterator, который может использоваться для STL-алгоритмов. Имеется несколько специализированных сервисных функций, чтобы помочь в использовании наборов результатов в STL-алгоритмах.

Столбцы во всем динамическом результате также очень близки к контейнеру произвольного доступа из STL. Однако, в дополнение к доступу к столбцам по по их индексным числам, Вы можете также обращаться к столбцам через их имена полей.

Кроме того, поскольку строки и столбцы подобны контейнерам, Вы можете также обрабатывать набор результатов как двумерный массив. Например, Вы можете получить 5-ый элемент в 3-ей строке простым запросом result[3][5]. А так как Вы можете также использовать имена полей, Вы можете написать вместо номера поля его имя, например, result[3]["price"], чтобы получить элемент "price" в 3-ей строке.

Фактические данные, возвращаемые динамическим набором результатов, сохранены в специальной строке подобно классу, которая имеет некоторые дополнительные полезные свойства. А именно: данные столбца автоматически преобразуются во все базисные типы данных, также как некоторые дополнительные типы, которые разработаны, чтобы обработать типы mysql, которые включают типы для обработки дат, времен, наборов и величин со значением null. Если имеется проблема в преобразовании, будет установлена метка предупреждения или возвращена исключительная ситуация в зависимости от того, как пакет настроен. Относительно исключительных ситуаций: MySQL++ поддерживает два различных метода рассмотрения исключительных ситуаций. Первый работает по фиксированному типу, второй (новый) представляет собой стандартный тип C++, использующий метод what(). Выбор методов должен быть выполнен при формировании библиотеки. Если скрипт выбора конфигурации выполнен с опцией -enable-exception, то новый метод будет использоваться. Если никакая опция не обеспечивается, или используется -disable-exception, всегда используется старый метод исключений MySQL++.

Динамические наборы результатов могут даже использоваться, чтобы помочь формировать запросы с помощью некоторого дополнительного метода. Имеются методы для возвратов: 1) Разделенный запятыми список данных (например: 1.5, 10, "Dog", "Brown"), 2) Разделенный запятыми список имен полей (например: age, weight, what, color), 3) Список присваиваний (например: age = 1.5 AND weight = 10 AND what = "Dog" AND color = "Brown").

Изменчивые наборы результатов могут быть созданы так, чтобы Вы могли воспользоваться преимуществом этих методов во вставке данных в базу данных без необходимости писать дополнительные запросы.

Статические наборы результатов

Результаты запроса могут также быть сохранены статически в специализированной структуре SQL. Эти структуры затем будут сохранены в некотором STL-контейнере, например, векторе или списке. В отличие от динамических наборов результатов принимается, что программист знает то, что набор результатов собирается вернуть. Из-за этого вся информация относительно столбцов, включая имена, будет потеряна.

Специализированные структуры являются термином C++ structs. Каждый элемент члена сохранен с уникальным именем внутри структуры. Вы никоим образом не можете использовать STL-алгоритмы или что-нибудь еще из STL, чтобы работать с индивидуальными элементами структур. Однако, поскольку эти структуры все равно затем будут сохранены в STL-контейнерах, Вы можете использовать STL-алгоритмы на контейнерах этих структур. Контейнеры представляют строки, а индивидуальные элементы структуры представляют столбцы. Например, Вы можете обращаться к элементу, именованному "price" в третьей строке как к result[3].price. В динамическом наборе результатов то же самое достигается записью result[3]["price"].

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

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

Динамические полностью изменчивые наборы

Этот набор результатов будет выполнен, когда курсоры на стороне сервера будут поддерживаться в MySQL. Но, основываясь на приобретенном знании и опыте при проектирования MySQL++ и MySQLGUI, была сделана предварительная версия. Этот набор результатов полностью динамический в том смысле, что весь набор результатов сохранен в динамическом контейнере C++. Этот контейнер будет только кэшировать набор результатов, и он будет иметь заданный по умолчанию размер. Этот динамический контейнер будет окном в M строк из всего набора результатов в N строк, где N ограничено сервером MySQL. Этот набор результатов будет также полностью динамическим в том смысле, что имена столбцов и тип информации столбцов не должны быть определены во время компиляции. Но все существующие функциональные возможности статических и динамических наборов будут также доступны и в этом наборе. Этот набор будет также иметь методы для модифицирования, удаления и вставки строк, а также ряд специализированных макрокоманд для конструирования классов.

Дополнение

В дополнение к материалу, упомянутому выше, хочу заметить, что есть много универсальных классов, которые могут использоваться с другими программами. Примеры этого включают специальный класс const string, адаптер произвольного доступа, который будет делать контейнер произвольного доступа из класса только с методом size() и определенным оператором subscript ([]), а также универсальный класс запроса SQL, который может использоваться любым SQL C или C++ API.

Начиная с версии 1.7, имеется новое дополнение к библиотекам. Добавилось несколько очень полезных функций для строк STL, которые могут применяться в любом приложении на C++, неважно, скомпоновано оно с MySQL++ или нет. Эти функции содержатся в исходных файлах string_util.hh и string_util.cc.

3.3. Важные изменения

3.3.1 Текущие изменения

Синтаксис списка равенства для SSQLS сменился с equal_list (cchar *, Manip, cchar *) на equal_list (cchar *, cchar *, Manip).
Начиная с версии 1.3 mysql++, больше не может компилироваться транслятором GNU версии ниже, чем 2.95. Начиная с версии 1.3, mysql++ был изменен, чтобы учесть и обработать изменения в различных аспектах C++ в версии 2.95. Собственно из-за этого-то пакет и перестал компилироваться версиями GNU 2.7.xx, 2.8.xx и более ранними. Также не поддерживается egcs 1.x.x. Хотя с некоторыми изменениями в коде mysql++ может быть откомпилирован и этими трансляторами выполнение таких программ кончится провалом.
Из-за проблем совместимости нельзя использовать g++ 2.95.3 и g++ 2.96.
Имеются отдельные версии для компиляторов Borland C++, VC++ и Compaq на Tru64.
Было также отмечено, что на некоторых инсталляциях SPARC Solaris исключительные ситуации C++ не работают с gcc 2.95.2. Этот случай был проверен и установлено, что mysql++ формируется безукоризненно на Solaris с помощью gcc version 2.95 19990728 (release).
Конструкторы ``connection'' для Connection и Connection::connect (формально известны как Mysql) переделаны так, чтобы имя базы данных было первым параметром. То же самое имеет силу для метода connect.
Все новые свойства клиентов, реализованные в 3.22.xx как различные параметры на connect, поддерживаются новым конструктором и методом real_connect.
Также поддерживаются новые параметры конфигурации в 3.23.xx.
Mysql++ теперь может компилироваться на Win32 с использованием Cygwin транслятора от Cygnus Inc.
Autoconf и Automake полностью выполнены.
Specialized SQL Structures (формально известны как Custom Mysql Structures) изменены с mysql_ на sql_.
Изменены все функции, которые возвращают ноль (false) при успехе и отличное от ноля значение (true) в противном случае, на bool. Это означает, что они теперь возвращают true при успехе и false в противном случае. Это означает, что Вы теперь должны отрицать Ваши выражения, которые проверяют вывод этих функций.
Почти все методы, которые возвращали MysqlString, теперь возвращают нормальные строки. Поскольку объекты MysqlString преобразуются в строки, нет проблем с MysqlString s = mysql.host_info.
Тип данных MysqlRow теперь возвращает MysqlString или MysqlColData. Он теперь подклассифицируется из специального строкового класса, который написан, чтобы обработать строковые константы намного более эффективным путем (то есть, это не копирует их). К сожалению, этот тип данных также более ограничен.
Добавлены все необходимые методы, имеющие отношение к административным функциям.
Mysql++ теперь цитирует и экранирует объекты автоматически, если данные столбца используются с оператором <<.
Mysql++ теперь имеет намного более безопасное выполнение INSERT, UPDATE и DELETE с новым методом exec().
Mysql++ теперь имеет лучшую конфигурацию.
Имеется новый метод выборки строк.
Mysql++ может работать и с двоичными данными.
Сделана стандартная обработка исключений для C++ с методом what().
Вся обработка преобразований 64 int в строки теперь переместились в libmysqlclient.
Программы, написанные с применением MySQL++, теперь будут автоматически читать все релевантные файлы конфигурации MySQL.

3.3.2 Что планируется сделать

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

3.4. Руководство по примерам

3.4.1 Введение

Это описание, как предполагается, дает Вам начало использования Mysql++ API. Пакет этот сложный, с большим количеством свойств, так что начните с чего-то простого.

3.4.2 Предположения

Этот учебник предполагает, что Вы знаете C++ довольно хорошо. Считается, что Вы знакомы с исключениями и Standard Template Library (STL).

3.4.3 Запуск примеров

Все коды примеров формируют полные программы. Однако, чтобы использовать их, Вы должны сначала откомпилировать их, для чего перейдите в каталог с примерами и наберите там make. Затем Вы должны установить базу данных запуском reset-db. Параметры здесь такие:

: reset-db [host [user [password]]]

Если Вы не указываете host, по умолчанию принимается localhost. Если Вы не указываете имя пользователя, по умолчанию принимается Ваше актуальное имя пользователя. Если Вы не указываете пароль, по умолчанию принимается, что Вы не нуждаетесь в нем.

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

Вы должны также выполнить программу reset-db между примерами, которые изменяют данные, чтобы все работало как надо.

3.4.4 Основы

3.4.4.1 Простой пример

Следующий пример показывает, как открыть подключение, выполнить простой запрос и отобразить результаты. Код может быть найден в файле simple1.cc, который размещен в каталоге примеров пакета.

#include <iostream>
#include <iomanip>
#include <sqlplus.hh>

int main()
{
  Connection con("mysql_cpp_data");
  // The full format for the Connection constructor is
  // Connection(cchar *db, cchar *host="", cchar *user="", 
  // cchar *passwd="")
  // You may need to specify some of them if the 
  // database is not on
  // the local machine or you database username is 
  // not the same as your
  // login name, etc..

  Query query = con.query();
  // This creates a query object that is bound to con.

  query << "select * from stock";
  // You can write to the query object 
  // like you would any other ostrem

  Result res = query.store();
  // Query::store() executes the query 
  // and returns the results

  cout << "Query: " <<query.preview() << endl;
  // Query::preview() simply returns a 
  // string with the current query
  // string in it.
  cout << "Records Found: "<< res.size() <<
       endl <<endl;
  Row row;
  cout.setf(ios::left);
  cout << setw(17) << "Item" << setw(4)
       <<"Num" << setw(7) <<"Weight"
       << setw(7) <<"Price" << "Date"
       <<endl << endl;
  Result::iterator i;
  // The Result class has a read-only 
  // Random Access Iterator
  for (i = res.begin(); i != res.end(); i++)
  {
    row = *i;
    cout << setw(17) << row[0] << setw(4)
         << row[1] << setw(7) << row["weight"]
         << setw(7) <<row[3]
         << row[4] <<endl;
  }
  return 0;
}

3.4.4.2 Немного более сложный пример

Этот пример почти подобен предыдущему, однако он использует исключительные ситуации и автоматическое свойство преобразования ColData. Файл с ним назван complic1.cc.

#include <iostream>
#include <iomanip>
#include <sqlplus.hh>

int main()
{
  try
  { // its in one big try block
    Connection con(use_exceptions);
    con.connect("mysql_cpp_data");
    // Here  we broke making the connection into two calls.
    // The first one creates the Connection object with the
    // use exceptions option turned on and the second one
    // makes the connection

    Query query = con.query();
    query << "select * from stock";
    Result res = query.store();
    cout << "Query: " <<query.preview() << endl;
    cout << "Records Found: "<< res.size() <<
         endl <<endl;
    Row row;
    cout.setf(ios::left);
    cout << setw(17) << "Item" << setw(4)
         <<"Num" << setw(7) <<"Weight"
         << setw(7) <<"Price" << "Date"
         <<endl << endl;
    Result::iterator i;
    cout.precision(3);
    for (i = res.begin(); i != res.end(); i++)
    {
      row = *i;
      cout << setw(17) <<row["item"] <<
           setw(4) <<row[1] << setw(7) <<
           (double)row[2] << setw(7) <<(double)row[3];
      Date date = row["sdate"];
      // The ColData is implicitly converted to a date here.
      cout.setf(ios::right);
      cout.fill('0');
      cout << setw(2) <<date.month << "-" <<
           setw(2) << date.day << endl;
      cout.fill(' ');
      cout.unsetf(ios::right);
    }
    return 0;
  } catch (BadQuery er)
  { // handle any connection or
    // query errors that may come up
    cerr << "Error: " <<er.error << endl;
    return -1;
  } catch (BadConversion er)
  { // handle bad conversions
    cerr << "Error: Tried to convert \"" << er.data
         << "\" to a \"" << er.type_name
         <<"\"." <<endl;
    return -1;
  }
}

Все должно быть довольно очевидно. Приведу лишь несколько примечаний относительно исключительных ситуаций:

use_exceptions

con

query

use_exceptions

не на старые

ColData будет всегда создавать исключительную ситуацию, когда сталкивается с плохим преобразованием. Плохое преобразование определено как преобразование в котором: a) Не все символы из строки читаются, и b) Символы после числа не точки (.), нули (0) или пробелы. Таким образом, когда ``1.25'' преобразован в int, исключительная ситуация будет создана, а вот при обработке ``1.00'' в int все будет в порядке, поскольку символы нуль и точка.

3.4.4.3 Получение информации о полях

Следующий пример показывает, как получить некоторую базисную информацию относительно полей, включая имя поля и тип SQL. Файл назван fieldinfo1.cc.

#include <iostream>
#include <iomanip>
#include <sqlplus.hh>

int main()
{
  try
  { // its in one big try block
    Connection con(use_exceptions);
    con.connect("mysql_cpp_data");
    Query query = con.query();
    query << "select * from stock";
    Result res = query.store();
    cout << "Query: " <<query.preview() << endl;
    cout << "Records Found: "<< res.size() <<
         endl <<endl;
    cout << "Query Info:\n";
    cout.setf(ios::left);
    for (unsigned int i = 0; i < res.size(); i++)
    {
      cout << setw(2) << i << setw(15) <<
           res.names(i).c_str() << setw(15) <<
           res.types(i).sql_name() << setw(20) <<
           res.types(i).name() << endl;
    }
    cout << endl;
    if (res.types(0) == typeid(string))
     cout << "Field 'item' is of an sql 
              type which most closely resembles a\n"
            << "the c++ string type\n";
    if (res.types(1) == typeid(short int))
     cout << "Field 'num' is of an sql type 
              which most closely resembles a\n"
            << "the c++ short int type\n";
    else if (res.types(1).base_type() == typeid(short int))
     cout << "Field 'num' base type is of 
              an sql type which most closely \n"
           << "resembles a the c++ short int type\n";
    return 0;
  } catch (BadQuery er)
  {
    cerr << "Error: " << er.error << endl;
    return -1;
  } catch (BadConversion er)
  {
    cerr << "Error: Tried to convert \"" << er.data
         << "\" to a \"" << er.type_name
         << "\"." << endl;
    return -1;
  }
}

3.4.5 Специализированные структуры SQL

3.4.5.1 Получение данных

Следующий пример показывает довольно интересное понятие, известное как Specialized SQL Structures (SSQLS). Имя файла для этого кода: custom1.cc.

#include <iostream>
#include <iomanip>
#include <vector>
#include <sqlplus.hh>
#include <custom.hh>

sql_create_5 (stock, 1, 5, string, item, int, num, double, weight,
              double, price, Date, sdate)

// this is calling a very complex macro which will create a custom
// struct "stock" which has the variables:
//   string item
//    int num
//    ...
//    Date sdate
// defined as well methods to help populate the class from a mysql row
// among other things that I'll get too in a latter example
int main ()
{
  try
  {
    Connection con (use_exceptions);
    con.connect ("mysql_cpp_data");
    Query query = con.query ();
    query << "select * from stock";
    vector < stock > res;
    query.storein (res);
    // this is storing the results into a vector of the custom struct
    // "stock" which was created my the macro above.
    cout.setf (ios::left);
    cout << setw (17) << "Item" << setw (4)
         << "Num" << setw (7) << "Weight"
         << setw (7) << "Price" << "Date"
         << endl << endl;
    cout.precision(3);
    vector <stock>::iterator i;
    for (i = res.begin (); i != res.end (); i++)
    {
      cout << setw (17) << i->item.c_str ()
           << setw (4) << i->num << setw (7)
           << i->weight << setw (7) <<
           i->price << i->sdate << endl;
    }
    return 0;
  } catch (BadQuery er)
  { // handle any connection
    // or query errors that may come up
    cerr << "Error: " << er.error << endl;
    return -1;
  } catch (BadConversion er)
  {
    // we still need to cache bad conversions incase something goes
    // wrong when the data is converted into stock
    cerr << "Error: Tried to convert \"" << er.data
         << "\" to a \"" << er.type_name
         << "\"." << endl;
    return -1;
  }
}

Как Вы можете видеть, SSQLS очень мощная штука.

3.4.5.2 Добавление данных

SSQLS может также использоваться, чтобы добавить данные в таблицу. Имя файла для этого кода: custom2.cc.

#include <iostream>
#include <vector>
#include <sqlplus.hh>
#include <custom.hh>
#include "util.hh"

sql_create_5(stock, 1, 5, string, item, int, num,
             double, weight, double, price, Date, sdate)

int main()
{
  try
  { // its in one big try block
    Connection con(use_exceptions);
    con.connect("mysql_cpp_data");
    Query query = con.query();
    stock row;
    /* row.item = "Hot Dogs";
    row.num = 100;
    row.weight = 1.5;
    row.price = 1.75;
    row.sdate = "1998-09-25"; */
    row.set("Hot Dogs", 100, 1.5, 1.75, "1998-09-25");
    // populate stock
    query.insert(row);
    // form the query to insert the row
    // the table name is the name of the struct by default
    cout << "Query : " << query.preview() << endl;
    // show the query about to be executed
    query.execute();
    // execute a query that does not return a result set
    print_stock_table(query);
    // now print the new table;
  } catch (BadQuery er)
  {
    cerr << "Error: " <<er.error << endl;
    return -1;
  } catch (BadConversion er)
  {
    cerr << "Error: Tried to convert \"" << er.data
         << "\" to a \"" << er.type_name
         << "\"." <<endl;
    return -1;
  }
}

Так как этот пример изменяет данные, Вы должны выполнить программу reset-db после работы примера.

3.4.5.3 Изменение данных

Очень просто изменять данные с помощью SSQLS. Имя файла: custom3.cc.

#include <iostream>
#include <vector>
#include <sqlplus.hh>
#include <custom.hh>
#include "util.hh"
// util.hh/cc contains the print_stock_table function

sql_create_5(stock, 1, 5, string, item, int, num,
             double, weight, double, price, Date, sdate)

int main()
{
  try { // its in one big try block
    Connection con(use_exceptions);
    con.connect("mysql_cpp_data");
    Query query = con.query();
    query << "select * from stock where item = \"Hotdogs' Buns\" ";
    Result res = query.store();
    if (res.empty())
       throw BadQuery("Hotdogs' Buns not found in table, run reset-db");
    stock row = res[0];
    stock row2 = row;
    row.item = "Hotdog Buns";   // now change item
    query.update(row2, row);
    // form the query to replace the row
    // the table name is the name of the struct by default
    cout << "Query : " << query.preview() << endl;
    // show the query about to be executed
    query.execute();
    // execute a query that does not return a result set
    print_stock_table(query);
    // now print the new table;
  } catch (BadQuery er) {
    cerr << "Error: " << er.error << endl;
    return -1;
  } catch (BadConversion er)
  {
    cerr << "Error: Tried to convert \"" << er.data
         << "\" to a \"" << er.type_name
         << "\"." << endl;
    return -1;
  }
}

Когда Вы выполняете пример, обратите внимание, что в предложении where проверено только поле item. Не забудьте выполнить reset-db после работы этого примера.

3.4.5.4 Less-Than-Comparable

SSQLS могут также быть сделаны less-than-comparable. Это означает, что структуры могут сортироваться и сохраняться в наборах результатов как показывается в следующем примере. Имя файла: custom4.cc.

#include <iostream>
#include <iomanip>
#include <vector>
#include <sqlplus.hh>
#include <custom.hh>

sql_create_5(stock, 1, 5, string,item, int,num, double,weight,
             double,price, Date,sdate)

int main()
{
  try
  { // its in one big try block
    Connection con(use_exceptions);
    con.connect("mysql_cpp_data");
    Query query = con.query();
    query << "select * from stock";
    set <stock> res;
    query.storein(res);
    // here we are storing the elements in a set not a vector.
    cout.setf (ios::left);
    cout << setw (17) << "Item" << setw (4)
         << "Num" << setw (7) << "Weight"
         << setw (7) << "Price" << "Date"
         << endl << endl;
    // Now we we iterate through the set.
    // Since it is a set the list will
    // naturally be in order.
    set <stock>::iterator i;
    cout.precision(3);
    for (i = res.begin (); i != res.end (); i++)
    {
      cout << setw (17) << i->item.c_str ()
           << setw (4) << i->num
           << setw (7) << i->weight << setw (7)
           << i->price << i->sdate << endl;
    }
    i = res.find(stock("Hamburger Buns"));
    if (i != res.end())
       cout << "Hamburger Buns found. Currently " << i->num
            << " in stock.\n";
    else cout << "Sorry no Hamburger Buns found in stock\n";
    // Now we are using the set's find method to find out how many
    // Hamburger Buns are in stock.
    return 0;
  } catch (BadQuery er)
  {
    cerr << "Error: " << er.error << endl;
    return -1;
  } catch (BadConversion er)
  {
    cerr << "Error: Tried to convert \"" << er.data
         << "\" to a \"" << er.type_name
         << "\"." << endl;
    return -1;
  }
}

3.4.6 Сделаем еще лучше

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

Поскольку эти примеры предполагаются к активному использованию (и применяются многими пользователями), константы, которые могут отличаться в разных ситуациях, были сгруппированы, чтобы упростить редактирование. Также, все эти примеры содержат полную ошибку, проверяющую код. Это один из тех редких случаев, в которых обработка исключительной ситуации, принятая в С++, полностью применена в MySQL++.

3.4.6.1 Загрузка двоичного файла в столбец типа BLOB

Эта функция появилась в MySQL version 3.23, но многие пользователи все еще используют старые версии. Пример показывает несколько свойств MySQL++. Эта программа требует одного параметра, который является полным путевым именем для двоичного файла.

#include <sys/stat.h>
#include <fstream>
#include <mysql++>

extern int errno;
const char MY_DATABASE[]="telcent";
const char MY_TABLE[]="fax";
const char MY_HOST[]="localhost";
const char MY_USER[]="root";
const char MY_PASSWORD[]="";
const char MY_FIELD[]="fax";   // BLOB field

int main(int argc, char *argv[])
{
  if (argc < 2)
  {
     cerr << "Usage: load_file full_file_path" <<
          endl<< endl;
     return -1;
  }
  Connection con(use_exceptions);
  try
  {
    con.real_connect(MY_DATABASE,MY_HOST,MY_USER,MY_PASSWORD,3306,
                     (int)0,60,NULL);
    Query query = con.query();
    ostrstream strbuf;
    ifstream In (argv[1],ios::in| ios::binary);
    struct stat for_len;
    if ((In.rdbuf())->is_open())
    {
       if (stat (argv[1],& for_len) == -1) return -1;
       unsigned int blen = for_len.st_size;
       if (!blen) return -1;
       char *read_buffer= new char[blen];
       In.read(read_buffer,blen);
       string fill(read_buffer,blen);
       strbuf << "INSERT INTO " << MY_TABLE
              <<" (" << MY_FIELD <<
              ") VALUES(\"" << escape <<
              fill << "\")";
       query.exec(strbuf.str());
       delete[] read_buffer;
    }
    else cerr << "Your binary file " << argv[1]
              << "could not be open, errno = " << errno;
    return 0;
  } catch (BadQuery er)
  {
    cerr << "Error: " <<er.error << " "
         <<con.errnum() << endl;
    return -1;
  }
}

Одно из свойств, которое отображается в этом примере, манипулятор escape. Хотя автоматическое цитирование и экранирование появилось в версии 1.6, это применимо только к классам ColData, так как они содержат информацию о типе данных. Авторы пакета могли бы также делать цитирование и экранировку на общей строке типа данных, но требуется просмотреть всю строку, чтобы выявить все места, где нужна экранировка служебных символов. Поскольку это свойство замедлит код, оно не реализовано.

3.4.6.1 Отображение картинок в HTML из столбцов типа BLOB

Этот пример также очень короткий. Рассмотрим функцию, которую он выполняет. Хотя с версии 3.23.3 имеется команда для сброса данных из столбцов BLOB в двоичный файл, эта программа может использоваться не только клиентами, все еще использующими старые версии, но и теми, кто не хочет сбрасывать картинку на диск.

#include <sqlplus.hh>
#define MY_DATABASE "telcent"
#define MY_TABLE "fax"
#define MY_HOST "localhost"
#define MY_USER "root"
#define MY_PASSWORD ""
#define MY_FIELD "fax" // BLOB field
#define MY_KEY "datet" // PRIMARY KEY

int main (int argc, char *argv[])
{
  if (argc < 2)
  {
     cerr << "Usage: cgi_image primary_key_value" <<
          endl<< endl;
     return -1;
  }
  cout << "Content-type: image/jpeg" << endl;
  Connection con(use_exceptions);
  try
  {
    con.real_connect(MY_DATABASE,MY_HOST,MY_USER,MY_PASSWORD,3306,
                     (int)0,60,NULL);
    Query query = con.query();
    query << "SELECT" << MY_FIELD << "FROM "
          << MY_TABLE << " WHERE " << MY_KEY
          <<" = " << argv[1];
    ResUse res = query.use();
    Row row=res.fetch_row();
    long unsigned int *jj = res.fetch_lengths();
    cout << "Content-length:" << *jj <<
         endl<< endl;
    fwrite(row.raw_data(0),1,*jj,stdout);
    return 0;
  } catch (BadQuery er)
  {
    cerr << "Error: " << er.error << " "
         << con.errnum() << endl;
    return -1;
  }
}

Этот пример показывает обработку двоичных данных в MySQL++, которая появилась в версии 1.6. Гибкое использование потоков допускает легкое использование этого кода во многих прикладных программах.

3.4.6.2 Удаление или модификация из Select

Об этом свойстве просят многие пользователи, но пока оно не сделано на уровне ядра СУБД, эта программа может использоваться вместо него. Это маленькая программка, которая также показывает некоторые свойства MySQL++.

#include <sqlplus.hh>
#define MY_DATABASE "telcent"
#define MY_TABLE "nazivi"
#define MY_HOST "localhost"
#define MY_USER "root"
#define MY_PASSWORD ""
#define MY_FIELD "naziv"
#define MY_QUERY "SELECT URL from my_table as t1, my_table as t2 \\
                 where t1.field = t2.field"

int main (void)
{
  Connection con(use_exceptions);
  try
  {
    ostrstream strbuf;
    unsigned int i=0;

    con.real_connect(MY_DATABASE,MY_HOST,MY_USER,MY_PASSWORD,3306,
                     (int)0,60,NULL);
    Query query = con.query();
    query << MY_QUERY;
    ResUse res = query.use();
    Row row;
    strbuf << "delete from " << MY_TABLE <<
           " where " << MY_FIELD << " in (";
    // for UPDATE just replace the above DELETE FROM with UPDATE statement
    for (;row=res.fetch_row();i++) strbuf << row[0] << ",";
    if (!i) return 0;
    string output(strbuf.str());
    output.erase(output.size()-1,1);
    output += ")";
    query.exec((const string&)output);
    // cout << output << endl;
    return 0;
  } catch (BadQuery er)
  {
    cerr << "Error: " << er.error << " "
         << con.errnum() << endl;
    return -1;
  }
}

Пожалуйста, сообщите в поле команды конструкции запроса MY_FIELD список значений для вставки. Значения поля будут цитироваться или нет в зависимости от их типа. Пользователи должны не должны ставить кавычки (или экранировать их символом escape), поскольку это приведет к ошибке. Этот метод требует несколько больше усилий от программиста. Программист может отключать это свойство, устанавливая соответствующую глобальную переменную переменную в false. Этот пример написан для выполнения DELETE. UPDATE требует изменений.

Все пользователи этих примеров должны быть осторожны: еще одна проверка требуется, чтобы выполнить этот запрос безопасно. А именно, в некоторых критических случаях размер запроса может превысить значение max_allowed. Эта проверка должна быть добавлна.

3.4.6.2 Двинемся дальше

Это только общий обзор того, что SSQLS может делать. Для получения большего количества информации обратитесь к главе 3.7.

3.4.7 Шаблоны запросов

Другое мощное свойство Mysql++: можно устанавливать шаблоны запросов. Следующий пример показывает, как использовать их. Этот код представляет собой фактический код используемый, чтобы устанавливать и/или сбрасывать типовую базу данных. Этот код может быть найден в файле reset-db.cc.

#include <iostream>
#include <sqlplus.hh>
int main (int argc, char *argv[])
{
  Connection connection(use_exceptions);
  try
  { // the entire main block is one big try block;
    if (argc == 1) connection.connect("");
    else if (argc == 2) connection.connect("",argv[1]);
    else if (argc == 3) connection.connect("",argv[1],argv[2]);
    else if (argc <= 4) connection.connect("",argv[1],argv[2],argv[3]);
    // create a new object and connect based on any (if any) arguments
    // passed to main();
    try
    {
      connection.select_db("mysql_cpp_data");
    } catch (BadQuery er)
    {
      // if it couldn't connect to the database assume that it doesn't exist
      // and try created it. If that does not work exit with an error.
      connection.create_db("mysql_cpp_data");
      connection.select_db("mysql_cpp_data");
    }
    Query query = connection.query();  // create a new query object
    try
    { // ignore any errors here we hope to make this simpler soon
      query.execute("drop table stock");
    } catch (BadQuery er) {}
    query << "create table stock (item char(20) not null,
          num smallint," << "weight double,
          price double, sdate date)";
    query.execute(RESET_QUERY);
    // send the query to create the table and execute it.  The
    // RESET_QUERY tells the query object to reset it self after
    // execution
    query << "insert into %5:table values (%q0, %q1, %2, %3, %q4)";
    query.parse();
    // set up the template query  we will use to insert the data. The
    // parse method call is important as it is what lets the query
    // know that this is a template and not a literal string
    query.def["table"] = "stock";
    // This is setting the parameter named table to stock.
    query.execute("Hamburger Buns", 56, 1.25, 1.1, "1998-04-26");
    query.execute("Hotdogs' Buns",65, 1.1, 1.1, "1998-04-23");
    query.execute("Dinner Roles", 75, 0.95, 0.97, "1998-05-25");
    query.execute("White Bread", 87, 1.5, 1.75, "1998-09-04");
    // The last parameter "table" is not specified here. Thus
    // the default value for "table" is used which is "stock".
  } catch (BadQuery er)
  { // handle any errors that may come up
    cerr << "Error: " <<er.error << endl;
    return -1;
  }
}

3.3.5. Обзор классов

Этот раздел документирует все классы для внешнего использования. Если некий класс не зарегистрирован здесь, не используйте кго, поскольку он представляет собой метод или класс для внутреннего пользования.

3.3.5.1 struct BadConversion

Используется для создания исключительной ситуации, когда происходит плохое преобразование.