该类型是SQLBuffer的灵魂,它用来表示从SQL TYPE到C++ TYPE的相互转变。该类型被定义在type_info.h中。在这个头文件中,其实定义了三个类型,其中前两个都是在mysql_type_info中所使用的utility类型。
1. mysql_ti_sql_type_info
该类型其实更多地保存mapping信息的数据结构,其核心的成员变量是
const char* sql_name_; // SQL类型的字符串描述,例如"TINYINT NOT NULL", "SMALLINT NOT NULL"等
const std::type_info* c_type_; // C++ type,例如typeid(float), typeid(int)
const enum_field_types base_type_; // SQL type, 被定义在mysql_com.h中的enum_field_types的常量,例如MYSQL_TYPE_FLOAT, MYSQL_TYPE_DOUBLE
const unsigned int flags_; // 自定义标志,是tf_default、tf_null、tf_unsigned的“或”的结果
另外,该类型还提供了一些查询方法,例如
值得注意的一点是,这个类型在mysql_type_info中被typedef了,
可以看到,types[]是mysql_type_info种的一个静态数组,让我们来看一下对应的cpp文件中的定义。
顺便说一句,sql_tinyint,sql_decimal等都被typedef了(在sql_types.h中),例如sql_tinyint_unsigned其实就是tiny_int<uint8_t>,而sql_int其实就是MYSQL C API所定义的int32_t。
显然,这里的定义与我们刚才所分析的各个成员变量的作用是吻合的。
2. mysql_ti_sql_type_info_lookup
从名字上来看,这个类型是lookup mysql_ti_sql_type_info类型(该类型在mysql_ti_sql_type_info_lookup和mysql_type_info中都被typedef为sql_type_info类型)。
其实,在这个lookup类型中,核心的东西只有一个,即
这个map说穿了,就是将C++ type(std::type_info*)与其所对应的,在刚才所说的在mysql_ti_sql_type_info中提到的types数组的下标形成对应关系。例如
上面的代码中提到的types[]中的第三个 ”TINYINT UNSIGNED NOT NULL”,则,在这个map_type中,就有这样的对应pair
[ key == typeid(sql_tinyint_unsigned), values == 2 ]
那么为什么刚才的map定义中value类型是unsigned char而不是unsigned int 呢?节约吧。
那么在mysql_type_info中到底是如何查找的呢?查看一下mysql_type_info的其中的一个构造函数就可以看到,
而lookups是什么?请看mysql_type_info中的成员变量部分,
同时,当我们查看mysql_ti_sql_type_info_lookup的构造函数,我们发现
换言之,在为static lookups进行定义的时候就已经生成了那个map。
最后,回到原来的问题,即怎么lookup法?
从mysql_type_info的上面贴出来的构造函数上来看,貌似用的是index的方法(使用operator [ ] ),的确,看了代码就是overwrite了operator [ ],在其中对这个map进行了查找,然后返回的也正是那个C++ type在表示“所有映射C++类型与SQL类型映射关系”的表(上文中的types数组)的下标索引。
3. mysql_type_info
刚才说了那么多,其实就是为了这个核心类型做准备的,文档上面说,该类型是“Used within MySQL++ for mapping SQL types to C++ types and vice versa”。从刚才的分析上来看,SQL TYPE就是在原生MYSQL C API中所定义的enum_field_types中的内容(被定义在MySQL Connector C 6.1 6.1.2includemysql_com.h中),而C++ types就是原生态的C++数据类型(int ,long, short等),还有MYSQL++自己定义的数据结构(struct或者class),比如tiny<T>,NULL<T>等。
具体来说,mysql_type_info如何做到“SQL types to C++ types and vice versa”的?关键在与看构造函数
- SQL Type –> C++ type
- C++ type –> SQLType
上面的lookups[t]之前已经介绍过了,现在来看一些type( )的实现
还是遍历types数组(上文中反复提到的表示“所有映射C++类型与SQL类型映射关系”的表)啊!
那么,这种信息到底是怎么被存储的?从构造函数上来看,貌似只是一个num_,也就是只是保存了types数组的下标而已。其实也很容易理解,types数组是一个静态的变量,一直在保存全局变量的section里面(具体叫什么已经忘记了……以前在《程序猿的自我修养》里面有见过),所以保存个下标即可。
再来一个问题,刚才只说了,如果构造这个mysql_type_info,那么还是没有说清楚如何“SQL types to C++ types and vice versa”,下面来说一下当mysql_type_info被构造完成,要开始具体用的时候该如何使用了。
- SQL type –> C++ type
- 先使用构造器mysql_type_info(enum_field_type, …)构造出mysql_type_info
- 调用mysql_type_info:: c_type( )
该函数只有一句话,即return *(types[num_].c_type_)。还记得types是mysql_ti_sql_type_info类型的数组嘛?回到第一点就什么都清楚了。
- C++ type –> SQL type
- 先使用构造器mysql_type_info(const std::type_info& t)构造出mysql_type_info
- 调用mysql_type_info:: base_type( )
该函数只有一句话,即return mysql_type_info(types[num_].base_type_)。为什么又是return一个mysql_type_info?不是说好的SQL type吗?我估计作者的用意是尽可能避免外部知道这个SQL type,所以尽所能隐藏它。同时在这个mysql_type_info:: base_type( )的注释里我们可以看到这样的话。
Returns the type_info for the C++ type inside the mysqlpp::Null type. If the type is not Null then this is the same as c_type().
这句话什么意思?让我们再来看看base_type( )中所调用的mysql_type_info的一个构造函数
这样我就懂作者那句英文的意思了。
最后一个问题,在escape和quote中,如何判断一个mysql_type_info类型是需要quote还是需要escape?