iOS开发 数据存储之SQLite3

一.SQLite介绍

SQL(Structured Query Language),用于对数据库的操作语句(增删改查),是一款轻型的数据库,是遵守ACID的关系型数据库管理系统,它包含在一个相对小的C库中

二.SQLite语言的特点

1.不区分大小写(比如数据库认为user和UsEr是一样的)

2.每条语句都必须以分号;结尾

3.字符串需要加""或''

三.SQLite中常用关键字

select、insert、update、delete、from、create、where、desc、order、by、group、table、alter、view、index等等

四.SQLite必要条件

在Xcode工程中,打开targets,在Build Phases下导入Libsqlite.tbd,在需要使用sqlite3的位置导入头文件(#import<sqlite3.h>)即可.

五.SQLite基本操作

1.数据库创建

//打开数据库
+ (sqlite3 *)openDB
{
    if (!db) {
        //1 获取document文件夹的路径
        //参数1: 文件夹的名字 参数2: 查找域 参数3: 是否使用绝对路径
        NSString *docPath = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) firstObject];
        //获取数据库文件的路径
        NSString *dbPath = [docPath stringByAppendingPathComponent:FILE_SQLITE_NAME];
        NSLog(@"%@",dbPath);
        //打开数据库 参数1: 文件路径(UTF8String可以将OC的NSString转为C中的char) 参数2: 接受数据库的指针
        if (sqlite3_open([dbPath UTF8String], &db) == SQLITE_OK) {
            char *errMsg;
            const char *sql_stmt = "CREATE TABLE IF NOT EXISTS PERSON_SQLITE_CACHE(id INTEGER PRIMARY KEY AUTOINCREMENT   NOT NULL, PERSON_ID INTEGER, PERSON_NAME TEXT, PERSON_AGE INTEGER, PERSON_SEX TEXT, PERSON_HEIGHT TEXT)";
            if (sqlite3_exec(db, sql_stmt, NULL, NULL, &errMsg) != SQLITE_OK) {
                sqlite3_close(db);
                NSLog(@"创建表失败%s",errMsg);
            }
        } else {
            NSLog(@"创建/打开数据库失败");
        }
    }
    return db;
}

2.数据库关闭

//关闭数据库
+ (BOOL)closeDB
{
    int result = sqlite3_close(db);
    db = nil;
    return result == SQLITE_OK;
}

3.数据库添加数据(增)

#pragma mark - 增
+ (BOOL)insertData:(Person *)person
{
    sqlite3 *db = [WLSQLite openDB];
    // 这里 %@ 要加上单引号或者双引号,因为有可能 %@ 值是中文,识别不了
    NSString *sqlStr = [NSString stringWithFormat:@"INSERT INTO PERSON_SQLITE_CACHE (PERSON_ID, PERSON_NAME, PERSON_AGE, PERSON_SEX, PERSON_HEIGHT) values ('%@', '%@', '%@', '%@', '%@')", @(person.pId), person.name, @(person.age), person.sex, @(person.height)];
    char *errMsg;
    int result = sqlite3_exec(db, [sqlStr UTF8String], NULL, NULL, &errMsg);
    if (result != SQLITE_OK) {
        NSLog(@"添加数据失败,%s",errMsg);
    }
    [WLSQLite closeDB];
    return YES;
}
+ (BOOL)insertDatas:(NSArray<Person *> *)persons
{
    sqlite3 *db = [WLSQLite openDB];
    sqlite3_stmt *stmt = nil;
    NSString *sqlStr = [NSString stringWithFormat:@"INSERT INTO PERSON_SQLITE_CACHE (PERSON_ID, PERSON_NAME, PERSON_AGE, PERSON_SEX, PERSON_HEIGHT) values (?, ?, ?, ?, ?)"];
    int result = sqlite3_prepare_v2(db, [sqlStr UTF8String], -1, &stmt, NULL);
    if (result == SQLITE_OK) {
        for (NSInteger index = 0; index < persons.count; index ++) {
            Person *person = persons[index];
            sqlite3_bind_int(stmt, 1, (int)person.pId);
            sqlite3_bind_text(stmt, 2, person.name.UTF8String, -1, SQLITE_TRANSIENT);
            sqlite3_bind_int(stmt, 3, (int)person.age);
            sqlite3_bind_text(stmt, 4, person.sex.UTF8String, -1, SQLITE_TRANSIENT);
            sqlite3_bind_double(stmt, 5, person.height);
        }
        //判断语句执行完成没有
        if (sqlite3_step(stmt) == SQLITE_DONE) {
            sqlite3_finalize(stmt);
            [WLSQLite closeDB];
            return YES;
        }
    }
    sqlite3_finalize(stmt);
    [WLSQLite closeDB];
    return YES;
}

4.数据库删除数据(删)

#pragma mark - 删
+ (BOOL)deleteDataWithId:(NSInteger)pId
{
    sqlite3 *db = [WLSQLite openDB];
    sqlite3_stmt *stmt = nil;
    NSString *sqlStr = [NSString stringWithFormat:@"DELETE FROM PERSON_SQLITE_CACHE WHERE PERSON_ID = '%@'", @(pId)];
    int result = sqlite3_prepare_v2(db, [sqlStr UTF8String], -1, &stmt, NULL);
    if (result == SQLITE_OK) {
        if (sqlite3_step(stmt) == SQLITE_ROW) {
            //觉的应加一个判断, 若有这一行则删除
            if (sqlite3_step(stmt) == SQLITE_DONE) {
                sqlite3_finalize(stmt);
                [WLSQLite closeDB];
                return YES;
            }
        }
    }
    sqlite3_finalize(stmt);
    [WLSQLite closeDB];
    return YES;
}

+ (BOOL)deleteAllData
{
    sqlite3 *db = [WLSQLite openDB];
    sqlite3_stmt *stmt = nil;
    NSString *sqlStr = [NSString stringWithFormat:@"DELETE FROM PERSON_SQLITE_CACHE"];
    int result = sqlite3_prepare_v2(db, [sqlStr UTF8String], -1, &stmt, NULL);
    if (result == SQLITE_OK) {
        if (sqlite3_step(stmt) == SQLITE_ROW) {
            //觉的应加一个判断, 若有这一行则删除
            if (sqlite3_step(stmt) == SQLITE_DONE) {
                sqlite3_finalize(stmt);
                [WLSQLite closeDB];
                return YES;
            }
        }
    }
    sqlite3_finalize(stmt);
    [WLSQLite closeDB];
    return YES;
}

5.数据库改数据(改)

#pragma mark - 改
+ (BOOL)updateDataName:(NSString *)aName byId:(NSInteger)pId
{
    sqlite3 *db = [WLSQLite openDB];
    sqlite3_stmt *stmt = nil;
    NSString *sqlStr = [NSString stringWithFormat:@"UPDATE PERSON_SQLITE_CACHE SET PERSON_NAME = '%@' WHERE PERSON_ID = '%@'", aName, @(pId)];
    int result = sqlite3_prepare_v2(db, [sqlStr UTF8String], -1, &stmt, NULL);
    if (result == SQLITE_OK) {
        if (sqlite3_step(stmt) == SQLITE_ROW) {
            //觉的应加一个判断, 若有这一行则修改
            if (sqlite3_step(stmt) == SQLITE_DONE) {
                sqlite3_finalize(stmt);
                [WLSQLite closeDB];
                return YES;
            }
        }
    }
    sqlite3_finalize(stmt);
    [WLSQLite closeDB];
    return YES;
}

+ (BOOL)updateData:(Person *)person
{
    sqlite3 *db = [WLSQLite openDB];
    sqlite3_stmt *stmt = nil;
    NSString *sqlStr = [NSString stringWithFormat:@"UPDATE PERSON_SQLITE_CACHE SET PERSON_NAME = '%@', PERSON_AGE = '%@', PERSON_SEX = '%@', PERSON_HEIGHT = '%@' WHERE PERSON_ID = '%@'", person.name, @(person.age), person.sex, @(person.height), @(person.pId)];
    int result = sqlite3_prepare_v2(db, [sqlStr UTF8String], -1, &stmt, NULL);
    if (result == SQLITE_OK) {
        if (sqlite3_step(stmt) == SQLITE_ROW) {
            //觉的应加一个判断, 若有这一行则修改
            if (sqlite3_step(stmt) == SQLITE_DONE) {
                sqlite3_finalize(stmt);
                [WLSQLite closeDB];
                return YES;
            }
        }
    }
    sqlite3_finalize(stmt);
    [WLSQLite closeDB];
    return YES;
}

6.数据库查数据(查)

#pragma mark - 查
+ (NSMutableArray<Person *> *)getDataWithId:(NSInteger)pId
{
    sqlite3 *db = [WLSQLite openDB];
    //数据库操作指针 stmt:statement
    sqlite3_stmt *stmt = nil;
    NSString *sqlStr = [NSString stringWithFormat:@"SELECT * FROM PERSON_SQLITE_CACHE WHERE PERSON_ID = %@",@(pId)];
    //验证SQL的正确性 参数1: 数据库指针, 参数2: SQL语句, 参数3: SQL语句的长度 -1代表无限长(会自动匹配长度), 参数4: 返回数据库操作指针, 参数5: 为未来做准备的, 预留参数, 一般写成NULL
    int result = sqlite3_prepare_v2(db, [sqlStr UTF8String], -1, &stmt, NULL);
    NSMutableArray<Person *> *persons = [NSMutableArray array];
    //判断SQL执行的结果
    if (result == SQLITE_OK) {
        while (sqlite3_step(stmt) == SQLITE_ROW) {
            Person *person = [[Person alloc] init];
            //列数从0开始
            person.pId = sqlite3_column_int(stmt, 0);
            person.name = [NSString stringWithUTF8String:(const char *)sqlite3_column_text(stmt, 1)];
            person.age = sqlite3_column_int(stmt, 2);
            person.sex = [NSString stringWithUTF8String:(const char *)sqlite3_column_text(stmt, 3)];
            person.height = sqlite3_column_double(stmt, 4);
            //添加到数组
            [persons addObject:person];
        }
    }
    //释放stmt指针
    sqlite3_finalize(stmt);
    //关闭数据库
    [WLSQLite closeDB];
    return persons;
}
+ (NSMutableArray<Person *> *)getAllData
{
    sqlite3 *db = [WLSQLite openDB];
    //数据库操作指针 stmt:statement
    sqlite3_stmt *stmt = nil;
    NSString *sqlStr = [NSString stringWithFormat:@"SELECT * FROM PERSON_SQLITE_CACHE"];
    //验证SQL的正确性 参数1: 数据库指针, 参数2: SQL语句, 参数3: SQL语句的长度 -1代表无限长(会自动匹配长度), 参数4: 返回数据库操作指针, 参数5: 为未来做准备的, 预留参数, 一般写成NULL
    int result = sqlite3_prepare_v2(db, [sqlStr UTF8String], -1, &stmt, NULL);
    NSMutableArray *persons = [NSMutableArray array];
    //判断SQL执行的结果
    if (result == SQLITE_OK) {
        while (sqlite3_step(stmt) == SQLITE_ROW) {
            Person *person = [[Person alloc] init];
            //列数从0开始 因为0是从主键开始,我们这里取的是PERSON_ID,所以从1开始
            person.pId = sqlite3_column_int(stmt, 1);
            person.name = [NSString stringWithUTF8String:(const char *)sqlite3_column_text(stmt, 2)];
            person.age = sqlite3_column_int(stmt, 3);
            person.sex = [NSString stringWithUTF8String:(const char *)sqlite3_column_text(stmt, 4)];
            person.height = sqlite3_column_double(stmt, 5);
            /*
            //blob类型的获取
            //1 获取长度
            int length = sqlite3_column_bytes(stmt, 4);
            //2 获取数据
            const void *photo = sqlite3_column_blob(stmt, 4);
            //3 转成NSData
            NSData *photoData = [NSData dataWithBytes:photo length:length];
            //4 转成UIImage
            UIImage *image = [UIImage imageWithData:photoData];
             */
            //添加到数组
            [persons addObject:person];
        }
    }
    //释放stmt指针
    sqlite3_finalize(stmt);
    //关闭数据库
    [WLSQLite closeDB];
    return persons;
}

六.基本操作

1.创建表

create table 表名 (字段名1 字段类型1, 字段名2 字段类型2, …);

create table if not exists 表名 (字段名1 字段类型1, 字段名2 字段类型2, …);

示例

create table t_student (id integer, name text, age integer, score real);

2.字段类型

SQLite将数据划分为以下几种存储类型:

integer:整型值

real:浮点值

text:文本字符串

blob:二进制数据(比如文件)

注意:实际上SQLite是无类型的,就算声明为integer类型,还是能存储字符串文本(主键除外)

建表时声明啥类型或者不声明类型都可以,也就意味着创表语句可以这么写:

create table t_student(name, age);

提示:为了保持良好的编程规范、方便程序员之间的交流,编写建表语句的时候最好加上每个字段的具体类型

3.删表

格式

drop table 表名 ;

drop table if exists 表名 ;

示例

drop table t_student ;

4.插入数据(insert)

格式

insert into 表名 (字段1, 字段2, …) values (字段1的值, 字段2的值, …) ;

示例

insert into t_student (name, age) values (‘mj’, 10) ;

注意:数据库中的字符串内容应该用单引号 ' 括住

5.更新数据(update)

格式

update 表名 set 字段1 = 字段1的值, 字段2 = 字段2的值, … ; 

示例

update t_student set name = 'jack', age = 20 ;

注意:上面的示例会将t_student表中所有记录的name都改为jack，age都改为20

6.删除数据（delete）

格式

delete from 表名 ;

示例

delete from t_student ;

注意:上面的示例会将t_student表中所有记录都删掉

7.条件语句

如果只想更新或者删除某些固定的记录，那就必须在DML语句后加上一些条件

条件语句的常见格式

where 字段 = 某个值 ;   // 不能用两个 =

where 字段 is 某个值 ;   // is 相当于 = 

where 字段 != 某个值 ; 

where 字段 is not 某个值 ;   // is not 相当于 != 

where 字段 > 某个值 ; 

where 字段1 = 某个值 and 字段2 > 某个值 ;  // and相当于C语言中的 &&

where 字段1 = 某个值 or 字段2 = 某个值 ;  //  or 相当于C语言中的 ||

示例

将t_student表中年龄大于10 并且 姓名不等于jack的记录，年龄都改为 5

update t_student set age = 5 where age > 10 and name != 'jack' ;

删除t_student表中年龄小于等于10 或者 年龄大于30的记录

delete from t_student where age <= 10 or age > 30 ;

猜猜下面语句的作用

update t_student set score = age where name = 'jack' ;

将t_student表中名字等于jack的记录,score字段的值都改为age字段的值

8.DQL语句

格式

select 字段1, 字段2, … from 表名 ;

select * from 表名;   //  查询所有的字段

示例

select name, age from t_student;

select * from t_student ;

select * from t_student where age > 10 ;  //  条件查询

9.起别名

格式(字段和表都可以起别名)

select 字段1 别名 , 字段2 别名 , … from 表名 别名 ;

select 字段1 别名, 字段2 as 别名, … from 表名 as 别名 ;

select 别名.字段1, 别名.字段2, … from 表名 别名 ;

示例

select name myname, age myage from t_student ;

给name起个叫做myname的别名，给age起个叫做myage的别名

select s.name, s.age from t_student s ;

给t_student表起个别名叫做s，利用s来引用表中的字段

10.计算记录的数量

格式

select count (字段) from 表名 ;

select count (*) from 表名 ;

示例

select count (age) from t_student ;

select count ( * ) from t_student where score >= 60;

11.排序

查询出来的结果可以用order by进行排序

select * from t_student order by 字段 ;

select * from t_student order by age ;

默认是按照升序排序(由小到大),也可以变为降序(由大到小)

select * from t_student order by age desc ;  //降序

select * from t_student order by age asc ;   // 升序(默认)

也可以用多个字段进行排序

select * from t_student order by age asc, height desc ;

先按照年龄排序(升序),年龄相等就按照身高排序(降序)

12.limit

使用limit可以精确地控制查询结果的数量,比如每次只查询10条数据

格式

select * from 表名 limit 数值1, 数值2 ;

示例

select * from t_student limit 4, 8 ;

可以理解为：跳过最前面4条语句，然后取8条记录

limit常用来做分页查询，比如每页固定显示5条数据，那么应该这样取数据

第1页：limit 0, 5

第2页：limit 5, 5

第3页：limit 10, 5

…

第n页：limit 5*(n-1), 5

select * from t_student limit 7 ;这条语句的作用相当于select * from t_student limit 0, 7 ;表示取最前面的7条记录

七.约束

1.简单约束

建表时可以给特定的字段设置一些约束条件,常见的约束有

not null:规定字段的值不能为null

unique:规定字段的值必须唯一

default:指定字段的默认值

(建议:尽量给字段设定严格的约束,以保证数据的规范性)

示例

create table t_student (id integer, name text not null unique, age integer not null default 1) ;

name字段不能为null,并且唯一

age字段不能为null,并且默认为1

2.主键约束

(1)简单说明

如果t_student表中就name和age两个字段，而且有些记录的name和age字段的值都一样时，那么就没法区分这些数据，造成数据库的记录不唯一，这样就不方便管理数据

良好的数据库编程规范应该要保证每条记录的唯一性，为此，增加了主键约束

也就是说，每张表都必须有一个主键，用来标识记录的唯一性

(2)什么是主键

主键(Primary Key,简称PK)用来唯一地标识某一条记录

例如t_student可以增加一个id字段作为主键,相当于人的身份证

主键可以是一个字段或多个字段

(3)主键的设计原则

主键应当是对用户没有意义的

永远也不要更新主键

主键不应包含动态变化的数据

主键应当由计算机自动生成

(4)主键的声明

在创表的时候用primary key声明一个主键

create table t_student (id integer primary key, name text, age integer) ;

integer类型的id作为t_student表的主键

主键字段

只要声明为primary key,就说明是一个主键字段

主键字段默认就包含了not null 和 unique 两个约束

说明：如果想要让主键自动增长(必须是integer类型),应该增加autoincrement

create table t_student (id integer primary key autoincrement, name text, age integer) ;

3.外键约束

利用外键约束可以用来建立表与表之间的联系

外键的一般情况是:一张表的某个字段,引用着另一张表的主键字段

新建一个外键

create table t_student (id integer primary key autoincrement, name text, age integer, class_id integer, constraint fk_student_class foreign key (class_id) references t_class (id));

t_student表中有一个叫做fk_t_student_class_id_t_class_id的外键

这个外键的作用是用t_student表中的class_id字段引用t_class表的id字段

4.表连接查询

表连接查询：需要联合多张表才能查到想要的数据

表连接的类型

内连接:inner join 或者 join  (显示的是左右表都有完整字段值的记录)

左外连接:left outer join (保证左表数据的完整性)

示例

查询0316iOS班的所有学生

select s.name,s.age from t_student s, t_class c where s.class_id = c.id and c.name = '0316iOS';