一个简单的支持MySQL和SQLite3的DB接口

本文涉及的产品
云数据库 RDS MySQL Serverless,0.5-2RCU 50GB
简介: C++源代码:simple_db.zip相关联代码:https://github.com/eyjian/mooon/tree/master/common_library/include #ifndef MOOON_SYS_SIMPLE_DB_H ...
C++源代码: img_e25d4fb2f8de1caf41a735ec53088516.pngsimple_db.zip
相关联代码: https://github.com/eyjian/mooon/tree/master/common_library/include

  1. #ifndef MOOON_SYS_SIMPLE_DB_H
  2. #define MOOON_SYS_SIMPLE_DB_H
  3. #include "sys/db_exception.h"
  4. #include string>
  5. #include vector>
  6. SYS_NAMESPACE_BEGIN

  7. typedef std::vectorstd::string> DBRow; // 用来存储一行所有字段的值
  8. typedef std::vectorDBRow> DBTable; // 用来存储所有行

  9. /**
  10.  * 访问DB的接口,是一个抽象接口,当前只支持MySQL
  11.  *
  12.  * 使用示例:
  13. DBConnection* db_connection = DBConnection::create_connection("mysql");
  14. try
  15. {
  16.     DBTable db_table;

  17.     // 不指定DB名,以及不需要密码
  18.     db->set_host("127.0.0.1", 3600);
  19.     db->set_user("root", "");
  20.     db->set_charset("utf8");
  21.     db->enable_auto_reconnect();
  22.     db->set_timeout_seconds(600);
  23.     
  24.     db_connection->open();
  25.     db_connection->query(db_table, "select count(1) from test_table where id=%d", 2015);
  26. }
  27. catch (CDBException& db_error)
  28. {
  29.     log("%s error: %s at %s:%d", db_connection.str().c_str(), db_error.what(), db_error.file(), db_error.lien());
  30. }

  31. DBConnection::destroy_connection(db_connection);
  32.  */
  33. class DBConnection
  34. {
  35. public:
  36.     /***
  37.      * 工厂方法 - 创建一个DB连接
  38.      * @db_type_name DB类型名,如:mysql、oracle、postgreSQL,不区别大小写
  39.      * 当前只支持MySQL和SQLite3,也就是参数值只能输入mysql(不区别大小写)
  40.      * @sql_max 支持的最大SQL语句长度,单位为字节数,不含结尾符
  41.      * 如果是支持的DB类型,则返回非NULL,否则返回NULL
  42.      */
  43.     static DBConnection* create_connection(const std::string& db_type_name, size_t sql_max);

  44.     /***
  45.      * 销毁一个由create_connection()创建的DB连接
  46.      * @db_connection 需要销毁的DB连接
  47.      */
  48.     static void destroy_connection(DBConnection* db_connection);

  49.     /***
  50.      * 判断是否为网络连接断开异常,
  51.      * 如使用过程中,与MySQL间的网络中断,或MySQL进程死掉等,这种情况下可以尝试重连接
  52.      */
  53.     static bool is_disconnected_exception(CDBException& db_error);

  54. public:
  55.     virtual ~DBConnection() {}
  56.     
  57.     /***
  58.      * 设置需要连接的DB的IP和服务端口号
  59.      * 注意,只有在open()或reopen()之前调用才生效
  60.      */
  61.     virtual void set_host(const std::string& db_ip, uint16_t db_port) = 0;

  62.     /***
  63.      * 设置连接的数据库名
  64.      * 注意,只有在open()或reopen()之前调用才生效
  65.      */
  66.     virtual void set_db_name(const std::string& db_name) = 0;
  67.     
  68.     /***
  69.      * 设置用来连接DB的用户名和密码
  70.      * 注意,只有在open()或reopen()之前调用才生效
  71.      */
  72.     virtual void set_user(const std::string& db_user, const std::string& db_password) = 0;
  73.     
  74.     /***
  75.      * 设置访问DB的字符集
  76.      * 注意,只有在open()或reopen()之前调用才生效
  77.      */
  78.     virtual void set_charset(const std::string& charset) = 0;
  79.     
  80.     /***
  81.      * 设置为连接断开后自动重连接,如果不主动设置,默认不自动重连接
  82.      * 注意,只有在open()或reopen()之前调用才生效
  83.      */
  84.     virtual void enable_auto_reconnect() = 0;
  85.     
  86.     /***
  87.      * 设置用来连接的超时秒数,如果不主动设置,则使用默认的10秒
  88.      * 注意,只有在open()或reopen()之前调用才生效
  89.      */
  90.     virtual void set_timeout_seconds(int timeout_seconds) = 0;
  91.     
  92.     /***
  93.      * 设置空值,字段在DB表中的值为NULL时,返回的内容
  94.      * 如果不主动设置,则默认空值时被设置为"$NULL$"
  95.      */
  96.     virtual void set_null_value(const std::string& null_value) = 0;
  97.     
  98.     /***
  99.      * 建立一个DB连接
  100.      * 出错抛出异常CDBException
  101.      */
  102.     virtual void open() throw (CDBException) = 0;

  103.     /**
  104.      * 关闭一个DB连接
  105.      * 使用open()建立的连接,在使用完后,要使用close()关闭它
  106.      */
  107.     virtual void close() throw () = 0;

  108.     /***
  109.      * 重新建立DB连接
  110.      * reopen()会先调用close()关闭连接,然后才重新建立连接,
  111.      * 因此调用reopen()之前,可不调用close(),当然即使调用了close()也不会有问题
  112.      */
  113.     virtual void reopen() throw (CDBException) = 0;

  114.     /***
  115.       * 数据库查询类操作,包括:select, show, describe, explain和check table等,
  116.       * 如果某字段在DB表中为NULL,则返回结果为"$NULL$",如果内容刚好为"$NULL$",则无法区分
  117.       * 出错抛出CDBException异常
  118.       */
  119.     virtual void query(DBTable& db_table, const char* format, ...) throw (CDBException) __attribute__((format(printf, 3, 4))) = 0;

  120.     /**
  121.      * 查询,期望只返回一行记录,
  122.      * 如果某字段在DB表中为NULL,则返回结果为空字符串,因此不能区分字段无值还是值为空字符串
  123.      * 如果查询失败,抛出CDBException异常,异常的错误码为-1,
  124.      * 如果查询实际返回超过一行记录,抛出CDBException异常,异常的错误码为DB_ERROR_TOO_MANY_ROWS
  125.      */
  126.     virtual void query(DBRow& db_row, const char* format, ...) throw (CDBException) __attribute__((format(printf, 3, 4))) = 0;

  127.     /**
  128.      * 查询,期望只返回单行单列,
  129.      * 如果某字段在DB表中为NULL,则返回结果为空字符串,因此不能区分字段无值还是值为空字符串
  130.      * 如果查询失败,抛出CDBException异常,异常的错误码为-1,
  131.      * 如果查询实际返回超过一行记录,抛出CDBException异常,异常的错误码为DB_ERROR_TOO_MANY_ROWS,
  132.      * 如果查询实际返回只有一行,但超过一列,则抛出CDBException异常,异常的错误码为DB_ERROR_TOO_MANY_COLS
  133.      */
  134.     virtual std::string query(const char* format, ...) throw (CDBException) __attribute__((format(printf, 2, 3))) = 0;

  135.     /***
  136.       * 数据库insert和update更新操作
  137.       * 成功返回受影响的记录个数,出错则抛出CDBException异常
  138.       */
  139.     virtual int update(const char* format, ...) throw (CDBException) __attribute__((format(printf, 2, 3))) = 0;

  140.     /**
  141.      * 取得可读的字符串信息
  142.      */
  143.     virtual std::string str() throw () = 0;
  144. };

  145. SYS_NAMESPACE_END
  146. #endif // MOOON_SYS_SIMPLE_DB_H

相关实践学习
基于CentOS快速搭建LAMP环境
本教程介绍如何搭建LAMP环境,其中LAMP分别代表Linux、Apache、MySQL和PHP。
全面了解阿里云能为你做什么
阿里云在全球各地部署高效节能的绿色数据中心,利用清洁计算为万物互联的新世界提供源源不断的能源动力,目前开服的区域包括中国(华北、华东、华南、香港)、新加坡、美国(美东、美西)、欧洲、中东、澳大利亚、日本。目前阿里云的产品涵盖弹性计算、数据库、存储与CDN、分析与搜索、云通信、网络、管理与监控、应用服务、互联网中间件、移动服务、视频服务等。通过本课程,来了解阿里云能够为你的业务带来哪些帮助     相关的阿里云产品:云服务器ECS 云服务器 ECS(Elastic Compute Service)是一种弹性可伸缩的计算服务,助您降低 IT 成本,提升运维效率,使您更专注于核心业务创新。产品详情: https://www.aliyun.com/product/ecs
相关文章
|
5月前
|
关系型数据库 MySQL Linux
【Linux】jdk & Tomcat & MySql的安装及Linux后端接口部署
【Linux】jdk & Tomcat & MySql的安装及Linux后端接口部署
107 0
|
24天前
Mybatis+mysql动态分页查询数据案例——房屋信息的接口(IHouseDao)
Mybatis+mysql动态分页查询数据案例——房屋信息的接口(IHouseDao)
12 1
|
2月前
|
SQL 关系型数据库 MySQL
MySQL技能完整学习列表14、应用开发和接口
MySQL技能完整学习列表14、应用开发和接口
48 0
|
7月前
|
存储 关系型数据库 分布式数据库
云原生关系型数据库Polar DB MySQL版(二)
云原生关系型数据库Polar DB MySQL版(二)
169 0
|
7月前
|
存储 关系型数据库 MySQL
云原生关系型数据库Polar DB MySQL版(一)
云原生关系型数据库Polar DB MySQL版(一)
227 0
|
3月前
|
JavaScript 关系型数据库 MySQL
百度搜索:蓝易云【Node.js写接口连接MySQL数据库教程】
现在,你的Node.js应用已经启动,可以通过访问 `http://localhost:3000/users`来获取所有用户的信息。注意替换上述代码中的数据库连接信息为你自己的实际数据。
47 0
|
4月前
|
SQL 关系型数据库 MySQL
mysql转sqlite3实战+部署sqlite3应用
mysql转sqlite3实战+部署sqlite3应用
105 0
|
8月前
|
关系型数据库 MySQL
mysql转sqlite3
mysql转sqlite3
84 0
|
4月前
|
前端开发 JavaScript 关系型数据库
【前端必备】使用NodeJs写接口(本地连接MySQL + 连接到云服务MySQL)
【前端必备】使用NodeJs写接口(本地连接MySQL + 连接到云服务MySQL)
|
4月前
|
存储 SQL 关系型数据库
⑩⑤【DB】详解MySQL存储过程:变量、游标、存储函数、循环,判断语句、参数传递..
⑩⑤【DB】详解MySQL存储过程:变量、游标、存储函数、循环,判断语句、参数传递..
43 0