文章目录
对很多C/C++程序员来说,操作MySQL数据库是一个技术难点,本文讲述采用freecplus开源框架操作MySQL数据库,freecplus框架是C语言技术网作者二十年的技术积累,功能强大,简单易用。
一、源代码说明
freecplus是一个Linux系统下的C/C++开源框架,源代码请前往C语言技术网(www.freecplus.net)下载。
本文介绍的是freecplus框架中采用connection和sqlstatement类操作MySQL数据库。
类的声明文件是freecplus/db/mysql/_mysql.h。
类的定义文件是freecplus/db/mysql/_mysql.cpp。
示例程序位于freecplus/db/mysql目录中。
编译规则文件是freecplus/db/mysql/makefile。
二、概述
本文不会介绍MySQL数据库、SQL语言和C/C++的基础知识,您应该是一个职业的C/C++程序员,在阅读本文之前,您已经掌握了MySQL数据库和SQL语言的基础知识。
freecplus框架把MySQL提供的库函数封装成了connection和sqlstatement类,采用封装后的类操作MySQL数据库,代码简洁优雅,性能卓越。
接下来我先列出connection和sqlstatement类的声明,然后通过流程图和示例程序介绍它位的用法。
三、connection类
MySQL数据库连接connection类的声明(程序员不必关心的私有成员和数据结构未列出):
// MySQL数据库连接池类。
class connection
{
public:
int m_state; // 与数据库的连接状态,0-未连接,1-已连接。
CDA_DEF m_cda; // 数据库操作的结果或最后一次执行SQL语句的结果。
char m_sql[10241]; // SQL语句的文本,最长不能超过10240字节。
connection(); // 构造函数。
~connection(); // 析构函数。
// 登录数据库。
// connstr:数据库的登录参数,格式:"ip,username,password,dbname,port",
// 例如:"172.16.0.15,qxidc,qxidcpwd,qxidcdb,3306"。
// charset:数据库的字符集,如"gbk",必须与数据库保持一致,否则会出现中文乱码的情况。
// autocommitopt:是否启用自动提交,0-不启用,1-启用,缺省是不启用。
// 返回值:0-成功,其它失败,失败的代码在m_cda.rc中,失败的描述在m_cda.message中。
int connecttodb(char *connstr,char *charset,unsigned int autocommitopt=0);
// 提交事务。
// 返回值:0-成功,其它失败,程序员一般不必关心返回值。
int commit();
// 回滚事务。
// 返回值:0-成功,其它失败,程序员一般不必关心返回值。
int rollback();
// 断开与数据库的连接。
// 注意,断开与数据库的连接时,全部未提交的事务自动回滚。
// 返回值:0-成功,其它失败,程序员一般不必关心返回值。
int disconnect();
// 执行SQL语句。
// 如果SQL语句不需要绑定输入和输出变量(无绑定变量、非查询语句),可以直接用此方法执行。
// 参数说明:这是一个可变参数,用法与printf函数相同。
// 返回值:0-成功,其它失败,失败的代码在m_cda.rc中,失败的描述在m_cda.message中,
// 如果成功的执行了非查询语句,在m_cda.rpc中保存了本次执行SQL影响记录的行数。
// 程序员必须检查execute方法的返回值。
// 在connection类中提供了execute方法,是为了方便程序员,在该方法中,也是用sqlstatement类来完成功能。
int execute(const char *fmt,...);
};
四、sqlstatement类
MySQL数据库的SQL语句操作sqlstatement类的声明(程序员不必关心的私有成员和数据结构未列出):
// 操作SQL语句类。
class sqlstatement
{
public:
int m_state; // 与数据库连接池的绑定状态,0-未绑定,1-已绑定。
char m_sql[10241]; // SQL语句的文本,最长不能超过10240字节。
CDA_DEF m_cda; // 执行SQL语句的结果。
sqlstatement(); // 构造函数。
sqlstatement(connection *conn); // 构造函数,同时绑定数据库连接池。
~sqlstatement(); // 析构函数。
// 绑定数据库连接池。
// conn:数据库连接池connection对象的地址。
// 返回值:0-成功,其它失败,只要conn参数是有效的,并且数据库的游标资源足够,connect方法不会返回失败。
// 程序员一般不必关心connect方法的返回值。
// 注意,每个sqlstatement只需要绑定一次,在绑定新的connection前,必须先调用disconnect方法。
int connect(connection *conn);
// 取消与数据库连接池的绑定。
// 返回值:0-成功,其它失败,程序员一般不必关心返回值。
int disconnect();
// 准备SQL语句。
// 参数说明:这是一个可变参数,用法与printf函数相同。
// 返回值:0-成功,其它失败,程序员一般不必关心返回值。
// 注意:如果SQL语句没有改变,只需要prepare一次就可以了。
int prepare(const char *fmt,...);
// 绑定输入变量的地址。
// position:字段的顺序,从1开始,必须与prepare方法中的SQL的序号一一对应。
// value:输入变量的地址,如果是字符串,内存大小应该是表对应的字段长度加1。
// len:如果输入变量的数据类型是字符串,用len指定它的最大长度,建议采用表对应的字段长度。
// 返回值:0-成功,其它失败,程序员一般不必关心返回值。
// 注意:1)如果SQL语句没有改变,只需要bindin一次就可以了,2)绑定输入变量的总数不能超过256个。
int bindin(unsigned int position,int *value);
int bindin(unsigned int position,long *value);
int bindin(unsigned int position,unsigned int *value);
int bindin(unsigned int position,unsigned long *value);
int bindin(unsigned int position,float *value);
int bindin(unsigned int position,double *value);
int bindin(unsigned int position,char *value,unsigned int len);
// 绑定输出变量的地址。
// position:字段的顺序,从1开始,与SQL的结果集一一对应。
// value:输出变量的地址,如果是字符串,内存大小应该是表对应的字段长度加1。
// len:如果输出变量的数据类型是字符串,用len指定它的最大长度,建议采用表对应的字段长度。
// 返回值:0-成功,其它失败,程序员一般不必关心返回值。
// 注意:1)如果SQL语句没有改变,只需要bindout一次就可以了,2)绑定输出变量的总数不能超过256个。
int bindout(unsigned