Mysql入门系列：MYSQL客户机程序4—在运行时获取连接参数

　　 6.5 客户机程序4在运行时获取连接参数

　　现在我们有了容易修改的防止出现错误的连接代码，我们要了解一些如何做某些比使用NULL 连接参数更灵巧的事情，如在运行时允许用户指定一些值。客户机程序3由于固定连接参数方面的缺陷，要想更改那些值中的任何一个，都必须编辑源文件并重新编译。这十分不方便，特别是想使程序用于其他人时。在运行时指定连接参数的一个通用的方法是使用命令行选项。MySQL分发包中的程序接受两种形式的连接参数，如表6 - 1所示。

　　与标准的MySQL客户机程序一致，客户机程序将接受同样的格式。这很容易，那是因为客户机库包括了实现选项分析的函数。

　　除此之外，客户机程序具有从选项文件中抽取信息的能力。这允许将连接参数放在-/.my. c n f（也就是主目录中的.my.cnf 文件）中，以便不用在命令行中指定它们。客户机库使检查MySQL选项文件和从它们中抽取任何相关的值变得非常容易。只在程序中增加几行代码，就可以使选项文件识别它，并且通过编写自己的代码而不必重新改造这个框架来进行操作。附录E MySQL程序参考中说明了选项文件的语法。

　　6.5.1访问选项文件内容

　　使用load_default() 函数为连接参数值读取选项文件， load_default() 寻找选项文件、分析任何感兴趣的可选组的内容，以及重新编写程序的参数向量（ a rgv[] 数组），以便把来自于那些组的信息以命令行选项的形式放置在argv[] 的开头。这就是说，在命令行指定出现的选项。因此，当分析命令选项时，就得到了作为常规选项分析循环部分的连接参数。选项加到argv[] 的开头而不是加到末尾，所以，如果连接参数真的在命令行指定，它们要比load_defaults() 增加的任何选项晚一些出现（因而忽略）。面的小程序show _ argv 显示了如何使用load _ defaults ( )，并举例说明了对参数向量如何做出这样的修改：

　　该处理选项文件的代码包括：

　　■ groups[] 是一个字符串数组，表示所感兴趣的选项文件组。对于客户机程序，始终至少指定client （[client] 组）。数组的最后一个元素必须是NULL。

　　■ my_init() 是load_defaults() 所需的执行一些设置操作的初始化例程。

　　■ load_defaults() 有四个参数：选项文件的前缀（这里应该始终是 my），列出感兴趣的可选组的数组、程序参数的数目和向量的地址。不传数目和向量的值，而是传地址，因为load_defaults() 需要改变它们的值。特别注意的是，虽然a rgv 是一个指针，但还是要传& argv ，它是指针的地址。

　　show _ argv打印参数两次，第一次是在命令行指定它们的时候，第二次是在load _ defaults( )修改它们的时候。为了查看load_defaults() 的运行效果，应确信在主目录中有一个具有[client] 组指定设置的. my.cnf 文件。假设. my.cnf 文件如下：

　　有可能会从不在命令行或~ /.my.cnf 文件中的s h o w _ a rgv 所产生的输出结果中看到一些选项。如果是这样，它们或许是在系统范围的选项文件中指定的。在主目录中读取.my.cnf 之前，load_defaults() 实际上是在MySQL数据目录中寻找/ e t c / my.cnf 和my.cnf 文件（在Windows中， load_defaults() 在Windows 系统目录中寻找文件C : my. c n f、C : mysql d a t a my.cnf 和my.ini ）。

　　使用load_defaults() 的客户机程序几乎始终是在选项组列表中指定 c l i e n t（以便从选项文件中获取任何通用的客户机设置），但是也可以为请求自己的程序请求特定值。可将下列代码：

　　修改为：

　　然后将[ show _ argv] 组加到~ / . my.cnf 文件中：

　　有了这些改变，再次调用show _ argv 就得到了一个不同的结果，如下所示：

　　参数数组中选项值出现的顺序取决于它们在选项文件中列出的顺序，而不是选项组在group[] 数组中列出的顺序。这意味着将可能在选项文件的[client] 组之后指定程序专有的组。即如果在两个组中都指定了一个选项，程序专有的值将有更高的优先权。在这个例子中可以看到： 在组[client] 和[ show _ argv] 中都指定了host 选项，但是因为组[ show _ argv] 在选项文件的最后出现，所以host 值将在参数向量中出现并取得优先权。

　　load_defaults() 不是从环境设置中提取值， 如果想使用环境变量的值， 例如MYSQL _ TCP _ PORT 或者MYSQL _ UNIX _ PORT ，就必须使用getenv() 来自己管理。我不想把这个管理能力增加到客户机中，但这里有一个例子，介绍了如何检查几个标准的与MySQL有关的环境变量值：

　　在标准MySQL客户机中，环境变量值的优先权比在选项文件或命令行指定值的优先权要低。如果检查环境变量的值，并要与约定保持一致，那么就要在调用load_default() 或者处理命令行选项之前（不是之后）检查环境。

　　6.5.2 分析命令行参数

　　现在我们可以把所有的连接参数都放入参数向量，但需要一个分析该向量的方法。getopt_long() 函数就是为此目的设计的。getopt_long() 设在MySQL客户机库的内部，因此，无论什么时候与库连接都可以访问它。源文件中要包含getopt.h 头文件，可以把这个头文件从MySQL源分发包的include 目录拷贝到正在开发的客户机程序所在的目录中。

　　load_defaults() 与安全

　　因为有些程序（如p s）可以显示任何过程的参数列表， load_defaults() 将口令的文本放在参数列表中，所以您可能对它处理窥探的含意表示惊异。这没有问题，因为ps 显示原始的a rgv[] 内容，由load_defaults() 创建的任何口令参数都指向为它自己分配的区域，这个区域并不是原始区域的一部分，所以ps 看不见它。另一方面，除非故意清除，否则在命令行指定的口令会在ps 中出现。6 . 5 . 2节分析命令行参数介绍了如何去做。下面的程序show_param 使用load_defaults() 读取选项文件，然后调用getopt_long() 来分

　　析参数向量。show_param 举例说明了通过执行以下操作参数处理的每个阶段发生了什么：

　　1) 建立主机名称、用户名称和口令的缺省值。

　　2) 打印原始连接参数和参数向量值。

　　3) 调用load_defaults() 重新编写参数向量，反映选项文件内容，然后打印结果向量。

　　4) 调用getopt_long() 处理参数向量，然后打印结果参数值和参数向量中的剩余部分。

　　show_param 允许使用各种指定的连接参数的方法进行试验（无论是在选项文件中还是在命令行中），并通过显示使用什么值进行连接来查看结果。当实际上我们把参数处理代码与连接函数do_connect() 连到一起时，show_param 对于预知下一个客户机程序将要发生什么是很有用的。

　　以下是show_param.c 的代码：

　　为了处理参数向量， show _ argv() 使用getopt_long() ，它在循环中调用：

　　getopt_long() 的前两个参数是程序的计数参数和向量参数，第三个参数列出了要识别的选项字符。这些是程序选项的短名称形式。选项字符后可以有冒号、双冒号或者无冒号，表示选项值必须跟在选项后面、可以跟在选项后面或者不能跟在选项后面。第四个参数long_options 是一个指向可选结构数组的指针，每个可选结构为程序需要支持的选项指定信息。它的目标与第三个参数的可选字符串相类似。每个long_options[] 结构有四个元素，其描述如下：

　　■ 选项的长名称。

　　■ 选项值。这个值可以是required _ argument、optional _ argument 或者no _ argument，表明选项值是必须跟在选项后面、可以跟在选项后面，还是不能跟在选项后面（它们与第三个参数选项字符串中的冒号、双冒号或无冒号的作用相同）。