MySQL- Руководство разработчика

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


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)
  • Сделать графическое представление набора результатов


              


Содержание раздела