三、MySQL客户端应用的开发
MySQL提供了丰富的数据接口API，包括C、C++、Perl、PHP、Python、TCL等API和 JDBC，ODBC接口。出于性能考虑，我们采用了MySQL的CAPI进行开发。现以VisualC++ 环境为例，作一简单介绍。
新建一Win32ConsoleApplication的Project，把“c:\mysql\include”添加到编译选项的包含路径中（在ProjectOptions中加入/I"d:\mysql\include"）。新建一m ain.c文件，主体如下：
#include
#include
#include
#include
intmain(intargc,char*argv[])
{
charszTargetDSN[]="test";
charszSqlText[500]="";
charaszFlds[25][25];
MYSQL*myData;
MYSQL_RES*res;
MYSQL_FIELD*fd;
MYSQL_ROWrow;
inti,j,k;
BOOLbCreate＝TRUE;
if((myData=mysql_init((MYSQL*)0))
//初始化数据结构
&&mysql_real_connect(myData,NULL,
//连接数据库
"root","your_password",szTargetDSN,
MYSQL_PORT,NULL,0))
{
if(bCreate)
{
sprintf(szSqlText,//构造SQL语句
"createtablemytable"
//新建一张表
"(timedatetime,s1char(6),"
"s2char(11),s3int,s4int)");
if(mysql_query(myData,szSqlText))
//执行SQL语句
{//执行SQL语句出错
ErrLog("Can''tcreatetable");
mysql_close(myData);
returnFALSE;
}
｝
sprintf(szSqlText,
"insertintomytable"
//向表中插入数据
"values(''2000-3-1021:01:30'',"
//注意时间的格式
"''Test'',''MySQLTest'',2000,3)");
if(mysql_query(myData,szSqlText))
{//执行SQL语句出错
ErrLog("Can''tinsertdatatotable");
mysql_close(myData);
returnFALSE;
}
sprintf(szSqlText,"select*frommytable");
if(mysql_query(myData,szSqlText))
//进行数据检索
{
//执行SQL语句出错
mysql_close(myData);
returnFALSE;
}
else
{
res=mysql_store_result(myData);
//取得查询结果
i=(int)mysql_num_rows(res);
//取得有效记录数
printf("Query:%s\n%ldrecordsfound:
\n",szSqlText,i);
for(i=0;fd=mysql_fetch_field(res);
i++)
strcpy(aszFlds[i],fd->name);
//取得各字段名
for(i=1;row=mysql_fetch_row(res);)
//依次读取各条记录
{j=mysql_num_fields(res);
//取得记录中的字段数
printf("Record#%ld:-\n",i++);
for(k=0;k
//输出各字段的值
printf("Fld#%d(%s):%s\n",k+1,aszFlds[k],
(((row[k]==NULL)||
(!strlen(row[k])))?"NULL":row[k]));
puts("==============================\n");
}
mysql_free_result(res);
}
}
else
{//连接数据库出错
ErrLog("Can''tconnecttothemysqlserver");
mysql_close(myData);
returnFALSE;
}
mysql_close(myData);
returnTRUE;
}
对其中几个函数作简单说明，详细说明，可参考MySQL文档：
1.MYSQL*mysql_init(MYSQL*mysql)
初始化一个类型为MYSQL的数据结构，为执行mysql_real_connect()做准备。参数 mysql为指向该结构的指针，如果mysql为NULL，则新建并初始化一个MYSQL的数据结构。新建的结构将在mysql_close()中释放。
若成功，返回初始化的MYSQL数据结构的指针，否则返回NULL。
2.MYSQL*mysql_real_connect(MYSQL*mysql,constchar*host,
constchar*user,constchar*passwd,constchar*db,
unsignedintport,constchar*unix_socket,unsignedintclient_flag)
与MySQL数据库引擎建立连接。在执行进一步的数据操作之前，必须保证mysql_re al_connect()成功返回。
参数mysql是mysql_init()的返回值；
参数host是运行MySQL数据库引擎的机器的TCP/IP主机名，如为NULL则默认为“lo calhost”；
参数user和passwd是MySQL数据库的合法用户和口令；
参数db是连接的数据库名；
参数port，unix_socket和client_flag一般取默认值。
3.intmysql_query(MYSQL*mysql,constchar*query)
执行query字符串中的SQL语句，query必须以0结尾。如果成功，返回0。
4.MYSQL_RES*mysql_store_result(MYSQL*mysql)
返回SELECT，SHOW，DESCRIBE,EXPLAIN等语句执行的结果。函数新建一个MYSQL_ RES的数据结构，把结果存储在该结构中。如果查询没有匹配的结果，则返回空数据集。处理完结果集后，必须调用mysql_free_result()。
如果出错，返回NULL，否则返回MYSQL_RES结构的指针。
5.MYSQL_ROWmysql_fetch_row(MYSQL_RES*result)
取回结果集中的下一条记录，如果没有记录或出错，返回NULL。一条记录中的字段数可以用mysql_num_fields(result)获得，各字段的值可以用row[0]到row[mysql_nu m_fields(result)-1]的数组来访问。
在工程的链接选项中，加入c:\mysql\lib\libmysql.lib的接口库，把libmysql.d ll复制到操作系统的system目录下（c:\winnt\system32），就可以编译运行了。
到这里，一个简单的数据库应用就开发完成了。当然，MySQL有一套功能丰富的AP I，大家可以查看文档。另外，如果需要跨平台的移植性，可以考虑用MySQL的ODBC接口。可以自己配置MySQL的ODBC连接属性，也可以下载myodbc-2.50.29-nt.zip工具包来配置。
