数据存储之FMDB

ios开发常用的五种数据存储方式：

plist
NSUserDefaults
NSKeyedArchiver
FMDB
CoreData
这篇文章我们主要回顾FMDB的使用

FMDB

什么是FMDB？简单来说就是以oc的方式对基于c语言的sqlite进行的封装.
什么又是SQL？SQL（structured query language）：结构化查询语言，是一种对关系型数据库中的数据进行定义和操作的语言.

FMDB优点:

(1) 使用起来更加的面相对象，省去了很多麻烦、冗余的c代码
(2) 对比苹果自带的Core Data框架，更加轻量级、灵活
(3) 提供了多线程安全的数据库操作方法，有效地防止数据混乱
(4) FMDB同时兼容ARC和非ARC工程，会自动根据工程配置来调整相关的内存管理代码

FMDB常用类：

FMDatabase ：一个单一的SQLite数据库，用于执行SQL语句
FMResultSet ：执行查询一个FMDatabase的结果集
FMDatabaseQueue ：在多个线程来执行查询和更新时会使用这个类，它是线程安全的

一、FMDB的常见语法及注意事项

1. 创建表格

//注意：sql不区分大小写
create table if not exists t_student (字段名1 字段类型1，字段名2 字段类型2...);
//示例（ integer 整型 real 浮点数 text 文本字符串 blob 二进制数据）
create table if not exists t_student(id integer,name text,age integer,score real);

2. 删除表格

//格式
drop table if exists 表名;
//示例
drop table if exists t_student ;

3. 插入数据

//格式
insert into 表名(字段1，字段2...) values （字段1值，字段2值...）;
//示例(注意：数据中的字符串类型应该用单引号''括住)
insert into t_student (id,name,age,score) values (2010,'xbk',26,100);

4. 更新数据

//格式
update 表名 set 字段1 ＝ 字段一的值，字段2 ＝ 字段2的值... 条件语句 ;
//示例
update t_student set age = 18,id = 2014,score = 99.0 where name = 'xbk';

5. 删除数据

//格式
delete from 表名 where 条件语句;
//示例 (删除所有分数大于等于60分的学生数据信息)
delete from t_student where score >= 60.0;

6. 查询数据

//格式(select * from 表名 表示查询所有字段)
select  * from 表名 条件语句;
//示例(查询所有分数不低于60的学生信息)
select * from t_sudent where score >= 60.0;

//查询特定字段
select name,age from 表名 条件语句 
select name,age from t_student where score > 60;

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表中分数在60-80之间 并且 姓名不等于xbk的记录，分数都改为 100
update t_student set score = 100 where score >= 60 and score <=80 and name != ‘xbk’ ;

8. 记录数据的数量

//格式
select count (字段) from 表名 ;
select count ( * ) from 表名 ;
//示例
select count (age) from t_student ;
select count ( * ) from t_student where score >= 60;

9. 排序

查询出来的结果可以用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 ;
先按照年龄排序（升序），年龄相等就按照身高排序（降序）

10. 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条记录

11. 简单约束

建表时可以给特定的字段设置一些约束条件，常见的约束有
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

12. 主键约束

(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) ;

13. 外键约束

利用外键约束可以用来建立表与表之间的联系
外键的一般情况是：一张表的某个字段，引用着另一张表的主键字段
新建一个外键
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字段

14. 表连接查询

表连接查询：需要联合多张表才能查到想要的数据
表连接的类型
内连接：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’;

15. SQL语句的种类(简单了解)

1.数据定义语句（DDL：Data Definition Language）
包括create和drop等操作
在数据库中创建新表或删除表（create table或 drop table）
2.数据操作语句（DML：Data Manipulation Language）
包括insert、update、delete等操作
上面的3种操作分别用于添加、修改、删除表中的数据
3.数据查询语句（DQL：Data Query Language）
可以用于查询获得表中的数据
关键字select是DQL（也是所有SQL）用得最多的操作
其他DQL常用的关键字有where，order by，group by和having

16. 关键字（简单了解）

select、insert、update、delete、from、create、where、desc、order、by、group、table、alter、view、index等等
数据库中不可以使用关键字来命名表、字段

二、FMDB的使用

我们现在假设存在这样一个场景：数据库中存放着一个carInfo的表格包含以下字段
userId：用户ID
carName：车的品牌（大众、奥迪）
carNumber：车牌号（京A88888）
carId ：本车ID
carIsDefault：是否是默认使用的车辆（默认车辆为1，不是则为0）

每个车主可以有多辆车，同一个车主userId自然是相同的，carId都是唯一的，再牛的你也只能开一辆车，所以使用carIsDefault字段来说明当前你使用的是哪辆车
我们就根据这个场景来学习FMDB的使用

项目中添加FMDB文件，并使用 libsqlite3.dylib 依赖包

屏幕快照 2016-11-26 上午11.37.49.png

你可以手动倒入，也可以使用 cocoapods配置！
然后在项目中引入下列头文件， FMDB就可以使用了！

 #import 
 #import

FMDB地址：https://github.com/ccgus/fmdb

1. 增或修改

#import 
#import 
#import 
@interface CarInfo : NSObject

@property (nonatomic, strong) NSString *userID;      //用户id
@property (nonatomic, strong) NSString *carID;       //车id
@property (nonatomic, strong) NSString *carName;     //车名
@property (nonatomic, strong) NSString *carNumber;   //车牌号
@property (nonatomic, assign) NSInteger carIsDefault;//是否为默认车辆

//向数据库中添加或修改车辆信息
-(BOOL)saveCarDataByUserID:(NSString *)userid carID:(NSString *)carid;

对应的.m文件

#import "CarInfo.h"
#define carSqlite      @"carInfo.sqlite" //数据库路径
#define k_carInfo      @"carInfo"        //表格
//表格中的字符
#define k_userID       @"userID"
#define k_carID        @"carID"
#define k_carName      @"carName"
#define k_carNumber    @"carNumber"
#define k_carIsDefault @"carIsDefault"

@implementation CarInfo

//向数据库中添加或修改车辆信息
-(BOOL)saveCarDataByUserID:(NSString *)userid carID:(NSString *)carid
{
    BOOL retVal = NO;
    //获取数据库路径
    NSString *database_path = [self getFilePath];
    NSLog(@"%@",database_path);
    FMDatabase *database = [FMDatabase databaseWithPath:database_path];
    if ([database open]) {
        //判断数据库中是否有carInfo表格,不存在则创建
        if (![database tableExists:k_carInfo]) {
            NSString *createTableSql = [NSString stringWithFormat:@"CREATE TABLE IF NOT EXISTS '%@' ('%@' text,'%@' text,'%@' text,'%@' text,'%@' text)",k_carInfo,k_userID,k_carID,k_carName,k_carNumber,k_carIsDefault];
            [database executeUpdate:createTableSql];
    }
    //根据userid以及carid查询
    NSString *querySql = [NSString stringWithFormat:@"select * from %@ where %@ = '%@' and %@ = '%@'",k_carInfo,k_userID,userid,k_carID,carid];
    FMResultSet *rs = [database executeQuery:querySql];
    int row = 0;
    while ([rs next]) {
        row++;
    }//如果row大于0说明数据库有这个userid及carid对应的数据，则进行数据的修改(update)
    if (row > 0) {
        //update
        NSString *updateSql = [NSString stringWithFormat:@"update %@ set %@ = '%@',%@ = '%@',%@ = '%@' where %@ = '%@' and %@ = '%@'",k_carInfo,k_carName,self.carName,k_carNumber,self.carNumber,k_carIsDefault,[NSString stringWithFormat:@"%ld",self.carIsDefault],k_userID,self.userID,k_carID,self.carID];
        retVal = [database executeUpdate:updateSql];
    }else{//如果row等于0说明数据库没有有这个userid及carid对应的数据，则进行数据的插入(insert)
        //insert
        NSString *insertSql = [NSString stringWithFormat:@"insert into %@(%@,%@,%@,%@,%@) values ('%@','%@','%@','%@','%@')",k_carInfo,k_userID,k_carID,k_carName,k_carNumber,k_carIsDefault,userid,carid,self.carName,self.carNumber,[NSString stringWithFormat:@"%ld",self.carIsDefault]];
        retVal = [database executeUpdate:insertSql];
    }
    [database close];
  }
  return retVal;
}

其中

-(NSString *)getFilePath
{
   return [[NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES)lastObject] stringByAppendingPathComponent:carSqlite];
}

下面我们在VC中执行此方法看看有什么效果

//向数据库中添加或修改车辆信息
-(void)saveORupdateBtnAction
{
    /*
     *
     *  这里只是简单的演示 FMDB 增、删、改、查的功能，所以自己测试的时候请先多执行几次本方法（多添加几次数据）
     *  然后在本方法添加的数据的基础上 进行下面删、查的测试
     *
     */
    CarInfo *carinfo = [[CarInfo alloc]init];
    carinfo.userID = @"1";
    carinfo.carID = @"djw2nri2i24bi55";
    carinfo.carName = @"兰博基尼";
    carinfo.carNumber = @"京66666";
    carinfo.carIsDefault = 0;
    //返回的是一个bool值，yes表示成功
    if ([carinfo saveCarDataByUserID:carinfo.userID carID:carinfo.carID]) {
        NSLog(@"添加或者修改数据成功");
    };
}

我们的数据添加成功了吗？不急，且先看看打印结果：

2016-11-27 20:26:44.897 DataStorageDemo[24932:1531746] /Users/x8f/Library/Developer/CoreSimulator/Devices/7A1AE587-2880-40CE-A11B-17F7DFE94ACD/data/Containers/Data/Application/31414B4E-8124-4638-BE48-4DE155AB8C30/Documents/carInfo.sqlite
2016-11-27 20:26:44.903 DataStorageDemo[24932:1531746] 添加或者修改数据成功

其中第一行是数据库在沙盒中的路径，然后我们点击前往-->前往文件夹--->输入打印出来的数据库路径：

屏幕快照 2016-11-27 下午8.32.24.png

屏幕快照 2016-11-27 下午8.36.24.png

我们看到

屏幕快照 2016-11-27 下午8.38.24.png

然后我们使用数据库工具打开这个sqlite

屏幕快照 2016-11-27 下午8.44.41.png

perfect ! ! ! 数据添加成功！
然后我们多添加几条数据以便进行删除与查询的操作演示.
我添加了几条数据

屏幕快照 2016-11-27 下午8.57.38.png

2. 查询

//查询某用户车辆信息(userid一定不能为空，carid存在则是查询特定车辆，不存在查询该用户所有车辆)
-(NSArray *)loadCarDateByUserID:(NSString *)userid carID:   (NSString *)carid
{
    NSString *database_path = [self getFilePath];
    FMDatabase *database = [FMDatabase databaseWithPath:database_path];
    if ([database open]) {
        if ([database tableExists:@"carInfo"]) {
            NSString *querySql;
            if (carid) {
                querySql = [NSString stringWithFormat:@"select * from %@ where %@ = '%@' and %@ = '%@'",k_carInfo,k_userID,userid,k_carID,carid];
            }else{
                querySql = [NSString stringWithFormat:@"select * from %@ where %@ = '%@'",k_carInfo,k_userID,userid];
            }
            FMResultSet *rs = [database executeQuery:querySql];
            NSMutableArray *carListArr = [NSMutableArray new];
            while ([rs next]) {
                CarInfo *carinfo = [[CarInfo alloc]init];
                carinfo.userID = [rs stringForColumn:k_userID];
                carinfo.carID = [rs stringForColumn:k_carID];
                carinfo.carName = [rs stringForColumn:k_carName];
                carinfo.carNumber = [rs stringForColumn:k_carNumber];
                carinfo.carIsDefault = [[rs stringForColumn:k_carIsDefault] integerValue];
                [carListArr addObject:carinfo];
            }
            return carListArr;
        }else{
            return nil;
        }
    }else{
        return nil;
     }
}

在VC中执行此方法

//查询某用户的全部车辆信息
-(void)loadDateBtnAction
{
   CarInfo *carinfo = [[CarInfo alloc]init];
   carinfo.userID = @"1";
   //这里最少要给一个userID  用于查询某用户的所有车辆信息
   NSArray *arr = [carinfo loadCarDateByUserID:carinfo.userID carID:nil];
   if (arr) {
       for (CarInfo *info in arr) {
           NSLog(@"%@---%@---%@---%@---%ld",info.userID,info.carID,info.carName,info.carNumber,info.carIsDefault);
       }
     }
  }

查看打印结果：

2016-11-27 21:12:09.321 DataStorageDemo[25318:1555432] /Users/x8f/Library/Developer/CoreSimulator/Devices/7A1AE587-2880-40CE-A11B-17F7DFE94ACD/data/Containers/Data/Application/2BE1BF87-F6D6-4D1D-B9F8-93488C850351/Documents/carInfo.sqlite
2016-11-27 21:12:09.326 DataStorageDemo[25318:1555432] 1---djw2nri2i24bi55---兰博基尼---京66666---0
2016-11-27 21:12:09.327 DataStorageDemo[25318:1555432] 1---93435n3nn2b2b1---法拉利---京A99999---1
2016-11-27 21:12:09.327 DataStorageDemo[25318:1555432] 1---dnk3r35k5n6363---保时捷---京A77777---0

3. 删除

这里只演示删除特定车辆

//根据userid、carid删除某用户特定车辆信息
-(BOOL)removeCarDataByUserId:(NSString *)userid carID:(NSString *)carid
{
   BOOL retVal = NO;
   NSString *database_path = [self getFilePath];
   FMDatabase *database = [FMDatabase databaseWithPath:database_path];
   if ([database open]) {
       if ([database tableExists:@"carInfo"]) {
           NSString *deleteSql = [NSString stringWithFormat:@"delete from %@ where %@ = '%@' and %@ = '%@'",k_carInfo,k_userID,userid,k_carID,carid];
           retVal = [database executeUpdate:deleteSql];
       }
       [database close];
     }
   return retVal;
}