iOS开发之SQLite-C语言接口规范(一)——Ready And Open Your SQLite

简介:

 为什么要搞一搞SQLite的C语言接口规范呢? 因为在做iOS开发中难免会遇到操作数据库的情况,你可以使用第三方的FMDB等,或者使用CoreData。但我们还是有必要去搞清楚如何去使用SQLite的C语言接口来操作SQLite数据库的。从今天开始就给大家结合实例详细的搞一搞SQLite的C语言接口。关于CoreData的东西请看之前的博客《IOS开发之表视图爱上CoreData》。

  如果英文好的小伙伴呢,你可以不听我啰嗦,直接官网走起:http://www.sqlite.org 上面的东西是应有尽有,你可以下载资源如SQLite的Shell, 上面还有好多的学习资源。不过前提是英文不能太Low呢。之前看过几本iOS开发的书籍,也包括某某出版社出版的《精通iOS开发》,虽然网上评价不错,但看书的时候总是不来感。大部分书上介绍的SQLite, 讲的太浅,只是罗列代码,接口参数是什么意思,为什么这么写都没讲。看书看的不爽了,就到官网上找找安慰吧,果不其然,眼前一亮。就写几篇博客好好的总结一下。

  一、准备SQLite测试工程和所需工具

    1. 准备一个已经引入动态链接库libsqlite3.0.dylib的iOS单视图工程(当然,看你心情,你也可以创建一个控制台工程,这不是重点)。

    2. 准备一个SQLite可视化的管理工具,我用的是SQLiteManager, 当然你可以选择你用着顺手的管理工具(自行百度吧)。当然如果你是初学者,并想“自残”一下话,可以从官网上Download一个叫做sqlite-shell的东西,用纯命令行去管理你的SQLite数据库。其实如果习惯了,用纯命令还是用着比较爽的,毕竟可以用来装13不是么! SQLite官网上有详细的Shell操作命令:如何去创建数据库,如何创建表等一系列的操作,今天不做赘述。(如果你之前搞过MySQL, Oracle等,应该对命令行操作数据库再熟悉不过了)。

    3. 你可以通过SQLiteManager来创建一个数据库插入一些测试数据,以备在我们的测试工程中进行使用。或者你可以懒一些,直接从网上Download一个现成的SQLite数据库进行操作使用(我下载了一个叫做Cars.sqlite文件来进行测试,数据库的表结构及数据如下所示)。

 

  二、打开你的数据库

    1.把准备好的测试SQLite数据库引入到我们的测试工程中。

    2.通过NSBundle加载我们的数据库资源

    //获取Sqllite文件的路径
    NSString *sqlPath = [[NSBundle mainBundle] pathForResource:@"Cars" ofType:@"sqlite"];

 

    3.因为是C语言接口,参数所用的字符串都是C语言中的字符串,所以呢得把字符串转成C语言中的字符串吧(也就是C语言中char类型的指针)

    //把路径转成C字符串
    const char * filePath = [sqlPath UTF8String];

    4.你需要定义一个sqlite3结构体类型的指针变量,打开数据库后可以获取这个sqlite3结构体指针的值,并赋值给之前对应的指针变量,然后就可以通过该sqlite3结构体指针变量来操作数据库。下面定义了一个sqlite3结构体类型的指针变量,然后把该指针变量的地址传给sqlite3_open()函数,函数参数传入的引用,在C语言中就可以得到数据库操作指针。为了便于理解,可以把sqlite3结构体当做一个类,而sqlite3结构体的指针可以看做是类的对象。
    sqlite3 * database;
    
    //打开数据库
    int result = sqlite3_open(filePath, &database);

   通过上述步骤就可以获取到操作数据库的结构体指针,sqlite3_open()函数,第一个参数就是C字符串格式的数据库文件的路径,第二个参数就是结构体指针的地址,用于获取操作数据库的句柄。该函数有一个int类型的返回值(0-101),这些返回值对应着不同的链接状态。0代表着成功,其余见下图:
if (result == SQLITE_OK) {
        NSLog(@"连接成功");
    } else {
        NSString *error = [NSString stringWithFormat:@"错误结果代码:%d", result];
        NSLog(@"%@", error);
    }

 

    

    sqlite3_open()就是一个构造函数, 另外还有sqlite3_open16()和sqlite3_open_v2(), 他们的功能都是打开一个新的数据库的连接,所需参数如下所示。这些构造函数可以通过数据库文件名称参数来连接一个数据库。如果文件名参数是UTF-8编码格式的, 可以调用sqlite3_open()和sqlite3_open_v2(),   那么如果文件参数是 UTF-16编码的话就调用构造函数sqlite3_open16()。第二个参数就是返回的数据库操作句柄的指针地址。

    由下方的图可以看出sqlite3_open_v2()比sqlite3_open()多了两个参数,一个是int flags, 一个是const char *zVfs。 sqlite3_open_v2()的用法和sqlite3_open()类似,可以说前者是后者的加强版。sqlite3_open()是以前的旧方法,而sqlite3_open_v2()是后来改进的方法。

    参数flag,不同的值代表着打开数据库后可以获取的不同操作,类似于数据库的操作权限,下方是flag的值代表的操作权限。

    SQLITE_OPEN_READONLY 数据库是只读模式打开。如果数据库不存在,则返回一个错误。

    SQLITE_OPEN_READWRITE 数据库以读写的模式打开, 如果文件被操作系统设置为保护模式,那么就为只读模式。在这两种情况下的数据库必须已经存在,否则会返回一个错误。

    SQLITE_OPEN_READWRITE | SQLITE_OPEN_CREATE 数据库以读写的模式打开, 如果数据库不存在,就创建一个。使用sqlite3_open()和sqlite3_open16()连接数据库时,默认的就是这种行为。

    如果sqlite3_open_v2()的第三个参数不包含上述三种结合中的一个的话,那么数据库的连接权限是未定义的。也就是说数据库不知道是读还是写,还是创建,所以操作数据库就没有意义了,所以上面必须选择一个参与“与”运算。

    SQLITE_OPEN_NOMUTEX 只要单线模式下没有设置编译的起始时间,就会在多线程模式下进行数据库的连接。

    SQLITE_OPEN_FULLMUTEX 在序列化的线程模式(在此模式中,SQLite能无约束地在多线程中安全使用)打开数据库连接,除非在编译时或者单线程之前选择起始时间。

    SQLITE_OPEN_SHAREDCACHE 可以使数据库连接适当的使用共享缓存模式,无论是否使用sqlite3_enable_shared_cache()启用共享缓存。

    SQLITE_OPEN_PRIVATECACHE 导致数据库连接不使用共享缓存模式,即使共享缓存模型可用。

 

    sqlite3_open_v2()第四个参数是sqlite3_vfs对象的名称,它定义了操作系统接口应该使用新的数据库连接。如果第四个参数是一个nil的话,那么就会使用默认sqlite3_vfs对象。下方是结构体sqlite3_vfs的具体内容:

 

    vfs: sqlite3_vfs对象的实例定义了一个SQLite核心和底层操作系统间的接口。“vfs”对象的名称代表“虚拟文件系统”。关于VFS的详解内容在这里:https://www.sqlite.org/vfs.html 有兴趣的小伙伴可以好好的搞一下。如果以后有时间的话在好好的介绍一下VFS。今天就不做过多的赘述了。第四个参数传入nil就会使用默认的sqlite3_vfs默认对象。

    关于VFS和sqlite3_vfs结构体的东西,如果以后有时间,在单独拿出来搞搞。了解VFS的结构和模式还是很有必要的。ok~今天打开并连接数据库,关于如何去通过接口去操作数据库就留在以后的博客中介绍吧。

    用到的数据库和sqliteAPI代码GitHub分享地址:https://github.com/lizelu/SQLiteResource

    在博客的最后呢,给出简单封装的打开数据库的方法:

/*******************************
 *功能:打开数据库
 *参数:databaseName -- 数据库名称
 *返回:数据库对象(sqlite3对象)
 *******************************/
+ (sqlite3 *) openDatabaseWithName: (NSString *)databaseName{
    
    //获取Sqllite文件的路径
    NSString *sqlPath = [[NSBundle mainBundle] pathForResource:databaseName ofType:@"sqlite"];
    
    //把路径转成C字符串
    const char * filePath = [sqlPath UTF8String];
    
    sqlite3 * database;
    
    //打开数据库
    int result = sqlite3_open(filePath, &database);
    
    if (result == SQLITE_OK) {
        return database;
    }
    
    return nil;

}

相关文章
|
8月前
|
开发框架 .NET 中间件
七天.NET 8操作SQLite入门到实战 - (2)第七天Blazor班级管理页面编写和接口对接
七天.NET 8操作SQLite入门到实战 - (2)第七天Blazor班级管理页面编写和接口对接
170 7
|
4月前
|
SQL 关系型数据库 数据库
七天.NET 8操作SQLite入门到实战详细教程(选型、开发、发布、部署)
七天.NET 8操作SQLite入门到实战详细教程(选型、开发、发布、部署)
|
5月前
|
开发框架 前端开发 .NET
七天.NET 8操作SQLite入门到实战 - (3)第七天Blazor学生管理页面编写和接口对接
七天.NET 8操作SQLite入门到实战 - (3)第七天Blazor学生管理页面编写和接口对接
|
7月前
|
SQL 数据库 C语言
【sqlite的C语言访问接口】执行SQL语句的接口------sqlite3_exec回调函数的使用
【sqlite的C语言访问接口】执行SQL语句的接口------sqlite3_exec回调函数的使用
|
8月前
|
移动开发 网络协议 Linux
We discovered one or more bugs in your app when reviewed on iPhone and iPad running iOS 14.1
We discovered one or more bugs in your app when reviewed on iPhone and iPad running iOS 14.1
76 0
|
8月前
|
iOS开发
Airtest的iOS实用接口介绍
Airtest的iOS实用接口介绍
|
8月前
|
JavaScript 前端开发 中间件
Node.js—Express使用、Express 路由 、Express 中间件、托管静态资源、使用 Express 写接口、node.js链接sqlite数据库
Node.js—Express使用、Express 路由 、Express 中间件、托管静态资源、使用 Express 写接口、node.js链接sqlite数据库
253 0
|
8月前
|
SQL 数据库 数据安全/隐私保护
Android Studio App开发中数据库SQLite的解析及实战使用(包括创建数据库,增删改查,记住密码等 附源码必看)
Android Studio App开发中数据库SQLite的解析及实战使用(包括创建数据库,增删改查,记住密码等 附源码必看)
627 0
|
开发工具 Android开发 iOS开发
使用xamarin开发Android、iOS报错failed to open directory: 系统找不到指定的文件
使用vs2019学习xamarin时,创建新程序。使用模拟器真机等测试都报错如下图错误: ![请在此添加图片描述](https://developer-private-1258344699.cos.ap-guangzhou.myqcloud.com/column/article/5877188/20231030-de8ce5fd.png?x-cos-security-token=r4KyZDEowPT0kGTL0LqE8EnwfN1Nzexadb05dcffed3939ff8d7591c528c01706nvpGSE93QwHpZM8NwhJNTZctNRQa0l3KDhEnqj8P7d8t
129 0
使用xamarin开发Android、iOS报错failed to open directory: 系统找不到指定的文件