【原创】modb 功能设计之“支持部分MySQL客户端协议”-2
在 《 modb 功能设计之“支持多消费者单生产者” 》中说到：需要有一个单独的线程来处理 sql 语句。本文就针对“ 支持部分 MySQL 客户端协议”做第二部分讲述。主要是 MySQL 官网文档中关于 Connector/C 的研究。
首先看看有哪些资源：
1. MySQL 官网 【MySQL Connectors】->【Connector/C (libmysqlclient)】
Connector/C (libmysqlclient) is a client library for C development.官网对 MySQL Connector/C 的 完整文档描 述参考 这里 。 重点内容摘录翻译如下
===
【22.5. MySQL Connector/C】
MySQL Connector/C 是一个客户端库，提供了用于客户端/服务器通信的 C API 。其可作为单独组件替代 MySQL Server 发布版本中带有的 MySQL 客户端库。
使用 MySQL Connector/C 的理由：
- 如果你仅需要使用客户端库提供的功能，MySQL Connector/C 提供了你所需的一切。没有必要源码编译或安装 MySQL Server 包来获取相关功能。
- MySQL Connector/C 不依赖 MySQL Server 的发布周期。bug 修复和新特特性添加均可独立于 MySQL Server 的发布。
【22.5.1. MySQL Connector/C Versions】
目前存在如下 MySQL Connector/C 版本：
- MySQL Connector/C 6.1：基于当前（5.6）MySQL 源码中的 C API 部分生成，并且与 5.6 源码保持同步更新。
- MySQL Connector/C 6.0：最初从 MySQL 的源码树分支上创建，但目前相较于那条源码树分支上的 C API 内容已经过时。
- 支持可插拔鉴权框架，即可以插件形式支持各种鉴权方法。该框架既可被用作 MySQL 本地鉴权方式，又可用作外部鉴权方式。
- 支持客户端侧 SHA-256，PAM 和 Windows 本地鉴权插件。老的 Connector/C 6.0 仅能使用本地 MySQL 密码形式的账号信息来进行连接。如果客户端想要使用一种不同的鉴权方式的账户信息来进行连接，则会受到“当前用户访问被拒绝”的错误。
- 支持 prepared CALL 语句，该功能使得客户端程序，能够在存储过程中处理，产生的多结果集，并获得最终的 OUT 和 INOUT 存储过程参数值。
- 支持 IPv6 连接。
- 支持在连接时，将客户端程序与指定 IP 地址进行绑定。
- 支持在连接时，指定连接属性来告之服务器端。
【22.5.2. MySQL Connector/C Supported Platforms】
下表中给出了 MySQL Connector/C 已经测试过的平台。
Table 22.28. Supported Platforms for MySQL Connector/C 6.1
| Platform |
Versions |
| Windows |
Windows Vista, Server 2008, Server 2012, 7, 8 |
| Linux |
Oracle and RHEL 5, 6; SuSE LES 11; CentOS 5, 6; Fedora 15, 16; OpenSuSE 12.1; Debian 6; Ubuntu 12.04; generic glibc 2.5-based Linux systems |
| Solaris |
10, 11 |
| Mac OS X |
10.6, 10.7 |
| FreeBSD |
9 |
Table 22.29. Supported Platforms for MySQL Connector/C 6.0.2
| Platform |
Versions |
| Windows |
Windows 2000, XP, Vista, Server 2003, Server 2008 |
| Linux |
RHEL 4, 5; SuSE LES 9, 10; generic glibc 2-based Linux systems |
| Solaris |
8, 9, 10 |
| Mac OS X |
10.4, 10.5 |
| FreeBSD |
6, 7 |
| HP-UX |
11.11, 11.23, 11.31 |
| IBM AIX |
5.3 |
【22.5.3. MySQL Connector/C Distribution Contents】
MySQL Connector/C 6.1 distributions contain the header, library, and utility files necessary to build MySQL client applications that communicate with MySQL Server using the C API.
Distributions are available in binary and source formats. A binary distribution contains the header, library, and utility components discussed following, compiled and ready for use in writing client programs. A source distribution contains the source files required to produce the same headers, libraries, and utilities included in a binary distribution, but you compile them yourself.
MySQL Connector/C 分布包中包含如下组件：
A set of .h header files that C applications include at compile time. These files are located in the include directory.
Static and dynamic libraries that C applications link to at link time. These libraries are located in the lib directory. The library names depend on the library type and platform for which a distribution is built:
Unix（以及 Unix-like）平台上，静态库为 libmysqlclient.a ，动态库为 libmysqlclient.so 。
Windows 平台上，静态库为 mysqlclient.lib ，动态库为 libmysql.dll 。动态库对应的静态导入库为 libmysql.lib 。相应 debug 版本的库在 lib/debug 目录下可以找到。
一些小实用程序。
【22.8.4.1. Building C API Client Programs】
编译 MS Windows 上的 MySQL 客户端程序
- 指定头文件和库文件所在位置。
- 需要额外链接库：ws2_32 和 Secur32 。
- 需要链接静态库（mysqlclient.lib）或者动态库（libmysql.dll）。
链接静态库时，需要注意：
- 客户端应用程序必须使用，与库编译时相同的 VS 版本进行编译。
- 客户端应用程序应该使用编译选项 /MT 来静态链接 C 运行时库。
如果客户端应用程序以 debug 模式构建，并且使用了静态 debug C 运行时库（编译选项为 /MTd ），其可以链接到静态库 mysqlclient.lib ，当且仅当库是采用同样的编译选项编译时。如果客户端应用程序使用动态 C 运行时库（编译选项为 /MD 或者 debug 模式的 /MDd），则必须链接到 libmysql.dll 动态库上，此时不可链接到静态库上。
===
【Changes in MySQL Connector/C 6.0】
【Changes in MySQL Connector/C 6.1】
【Changes in MySQL Connector/C 6.1.2 (2013-09-30)】
添加或者改变的功能：
专门针对 Windows XP 和 Windows Server 2003 的条件变量实现已从源码中移除，因为 MySQL 5.6 决定不在提供上述平台的支持。
注意：上述该表应该做如下理解：Connector/C 6.1 尽管在之前没有被官方声明支持 Windows XP 或 Windows Server 2003，但是确实在上述平台是可用的。但从 6.1.2 版本开始已经不行了。
MySQL 现已支持协议跟踪插件的使用。
通过 VS2008、VS2010、VS2012 生成的静态库现已作为 Windows 平台 Connector/C 包的一部分一同发布。在 lib 目录下的 vs9、vs10 和 vs11 分别包含了使用 VS2008、VS2010、VS2012 构建的静态库和相应的 pdb 文件。
=== 未完待续 ===