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

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

 1 /*******************************
 2  *功能:打开数据库
 3  *参数:databaseName -- 数据库名称
 4  *返回:数据库对象(sqlite3对象)
 5  *******************************/
 6 + (sqlite3 *) openDatabaseWithName: (NSString *)databaseName{
 7
 8     //获取Sqllite文件的路径
 9     NSString *sqlPath = [[NSBundle mainBundle] pathForResource:databaseName ofType:@"sqlite"];
10
11     //把路径转成C字符串
12     const char * filePath = [sqlPath UTF8String];
13
14     sqlite3 * database;
15
16     //打开数据库
17     int result = sqlite3_open(filePath, &database);
18
19     if (result == SQLITE_OK) {
20         return database;
21     }
22
23     return nil;
24
25 }
时间: 2024-11-13 12:09:02

SQLite之C语言接口规范(一)——Ready And Open Your SQLite的相关文章

iOS开发之SQLite--C语言接口规范(四) —— Result Values From A Query

数据库的在上一篇博客中<SQLite之C语言接口规范(三)——Binding Values To Prepared Statements>用到了如何从查询结果中取出结果值.今天的博客就详细的介绍一下sqlite3_column_*()的方法.在SQLite数据库C语言接口中,从查询结果中取出不同类型的值需要不同的接口函数. 一. sqlite3_column_*()介绍 1.下图是sqlite3_column_*()所包含的方法,由下图容易的看出取出不同类型的值需要不同的接口函数.可以取出的类

Linux平台上SQLite数据库教程(二)——C语言API介绍

Linux平台上SQLite数据库教程(二)--C语言API介绍 前言:本文将介绍几个基本的SQLite3数据库的C语言API接口,主要用到两个文件:sqlite3.c.sqlite3.h.源码地址:https://github.com/AnSwErYWJ/SQLite. 打开数据库 1.原型: int sqlite3_open( const char* filename, /* 数据库文件名, 必须为 UTF-8 格式 */ sqlite3** ppDB /* 输出: SQLite 数据库句柄

sqlite嵌入式数据库C语言基本操作(2)

:first-child{margin-top:0!important}img.plugin{box-shadow:0 1px 3px rgba(0,0,0,.1);border-radius:3px}iframe{border:0}figure{-webkit-margin-before:0;-webkit-margin-after:0;-webkit-margin-start:0;-webkit-margin-end:0}kbd{border:1px solid #aaa;-moz-bord

【Go语言】连接数据库SQLite、MySQL、Oracle

本文目录 1.Go连接SQLite 1_1.SQLite推荐驱动 1_2.SQLite连接示例代码 2.Go连接MySQL 2_1.MySQL推荐驱动 2_2.MySQL连接示例代码 3.Go连接Oracle 3_1.Oracle推荐驱动以及准备事项 3_2.Oracle连接示例代码 说明:go语言连接数据库不像Java那么方便,本文分别介绍了连接三种典型的数据库的驱动以及连接方法:小型,SQLite;中型,MySQL;大型,Oracle. -1.Go连接SQLite 1.Go连接SQLite

sqlite学习笔记7:C语言中使用sqlite之打开数据库

数据库的基本内容前面都已经说得差点儿相同了.接下看看如何在C语言中使用sqlite. 一 接口 sqlite3_open(const char *filename, sqlite3 **ppDb) 打开数据库,假设数据库不存在则新建一个数据库,并打开 sqlite3_close(sqlite3*) 关闭数据库.假设关闭之前还存在没有运行完的语句,将会返回SQLITE_BUSY 二 实例 1 文件夹结构 Projects{ main.c// 代码所在文件 sqlite{// 官网下载下来的sqli

SQLite的使用(包括编译安装的步骤)

SQLite官网http://www.sqlite.org/ SQLite简介 SQLite是一款轻型的数据库,是遵守ACID(原子性.一致性.隔离性和持久性)的关系式数据库管理系统.SQLite实现了多数的SQL-92标准,包括事务.触发器和多数的复杂查询. SQLite的设计目标是嵌入式的,它占用的资源非常低,目前在很多嵌入式产品中都使用了SQLite. SQLite是跨平台的.可移植的,能够支持Windows/Linux/Unix等主流操作系统,同时SQLite能够和很多程序语言相结合,例

ASP.net与SQLite数据库通过js和ashx交互(连接和操作)

ASP.net与SQLite数据库通过js和ashx交互(连接和操作): 废话(也是思路):用的是VS2010,打算做网站前后台.由于不喜欢前台语言里加些与html和css和js的其他内容,想实现前后台语言的分离,与前后台通过js的ajax实现交互,故很多百度出来的方法不成立,虽听说ashx过时,但是他实现了我要的效果:即前后台语言不是相互嵌入实现交互,而是通过js实现(有接口就可以).由于领导指定用SQLite,故这两天还折腾了SQLite,不过对于这种小型的网站,它是个很好的选择(不需要部署

SQLite的使用详解

一.SQLite简介   SQLite是一款轻型的数据库,是遵守ACID的关联式数据库管理系统,它的设计目标是嵌入式的,而且目前已经在很多嵌入式产品中使用了它,它占用资源非常的低,在嵌入式设备中,可能只需要几百K的内存就够了.它能够支持Windows/Linux/Unix等等主流的操作系统,同时能够跟很多程序语言相结合,比如Tcl.PHP.Java等,还有ODBC接口,同样比起Mysql.PostgreSQL这两款开源世界著名的数据库管理系统来讲,它的处理速度比他们都快. 下面就是SQLite的

sqlite的应用实例

sqlite 的介绍: sqlite是c语言写的一个开源库,它实现的是一个开源的自自包含的SQL关系型的数据库引擎,可以使用sqlite存储大量关联数据.可以嵌入到iPhone或者ipad的设备上面. 优点: 1.sqlite是一个完全自包含(独立性比较高)的Sql数据库引擎, 1)所以所有的数据库数据都被存储在一个单独的.跨平台的磁盘中: 2)它需要几个外部库和一点点的操作系统的支持. 2.sqlite所占用的空间是非常的晓得.大概只是300k 3.sqlite不需要配置.安装以及管理员的过程