MySQL API使用详解

连接数据库步骤

1.初始化连接环境
2.连接 mysql 的服务器，需要提供如下连接数据:
	● 服务器的 IP 地址
	● 服务器监听的端口（默认端口是 3306）
	● 连接服务器使用的用户名（默认是 root），和这个用户对应的密码
	● 要操作的数据库的名字
3.连接已经建立，后续通过调用API执行一个sql语句对数据库进行增删改查
4.如果要进行数据的添加/删除/更新，需要进行事务的处理
	● 执行成功则提交事务
	● 执行失败则进行数据回滚

5.数据库的读操作 -> 查询 -> 得到结果集
6.遍历结果集 -> 得到了要查询的数据
7.释放资源

//头文件
#include <mysql.h>

//初始化数据库，参数mysql默认为null，成功则返回新对象
MYSQL *mysql_init(MYSQL *mysql)

//连接MySQL服务器，成功返回MYSQL*连接句柄(类似与实例或对象)，失败返回NULL
MYSQL *mysql_real_connect(
    MYSQL *mysql,               //mysql_init()函数的返回值
    const char *host,           //mysql服务器的主机地址, 写IP地址即可，localhost, null -> 代表本地连接
    const char *user,           //连接mysql服务器的用户名, 默认: root 
    const char *passwd,         //连接mysql服务器用户对应的密码, root用户的密码
    const char *db,             //要使用的数据库的名字
    unsigned int port,          //连接的mysql服务器监听的端口,如果==0, 使用mysql的默认端口3306, !=0, 使用指定的这个端口
    const char *unix_socket,    //本地套接字, 不使用指定为 NULL
    unsigned long client_flag)  //通常指定为0

//执行sql语句, 成功返回0并存储至MySQL对象中，失败返回非0值
//mysql: mysql_real_connect() 的返回值
//query: 一个可以执行的sql语句, 结尾的位置不需要加 ;
int mysql_query(MYSQL *mysql, const char *query)

//将结果集从mysql(参数)对象中取出，保存查询后的结果集至MYSQL_RES对应的一块内存中，失败返回NULL 
MYSQL_RES *mysql_store_result(MYSQL *mysql)

//返回结果集中的列数
unsigned int mysql_num_fields(MYSQL_RES *result)

//通过这个函数得到结果集中所有列的名字，返回MYSQL_FIELD*指向一个结构体数组
//例如：	MYSQL_FIELD* fields = mysql_fetch_fields(res);
//		int num = mysql_num_fields(res);
//		for(int i=0; i<num; ++i)
//		{
//		    printf("当前列的名字: %s\n", fields[i].name);
//		}
MYSQL_FIELD *mysql_fetch_fields(MYSQL_RES *result)

//查询返回结果集内当前行的列的长度，成功返回无符号长整数的数组表示各列的大小，失败返回NULL。
unsigned long *mysql_fetch_lengths(MYSQL_RES *result)

// 遍历结果集的下一行，如果想遍历整个结果集, 需要进行循环调用，成功返回当前记录中每个字段的值，失败返回NULL，说明已经读完
//返回值是二级指针, char** 指向一个指针数组, 类型是数组,里边的每个元素都是指针，char* []中的字符串对应的一列数据
typedef char** MYSQL_ROW
MYSQL_ROW mysql_fetch_row(MYSQL_RES *result)

// 释放结果集
void mysql_free_result(MYSQL_RES *result)

// 关闭mysql实例
void mysql_close(MYSQL *mysql)

// 获取api默认使用的字符编码
const char *mysql_character_set_name(MYSQL *mysql)

// 设置api使用的字符集，csname就是要设置的字符集 -> 支持中文: utf8
int mysql_set_character_set(MYSQL *mysql, char *csname)

//提交事务，“1”为自动提交，“0”为手动提交，成功返回0，失败返回非0
my_bool mysql_autocommit(MYSQL *mysql, my_bool mode) 

//事务提交，成功返回0，失败返回非0
my_bool mysql_commit(MYSQL *mysql)
    
// 数据回滚，成功返回0，失败返回非0
my_bool mysql_rollback(MYSQL *mysql)

// 返回错误的描述
const char *mysql_error(MYSQL *mysql)

// 返回错误的编号
unsigned int mysql_errno(MYSQL *mysql)

MYSQL* mysql = mysql_init(NULL);
mysql = mysql_real_connect(mysql, "localhost", "root", "passwd", "wzz_DB", 0, NULL, 0);
mysql_set_character_set(mysql, "utf8");
const char* sql = "select * from dept";
int ret = mysql_query(mysql, sql);
if(res == NULL)
{
	printf("mysql_store_result()失败了, 原因: %s\n", mysql_error(mysql));
	return -1;
}
int num = mysql_num_fields(res);  //得到结果集中的列数
MYSQL_FIELD * fields = mysql_fetch_fields(res); //得到所有列的名字, 并且输出
for(int i=0; i<num; ++i)
{
	printf("%s\t\t", fields[i].name);
}
MYSQL_ROW row;
while( (row = mysql_fetch_row(res)) != NULL)  //遍历结果集中所有的行
{
	for(int i=0; i<num; ++i)
	{
		printf("%s\t\t", row[i]);
	}
	printf("\n");
}
mysql_free_result(res);  //释放结果集
mysql_autocommit(mysql, 0); //写事务，以下两条对应的是一个事务，设置事务为手动提交
int ret1 = mysql_query(mysql, "insert into dept values(61, '海军', '圣地玛丽乔亚')");
int ret2 = mysql_query(mysql, "insert into dept values(62, '七武海', '世界各地')");
if(ret1==0 && ret2==0 && ret3==0)
{
	mysql_commit(mysql);  //提交事务
}
else
{
	mysql_rollback(mysql);  //数据回滚
}
mysql_close(mysql);  //释放数据库资源