本系列文章主要是使用C++语言来调用其API,达到管中窥豹的目的。另外本文使用的开发环境为mac + clion,并且基于SQLite 3.7.14来进行开发.
一、去下载sqlite-amalgamation-3071400.zip,然后解压到文件夹(其结构目录树如下):
.
├── shell.c
├── sqlite3.c
├── sqlite3.h
└── sqlite3ext.h
二、新建一个sql_tutorial的工程,景sqlite3.c和sqlite3.h文件拷贝到sql_src目录下:
.
├── main.cpp
└── sql_src
├── sqlite3.c
└── sqlite3.h
三、在main.cpp中调用sqlite的代码如下:
/** * We get the version of the SQLite database. This time we will use an SQL query. */ #include <iostream> #include "./sql_src/sqlite3.h" using namespace std; int main() { sqlite3 *db; sqlite3_stmt *res; const char *file = "test.db"; int rc = sqlite3_open(file, &db); if (rc != SQLITE_OK) { cout << "Cannot open database: " << sqlite3_errmsg(db) << endl; sqlite3_close(db); exit(1); } rc = sqlite3_prepare_v2(db, "SELECT SQLITE_VERSION()", -1, &res, 0); if (rc != SQLITE_OK) { cout << "Failed to fetch data: " << sqlite3_errmsg(db) << endl; sqlite3_close(db); exit(1); } rc = sqlite3_step(res); if (rc == SQLITE_ROW) { cout << sqlite3_column_text(res, 0) << endl; } sqlite3_finalize(res); sqlite3_close(db); return 0; }
四、最后的运行结果如下:
3.7.14 Process finished with exit code 0
调用分析:
sqlite3 *db;
1、该sqlite3的结构定义了一个数据库句柄。每个打开的SQLite数据库是由数据库句柄表示。
sqlite3_stmt *res;
2、该sqlite3_stmt结构代表一个SQL语句。
int rc = sqlite3_open(file, &db);
3、该sqlite3_open()函数打开一个新的数据库连接。其参数是数据库名称和数据库句柄。在“test.db的”是采用了特殊的数据库名称导致打开一个内存数据库。函数的返回码指示数据库是否被成功打开。当连接成功建立,则返回SQLITE_OK。
if (rc != SQLITE_OK) { cout << "Cannot open database: " << sqlite3_errmsg(db) << endl; sqlite3_close(db); exit(1); }
4、如果返回代码指示错误,我们打印邮件到控制台,关闭数据库处理,并终止该计划。该sqlite3_errmsg()函数返回错误的描述。它是否被打开时发生错误,与数据库连接句柄相关联的资源,应通过使其向sqlite3_close()函数释放。
rc = sqlite3_prepare_v2(db, "SELECT SQLITE_VERSION()", -1, &res, 0); if (rc != SQLITE_OK) { cout << "Failed to fetch data: " << sqlite3_errmsg(db) << endl; sqlite3_close(db); exit(1); }
5、执行SQL语句之前,必须调用首先被编译成字节代码的sqlite3_prepare功能之一。 (该sqlite3_prepare()函数被弃用。)
sqlite3_prepare_v2()函数有五个参数。
第一个参数是从所述sqlite3_open()函数获得的数据库句柄。
第二个参数是要编译的SQL语句。
第三个参数为以字节为单位的SQL语句的最大长度。传递-1会导致读取SQL字符串到第一个零终止子字符串结束了。根据该文件,可以通过传递提供的SQL字符串的字节的确切数量获得一些小的性能优势。
第四个参数是语句句柄。这将指向预编译的语句,如果sqlite3_prepare_v2()成功运行
最后一个参数是一个指向SQL语句的未使用的部分。只有SQL字符串的第一个语句被编译,所以参数指向剩下什么未编译。我们传入0,因为该参数对我们不是很重要。
如果成功,sqlite3_prepare_v2()返回SQLITE_OK;否则错误代码返回
rc = sqlite3_step(res);
6、调用sqlite3_step()运行SQL语句。 SQLITE_ROW返回码表示有另一行准备。我们的SQL语句返回只有一行数据,因此,我们调用这个函数一次。
sqlite3_finalize(res);
7、该sqlite3_finalize()函数销毁准备语句对象。
sqlite3_close(db);
8、该sqlite3_close()函数关闭数据库连接。