10.9 自动注册DSN和创建表
在开始编写自己的数据库应用程序时,读者很快会遇到两个令人头痛的问题。一是在访问ODBC数据源前,必须在ODBC管理器中手工注册DSN(数据源名)。这样的应用程序要求用户作额外的工作,显得很不专业。另一个问题是AppWizard和ClassWizard并不支持表的创建,程序员似乎必须先用DBMS创建好表,然后才能使用。如果一个数据库应用程序不能自己创建表,那么它的功能将大打折扣。
事实上,通过一些技巧,可以使应用程序能够对用户透明地注册DSN并任意创建表。本节的目的就是教会读者如何解决这两个问题。在下面几个小节中,分别提供了ODBC和DAO的解决方案。
10.9.1 自动注册DSN
无论是用ODBC还是DAO类,在访问ODBC数据源以前,都必须先注册DSN。通过调用函数SQLConfigDataSource,可以实现自动注册DSN。当然,用DAO可以直接访问一些常用的数据库,而不必通过ODBC来访问(参见10.8.3)。
清单10.14的代码演示了注册DSN的过程。该段代码先用SQLConfigDataSource注册一个名为MYDB的FoxPro 2.5数据源,然后调用CDatabase::Open函数与该数据源连接。注意在使用这段代码时,要包含afxdb.h头文件,读者可以把该文件放到stdafx.h中。
清单10.14 自动注册DSN
#include “afxdb.h”
. . .
CDatabase db;
if(!SQLConfigDataSource(NULL,ODBC_ADD_DSN, "Microsoft FoxPro Driver (*.dbf)",
"DSN=MYDB\0"
"DefaultDir=c:\\mydir\0"
"FIL=FoxPro 2.5\0"
"DriverId=280\0"))
{
AfxMessageBox("Can't add DSN!");
return ;
}
TRY
{
db.Open("MYDB");
}
CATCH(CDBException, e)
{
AfxMessageBox(e->m_strError);
return;
}
END_CATCH
在注册DSN时,SQLConfigDataSource函数的第二个参数应该是ODBC_ADD_DSN,第三个参数指定了ODBC驱动程序,它的写法可以参照ODBC管理器的驱动程序页。第四个参数说明了数据源的各种属性,它是由一系列子串构成,每个子串的末尾必须有一个“\0”。最重要的属性是“DSN=数据源名”,其它属性包括缺省目录以及驱动程序版本信息。在上例中,使用FoxPro 2.5的版本,所以DriverId应该是280,对应地,FoxPro 2.6的DriverId是536,FoxPro 2.0的是24。
如果读者对SQLConfigDataSource函数的第四个参数的设置方法不清楚,那么可以打开Windows的注册表看一看已注册过的DSN的各项属性。运行RegEdit可以打开注册表,然后依次打开HKEY_CURRENT_USER->Software->ODBC->ODBC.INI,就可以看到已注册的DSN,打开各DSN,则可以看到该DSN的各项属性,读者可以仿照DSN属性来设置第四个参数。
DSN的名字必须唯一,因此如果要注册的DSN已被注册过,那么SQLConfigDataSource就修改原来DSN的属性。
10.9.2 用ODBC创建表
由于ODBC类不支持DDL,所以只有通过ODBC API来创建表。程序需要调用Cdatabase :: ExecuteSQL来直接执行SQL语句。
清单10.15给出了创建表的一个例子,该程序先自动注册了一个名为MYDB的FoxPro 2.5数据源,然后创建了一个名为OFFICES的表(OFFICES.DBF文件),在这个表中有OfficeID和OfficeName两个TEXT型字段,长度分别为4和10个字节。注意,如果要使用这段代码,则需要包含afxdb.h和odbcinst.h。
清单10.15 ODBC创建表的例子
#include “afxdb.h”
#include "odbcinst.h"
. . .
CDatabase db;
if(!SQLConfigDataSource(NULL,ODBC_ADD_DSN, "Microsoft FoxPro Driver (*.dbf)",
"DSN=MYDB\0"
"DefaultDir=c:\\mydir\0"
"FIL=FoxPro 2.5\0"
"DriverId=280\0"))
{
AfxMessageBox("Can't add DSN!");
return ;
}
TRY
{
db.Open("MYDB");
db.ExecuteSQL("CREATE TABLE OFFICES (OfficeID TEXT(4)"
",OfficeName TEXT(10))"); }
CATCH(CDBException, e)
{
AfxMessageBox(e->m_strError);
return;
}
END_CATCH
ExecuteSQL执行了一个实实在在的SQL语句CREATE来创建表,看来用户应该找本SQL方面的书研究研究。要注意一个数据库中的表名必须是唯一的,如果要创建的表已经存在,则ExecuteSQL会产生一个异常。
10.9.3 用DAO创建表
由于DAO类直接支持DDL,所以用DAO类创建表比ODBC容易。DAO的CDaoTableDef类提供了对表的结构的定义,该类提供了创建表的成员函数。
清单10.16演示了一段用DAO类创建表的例子。注意,若要使用这段代码,则应该包含afxdao.h头文件。在该例中,先与一个FoxPro 2.5数据库连接(实际上是一个目录),然后再构建一个CDaoTableDef对象,接着调用CDaoTableDef :: Create函数创建一个名为STUDENTS的表(STUDENTS.DBF),调用CDaoTableDef :: CreateField为该表创建了两字段,字段名分别是ID和NAME,类型分别是Integer和dbText,字段的长度分别为2和10个字节。最后调用CDaoTableDef :: Append把新创建的表保存到数据库中。
清单10.16 DAO创建表的例子
#include “afxdao.h”
. . .
CDaoDatabase daoDb;
try
{
daoDb.Open("",FALSE,FALSE,"FoxPro 2.5;DATABASE=d:\\zwin");
CDaoTableDef table(&daoDb);
table.Create("STUDENTS");
table.CreateField("ID",dbInteger,2);
table.CreateField("NAME",dbText,10);
table.Append();
}
catch(CDaoException* e)
{
AfxMessageBox(e->
m_pErrorInfo->m_strDescription);
e->Delete();
return FALSE;
}
关于CDaoDatabase :: Open的说明请参见10.8.3。注意一个数据库中的表名必须是唯一的,如果要创建的表已经存在,则CDaoTableDef :: Create会产生一个异常。