• 【原创】10. MYSQL++ 之 DbDriver


    1. 综述

    DbDriver只是对于MYSQL C API的一个非常简单的封装,作者原句是This class does as little as possible to adapt between its public interface and the interface required by the underlying C API. 作为MYSQL++的使用者我们不应该直接去创建这个类型,而应该默认让mysqlpp:: Connection来来创建和管理,如果实在是需要,可以通过mysqlpp:: Connection::driver( )来获取底层的DbDriver类型。

    作者想把这个类型封装为MYSQL C API的轻类型的另外一个原因,就是希望it may be turned into an abstract base class, with subclasses for different database server types.

    2. 什么时候创建了DbDriver

    正如作者所言,DbDriver被创建的时机只有在mysqlpp:: Connection的构造函数中。

    clip_image002

    3. mysqlpp:: Option及其子类型

    在了解DbDriver之前,我们有必要来看一下MYSQL++定义的另外一个表示连接属性的类型mysqlpp:: Option。该类型其实是作为后续子类型的父类型而存在的。

    由于这些Option类型只与DbDriver打交道,所以作为pure-OO的做法来说,我们有足够的理由将这些类型定义为DbDriver的protected或者private类型,但是作者在这里把这些类型放到专门的文件中(options.h和options.cpp),这完全只是因为这些类型过于冗长的关系。(顺便说一句,在C#中,这个问题被妥妥地解决了。终极办法是使用partial class,即分部类型。)

    说一下这些Option类型的源模型。

    https://dev.mysql.com/doc/refman/5.1/en/mysql-options.html

    总体来说,其实这些类型就是为了包装链接中所叙述的那么多的OPTION,实现方法基本上也就是使用TEMPLATE+DELEGATE的设计模式,利用纯虚基类指定方法接口,使用DELEGATE调用mysqlpp:: DbDriver:: set_option( )方法(其下其实封装的是mysql_options() 这个C API)。

    看一下代码片段就知道了

    clip_image004

    在这些类型的定义中,可以学到如下几点:

    • 不同的属性有不同的设置方法,MYSQL++是如何做到公用和节省的?
      • 有一些属性是基于bool型的参数(例如,FoundRowsOption,该Option其实封装的是CLIENT_FOUND_ROWS这个属性,该属性的取值就应该是一个bool型);
      • 有些属性是基于整数型的参数(例如ConnectTimeoutOption,该Option其实封装的是MYSQL_OPT_CONNECT_TIMEOUT这个属性,该属性的取值就是一个int型);
      • 还有一些属性是基于字符串(std::string)型的参数(例如ReadDefaultFileOption,该属性封装的是MYSQL_READ_DEFAULT_FILE这个底层属性——Read options from the named option file instead of from my.cnf.——他的取值就是一个char*)。对于有那么多不同参数种类的属性,MYSQL++是如何做的?

    clip_image006

    clip_image008

    (为了看起来方便,我将Set方法的实现拉到了.h中了,原来是写在了options.cpp中)

    MYSQL++采用模板类型继承已有的Option类型,然后实例化的方式来简单地拓展了3个不同类型的Option。其余的具体的Option则再通过这几个已拓展的类型进行实现,代码简洁漂亮。

    • 为了让代码更简明,MYSQL++采用了在mysqlpp:: Option中内置了一个enum的形式,

    clip_image010

    这样做的好处是什么?简单,看得清楚。让我们来看一下在DbDriver的set_option_impl中的具体使用

    clip_image011

    4. mysqlpp:: DbDriver属性与方法

    • 属性

    clip_image012

    其中

    clip_image013

    很显然,核心自然就是那个mysql_,这可是MYSQL C API 的核心!

    同时,需要关心的是is_connected_,这个变量其实主要用在

    bool connected() const { return is_connected_; }

    这个函数的意思也挺明确的,就是 This does not actually check whether the connection is viable, it just indicates whether there was previously a successful connect() call and no disconnect().

    • 方法
      • 构造与析构

    DbDriver其实是非常好的RAII的范本,在DbDriver中会将表示“是否已经call过connect()以及还没有call过disconnect()的is_connected_置为false,同时初始化mysql_。在析构函数中,首先检查的是这个is_connected是否为true(表示已经call 过Connect()并且还没有call过DisConnect()),如果是true则立即进行disconnect。

      • 设置OPTIONS

    其实主要需要关注的无非就是

       1:  bool DbDriver:: set_option(Option* o);

    问题是为什么是它?我们知道,OPTIONS是连接的属性,所以我去查看了mysqlpp:: Connection的内容,发现他有这个同名方法。

    这个方法具体做了什么?

    clip_image015

    如果已经是连接状态了,那么久直接进行set(那个DbDriver:: set_option_impl( ) 方法其实就是调用了mysqlpp:: Option::set( )方法,具体可以看上面),如果没有连接过,那么久加入到pending_options_中。

    接下来的问题是pending_options_什么时候用到?请看下文。

    顺带便说一下applied_options_在什么时候用,

    clip_image016

    一旦没有error出现的时候,就会将这个指针加入到applied_options,为什么要保留这个指针?当然是为了以后销毁。

    clip_image018

      • Connect与Disconnect

    在最为传统的MYSQL C API中,建立连接和断开连接分别是mysql_real_connect和mysql_close系统调用

    在MYSQL++中,做法主要是

       1:  bool
       2:   
       3:  DBDriver::connect(const char* host, const char* socket_name,
       4:   
       5:  unsigned int port, const char* db, const char* user,
       6:   
       7:  const char* password)
       8:   

       1:  void DBDriver::disconnect()

    disconnect没啥好说的,就是直接调用了mysql_close,然后清理了变量方便这个实例后续重用(当然,先检查是否连接过)

    clip_image019

    对于DbDriver:: connect来说,代码如下

    clip_image021

    关键的就是这个connect_prepare做了什么?

    clip_image023

    首先他显示检查是否在“连接”状态,如果是,则断开连接,然后调用初始化的mysql_init函数,随后将之前添加的pending_options_加入到option中。

      • 其他琐碎代码

    其他的代码基本上就是底层C API的包装,只有escapting和quoting理解起来会有点困难。请查看相关章节。

    原创作品,转载请注明出处www.cnblogs.com/aicro

  • 相关阅读:
    PDO扩展
    阿里云ECS VSFTP上传本地文件
    Nginx+lua_Nginx+GraphicsMagick来实现实时缩略图
    Mysql 5.6主从同步配置与解决方案
    windows安装配置mongodb及图形工具MongoVUE
    安装phpredis扩展以及phpRedisAdmin工具
    Redis安装配置以及开机启动
    CentOS安装Git服务器 Centos 6.5 + Git 1.7.1.0 + gitosis
    OpenStack 入门3
    Openstack 入门2
  • 原文地址:https://www.cnblogs.com/aicro/p/3633512.html
Copyright © 2020-2023  润新知