Linux mysql C 编程——connector/c

Linux Mysql C

使用C语言编写mysql客户端程序，即使用mysql提供的api，对mysql进行访问。基础的API对封装自己的DB访问框架来说就是一砖一瓦。

开始使用API前

在编程语言和mysql数据之间实现通信的组件就是Connector。Mysql针对许多语言都提供了connector。可以说connector是一个库，是上面提到的API的载体。要使用api进行数据库操作，就需要先安装connector

原则上，不需要机器先安装mysql-client或者mysql-server，因为可能使用API是为了与远程机器通信，与本机mysql数据库无关。

首先要从mysql官网下载connector，http://dev.mysql.com/downloads/connector/c/
针对本机系统选择版本下载，以Compressed TAR Archive版本为例，这里已经是编译好的mysql connector。
下载后解压缩，相应的会有几个文件夹：bin/,include/,lib/，分别将里面的文件放到/usr/bin/,/usr/include/mysql, /usr/lib/mysql
这里存放的路径不是绝对的，只是我个人的习惯，在编译我的mysql客户端程序时会指定include和lib。

到这里，其实就可以说connector安装好了，很简单，因为就是一些头文件和链接库，我们需要它们（API）来编写我们的mysql客户端程序。

开始使用API

mysql connector api比较多，基础的是以下这些：

• mysql_library_init: 在其他api调用前调用，在多线程环境不能省略，因为其不是线程安全的，在产生线程之前调用。
• mysql_library_end: 与mysql_library_init对应，所有API都调用结束后调用。
• mysql_init: 产生一个MYSQL结构体（mysql核心数据结构）实例，会自动调用mysql_library_init，所以也不是线程安全的。
• mysql_close：断开连接，释放由mysql_init产生的MYSQL结构体实例
• mysql_real_connect:连接数据库
• mysql_real_query和mysql_query：前者需要指定SQL statement及其长度，后者不用指定长度，而是更具\0来判断。mysql_real_query适合于二进制数据（可能带有null，\0）
• mysql_store_result(): 针对SELECT，将数据一次性加载放入内存，可以seek(通过mysql_row_seek)，可以获得行数(mysql_num_rows())
• mysql_use_result：针对SELECT，不一次性拿到，避免内存消耗过大，不支持随即访问和获取行数等。
• mysql_fetch_row：从mysql_store_result或mysql_use_result返回的MYSQL_RES结构体实例中获取一行数据 MYSQL_ROW结构体
• mysql_affected_rows：针对INSERT,UPDATE,DELETE

从流程上理解这些基础API会更好
初始化 =>建立连接 => 执行SQL语句 => 获取结果集（针对不同的SQL操作，获取不同数据） => 遍历结果集，以行的形式(也可以是随机访问) => 关闭连接 => 清理资源

编程实例

/*
 * main.cpp
 */
#include "mysql.h"
#include <cstdlib>
#include <cstdio>

int main()
{
    MYSQL mysql;
    MYSQL_RES *res;
    MYSQL_ROW row;
    char sql[100];

    mysql_library_init(0, NULL, NULL);
    mysql_init(&mysql);

    if (!mysql_real_connect(&mysql,"localhost","root","root","test",0,NULL,0)){
        fprintf(stderr, "无法连接到数据库，错误原因：%s\n", mysql_error(&mysql));
    }

    else {
        fprintf(stdout, "连接数据库成功\n");
        sprintf(sql, "insert into students(name) values('eric')");
        mysql_query(&mysql, sql);
        sprintf(sql, "select name from students");
        int t = mysql_query(&mysql, sql);
        if (0 != t) {
            fprintf(stderr, "查询数据库失败%s\n", mysql_error(&mysql));
        }
        else {
            res = mysql_store_result(&mysql);
            while (row = mysql_fetch_row(res)) {
                for (int r = 0;r < mysql_num_fields(res); r++) {
                    printf("%s\n", row[r]);
                }
            }
        }

    }
    return 0;
}

编译链接执行

g++ -c -I /usr/include/mysql src/main.cpp 
g++ -o main main.o -L /usr/lib/mysql -lmysqlclient
./main

可以看到数据库中数据插入成功
终端输出插入的字段 eric