第七根弦的技术博客

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

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

看一下代码片段就知道了

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

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

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

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

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

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

4. mysqlpp:: DbDriver属性与方法

• 属性

其中

很显然，核心自然就是那个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的内容，发现他有这个同名方法。

这个方法具体做了什么？

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

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

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

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

• Connect与Disconnect

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

在MYSQL++中，做法主要是

和

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

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

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

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

• 其他琐碎代码

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