RussianLDP Рейтинг@Mail.ru
WebMoney: 
WMZ Z294115950220 
WMR R409981405661 
WME E134003968233 
YandexMoney: 
41001198119846 
E-gold:
5128052

3.10 MyDAO: библиотека-оболочка для C++

Версия v0.1 (19-Feb-2000). Автор: Satish (spitfire@pn3.vsnl.net.in). Лицензия: Feel free to use/copy/modify/add bugs/find bugs, but keep the author informed.

Введение

Это C++ библиотека для сервера MySQL. Разработчик данного пакета искал библиотеку C++, которая может создавать и работать с Data Access Objects. Он натолкнулся на программное обеспечение, написанное Roland Hanel (MySQL C++) и Ed Carp (MyC). Но MyC написан на чистом C и не может создавать объект в истинном смысле. Также это не может создавать и работать с несколькими наборами результатов. На основе этих пакетов была написан пакет MyDAO ver 0.1.

Руководство программиста

dbconnect class: Один объект подключения должен быть создан. Это ответственно за соединение с сервером MySQL и открытие базы данных. Свойства:

  • bool Connected;
    Connected равно true, если подключение к серверу MySQL работает.
  • MYSQL *DBase;
    DBase является указателем на структуру MYSQL. Это требуется, чтобы открыть набор результатов.

Методы:

  • void dbconnect::Connect(char *host, char *port, char *uname, char*pwd);
    Пытается соединиться с сервером MySQL, используя указанные параметры хоста, порта, имени пользователя и пароля. Если подключение успешно установлено, свойство Connected будет true.
  • void dbconnect::Disconnect();
    Разъединяет текущее подключение с сервером MySQL.
  • bool dbconnect::OpenDB(char *db);
    Открывает базу данных db. Если все в порядке, вернет true.

Пример:

dbconnect MyConnect;
char host[]="localhost";
char port[]="3306";
char name[]="satish";
char pwd[]="";
char db[]="orders";

MyConnect.Connect(host, port, name, pwd);
if (MyConnect.Connected) cout << "Connected" << endl;
else
{
  cout << "Connection failed" << endl;
  return;
}
if (!MyConnect.OpenDB(db)) {
   cout << "Can not open selected database" << endl;
   return;
}
else
{
  cout << "Opened datbase: " << db << endl;
  //   open recorset(s)...
  //   Manipulate data...
}
MyConnect.Disconnect();

recordset class: Любое количество наборов результатов может быть создано из этого класса. Он имеет много свойств для простого манипулирования данными.

Свойства:

  • char RecSource[MAX_RECSRC_LEN];
    Источник записей, из которых данные должны обрабатываться. Это должна быть SQL-инструкция SELECT, возвращающая записи.
  • unsigned long int RecordCount;
    Число строк в открытом наборе результатов.
  • unsigned long int AffectedRows;
    Может использоваться только с Update, AddNew или Delete. Число строк фактически обработанных сервером.
  • bool EOR;
    Конец набора результатов. True, если Вы двигаетесь в последнюю строку.
  • bool BOR;
    Начало набора результатов. True, если Вы двигаетесь первую строку. Замечание: EOR и BOR вместе будут равны true, если RecordCount=0.

Методы:

  • void recordset::OpenRecordset(MYSQL *Structmysql, char *sql);
    Открывает набор результатов основанный на SQL-инструкции select.
  • void recordset::CloseRecordset();
    Закрывает набор результатов. Он должен быть закрыт, чтобы освободить память, используемую им.
  • void recordset::MoveNext();
    Перемещается в следующую строку набора результатов. Если уже достигнута последняя строка, в ней и останется.
  • void recordset::MovePrevious();
    Перемещается в предыдущую строку набора результатов. Если уже достигнута первая строка, в ней и останется.
  • void recordset::MoveFirst();
    Перемещается в первую строку набора результатов.
  • void recordset::MoveLast();
    Перемещается в последнюю строку набора результатов.
  • char* recordset::GetField(char *FName);
    Возвращает содержание поля FName.
  • void recordset::SetField(char *FName, char *Value);
    Устанавливает содержание поля FName в значение Value. Изменения будут отброшены, если после установки значения не используется метод Update/AddNew.
  • void recordset::Edit();
    Должен использоваться перед методами SetField и Update, иначе все изменения будет отброшены.
  • void recordset::AddNew();
    Используется, чтобы добавить новую строку в набор результатов. Для работы этого метода набор результатов должен быть основан на таблице. Метод Update должен использоваться после установки всех значений поля. Определение WHERE не должно использоваться в методе Update, если оно уже используется с методом AddNew. Свойство AffectedRows выдаст число добавленных строк.
  • void rercordset::Update(char *Where);
    Используется, чтобы редактировать или добавить строку вместе с методами Edit/AddNew. Определение WHERE не должно использоваться с AddNew.
  • void recordset::Delete(char *Where);
    Применяется, чтобы удалить строки из набора результатов.
  • void recordset::Refresh();
    Изменения, сделанные методом Update, невидимы, если метод Refresh не используется. Обновите набор результатов немедленно после Update.
  • char* recordset::GetFieldN(int FNum);
    Аналогично GetField, но вместо имени поля используется его код (номер).
  • void recordset::SetFieldN(int FNum, char *Value)
    Аналогично SetField, но вместо имени поля используется его код (номер).

Пример 1:

//   Продолжение примера из dbconnect.
//   Откроем таблицу заказчиков (customers) и распечатаем
//   все записи из нее.
recordset MySet;
char sql[]="SELECT * FROM customers";

MySet.OpenRecordset(MyConnect.DBase, sql);
if (MySet.EOR && MySet.BOR){
   cout << "No records found" << endl;
   return;
}
else
{
  // Show number of records
  cout << "No. of records: " << MySet.RecordCount << endl;
  // Show all records
  while (!MySet.EOR)
  {
    cout << MySet.GetField("or_id") << "\t";
    cout << MySet.GetField("customers") << "\t";
    cout << MySet.GetField("city") << endl;
    MySet.MoveNext();
  }
}

Пример 2:

//   Добавление новой строки в таблицу заказчиков.
MySet.AddNew();
MySet.SetField("cs_id", "7");
MySet.SetField("name", "Satish");
MySet.SetField("city", "Pune");
MySet.Update("");               // where не используется!
MySet.Refresh();                // Сделаем изменения видимыми.

Пример 3:

//   Изменение имени заказчика.
MySet.Edit();
MySet.SetField("cs_id", "7");
MySet.SetField("name", "Suresh");
MySet.SetField("city", "Pune");
MySet.Update("or_id=7");        // where здесь необходимо использовать.
MySet.Refresh();                // Сделаем изменения видимыми.

Пример 4:

//   Удаление записи.
MySet.Delete("name='Suresh'");
MySet.Refresh();                // Сделаем изменения видимыми.

Пример 5:

//   Закроем набор результатов после употребления. Это ОБЯЗАТЕЛЬНО!
MySet.CloseRecordset();

Что еще надо сделать:

  • Лучший контроль ошибок
  • Методы поиска информации (FindFirst, FindNext, FindPrevious, FindLast)
  • Сделать графическое представление набора результатов

Поиск

 

Найди своих коллег!