CDatabase 类封装了 MySQL 数据库的功能,因此不具备通用性,只能在对 MySQL 的应用程序中使用。下面将根
据
C++要求及规范给出 CDatabase 类的具体结构以及相关简要介绍:
class CDatabase
{
public:
BOOL UnLockTable(); //解锁
BOOL LockTable(char* TableName,char* PRIORITY); //加锁
int Reload(); //重新登陆,非零时返回错误信息
char* GetState(); //服务器状态
char* GetServerInfo(); //服务器信息
int GetProtocolInfo(); //协议信息
char* GetHostInfo(); //主机信息
char * GetClientInfo(); //客户机信息
char* GetFieldName(int FieldNum); //字段名
BOOL IsEnd(); //是否最后
int DropDB(char *db); //删除数据库,非零时返回错误信息
void SeekData(int offset); //查找指定数据
int CreateDB(char *db); //创建数据库,非零时返回错误信息
void FreeRecord(); //释放结果集
unsigned int GetFieldNum(); //得到字段数
BOOL ConnectDB(Database_Param *p); //连接数据库
MYSQL_ROW GetRecord(); //得到结果(一个记录)
my_ulonglong GetRowNum(); //得到记录数
BOOL SelectDB(Data_Param *para); //选择数据库
BOOL UpdateRecord(Data_Param *para); //更新记录
BOOL SelectRecord(Data_Param *para); //选择记录
BOOL InsertRecord(Data_Param *para); //插入记录
BOOL DelRecord(Data_Param *para); //删除记录
BOOL SelectAll(Data_Param *para); //选择所有记录
char * OutErrors(); //输出错误信息
CDatabase(); //初始化数据库
virtual ~CDatabase(); //关闭数据库连接
private:
MYSQL mysql; //数据库连接句柄
MYSQL_RES *query; //结果集
MYSQL_ROW row; //记录集
MYSQL_FIELD *field; //字段信息(结构体)
BOOL FindSave(char *str); //查找并保存结果集
};
通过
CDatabase 类中定义的这些功能函数,我们可以通过远程或本机完成对 MySQL 数据库的绝大部分操控,并
且由于定义了解锁和加锁功能,使得应用程序能够多线程或多进程地访问数据库,大大提高了效能。以上函数的
具体功能都是通过调用
C API 函数实现的。
3.2 CDatabase 类在 VC 中的应用
第一步 建立初始化
MySQL 对象,并且将其初始化。即定义 CDatabase 类对象,这样程序就会自动调用构造函数
CDatabase(),完成初始化。
构造函数实现如下:
CDatabase::CDatabase ()
{
mysql_init (&mysql);
}
完成初始化只需定义
CDatabase 类对象,即
CDatabase base;
第二步 连接服务器,并连接需要的数据库。即调用
ConnectDB(Database_Param *p)函数,结构体
Database_Param 中存放数据库参数,包括主机名、用户名、密码、数据库名等。该函数如返回 TRUE 表示连接
成功,否则表示失败。