iOS數(shù)據(jù)持久化 - SQLite

一.簡介

  • 特點
    1.SQLite是嵌入式\移動客戶端使用的輕量級關系數(shù)據(jù)庫.
    2.SQLite占用資源非常少,在嵌入式設備中只需要幾百K的內存就夠了,目前應用于Android、iOS、Windows Phone等智能手機.
    3.SQLite是無類型的數(shù)據(jù)庫,可以保存任何類型的數(shù)據(jù),對于SQLite來說對字段不指定類型是完全有效的.
  • 近似類型
    SQLite為了和其他數(shù)據(jù)庫兼容性最大化,支持“近似類型”的觀點,列的"近似類型"指的是存儲列上數(shù)據(jù)的推薦類型.
  • 近似類型規(guī)則

如果類型字符串中包含“int”,那么該字段的親緣類型是INTEGER
如果類型字符串中包含“char”、“clob”或“text”,那么該字段的親緣類型是TEXT,如VARCHAR
如果類型字符串中包含“blob”,那么該字段的親緣類型是none
如果類型字符串中包含“real”、“floa”或“doub”,那么該字段的親緣類型是real
其余情況下,字段的親緣類型為NUMERIC

  • 字段約束條件

not null - 非空
unique - 唯一
primary key - 主鍵
foreign key - 外鍵
check - 條件檢查,確保一列中的所有值滿足一定條件
default - 默認
autoincreatement - 自增型變量

  • 建議使用場景
    儲存大量需要增刪改查且數(shù)據(jù)之間有一定邏輯關系的數(shù)據(jù).

二.使用

  • 注意
    程序中一般只有一個數(shù)據(jù)庫,可以在數(shù)據(jù)庫中創(chuàng)建多張表來保存不同的信息,千萬不要創(chuàng)建多個數(shù)據(jù)庫,每個數(shù)據(jù)庫中只有一張表,因為不斷的連接,關閉數(shù)據(jù)庫非常消耗性能.
  • 添加依賴
    加入libsqlite3.0.tbd框架以及引入sqlite3.h頭文件.
  • 打開數(shù)據(jù)庫
    創(chuàng)建一個類對數(shù)據(jù)庫進行操作
#import "SQLService.h"

@implementation SQLService

// 創(chuàng)建數(shù)據(jù)庫指針
static sqlite3 *sql = nil;

// 打開數(shù)據(jù)庫
+ (sqlite3 *)open {
    
    // 此方法的主要作用是打開數(shù)據(jù)庫
    // 返回值是一個數(shù)據(jù)庫指針
    // 因為這個數(shù)據(jù)庫在很多的SQLite API(函數(shù))中都會用到,我們聲明一個類方法來獲取,更加方便

    // 懶加載
    if (sql != nil) {
        return sql;
    }
    
    // 獲取Documents路徑
    NSString *docPath = [NSSearchPathForDirectoriesInDomains(NSDocumentationDirectory, NSUserDomainMask, YES) lastObject];
    
    // 生成數(shù)據(jù)庫文件在沙盒中的路徑
    NSString *sqlPath = [docPath stringByAppendingPathComponent:@"studentDB.sqlite"];
    
    // 創(chuàng)建文件管理對象
    NSFileManager *fileManager = [NSFileManager defaultManager];
    
    // 判斷沙盒路徑中是否存在數(shù)據(jù)庫文件,如果不存在才執(zhí)行拷貝操作,如果存在不在執(zhí)行拷貝操作
    if ([fileManager fileExistsAtPath:sqlPath] == NO) {
        // 獲取數(shù)據(jù)庫文件在包中的路徑
        NSString *filePath = [[NSBundle mainBundle] pathForResource:@"studentDB" ofType:@"sqlite"];
        
        // 使用文件管理對象進行拷貝操作
        // 第一個參數(shù)是拷貝文件的路徑
        // 第二個參數(shù)是將拷貝文件進行拷貝的目標路徑
        [fileManager copyItemAtPath:filePath toPath:sqlPath error:nil];
        
    }
    
    // 打開數(shù)據(jù)庫需要使用一下函數(shù)
    // 第一個參數(shù)是數(shù)據(jù)庫的路徑(因為需要的是C語言的字符串,而不是NSString所以必須進行轉換)
    // 第二個參數(shù)是指向指針的指針
    sqlite3_open([sqlPath UTF8String], &sql);
    
    return sql;
}
  • 關閉數(shù)據(jù)庫
// 關閉數(shù)據(jù)庫
+ (void)close {
    // 關閉數(shù)據(jù)庫
    sqlite3_close(db);
    // 將數(shù)據(jù)庫的指針置空
    db = nil;
}
  • 創(chuàng)建表
    // 將建表的sql語句放入NSString對象中
    NSString *sql = @"create table if not exists stu (ID integer primary key, name text not null, gender text default '男')";
    // 打開數(shù)據(jù)庫
    sqlite3 *sql = [SQLService open];
    
    // 執(zhí)行sql語句
    int result = sqlite3_exec(sql, sql.UTF8String, nil, nil, nil);
    
    if (result == SQLITE_OK) {
        NSLog(@"建表成功");
    } else {
        NSLog(@"建表失敗");
    }
    
    // 關閉數(shù)據(jù)庫
    [SQLService close];
  • 查詢表(全部數(shù)據(jù))
// 獲取表中保存的所有學生
+ (NSArray *)allStudents {
    // 打開數(shù)據(jù)庫
    sqlite3 *sql = [SQLService open];
    
    // 創(chuàng)建一個語句對象
    sqlite3_stmt *stmt = nil;
    
    // 聲明數(shù)組對象
    NSMutableArray *mArr = nil;
    
    // 此函數(shù)的作用是生成一個語句對象,此時sql語句并沒有執(zhí)行,創(chuàng)建的語句對象,保存了關聯(lián)的數(shù)據(jù)庫,執(zhí)行的sql語句,sql語句的長度等信息
    int result = sqlite3_prepare_v2(sql, "select * from Students", -1, &stmt, nil);
    if (result == SQLITE_OK) {
        
        // 為數(shù)組開辟空間
        mArr = [NSMutableArray arrayWithCapacity:0];
        
        // SQLite_ROW僅用于查詢語句,sqlite3_step()函數(shù)執(zhí)行后的結果如果是SQLite_ROW,說明結果集里面還有數(shù)據(jù),會自動跳到下一條結果,如果已經是最后一條數(shù)據(jù),再次執(zhí)行sqlite3_step(),會返回SQLite_DONE,結束整個查詢
        while (sqlite3_step(stmt) == SQLITE_ROW) {
            
            // 獲取記錄中的字段值
            // 第一個參數(shù)是語句對象,第二個參數(shù)是字段的下標,從0開始
            int ID = sqlite3_column_int(stmt, 0);
            const unsigned char *cName = sqlite3_column_text(stmt, 1);
            const unsigned char *cGender = sqlite3_column_text(stmt, 2);
            
            // 將獲取到的C語言字符串轉換成OC字符串
            NSString *name = [NSString stringWithUTF8String:(const char *)cName];
            NSString *gender = [NSString stringWithUTF8String:(const char *)cGender];
            Student *student = [Student studentWithID:ID name:name gender:gender];
            
            // 添加學生信息到數(shù)組中
            [mArr addObject:student];
        }
    }
    
    // 關閉數(shù)據(jù)庫
    sqlite3_finalize(stmt);

    return mArr;
}
  • 查詢表(指定數(shù)據(jù))
// 根據(jù)指定的ID,查找相對應的學生
+ (Student *)findStudentByID:(int)ID {
    // 打開數(shù)據(jù)庫
    sqlite3 *sql = [SQLService open];
    
    // 創(chuàng)建一個語句對象
    sqlite3_stmt *stmt = nil;
    
    Student *student = nil;
    
    // 生成語句對象
    int result = sqlite3_prepare_v2(sql, "select * from Students where ID = ?", -1, &stmt, nil);
    
    if (result == SQLITE_OK) {
        
        // 如果查詢語句或者其他sql語句有條件,在準備語句對象的函數(shù)內部,sql語句中用?來代替條件,那么在執(zhí)行語句之前,一定要綁定
        // 1代表sql語句中的第一個問號,問號的下標是從1開始的
        sqlite3_bind_int(stmt, 1, ID);
        
        if (sqlite3_step(stmt) == SQLITE_ROW) {
            
            // 獲取記錄中的字段信息
            const unsigned char *cName = sqlite3_column_text(stmt, 1);
            const unsigned char *cGender = sqlite3_column_text(stmt, 2);
            
            // 將C語言字符串轉換成OC字符串
            NSString *name = [NSString stringWithUTF8String:(const char *)cName];
            NSString *gender = [NSString stringWithUTF8String:(const char *)cGender];
            
            student = [Student studentWithID:ID name:name gender:gender];
            
        }
    }
    
    // 先釋放語句對象
    sqlite3_finalize(stmt);

    return student;
}

  • 表中添加數(shù)據(jù)
// 插入一條記錄
+ (void)insertStudentWithID:(int)ID name:(NSString *)name gender:(NSString *)gender {
    
    // 打開數(shù)據(jù)庫
    sqlite3 *sql = [SQLService open];
    
    sqlite3_stmt *stmt = nil;
    
    int result = sqlite3_prepare_v2(sql, "insert into Students values(?,?,?)", -1, &stmt, nil);
    
    if (result == SQLITE_OK) {
        // 綁定
        sqlite3_bind_int(stmt, 1, ID);
        sqlite3_bind_text(stmt, 2, [name UTF8String], -1, nil);
        sqlite3_bind_text(stmt, 3, [gender UTF8String], -1, nil);
        
        // 插入與查詢不一樣,執(zhí)行結果沒有返回值
        sqlite3_step(stmt);
        
    }
    
    // 釋放語句對象
    sqlite3_finalize(stmt);
    
}
  • 更新表內數(shù)據(jù)
// 更新指定ID下的姓名和性別
+ (void)updateStudentName:(NSString *)name gender:(NSString *)gender forID:(int)ID {
    
    // 打開數(shù)據(jù)庫
    sqlite3 *sql = [SQLService open];
    
    sqlite3_stmt *stmt = nil;
    
    int result = sqlite3_prepare_v2(sql, "update Student set name = ?, gender = ? where ID = ?", -1, &stmt, nil);
    if (result == SQLITE_OK) {
        sqlite3_bind_text(stmt, 1, [name UTF8String], -1, nil);
        sqlite3_bind_text(stmt, 2, [gender UTF8String], -1, nil);
        sqlite3_bind_int(stmt, 3, ID);
        
        sqlite3_step(stmt);
    }
    sqlite3_finalize(stmt);
}
  • 刪除表內數(shù)據(jù)
// 根據(jù)指定ID刪除學生
+ (void)deleteStudentByID:(int)ID {
    
    // 打開數(shù)據(jù)庫
    sqlite3 *sql = [SQLService open];
    
    sqlite3_stmt *stmt = nil;
    
    int result = sqlite3_prepare_v2(sql, "delete from Students where ID = ?", -1, &stmt, nil);
    
    if (result == SQLITE_OK) {
        sqlite3_bind_int(stmt, 1, ID);
        sqlite3_step(stmt);
    }
    
    sqlite3_finalize(stmt); 
}
最后編輯于
?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
【社區(qū)內容提示】社區(qū)部分內容疑似由AI輔助生成,瀏覽時請結合常識與多方信息審慎甄別。
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發(fā)布,文章內容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務。

友情鏈接更多精彩內容