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