【原创】3. MYSQL++ Query类型与SQL语句执行过程（非template与SSQLS版本）
我们可以通过使用mysqlpp:: Query来进行SQL语句的增删改查。
首先来看一下mysqlpp::Query的一些最简单的调用，
conn.connect(mysqlpp::examples::db_name, "127.0.0.1", "root", "root");
mysqlpp::Query query = conn.query("select item from stock");
mysqlpp::StoreQueryResult res = query.store();
// OR
mysqlpp::Query query = conn.query("select * from stock");
{
mysqlpp::UseQueryResult res = query.use();
while (mysqlpp::Row row = res.fetch_row()) {
// row[0]; 第一列
}
}
在mysqlpp::Connection.query( )方法中，他其实是这样调用的。
MYSQL++ 的mysqlpp::Query类型
请注意，这里的Query居然继承了std: :ostream！这个是为什么？
我认为，这样做的一个好处是，可以运用如下的方式
mysqlpp::Query q(0);
q << mysqlpp::quote << “test”;
当然，mysqlpp::quote是一个enum【在mani.h中定义】，这里有很多技巧，放在专门的“escape与quote”相关内容中介绍。
- 用法
首先需要说明的是，通常情况下，APP并不会直接创建这个mysqlpp::Query对象，而是call mysqlpp::Connection::query() to get one tied to that connection.
该类型提供了一些能够执行select,insert等SQL语句的方法。有下面几种方法来执行一句SQL语句
- pass a SQL statement in either the form of a C or C++ string to one of the exec*(), store*(), or use() methods
- build up the query string over several C++ statements using Query's stream interface.
- "template queries"，This is something like C's
printf()function. You call the parse() method to tell the Query object that the query string contains placeholders. - Use Specialized SQL Structures (SSQLS) to manipulate the db only by data structure.
Query有一些最基本的用法，包括
- 直接利用已经拼凑好了的SQL语句调用mysqlpp::Query::exec*()，mysqlpp::Query::store()或者mysqlpp::Query::use()
- 使用ostream接口，像构造cout一样构造SQL语句，然后再调用mysqlpp::Query::exec*()，mysqlpp::Query::store()或者mysqlpp::Query::use()
- 类似于printf一样使用template queries
- 类似于Hibernate那样使用Specialized SQL Structures feature(SSQLS)
这里只介绍最简单的两个情况，template queries和SSQLS的原理放到其他章节。
仔细来看一下Query提供的各个重要方法的重构方式（类似的方法族还有store）
- 首先关注参数
1）
UseQueryResult mysqlpp::Query::use (const char * str, size_t len ）
该方法主要是我们已经有了一个已经”成熟“的SQL语句，类似于，我们在UI工具上已经打好了，然后贴过去的那种，这种语句必须要已经经过了escape等转义工作，MYSQL++内部并不做进一步的转义操作。
2）
UseQueryResult mysqlpp::Query::use ( const SQLTypeAdapter & str )
SQLTypeAdaper就是这个可以将普通的，未经过转义的SQL语句，或者如果“基本语句”（就是上面mysqlpp::Connection.query()传入的char*)是一个template query，那么可以将某个int，double等转义为可以供底层API所使用的string形式的工具类。（例如，如果update set a = 'sth' , 在这个sth周围就需要加上引号，而我们所传入的可能就是这个“sth”）
所以这个方法的工作就是将原始的SQL字符串 str 转换为可以供底层API所使用的字符串
3）
UseQueryResult mysqlpp::Query::use ( SQLQueryParms & p )
SQLQueryParms是一个为了template query而准备的PARAM相关的类型，例如，如果有类似于这样的sql template 语句（可能和实际的MYSQL++用法不一致，只是表意）
select * from where id = %d, name = ‘%s’.
则我们可以这样设置SQLQueryParms
SQLQueryParms sqp;
sqp << 1 << "root";
4）
UseQueryResult mysqlpp::Query::use ( )
这个方法就是使用“基本语句”进行逐条执行。
- 再来关注返回值
为了讲述方便，我们先来看一下在result.h（Declares classes for holding information about SQL query）中所定义的各种类型的关系。这几个类型不在这里做仔细介绍，可以查看相关章节。
1）
bool exec(const std::string& str);
这里返回的是bool，表示的是“语句是否执行成功”，我认为适合于那种update, delete，insert，且都不关心有多少rows被touch的情况。
2）
SimpleResult execute();
这里的SimpleResult正如其名，其中只有如下信息
-
the last value used for an AUTO_INCREMENT field
（ulonglong insert_id() const） -
the number of rows affected by the query
（ulonglong rows( ) const） -
any additional information about the query returned by the server（const char* info( ) const）
3)
UseQueryResult use();
由于use的语义类似于使用游标，也就是支持一行一行地拉出内容，所以UseQueryResult 也就自然而然地支持一些关于fetch row的功能。
4)
StoreQueryResult store();
StoreQueryResult它本身就是从vector<Row>继承而来，所以它就是vector。所以用户程序可以直接使用下标的形式来获取所有的ROW。这也就是说在这个store之后，所有的ROW的内容都在了这个vecor<Row>里面了。
- for_each，store_if，storein，storein_set，storein_sequence
这些方法都是模仿STL中的<algorithm>里面的迭代器的处理函数，具体可以看看文档。
- insert，update，insertfrom，replace，replacefrom
这些方法都是给SSQLS所使用的。
2. 实现
1) insert policy
首先我们看到了在mysqlpp::Query类型的一开始，就在private定义下面定义了一个#include
通过查看这个头文件，他定义了一系列的辅助类型，他们控制着在哪些条件下ROW是可以被插入的。文档中说，这些类型都是为SSQLS服务的（核心作用是在Query::insertfrom() ）
他们的核心方法是一个叫做can_add的方法
- RowCountInsertPolicy——如果当前已经插入的rows查过了某个threshold，那么can_add就返回false
- SizeThresholdInsertPolicy——如果当前想要插入的row的大小大于预设的threshold，那么can_add就返回false
- MaxPacketInsertPolicy——如果当前已经插入的rows的总体的大小查过了某个threshold，那么can_add就返回false
2） 最简单的实现流程（普通query，而非SSQLS或者template query）
我们假设有如下的调用Query代码
conn.connect(mysqlpp::examples::db_name, "127.0.0.1", "root", "root");
mysqlpp::Query query = conn.query("select item from stock");
mysqlpp::StoreQueryResult res = query.store();
mysqlpp::Query query = conn.query("select item from stock");
当代码进入到Connection::query的时候，该函数实际上在栈上新添了一个mysqlpp::Query对象，此时调用的构造函数是
需要注意的是两个变量
- sbuffer，他是一个std::stringbuf，用来存储assembled query。另外，init和imbue方法都是std::ostream的方法。
- template_defaults，这是一个SQLQueryParms，这个变量实际上视为template query做准备的，他用作“default template parameters, used for filling in parameterized queries”
注意看到上面的红色框中的内容
- 初始化列表中的内容都会在进入构造器之前完成，所以如果有类型在初始化列表中被构造（如下面的a(1)，和上面例子中的template_defailt(this)），编译器都会在包含类型构造之前先行构造。（我原来以为，被一个包含类型只会被调用无参默认构造函数，其实可以在成员初始化列表中调用其他构造函数）
如果有如下代码
class A
{
public:
A(int i) { cout << "in cons A " << i << endl；}
}
class B
{
public:
B() : a(1) { cout << "in cons B" << endl；}
private:
A a;
}
- 根据上面的理论，template_defaults(this)，实际上是调用了SQLQueryParms(Query * q)这个构造函数来构造SQLQueryParms.
- 其他的都是将sql语句加入到sbuffer中。但是需要注意的是上面提到的imbue用法，我们需要使用的是最通用的locale。
query.store( );
- AutoFlag其实就是一个RAII，在构造函数中将 template_defaults.processing_ 置为 true，在析构函数中将其置为false
- Query: ：store有以下四个不同的overload，具体的不同点请参看上文，以下四者殊途同归，最终调用的都是最后一个版本
StoreQueryResult store();
StoreQueryResult store(SQLQueryParms& p);
StoreQueryResult store(const SQLTypeAdapter& str);
StoreQueryResult store(const char* str, size_t len);
再来看一下Query: ：str( SQLQueryParms)的源代码
先解释一下什么是parse_elems_，他的定义是 std::vector<SQLParseElement> parse_elems_; 表示 List of template query parameters
所以很显然，在我们的这一章节所关注的用法中，Query:: str( SQLQueryParms& )直接返回的就是sbuffer_.str( ），也就是构造Query时候所传入的SQL语句。
当回到Query:: store( )的时候，该方法直接调用的就是Query:: store(const SQLTypeAdapter& )，其中str的返回值（string）到SQLTypeAdapter是隐式转换并进行构造的（因为SQLTypeAdapter有一个以string为param的构造器）
该方法又会调用最为核心的store版本。StoreQueryResult store(const char* str, size_t len);（else里面的那句）
该版本其实也不难理解，
523行到530行这一段是对template query的处理，这里不涉及，先略过。
从531行开始然后就是调用DbDriver的exec( )方法进行SQL语句执行，并通过DbDriver:: store_result( ) 方法获取表示结果集的 MYSQL_RES。
536行开始，针对res的结果进行处理，这里强调区分了SQL语句无返回值和SQL语句执行失败（res返回的是null，但是sql_error==0）两种情况。
对于非template query，需要做的是直接reset(调用Query:: reset( ))，然后构造一个StoreQueryResult返回
最后来说一下这个Query:: reset( )函数
该方法直接将ostream的buffer放空，并调整指针位置，重置所有的变量，防止下一次的执行情况和这一次的冲突。
最后需要说明的一点是，对于MYSQL C API而言，需要返回结果行的语句（如select)和不需要返回结果行的语句（如insert, delete)都是通过mysql_query( )函数进行的，所以其实在mysqlpp:: Query类型中，store( )和execute( )系列方法在最终执行上是一致的，即都是通过调用DbDriver:: execute(const char* qstr, size_t length)进行的。所以store( )和execute( )的唯一区别在于store( )其实最终返回的是带有结果的 StoreQueryResult类型，而execute( )返回的是 SimpleResult
原创作品，转载请注明出处www.cnblogs.com/aicro。