freecplus框架-PostgreSQL数据库操作

一、源代码说明

freecplus是一个Linux系统下的C/C++开源框架，源代码请前往C语言技术网(www.freecplus.net)下载。

本文介绍的是freecplus框架中采用connection和sqlstatement类操作PostgreSQL数据库。

类的声明文件是freecplus/db/postgresql/_postgresql.h。

类的定义文件是freecplus/db/postgresql/_postgresql.cpp。

示例程序位于freecplus/db/postgresql目录中。

编译规则文件是freecplus/db/postgresql/makefile。

二、概述

本文不会介绍PostgreSQL数据库、SQL语言和C/C++的基础知识，您应该是一个职业的C/C++程序员，在阅读本文之前，您已经掌握了PostgreSQL数据库和SQL语言的基础知识。

freecplus框架把PostgreSQL提供的库函数封装成了connection和sqlstatement类，采用封装后的类操作PostgreSQL数据库，代码简洁优雅，性能卓越。

接下来我先列出connection和sqlstatement类的声明，然后通过流程图和示例程序介绍它位的用法。

三、connection类

PostgreSQL数据库连接connection类的声明（程序员不必关心的私有成员和数据结构未列出）：

// PostgreSQL数据库连接池类。
class connection
{
   
public:
  int m_state;         // 与数据库的连接状态，0-未连接，1-已连接。

  CDA_DEF m_cda;       // 数据库操作的结果或最后一次执行SQL语句的结果。

  char m_sql[10241];   // SQL语句的文本，最长不能超过10240字节。

  connection();        // 构造函数。
 ~connection();        // 析构函数。

  // 登录数据库。
  // connstr：数据库的登录参数，格式："host= user= password= dbname= port=",
  // 例如："host=172.16.0.15 user=qxidc password=qxidcpwd dbname=qxidcdb port=5432"
  // username-登录的用户名，password-登录的密码，dbname-缺省数据库，port-mysql服务的端口。
  // 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类

PostgreSQL数据库的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);