一、mysqlpp::Row类型
在之前的介绍中我们看到了如何通过mysqlpp::Query找到各种Result类型,然后又仔细分析了各种Result类型又是如何生成对应的Row类型(如下所示)。
接下去的问题就是,到底mysqlpp::Row是什么。
1. Row类型的使用(先不提SSQLS)
还是先来看如何使用这个Row类型,照样是通过sample程序。
1 2 3 4 5 6 7 8 9 |
mysqlpp::Connection conn(false); conn.connect(...); mysqlpp::Query query = conn.query("select * from stock"); mysqlpp::UseQueryResult res = query.use(); while (mysqlpp::Row row = res.fetch_row()) { cout << setw(30) << row["item"] << ' ' << setw(9) << row["num"] << endl; } |
OR
1 2 3 4 5 6 7 8 9 |
mysqlpp::Connection conn(false); conn.connect(...); mysqlpp::Query query = conn.query("select * from stock"); mysqlpp::UseQueryResult res = query.use(); while (mysqlpp::Row row = res.fetch_row()) { cout << setw(30) << row[0] << ' ' << setw(9) << row[1] << endl; } |
上面的例子中提到的两种最为基本的用法,主要就是查看每行数据的各个列的不同方式。至于查找Row的列的信息,可以通过row[0]等返回回来的String,具体可以看下文和对于mysqlpp::String的介绍的章节。
2. mysqlpp::Row的实现
关于mysqlpp::Row的定义主要在row.h和row.cpp中。在说明中,我们可以看到,作者对Row的定义是const,这是因为他认为通过返回的Row去修改database是不合适的。所以不直接从vector进行派生,而自己去实现一些必要的方法。
mysqlpp::Row是直接从OptionalExceptions进行派生的。
- 成员变量
list_type data_;
RefCountedPointer<FieldNames> field_names_;
bool initialized_;
list_type是什么?typedef std::vector<mysqlpp::String> list_type;
FieldNames是一个派生自vecot<std::string>的类型
在类型声明的一开头,作者首先typedef了list_type相关的迭代器,反响迭代器,引用迭代器,元素类型值,元素类型长度等信息。
- 成员方法
首先来看各种构造方法和等号赋值方法。
主要定义了两种构造器
主要看一下在本节一开始的实例中所使用的第二个构造器。
首先我们看到的是使用一个initialized_进行构造成功与否的保护,估计在之后所有的方法上都会先对这个变量进行查询,如果是false直接返回错误或者抛出异常。
其次,是对于data_(一个vector<String>类型)的初始化和填充,需要注意的是第45行。value_type是这样定义的,也就是一个vector<String>::value_type
查看STL文档得知,vector<T>::value_type是A type that represents the data type stored in a vector. value_type is a synonym for the template parameter Type.换句话说,作者为了减少冗余,这里采用了通用的方式。值得学习!
所以说,其实在第45行,主要做的事情就是调用mysqlpp:: String的构造函数,这个请查看String的介绍。
这里还要注意的是第48行,跟着进去看到的是ResultBase:: field_type( )方法,定义是
又出现了熟悉的value_type,那么FieldTypes是什么呢?
又回到了之前介绍过的mysql_type_info。这样子即使你没有看过String的构造函数,你也已经很明白了,这个String很神通广大,他居然能够知道值以及具体的类型!也就是说,MySQL++就用了一个String包装了MYSQL C API中的行信息和行所对应的列的信息。
接下来在52行把所有的field_names的信息传递给了mysqlpp::Row的成员变量field_names_,所有都已经成功了之后,就大胆地设置初始化标志为true。
再来分析一下在mysqlpp::Row中delegate std::vector的方法
不多说,完全就是delegate,只不过原来一直没有注意过一点的是,vector<T>:: begin( )居然被定义了两个版本(只怪自己学艺不精)
1 2 |
iterator begin(); const_iterator begin() const; |
当然,上面用的版本都是非const版本,这是因为data_被定义为vector<String>没有带const,但是返回值都是const的!
顺带便说一下,const_reference以及const_iterator的定义
还有就是
获取Row中Field值的方法
从上面的例子中我们可以简单的看到,要获取一行数据的值还是很简单的,主要的方法就是通过operator [ ]
再来说明一下上面提到的为什么该参数一定要是int而不是size_type的问题。下文我们可以知道,作者重载了一个operator[](char*)。如果出现了row[0]或者row[NULL](假设这个平台将NULL定义为0),我们有理由说编译器会搞不清楚到底你要的是size_type还是char*,毕竟我们同样可以把NULL赋值给char*。但是如果有了int,由于0是int型,所以会被匹配到这里。
这里的at方法还是很简单的。
方法二,通过field的字符串形式的name来查找Row中对应的field的值
其中field_num方法的定义如下
该函数的实现代码如下,
需要注意的是划红色圈的地方,这里其实调用的是mysqlpp:: FieldNames(一个派生自vector<string>的类型)的operator[ ]的重载方法
以下这些方法是用于SSQLS,基于value_list_b结构体
equal_list
在Row的定义中,我们可以看到两个同名不同参的函数equal_list,这两个函数主要用在了SSQLS中,用于生成”equals clause”,例如在SELECT语句中的WHERE就是一个典型的”equals clause”,例如,
SELECT * FROM Tbl1 WHERE id = ‘1’, name = ‘root’
这个是需要配合使用equal_list_b结构以及一个用于做quoting和escaping的类型。
这几个重要方法请参看SSQLS的具体解释。
field_list
这几个方法同样也是用于SSQLS的,主要用于返回各种FieldNames。这个函数会有一些输入(某些重构是vector<bool>,有些就是很多bool参数)来表明一个row中哪些field是需要被返回到结果集中的。不需要的就用false。
value_list
这个函数是获取mysqlpp::Row的整个(或者部分)值的函数。这个函数会有一些输入(某些重构是vector<bool>,有些就是很多bool参数)来表明一个row中哪些field是需要被返回到结果集中的。不需要的就用false。
发表评论
要发表评论,您必须先登录。