从SQLite说起

如果没有SQLite的基础，我们只是从Android封装的SQLite API去学习的话，难免思路会受到限制。所以，我们还是需要老老实实从头开始学习SQLite.

当我们有一身的SQLite武功之后，再去看Android的封装，就能更清楚如何发挥SQLite的特长。

SQLite的核心只有一个c文件，访问的db也存在一个文件当中。所以，我们完全可以把它嵌入到另外一个程序中。

在mac上，可以通过Homebrew来安装。安装之后，我们就可以用sqlite3的API来写代码了。

先来个能编过的sqlite3调用例子吧

我们找个网上找到的最简单的打开关闭SQLite数据库的例子：

#include <stdio.h>
#include <sqlite3.h>
#include <stdlib.h>

int main(int argc, char *argv[])
{
    sqlite3 *db;
    char *zErrMsg = 0;
    int rc;

    rc = sqlite3_open("contacts.db", &db);

    if (rc)
    {
        fprintf(stderr, "Can't open database: %s\n", sqlite3_errmsg(db));
        exit(0);
    }
    else
    {
        fprintf(stderr, "Opened database successfully\n");
    }
    sqlite3_close(db);
}

我们先不管它是什么意思，先编译一下试试：

gcc -o test_sqlite test.c -lsqlite3

然后运行一下吧，需要本地有个叫contacts.db的数据库。

./test_sqlite

输出为：

Opened database successfully

从上面的例子，我们可以学习到两个容易理解的API: sqlite3_open和sqlite3_close.

SQLite3是一个基于VDBE的数据库引擎

有了能运行的环境之后，我们就来看看SQLite数据库引擎的结构吧：

从这张官方图上，我们可以看到，除了工具和测试代码之外，SQLite的核心部分分为三部分：核心，编译器和后端。

核心部分就是对SQL命令的处理的部分，它通过编译器来编译成VDBE（Virtual Database Engine）能执行的代码。

后端是真正对数据库进行操作的部分，包括B-树的查找结构等。

喜欢划重点的同学注意啦，重点来了：调用SQLite3数据库的代码优化的第一个点就是将编译好的字节码保存起来，下次用的时候直接调用。

这么重要的功能，SQLite3 API中当然有提供，这就是后面我们会大量学习使用的sqlite3_prepare和sqlite3_prepare_v2函数。

Android对此也有同样的封装，提供了SQLiteStatement来实现预编译代码的保存。

有同学问了，我的SQL语句并不是一成不变的，语句中的参数经常改变，这样的话，编译出来的代码就没有用了啊？

这在SQLite3的设计中当然是有考虑到的，编译好的语句，是可以支持参数的。我们首先使用sqlite3_prepare_v2编译，然后再通过sqlite3_bind_*函数来绑定参数。下次如果换了参数，先调用sqlite3_reset清除掉绑定信息，然后再重新用sqlite3_bind_*来做绑定新参数，就可以了。

一个调用sqlite3实现数据库操作的功能可以用下面的步骤来套用：

1. 根据业务需求，构造sql语句

2. 调用sqlite3_prepare_v2函数来编译sql语句

3. 如果有参数，调用sqlite3_bind_*函数来绑定参数

4. 调用sqlite3_step函数来执行一次sql操作，直至所有操作都完成

5. 下次再使用第2步编译出来的语句时，调用sqlite3_reset函数清理参数。然后重复第3步的操作

6. 最后，调用sqlite3_finalize来销毁预编译语句

下面我们直接开始实操，首先先举个select的例子。

我们以Android中联系人数据库为例，取其中的calls表的简化版：

CREATE TABLE calls (
_id INTEGER PRIMARY KEY AUTOINCREMENT,
sourceid TEXT,
number TEXT
...
);

虽然字段很多，我们就关注id和号码就好。

如何写查询语句

我们先来一半，我们选_id和number这两列，然后看看返回的数据中是不是两列：

核心代码如下：

    rc = sqlite3_prepare_v2(db, sql_select_caller, -1, &stmt, &tail);

    rc = sqlite3_step(stmt);
    int ncols = sqlite3_column_count(stmt);

    printf("The column counts of calls is:%d\n", ncols);

    sqlite3_finalize(stmt);

完整版的代码，便于大家实验：

#include <stdio.h>
#include <sqlite3.h>
#include <stdlib.h>

int main(int argc, char *argv[])
{
    sqlite3 *db;
    char *zErrMsg = 0;
    int rc;
    const char *sql_select_caller = "select _id, number from calls";
    sqlite3_stmt *stmt;
    const char *tail;

    rc = sqlite3_open("contacts.db", &db);

    if (rc)
    {
        fprintf(stderr, "Can't open database: %s\n", sqlite3_errmsg(db));
        exit(0);
    }
    else
    {
        fprintf(stderr, "Opened database successfully\n");
    }

    //select _id, number from calls
    rc = sqlite3_prepare_v2(db, sql_select_caller, -1, &stmt, &tail);

    rc = sqlite3_step(stmt);
    int ncols = sqlite3_column_count(stmt);

    printf("The column counts of calls is:%d\n", ncols);

    sqlite3_finalize(stmt);

    sqlite3_close(db);
}

下面我们直接调用sqlite3_step去读每一条记录，增加下面一段：

    while(rc == SQLITE_ROW){
        printf("calls ID=%d,\t",sqlite3_column_int(stmt,0));
        printf("number=%s\n",sqlite3_column_text(stmt,1));
        rc = sqlite3_step(stmt);
    }

如果sqlite3_step返回的结果是SQLITE_ROW，说明这一次执行取到了一条符合条件的记录。每次取一条记录。

完整代码如下：

#include <stdio.h>
#include <sqlite3.h>
#include <stdlib.h>

int main(int argc, char *argv[])
{
    sqlite3 *db;
    char *zErrMsg = 0;
    int rc;
    const char *sql_select_caller = "select _id, number from calls";
    sqlite3_stmt *stmt;
    const char *tail;

    rc = sqlite3_open("contacts.db", &db);

    if (rc)
    {
        fprintf(stderr, "Can't open database: %s\n", sqlite3_errmsg(db));
        exit(0);
    }
    else
    {
        fprintf(stderr, "Opened database successfully\n");
    }

    //select _id, number from calls
    rc = sqlite3_prepare_v2(db, sql_select_caller, -1, &stmt, &tail);

    rc = sqlite3_step(stmt);
    int ncols = sqlite3_column_count(stmt);

    printf("The column counts of calls is:%d\n", ncols);

    while (rc == SQLITE_ROW)
    {
        printf("calls ID=%d,\t", sqlite3_column_int(stmt, 0));
        printf("number=%s\n", sqlite3_column_text(stmt, 1));
        rc = sqlite3_step(stmt);
    }

    sqlite3_finalize(stmt);

    sqlite3_close(db);
}

输出如下例：

The column counts of calls is:2
calls ID=1, number=18600009876
calls ID=2, number=18600019876
calls ID=3, number=18600029876
calls ID=4, number=18600039876
calls ID=5, number=18600049876
calls ID=6, number=18600059876
calls ID=7, number=18600069876
calls ID=8, number=18600079876
calls ID=9, number=18600089876
calls ID=10,    number=18600099876

如何写非查询语句

上面的例子是针对查询语句的，我们再举个非查询语句的例子。比如我们试个插入的例子。

void insert_item(sqlite3 *db)
{
    const char *sql_insert_sample = "insert or ignore into calls (_id,number) values (?1,?2);";
    sqlite3_stmt *stmt = NULL;
    const char *tail = NULL;

    int rc = sqlite3_prepare_v2(db, sql_insert_sample, -1, &stmt, &tail);

    sqlite3_bind_int(stmt, 1, 1000);
    sqlite3_bind_text(stmt, 2, "01084993677", 11, NULL);

    rc = sqlite3_step(stmt);

    if (rc == SQLITE_DONE)
    {
        printf("Last inserted row id=%ld\n", (long)sqlite3_last_insert_rowid(db));
    }
    else
    {
        printf("Insert failed!");
    }

    sqlite3_finalize(stmt);
}

输出如下：

Last inserted row id=0

小结

上面，我们就查询和非查询两种情况，学习了如何使用SQLite3的API。

剩下的工作主要就是构造SQL语句以及处理返回结果了。