第一步 導(dǎo)入數(shù)據(jù)庫(kù) libsqlite3.0.tbd
屏幕快照 2016-12-12 19.24.07.png
第二步 創(chuàng)建一個(gè)繼承于NSObject的類(lèi)，并聲明單例方法
//單例方法的聲明
+ (DataBaseHelper*)sharedDataBaseHelper;
//單例方法的實(shí)現(xiàn)
+ (DataBaseHelper*)sharedDataBaseHelper{
//定義一個(gè)靜態(tài)的DataBaseHelper對(duì)象，賦值為空
static DataBaseHelper* dbHelper = nil;
if (dbHelper == nil) {
dbHelper = [[DataBaseHelper alloc] init];
}
return dbHelper;
}
第三步：在類(lèi)的(.m)文件中進(jìn)行類(lèi)的擴(kuò)展 --- 延展（category）
@interface DataBaseHelper ()
{
//數(shù)據(jù)庫(kù)句柄---句柄：指代數(shù)據(jù)庫(kù)的對(duì)象
sqlite3 *sqliteHandle;
}
@property (nonatomic,strong) NSString* dbFileName;//數(shù)據(jù)庫(kù)文件路徑，全局化
@end
第四步：創(chuàng)建數(shù)據(jù)庫(kù)存儲(chǔ)的文件路徑，一般在documents或者library下的caches（緩存文件夾）
- (void)dbFileNameWithName:(NSString*)fileName{
//將fileName中的空格替換，防止文件名中存在空格
fileName = [fileName stringByReplacingOccurrencesOfString:@" " withString:@""];
//判斷用戶(hù)傳遞進(jìn)來(lái)的文件名是否為nil
if (fileName) {
//判斷文件明是否為空字符串
if (fileName.length == 0) {
//空字符串 @“”
NSLog(@"數(shù)據(jù)庫(kù)文件無(wú)名稱(chēng),當(dāng)程序關(guān)閉的時(shí)候，數(shù)據(jù)庫(kù)文件也會(huì)銷(xiāo)毀");
}else{
//判斷文件名是否帶后綴名,如果有，直接使用，如果沒(méi)有后綴名，添加后綴名之后再使用
if (![fileName hasSuffix:@".sqlite"]) {
//如果沒(méi)有后綴名，添加后綴名在使用
[fileName stringByAppendingString:@".sqlite"];
}
}
}else{
//說(shuō)明文件名為nil
NSLog(@"數(shù)據(jù)庫(kù)文件無(wú)名稱(chēng),當(dāng)程序關(guān)閉的時(shí)候，數(shù)據(jù)庫(kù)文件也會(huì)銷(xiāo)毀");
fileName = @"";
}
//將文件名稱(chēng)拼接成一個(gè)有效的文件路徑
//獲取沙盒下documents的路徑
NSString* documentsPath = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).firstObject;
//拼接文件路徑
fileName = [documentsPath stringByAppendingPathComponent:fileName];
//將處理好的文件名賦值給屬性讓其他方法是用
self.dbFileName = fileName;
}
第五步：打開(kāi)或者創(chuàng)建數(shù)據(jù)庫(kù)
- (sqlite3*)createDB{
//創(chuàng)建數(shù)據(jù)庫(kù)文件的函數(shù)，如果數(shù)據(jù)庫(kù)文件存在，那么這個(gè)方法就是打開(kāi)數(shù)據(jù)庫(kù)文件，如果數(shù)據(jù)庫(kù)不文件存在，這個(gè)方法就是創(chuàng)建數(shù)據(jù)庫(kù)文件，再打開(kāi)
//第一個(gè)參數(shù)：數(shù)據(jù)庫(kù)文件的路徑,并且需要將其轉(zhuǎn)換為char * 類(lèi)型（是C語(yǔ)言的字符串類(lèi)型）
//第二個(gè)參數(shù)：數(shù)據(jù)庫(kù)文件的句柄，取地址 & 符號(hào)就是取地址
//將數(shù)據(jù)庫(kù)句柄指向數(shù)據(jù)庫(kù)內(nèi)存，我們對(duì)數(shù)據(jù)庫(kù)的操作，都是通過(guò)句柄來(lái)完成的
int result = sqlite3_open(self.dbFileName.UTF8String, & sqliteHandle);
//判斷數(shù)據(jù)庫(kù)庫(kù)是否打開(kāi)或者創(chuàng)建成功
if (result == SQLITE_OK) {
NSLog(@"創(chuàng)建或者打開(kāi)數(shù)據(jù)庫(kù)成功");
return sqliteHandle;
}else{
NSLog(@"創(chuàng)建或者打開(kāi)數(shù)據(jù)庫(kù)失敗 === %d",result);
return NULL;
}
}
第六步：非查詢(xún)操作（無(wú)返回結(jié)果集執(zhí)行的操作）創(chuàng)建、插入、更新、刪除等
參數(shù)為：需要執(zhí)行的sql語(yǔ)句
- (BOOL)noQueryWithSql:(NSString*)sql{
//執(zhí)行任何數(shù)據(jù)庫(kù)操作之前，先打開(kāi)數(shù)據(jù)庫(kù)，操作執(zhí)行完畢記得關(guān)閉數(shù)據(jù)庫(kù)
sqlite3 *sqlite = [self createDB];
//執(zhí)行sql語(yǔ)句
if (sqlite) {//保證數(shù)據(jù)庫(kù)打開(kāi)成功
int result = sqlite3_exec(sqlite, sql.UTF8String, NULL, NULL, NULL);
//當(dāng)操作有結(jié)果的時(shí)候，一定要關(guān)閉數(shù)據(jù)庫(kù)
//參數(shù)可以填sqlite，也可以填sqliteHandle
sqlite3_close(sqlite);
//判斷執(zhí)行的非查詢(xún)操作是否成功
if (result == SQLITE_OK) {
NSLog(@"執(zhí)行非查詢(xún)操作成功");
return YES;
}else{
NSLog(@"執(zhí)行非查詢(xún)操作失敗");
return NO;
}
}
NSLog(@"執(zhí)行操作的時(shí)候，打開(kāi)數(shù)據(jù)庫(kù)失敗了");
return NO;
}
第六步：通用查詢(xún)方法
==注意：數(shù)據(jù)表的列數(shù)、字段名（作為字典的key）、字段的類(lèi)型都是變化的，不能寫(xiě)死==
- (NSArray*)queryWithSql:(NSString*)sql{
//打開(kāi)數(shù)據(jù)庫(kù)
sqlite3 *sqlite = [self createDB];
//創(chuàng)建可變數(shù)組，用來(lái)存放所有的記錄
NSMutableArray *resultMArray = [[NSMutableArray alloc] init];
//伴隨指針 當(dāng)我們進(jìn)行查詢(xún)操作的時(shí)候，該指針可以理解為存儲(chǔ)一條一條的記錄。我們獲取一條記錄的所有信息都是通過(guò)伴隨指針。
//聲明伴隨指針，作用存放所有的記錄,賦值為NULl
sqlite3_stmt *stmt = NULL;
//預(yù)執(zhí)行sql語(yǔ)句，如果預(yù)執(zhí)行成功說(shuō)明，那么我們就可以獲取一條一條的記錄；如果預(yù)執(zhí)行失敗,說(shuō)明我們的sql語(yǔ)句有問(wèn)題 不能獲取表中的記錄信息
//第一個(gè)參數(shù)：數(shù)據(jù)庫(kù)句柄
//第二個(gè)參數(shù)：要執(zhí)行的SQ語(yǔ)句
//第三個(gè)參數(shù)：要執(zhí)行的長(zhǎng)度，如果全部執(zhí)行，這里就賦值為-1
//第四個(gè)參數(shù)：伴隨指針
//第五個(gè)參數(shù)：如果sql語(yǔ)句不全部執(zhí)行，該參數(shù)保存未執(zhí)行的sql語(yǔ)句
int result = sqlite3_prepare(sqliteHandle, sql.UTF8String, -1, &stmt, NULL);
//判斷預(yù)執(zhí)行是否成功
if(result == SQLITE_OK){
//說(shuō)明sql語(yǔ)句沒(méi)有問(wèn)題
//從伴隨指針中遍歷取出每一條記錄
while (sqlite3_step(stmt) == SQLITE_ROW) {
//每執(zhí)行一次循環(huán)體，就取出一條記錄
//創(chuàng)建字典
NSMutableDictionary *mDic = [NSMutableDictionary dictionary];
//確定該條記錄有幾個(gè)字段
//參數(shù)為伴隨指針
int sumColumns = sqlite3_column_count(stmt);
//for循環(huán)遍歷一條記錄中的所有字段，
for (int i = 0; i < sumColumns; i++) {
//獲取當(dāng)前字段（列）的數(shù)據(jù)類(lèi)型
int type = sqlite3_column_type(stmt, i);
//獲取字段名 key
const char* name = sqlite3_column_name(stmt, i);
//將char*類(lèi)型轉(zhuǎn)換為我們OC中可用的字符串類(lèi)型
NSString *key = [NSString stringWithCString:name encoding:NSUTF8StringEncoding];
//取出每一列的值
//這里只取兩個(gè)基本的類(lèi)型，別的類(lèi)型可自行添加
switch (type) {
case SQLITE_INTEGER:
//int型
{//在case下如果有多行代碼，加一個(gè){}
int value = sqlite3_column_int(stmt, i);
//為字典賦值
[mDic setObject:@(value) forKey:key];
}
break;
case SQLITE_TEXT:{
//字符串型
const unsigned char* value = sqlite3_column_text(stmt, i);
//將char*類(lèi)型轉(zhuǎn)換為我們OC中可用的字符串類(lèi)型
NSString* valueString = [NSString stringWithCString:(const char*)value encoding:NSUTF8StringEncoding];
//為字典賦值
[mDic setObject:valueString forKey:key];
}
break;
default:
break;
}
}
//一次for循環(huán)結(jié)束，一條記錄才轉(zhuǎn)換為一個(gè)字典
[resultMArray addObject:mDic];
}
//while循環(huán)結(jié)束,說(shuō)明所有的記錄都已經(jīng)獲取完整
// return resultMArray;
}else{
//說(shuō)明sql語(yǔ)句有問(wèn)題
NSLog(@"執(zhí)行查詢(xún)操作有誤 === %d",result);
// return resultMArray;
}
//釋放資源，關(guān)閉數(shù)據(jù)庫(kù)
sqlite3_finalize(stmt);
//關(guān)閉數(shù)據(jù)庫(kù)
sqlite3_close(sqlite);
//返回?cái)?shù)組
return resultMArray;
}
