首页mysqlmysql++ › 10. MYSQL++ 之 DbDriver

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的构造函数中。
300958065627166

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)。

看一下代码片段就知道了
300958078915193

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

  • 不同的属性有不同的设置方法,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++是如何做的?

300958093124193
300958107347490

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

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

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

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

4. mysqlpp:: DbDriver属性与方法

  • 属性

300958136414703
其中
300958140628874

很显然,核心自然就是那个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

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

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

这个方法具体做了什么?
300958151257216

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

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

顺带便说一下applied_options_在什么时候用,
300958160162545
一旦没有error出现的时候,就会将这个指针加入到applied_options,为什么要保留这个指针?当然是为了以后销毁。
300958168913644

    • Connect与Disconnect

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

在MYSQL++中,做法主要是

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

对于DbDriver:: connect来说,代码如下
300958189535813
关键的就是这个connect_prepare做了什么?
300958205626755

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

    • 其他琐碎代码

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

发表评论