iOS开发 - 第06篇 - 实用技术 - 02 - 数据库SQLite & FMDB

1、iOS中的数据存储方式

1>plist：将数据放到一个NSArray或者NSDictionary，通过writeToFile:写到plist中，存放到沙盒。

注：这种方法只能存放普通数据类型NSNumber、NSString等，不能用于存放自定义对象！

2>Preference(偏好设置\NSUserDefaults)

注：本质也是plist，也只能存放简单的数据！

3>NSCoding(NSKeyedArchiver\NSkeyedUnarchiver)

注：只要对象遵循了NSCoding协议，都能把对象写到文件中！

注：上述三种方法都有一个缺点，不能存储大批量数据！！！

原因：上述三种方法需要修改数据再重新存取的时候，需要先将数据全部读到内存中，再增删改查数据，再将全部数据写入沙盒覆盖原文件，一旦数据量很大会导致内存很大！！！

4>SQLite3

5>Core Data

注1：SQLite3和Core Data区别：前者属于纯C语言，轻量级；后者基于SQLite3，OC版本，重量级，庞大；

注2：上述两种数据库不需要将所有数据读到内存中，适用于存储大批量数据，而且可以检索数据！！！

2、SQLite

2.1 基本知识

1>什么是SQLite

SQLite是一款轻型的嵌入式数据库，它占用资源非常的低，在嵌入式设备中，可能只需要几百K的内存就够了，它的处理速度比Mysql、PostgreSQL这两款著名的数据库都还快。

2>什么是数据库

数据库(Database)是按照数据结构来组织、存储和管理数据的仓库，数据库可以分为2大种类：

关系型数据库(主流)

对象型数据库

3>常用关系型数据库

PC端：Oracle、MySQL、SQLServer、Access、DB2、Sybase

嵌入式\移动客户端：SQLite

4>数据库是如何存储数据的

数据库的存储结构和excel很像，以表(table)为单位

5>数据库存储数据的步骤

新建一张表(table)

添加多个字段(column，列，属性)

添加多行记录(row，record，每行存放多个字段对应的值)

2.2 SQL语句

1>通过使用SQL语句在程序运行过程中操作数据库中的数据；

2>什么是SQL

SQL(structuredquery language)：结构化查询语言，是一种对关系型数据库中的数据进行定义和操作的语言；

在程序运行过程中，要想操作（增删改查，CRUD）数据库中的数据，必须使用SQL语句；

3>SQL语句的特点

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

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

3. SQL中的常用关键字有：

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

4. 数据库中不可以使用关键字来命名表、字段

4> SQL语句种类

1. 数据定义语句(DDL：DataDefinition Language)

包括create和drop等操作：在数据库中创建新表或删除表(create table或 drop table)

2. 数据操作语句(DML：DataManipulation Language)

包括insert、update、delete等操作：上面的3种操作分别用于添加、修改、删除表中的数据

3. 数据查询语句(DQL：DataQuery Language)

可以用于查询获得表中的数据：关键字select是DQL(也是所有SQL)用得最多的操作，其他DQL常用的关键字有where，order by，group by和having

具体语法参考教程：点击打开链接

3、使用SQLite

1> 导入libsqlite3.0.dylib

2> #import>

实现：可以添加数据到数据库中，并进行查询操作

#import "HMViewController.h"
#import 
#import "HMShop.h"

@interface HMViewController () 

@property (weak, nonatomic) IBOutlet UITextField *nameField;
@property (weak, nonatomic) IBOutlet UITextField *priceField;
/** 数据库对象实例 */
@property (nonatomic, assign) sqlite3 *db;
@property (weak, nonatomic) IBOutlet UITableView *tableView;
- (IBAction)insert;
@property (nonatomic, strong) NSMutableArray *shops;

@end

@implementation HMViewController

- (NSMutableArray *)shops
{
    if (!_shops) {
        self.shops = [[NSMutableArray alloc] init];
    }
    return _shops;
}

- (void)viewDidLoad
{
    [super viewDidLoad];
    
    // 增加搜索框
    UISearchBar *searchBar = [[UISearchBar alloc] init];
    searchBar.frame = CGRectMake(0, 0, 320, 44);
    searchBar.delegate = self;
    self.tableView.tableHeaderView = searchBar;
    
    // 初始化数据库
    [self setupDb];
    
    // 查询数据
    [self setupData];
    
    // 关闭数据库(一般不需要关闭)
    // sqlite3_close();
}

#pragma mark - UISearchBarDelegate
- (void)searchBar:(UISearchBar *)searchBar textDidChange:(NSString *)searchText
{
    [self.shops removeAllObjects];
    
    NSString *sql = [NSString stringWithFormat:@"SELECT name,price FROM t_shop WHERE 
                    name LIKE '%%%@%%' OR  price LIKE '%%%@%%' ;", searchText, searchText];
    // stmt是用来取出查询结果的
    sqlite3_stmt *stmt = NULL;
    // 准备
    int status = sqlite3_prepare_v2(self.db, sql.UTF8String, -1, &stmt, NULL);
    if (status == SQLITE_OK) { // 准备成功 -- SQL语句正确
        while (sqlite3_step(stmt) == SQLITE_ROW) { // 成功取出一条数据
            const char *name = (const char *)sqlite3_column_text(stmt, 0);
            const char *price = (const char *)sqlite3_column_text(stmt, 1);
            
            HMShop *shop = [[HMShop alloc] init];
            shop.name = [NSString stringWithUTF8String:name];
            shop.price = [NSString stringWithUTF8String:price];
            [self.shops addObject:shop];
        }
    }
    
    [self.tableView reloadData];
}

/**
 * 查询数据
 */
- (void)setupData
{
    const char *sql = "SELECT name,price FROM t_shop;";
    // stmt是用来取出查询结果的
    sqlite3_stmt *stmt = NULL;
    // 准备
    int status = sqlite3_prepare_v2(self.db, sql, -1, &stmt, NULL);
    if (status == SQLITE_OK) { // 准备成功 -- SQL语句正确
        while (sqlite3_step(stmt) == SQLITE_ROW) { // 成功取出一条数据
            const char *name = (const char *)sqlite3_column_text(stmt, 0);
            const char *price = (const char *)sqlite3_column_text(stmt, 1);
            
            HMShop *shop = [[HMShop alloc] init];
            shop.name = [NSString stringWithUTF8String:name];
            shop.price = [NSString stringWithUTF8String:price];
            [self.shops addObject:shop];
        }
    }
}

/**
 * 初始化数据库
 */
- (void)setupDb
{
    // 打开数据库(连接数据库)
    NSString *filename = [[NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, 
                            NSUserDomainMask, YES) lastObject] stringByAppendingPathComponent:@"shops.sqlite"];
    // 如果数据库文件不存在, 系统会自动创建文件自动初始化数据库
    int status = sqlite3_open(filename.UTF8String, &_db);
    if (status == SQLITE_OK) { // 打开成功
        NSLog(@"打开数据库成功");
        
        // 创表
        const char *sql = "CREATE TABLE IF NOT EXISTS t_shop (id integer PRIMARY KEY, name text NOT NULL, price real);";
        char *errmsg = NULL;
        sqlite3_exec(self.db, sql, NULL, NULL, &errmsg);
        if (errmsg) {
            NSLog(@"创表失败--%s", errmsg);
        }
    } else { // 打开失败
        NSLog(@"打开数据库失败");
    }
}

- (IBAction)insert {
    NSString *sql = [NSString stringWithFormat:@"INSERT INTO t_shop(name, price) VALUES ('%@', %f);", 
                    self.nameField.text, self.priceField.text.doubleValue];
    sqlite3_exec(self.db, sql.UTF8String, NULL, NULL, NULL);
    
    // 刷新表格
    HMShop *shop = [[HMShop alloc] init];
    shop.name = self.nameField.text;
    shop.price = self.priceField.text;
    [self.shops addObject:shop];
    [self.tableView reloadData];
}

#pragma mark - 数据源方法
- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section
{
    return self.shops.count;
}

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath
{
    static NSString *ID = @"shop";
    UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:ID];
    if (!cell) {
        cell = [[UITableViewCell alloc] initWithStyle:UITableViewCellStyleSubtitle reuseIdentifier:ID];
        cell.backgroundColor = [UIColor grayColor];
    }
    
    HMShop *shop = self.shops[indexPath.row];
    cell.textLabel.text = shop.name;
    cell.detailTextLabel.text = shop.price;
    
    return cell;
}

@end

4、SQLite函数总结

1.打开数据库
int sqlite3_open(
    const char *filename,   // 数据库的文件路径
    sqlite3 **ppDb          // 数据库实例
);

2.执行任何SQL语句
int sqlite3_exec(
    sqlite3*,                                  // 一个打开的数据库实例
    const char *sql,                           // 需要执行的SQL语句
    int (*callback)(void*,int,char**,char**),  // SQL语句执行完毕后的回调
    void *,                                    // 回调函数的第1个参数
    char **errmsg                              // 错误信息
);

3.检查SQL语句的合法性（查询前的准备）
int sqlite3_prepare_v2(
    sqlite3 *db,            // 数据库实例
    const char *zSql,       // 需要检查的SQL语句
    int nByte,              // SQL语句的最大字节长度
    sqlite3_stmt **ppStmt,  // sqlite3_stmt实例，用来获得数据库数据
    const char **pzTail
);

4.查询一行数据
int sqlite3_step(sqlite3_stmt*); // 如果查询到一行数据，就会返回SQLITE_ROW

5.利用stmt获得某一字段的值（字段的下标从0开始）
double sqlite3_column_double(sqlite3_stmt*, int iCol);  // 浮点数据
int sqlite3_column_int(sqlite3_stmt*, int iCol); // 整型数据
sqlite3_int64 sqlite3_column_int64(sqlite3_stmt*, int iCol); // 长整型数据
const void *sqlite3_column_blob(sqlite3_stmt*, int iCol); // 二进制文本数据
const unsigned char *sqlite3_column_text(sqlite3_stmt*, int iCol);  // 字符串数据

5、FMDB

5.1 简介

FMDB是iOS平台的SQLite数据库框架，FMDB以OC的方式封装了SQLite的C语言API；

FMDB的优点：使用起来更加面向对象，省去了很多麻烦、冗余的C语言代码，对比苹果自带的CoreData框架，更加轻量级和灵活，提供了多线程安全的数据库操作方法，有效地防止数据混乱；

5.2 基本使用

1> FMDB有三个主要的类

FMDatabase：一个FMDatabase对象就代表一个单独的SQLite数据库，用来执行SQL语句；

FMResultSet：使用FMDatabase执行查询后的结果集

FMDatabaseQueue：用于在多线程中执行多个查询或更新，它是线程安全的

2> 打开数据库

1. 通过指定SQLite数据库文件路径来创建FMDatabase对象

FMDatabase*db = [FMDatabase databaseWithPath:path];

if(![db open]) {

    NSLog(@"数据库打开失败！");

}

2. 文件路径有三种情况：

具体文件路径：如果不存在会自动创建

空字符串@""：会在临时目录创建一个空的数据库，当FMDatabase连接关闭时，数据库文件也被删除

nil：会创建一个内存中临时数据库，当FMDatabase连接关闭时，数据库会被销毁

 

3> 执行更新

在FMDB中，除查询以外的所有操作，都称为“更新”，create、drop、insert、update、delete等

使用executeUpdate:方法执行更新

- (BOOL)executeUpdate:(NSString*)sql, ...
- (BOOL)executeUpdateWithFormat:(NSString*)format, ...
- (BOOL)executeUpdate:(NSString*)sql withArgumentsInArray:(NSArray *)arguments

// 示例：
[db executeUpdate:@"UPDATE t_student SET age = ? WHERE name = ?;", @20, @"Jack"]；

4> 执行查询

- (FMResultSet *)executeQuery:(NSString*)sql, ...
- (FMResultSet *)executeQueryWithFormat:(NSString*)format, ...
- (FMResultSet *)executeQuery:(NSString *)sql withArgumentsInArray:(NSArray *)arguments

// 示例
// 查询数据
FMResultSet *rs = [db executeQuery:@"SELECT * FROM t_student"];

// 遍历结果集
while ([rs next]) {
    NSString *name = [rs stringForColumn:@"name"];
    int age = [rs intForColumn:@"age"];
    double score = [rs doubleForColumn:@"score"];
}

5.3 示例

在实际使用中，往往将关于数据的操作封装到工具类中，把数据库语句封装起来，不让控制器关注数据库语句，需要使用的时候调用即可，这样的好处：一旦需要修改数据库的使用方式，如需要改成CoreData，就不需要在每一个使用数据的控制器中修改，直接修改工具类即可！！！

1> HMShopTool

#import "HMShopTool.h"
#import "FMDB.h"
#import "HMShop.h"

@implementation HMShopTool

static FMDatabase *_db;

+ (void)initialize
{
    // 1.打开数据库
    NSString *path = [[NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, 
                        NSUserDomainMask, YES) lastObject] stringByAppendingPathComponent:@"shops.sqlite"];
    _db = [FMDatabase databaseWithPath:path];
    [_db open];
    
    // 2.创表
    [_db executeUpdate:@"CREATE TABLE IF NOT EXISTS t_shop (id integer PRIMARY KEY, name text NOT NULL, price real);"];
}

+ (void)addShop:(HMShop *)shop
{
#warning 这里的字符串不用再加上''
    [_db executeUpdateWithFormat:@"INSERT INTO t_shop(name, price) VALUES (%@, %f);", shop.name, shop.price];
}

+ (NSArray *)shops
{
    // 得到结果集
    FMResultSet *set = [_db executeQuery:@"SELECT * FROM t_shop;"];
    
    // 不断往下取数据
    NSMutableArray *shops = [NSMutableArray array];
    while (set.next) {
        // 获得当前所指向的数据
        HMShop *shop = [[HMShop alloc] init];
        shop.name = [set stringForColumn:@"name"];
        shop.price = [set doubleForColumn:@"price"];
        [shops addObject:shop];
    }
    return shops;
}
@end

2> 外界使用

直接调用方法即可！！！