当前位置：首页 > article >正文

SQLite数据库介绍

article 2024/10/4 0:01:36

文章目录

- SQLite
- - 常用接口
- 使用示例
- 测试

SQLite

SQLite是一个本地化的数据库,不需要客户端服务端什么的配置,主打就是轻量化方便化

他也不是一个独立的进程,而是可以根据应用程序的需求,可以进行静态或者动态的连接

而且他是直接存储在磁盘文件的,提供了简单易用的API接口

需要注意的是在SQLite中一个数据库对应了一个数据库文件

常用接口

int sqlite3_threadsafe(); 
// 查看是否启用线程安全 0-未启用 1-启用

sqlite有三种安全模式

非线程安全模式
线程安全模式(不同的连接在不同的线程是安全的,或者说进程间是安全的,一个句柄不能用于多线程之间)
串行化模式(可以在不同的线程或者进程之间使用同一个句柄)

int sqlite3_open(const char* filename, sqlite3 **ppDb);
int sqlite3_open_v2(const char* filename, sqlite3 **ppDb, int flags, const char* *zVfs);

这里是创建或者打开数据库的两种操作

第一个参数是文件名,第二个参数是传入一个句柄指针的地址

第三个参数是flag是可以设置文件的打开方式,提供下面的宏可以选择

SQLITE_OPEN_READWRITE: 读写方式打开数据库文件
SQLITE_OPEN_CREATE: 不存在数据库文件则创建
SQLITE_OPEN_NOMUTEX: 多线程模式,只要不同线程使用不同的连接即可保证线程安全
SQLITE_OPEN_FULLMUTEX: 串行化模式,即打开所有的锁

当返回值为SQLITE_OK (0)表示数据库成功打开操作成功

如果是其他值的话就代表着有问题,需要查找对应的宏来看到

int sqlite_exec(sqlite3, char* sql, int(*callback)(void*, int, char**, char**), void* arg, char ** err);

这是一个执行语句的操作函数

这里面需要传入一个回调函数,对查询到的结果进行处理

返回值含义和上一个是一样的

int (*callback) (void*, int, char**, char**);

void* 是用来设置回调时传入的arg参数,一般来说是用于将数据存于某个地址
int 一行中的列数
char** 存储一行数据的字符指针数组
char** 每一列的字段名
int返回值,成功处理需要返回一个0,如果返回非0程序会直接中断退出

使用示例

/*
    封装SqliteHelper类
    提供简单的sqlite数据库操作接口

    1. 创建/打开数据库
    2. 针对打开的数据库执行操作
        1. 表操作
        2. 数据操作
    3. 关闭数据库
*/
#include <iostream>
#include <string>
#include <vector>
#include <sqlite3.h>
#include <functional>
#include "../logs/Xulog.h"

class SqliteHelper
{
public:
    typedef int (*SqliteCallback)(void *, int, char **, char **);
    SqliteHelper(const std::string &dbfile)
        : _dbfile(dbfile), _handler(nullptr)
    {
    }
    bool open(int safe_level = SQLITE_OPEN_FULLMUTEX)
    {
        int ret = sqlite3_open_v2(_dbfile.c_str(), &_handler, SQLITE_OPEN_READWRITE | SQLITE_OPEN_CREATE | safe_level, nullptr);
        if (ret != SQLITE_OK)
        {
            ERROR("打开SQLite数据库失败: %s", sqlite3_errmsg(_handler));
            return false;
        }
        return true;
    }
    bool exec(const std::string &sql, SqliteCallback cb, void *arg)
    {
        int ret = sqlite3_exec(_handler, sql.c_str(), cb, arg, nullptr);
        if (ret != SQLITE_OK)
        {
            ERROR("%s--执行语句失败: %s", sql.c_str(), sqlite3_errmsg(_handler));
            return false;
        }
        return true;
    }
    void close()
    {
        sqlite3_close_v2(_handler);
    }

private:
    std::string _dbfile;
    sqlite3 *_handler;
};

测试

#include "Sqlite3.hpp"
#include <cassert>

int select_stu_callback(void *arg, int col_count, char **result, char **fields_name)
{
    std::vector<std::string> *array = (std::vector<std::string> *)arg;
    array->push_back(result[0]);
    return 0;
}
int main()
{
    SqliteHelper helper("./test.db");
    // 创建或打开数据库文件
    assert(helper.open());
    // 创建表
    const char *ct = "CREATE TABLE IF NOT EXISTS stu (sn INTEGER PRIMARY KEY AUTOINCREMENT, name VARCHAR(32), age INT);";
    assert(helper.exec(ct, nullptr, nullptr));
    // 数据操作语句
    // const char *insert_sql = "INSERT INTO stu (sn, name, age) VALUES (1, 'Morty', 16), (2, 'Summer', 18), (3, 'Rick', 58);";
    // assert(helper.exec(insert_sql, nullptr, nullptr));

    // const char *update_sql = "UPDATE stu SET name='S.Morty' WHERE sn=1;";
    // assert(helper.exec(update_sql, nullptr, nullptr));

    // const char *delete_sql = "DELETE FROM stu WHERE sn=2;";
    // assert(helper.exec(delete_sql, nullptr, nullptr));

    const char *select_sql = "SELECT name FROM stu;";
    std::vector<std::string> arr;
    assert(helper.exec(select_sql, &select_stu_callback, &arr));
    for (auto &name : arr)
    {
        std::cout << name << " ";
    }
    std::cout << std::endl;

    // 关闭数据库
    helper.close();
    return 0;
}