首页mysqlmysql++ › 8. MYSQL++中的Row类型

8. MYSQL++中的Row类型

一、mysqlpp::Row类型

在之前的介绍中我们看到了如何通过mysqlpp::Query找到各种Result类型,然后又仔细分析了各种Result类型又是如何生成对应的Row类型(如下所示)。

300956247812726

接下去的问题就是,到底mysqlpp::Row是什么。

1. Row类型的使用(先不提SSQLS)

还是先来看如何使用这个Row类型,照样是通过sample程序。

OR

上面的例子中提到的两种最为基本的用法,主要就是查看每行数据的各个列的不同方式。至于查找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相关的迭代器,反响迭代器,引用迭代器,元素类型值,元素类型长度等信息。

  • 成员方法

首先来看各种构造方法和等号赋值方法。

主要定义了两种构造器
300956256097839
300956267811382
300956276413954
主要看一下在本节一开始的实例中所使用的第二个构造器。
300956291875681

首先我们看到的是使用一个initialized_进行构造成功与否的保护,估计在之后所有的方法上都会先对这个变量进行查询,如果是false直接返回错误或者抛出异常。

其次,是对于data_(一个vector<String>类型)的初始化和填充,需要注意的是第45行。value_type是这样定义的,也就是一个vector<String>::value_type
300956298121324

查看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( )方法,定义是
300956302038036
又出现了熟悉的value_type,那么FieldTypes是什么呢?
300956306253208

又回到了之前介绍过的mysql_type_info。这样子即使你没有看过String的构造函数,你也已经很明白了,这个String很神通广大,他居然能够知道值以及具体的类型!也就是说,MySQL++就用了一个String包装了MYSQL C API中的行信息和行所对应的列的信息。

接下来在52行把所有的field_names的信息传递给了mysqlpp::Row的成员变量field_names_,所有都已经成功了之后,就大胆地设置初始化标志为true。

再来分析一下在mysqlpp::Row中delegate  std::vector的方法
300956323918635
300956333125721
300956338752149

不多说,完全就是delegate,只不过原来一直没有注意过一点的是,vector<T>:: begin( )居然被定义了两个版本(只怪自己学艺不精)

当然,上面用的版本都是非const版本,这是因为data_被定义为vector<String>没有带const,但是返回值都是const的!

顺带便说一下,const_reference以及const_iterator的定义
300956343129548
300956348444220
还有就是
300956357973062

获取Row中Field值的方法

从上面的例子中我们可以简单的看到,要获取一行数据的值还是很简单的,主要的方法就是通过operator [ ]

方法一,通过index查找Row中对应的field的值
300956367813660

再来说明一下上面提到的为什么该参数一定要是int而不是size_type的问题。下文我们可以知道,作者重载了一个operator[](char*)。如果出现了row[0]或者row[NULL](假设这个平台将NULL定义为0),我们有理由说编译器会搞不清楚到底你要的是size_type还是char*,毕竟我们同样可以把NULL赋值给char*。但是如果有了int,由于0是int型,所以会被匹配到这里。

这里的at方法还是很简单的。
300956376727988
方法二,通过field的字符串形式的name来查找Row中对应的field的值
300956386411060
300956395785672
其中field_num方法的定义如下
300956400787586
该函数的实现代码如下,
300956410623887
需要注意的是划红色圈的地方,这里其实调用的是mysqlpp:: FieldNames(一个派生自vector<string>的类型)的operator[ ]的重载方法
300956415006585
300956424535427

以下这些方法是用于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。

发表评论