【iOS】sqlite3的使用（増删改查）

最新推荐文章于 2021-02-27 19:43:49 发布

imJackXu

最新推荐文章于 2021-02-27 19:43:49 发布

阅读量4k

点赞数

分类专栏： iOS 文章标签： iOS sqlite3 sqlite 数据库

本文链接：https://blog.csdn.net/dolacmeng/article/details/46534575

版权

iOS 专栏收录该内容

106 篇文章 3 订阅

订阅专栏

一、sqlite3常用函数

二、将sqlite3集成到项目，实现増删改查

三、封装DBManager

四、Demo

一、sqlite3常用函数及解释

（1）sqlite3_open:

用来创建和打开数据库文件，接收两个参数，第一个是数据库的名字，第二个是数据库的句柄。如果数据库文件不存在，将首先新建它，然后再打开它，否则只是打开它。

（2）sqlite3_prepare_v2:

使用格式化的字符串来获得sql准备语句（prepared statement），然后转化为可被SQLite3识别的执行语句。（实际上这个函数并不执行这个SQL语句）

（3）sqlite3_step:

这个函数执行上一个函数调用创建的准备语句，这个语句执行到结果的第一行可用的位置，再次调用sqlite3_setp()，会继续前进到结果的第二行。当执行插入、更新、删除操作时会被调用一次，当执行取回数据时可以执行多次。这个函数不能在sqlite3_preprare_v2之前调用。

（4）sqlite3_column_count:

返回表的列数

（5）sqlite3_column_text:

以text的格式返回列的内容（实际上是C的char*类型）。它接收两个参数，SQLite语句和列的索引。

（6）sqlite3_column_name:

返回列的名字，参数和上一个函数一样

（7）sqlite3_changes:

返回执行语句后受影响的行数

（8）sqlite3_last_insert_rowid:

返回最后插入的行的id

（9）sqlite3_errmsg:

返回SQLite错误描述

（10）sqlite3_finalize:

从内存删除之前sqlite3_prepare_v2函数创建的准备语句

（11）sqlite3_close:

关闭数据库连接，在结束任何数据库数据修改后调用，它将释放其存储的系统资源。

二、将sqlite3集成到项目，实现増删改查

1.首先需要将SQLite3的库添加到工程，输入sqlite，从推荐选项中选择libsqlite3.dylib ，如下图。

2.导入sqlite3的头文件：#import <sqlite3.h>

3.定义宏，方便后面使用，并声明一个sqlite3 句柄

#define DBNAME    @"myDB.sqlite"
#define TABLENAME @"PERSONINFO"
#define NAME      @"name"

@interface ViewController (){
    sqlite3 *db;
}

3.创建和打开数据库文件

  NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
  NSString *documents = [paths objectAtIndex:0];
  NSString *database_path = [documents stringByAppendingPathComponent:DBNAME];    
  if (sqlite3_open([database_path UTF8String], &db)!= SQLITE_OK) {
       sqlite3_close(db);
       NSLog(@"打开数据库失败");
  }

4. 新建一个sql语句操作数据库的函数

-(void)execSql:(NSString *)sql  
{  
    char *err;  
    if (sqlite3_exec(db, [sql UTF8String], NULL, NULL, &err) != SQLITE_OK) {  
        sqlite3_close(db);  
        NSLog(@"数据库操作数据失败!");  
    }  
}

5.创建数据表，表名为2中的宏定义PERSONINFO

NSString *sqlCreateTable = @"CREATE TABLE IF NOT EXISTS PERSONINFO(peopleInfoID integer primary key, firstname text, lastname text, age integer);";  
[self execSql:sqlCreateTable];

6.插入一条名字为张三，年龄22岁的记录

NSString *sql = [NSString stringWithFormat:@"insert into peopleInfo values(null, '%@', '%@', %d)", @“张”,@“三”,22]; 
 
[self execSql:sql];

7.查询所有记录

NSString *sqlQuery = @"SELECT * FROM PERSONINFO";  
   sqlite3_stmt * statement;  
     
   if (sqlite3_prepare_v2(db, [sqlQuery UTF8String], -1, &statement, nil) == SQLITE_OK) {  
       while (sqlite3_step(statement) == SQLITE_ROW) {  
           char *firstName = (char*)sqlite3_column_text(statement, 1);  
           NSString *firstNameStr = [[NSString alloc]initWithUTF8String:firstName];  
             <pre name="code" class="objc">           char *lastName = (char*)sqlite3_column_text(statement, 2);  
           NSString *lastNameStr = [[NSString alloc]initWithUTF8String:lastName];

int age = sqlite3_column_int(statement, 3); NSLog(@"firstName:%@ lastName:%@ age:%d", firstNameStr ,lastNameStr, age);
} } sqlite3_close(db);

三、封装DBManager

(1) 新建一个添加一个DBManager类: 选择File > New > File…，选择 Cocoa Touch Class，单击下一步，按如图所示操作。

（2）.h文件

#import <Foundation/Foundation.h>

@interface DBManager : NSObject

@property (nonatomic, strong) NSMutableArray *arrColumnNames;//存储列名
@property (nonatomic) int affectedRows;//记录被改变的行数
@property (nonatomic) long long lastInsertedRowID;//记录最后插入行的id

-(NSArray *)loadDataFromDB:(NSString *)query;//查询
-(void)executeQuery:(NSString *)query;//插入、更新、删除
-(instancetype)initWithDatabaseFilename:(NSString *)dbFilename;//初始化方法
-(BOOL)createTableWithSql:(const char *)sql_stmt;//新建表

@end

（3）.m文件

#import "DBManager.h"
#import <sqlite3.h> //导入sqlite3的头文件

@interface DBManager()

@property (nonatomic, strong) NSString *documentsDirectory;
@property (nonatomic, strong) NSString *databaseFilename;
@property (nonatomic, strong) NSMutableArray *arrResults;

@end

@implementation DBManager

-(instancetype)initWithDatabaseFilename:(NSString *)dbFilename{
    self = [super init];
    if (self) {
        //获得存储路径
        NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
        self.documentsDirectory = [paths objectAtIndex:0];
        
        //数据库名
        self.databaseFilename = dbFilename;
    }
    return self;
}

#pragma mark 建表
-(BOOL)createTableWithSql:(const char *)sql_stmt{
    BOOL isSuccess = YES;
    //检查数据库文件是否已经存在
    NSString *destinationPath = [self.documentsDirectory stringByAppendingPathComponent:self.databaseFilename];
    NSLog(@"path:%@",destinationPath);
    if (![[NSFileManager defaultManager] fileExistsAtPath:destinationPath]) {
        sqlite3 *database = nil;
        const char *dbpath = [destinationPath UTF8String];
        if (sqlite3_open(dbpath, &database) == SQLITE_OK){
            char *errMsg;
            if (sqlite3_exec(database, sql_stmt, NULL, NULL, &errMsg)
                != SQLITE_OK)
            {
                isSuccess = NO;
                NSLog(@"Failed to create table");
            }
            sqlite3_close(database);
        }else{
            isSuccess = NO;
            NSLog(@"Failed to open/create table");
        }
    }
    return isSuccess;
}

#pragma mark 执行sql语句
-(void)runQuery:(const char *)query isQueryExecutable:(BOOL)queryExecutable{
    //创建一个sqlite3对象
    sqlite3 *sqlite3Database;
    
    //设置数据库路径
    NSString *databasePath = [self.documentsDirectory stringByAppendingPathComponent:self.databaseFilename];
    
    //初始化存储结果的array
    if (self.arrResults != nil) {
        [self.arrResults removeAllObjects];
        self.arrResults = nil;
    }
    self.arrResults = [[NSMutableArray alloc] init];
    
    //初始化存储列名的array
    if (self.arrColumnNames != nil) {
        [self.arrColumnNames removeAllObjects];
        self.arrColumnNames = nil;
    }
    self.arrColumnNames = [[NSMutableArray alloc] init];
    
    
    //打开数据库
    BOOL openDatabaseResult = sqlite3_open([databasePath UTF8String], &sqlite3Database);
    if(openDatabaseResult == SQLITE_OK) {
        //声明一个sqlite3_stmt对象，存储查询结果
        sqlite3_stmt *compiledStatement;
        
        //将所有数据加载到内存
        BOOL prepareStatementResult = sqlite3_prepare_v2(sqlite3Database, query, -1, &compiledStatement, NULL);
        if(prepareStatementResult == SQLITE_OK) {
            //是否是查询语句
            if (!queryExecutable){
                //用来保存每一行数据
                NSMutableArray *arrDataRow;
                
                //将结果一行行地加入到arrDataRow中
                while(sqlite3_step(compiledStatement) == SQLITE_ROW) {
                    //初始化arrDataRow
                    arrDataRow = [[NSMutableArray alloc] init];
                    
                    //获得列数
                    int totalColumns = sqlite3_column_count(compiledStatement);
                    
                    //读取和保存每一列数据
                    for (int i=0; i<totalColumns; i++){
                        //将数据转化为char
                        char *dbDataAsChars = (char *)sqlite3_column_text(compiledStatement, i);
                        
                        //数据不为空则加到arrDataRow中
                        if (dbDataAsChars != NULL) {
                            //将char转化为string.
                            [arrDataRow addObject:[NSString  stringWithUTF8String:dbDataAsChars]];
                        }
                        
                        //保存列名（只保存一次）
                        if (self.arrColumnNames.count != totalColumns) {
                            dbDataAsChars = (char *)sqlite3_column_name(compiledStatement, i);
                            [self.arrColumnNames addObject:[NSString stringWithUTF8String:dbDataAsChars]];
                        }
                    }
                    
                    //如果不为空，将每行的数据保存到
                    if (arrDataRow.count > 0) {
                        [self.arrResults addObject:arrDataRow];
                    }
                }
            }
            else {
                //插入、更新、删除等操作
                if (sqlite3_step(compiledStatement) == SQLITE_DONE) {
                    // 被改变了多少行
                    self.affectedRows = sqlite3_changes(sqlite3Database);
                    
                    // 最后插入的行id
                    self.lastInsertedRowID = sqlite3_last_insert_rowid(sqlite3Database);
                }
                else {
                    // 插入、更新、删除等错误
                    NSLog(@"DB Error: %s", sqlite3_errmsg(sqlite3Database));
                }
            }
        }
        else {
            //打开错误
            NSLog(@"%s", sqlite3_errmsg(sqlite3Database));
        }
        
        // 释放内存
        sqlite3_finalize(compiledStatement);
        
    }
    
    // 关闭数据库
    sqlite3_close(sqlite3Database);
}

-(NSArray *)loadDataFromDB:(NSString *)query{
    // 执行查询
    [self runQuery:[query UTF8String] isQueryExecutable:NO];
    
    // 返回查询结果
    return (NSArray *)self.arrResults;
}

-(void)executeQuery:(NSString *)query{
    // 执行插入、更新、删除等
    [self runQuery:[query UTF8String] isQueryExecutable:YES];
}

@end