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
其实主要需要关注的无非就是
1: bool DbDriver:: set_option(Option* o);
问题是为什么是它?我们知道,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++中,做法主要是
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,然后清理了变量方便这个实例后续重用(当然,先检查是否连接过)
对于DbDriver:: connect来说,代码如下
关键的就是这个connect_prepare做了什么?
首先他显示检查是否在“连接”状态,如果是,则断开连接,然后调用初始化的mysql_init函数,随后将之前添加的pending_options_加入到option中。
- 其他琐碎代码
其他的代码基本上就是底层C API的包装,只有escapting和quoting理解起来会有点困难。请查看相关章节。
原创作品,转载请注明出处www.cnblogs.com/aicro。