SQLite是嵌入式的和輕量級(jí)的SQL數(shù)據(jù)庫(kù)。SQLite是由C實(shí)現(xiàn)的。廣泛用于包括瀏覽器(支持HTML5的大部分瀏覽器，IE除外)、iOS、Android以及一些便攜需求的小型web應(yīng)用系統(tǒng)。

1 使用原因：存儲(chǔ)、檢索信息

2 SQLite是MySQL精簡(jiǎn)版。但無(wú)需服務(wù)器就能進(jìn)行。

3 兩個(gè)限制：1)必須手動(dòng)創(chuàng)建數(shù)據(jù)庫(kù) 2)沒(méi)有面向?qū)ο蟮慕涌凇?/p>

4 如何手動(dòng)創(chuàng)建數(shù)據(jù)庫(kù)。

使用SQLite前的準(zhǔn)備

使用SQLite是很多做iOS開發(fā)中第一次面對(duì)C的情況，包括我。因?yàn)镾QLite是C寫的，Objective-C可以直接使用C代碼。在SQLite前，一般都會(huì)使用Cocoa Touch框架，都是基于Objective-C的。

首先，添加framework：libsqlite3.0.dylib

需要在對(duì)應(yīng)文件的頭文件中加入：

并在Frameworks中加入所需的庫(kù)，否則會(huì)報(bào)錯(cuò)：

加入庫(kù)的方法是：

選擇sqlite庫(kù)：

選擇完的效果：

下面是代碼：

//sqlite    
    [self openDataBase];   
    //[self createTable];   
    //[self insertTable];   
    [self queryTable];   
       
       
    [self deleteTable];   
    [self queryTable];   

實(shí)現(xiàn)：

//open database   
- (void)openDataBase   
{   
    NSArray *documentsPaths=NSSearchPathForDirectoriesInDomains(NSDocumentDirectory   
                                                                , NSUserDomainMask    
                                                                , YES);    
    NSString *databaseFilePath=[[documentsPaths objectAtIndex:0] stringByAppendingPathComponent:@"db.sql"];   
       
    if (sqlite3_open([databaseFilePath UTF8String], &database)==SQLITE_OK)    
    {    
        NSLog(@"open sqlite db ok.");    
    }   
    else    
    {   
        NSLog( @"can not open sqlite db " );   
   
        //close database   
        sqlite3_close(database);    
    }   
}   
   
//create table   
- (void)createTable   
{   
    char *errorMsg;   
    const char *createSql="create table if not exists persons (id integer primary key autoincrement,name text)";   
       
    if (sqlite3_exec(database, createSql, NULL, NULL, &errorMsg)==SQLITE_OK)    
    {    
        NSLog(@"create ok.");    
    }   
    else    
    {   
        NSLog( @"can not create table" );   
        [self ErrorReport:(NSString *)createSql];   
    }   
}   
   
   
//insert table   
- (void)insertTable   
{   
    char *errorMsg;   
   
    const char *insertSql="insert into persons (name) values ('田周輝')";    
    if (sqlite3_exec(database, insertSql, NULL, NULL, &errorMsg)==SQLITE_OK)    
    {    
        NSLog(@"insert ok.");    
    }   
    else    
    {   
        NSLog( @"can not insert it to table" );   
        [self ErrorReport: (NSString *)insertSql];   
    }   
}   
   
   
//error    
- (void)ErrorReport: (NSString *)item   
{   
    char *errorMsg;   
       
    if (sqlite3_exec(database, (const char *)item, NULL, NULL, &errorMsg)==SQLITE_OK)   
    {    
        NSLog(@"%@ ok.",item);    
    }   
    else    
    {    
        NSLog(@"error: %s",errorMsg);    
        sqlite3_free(errorMsg);    
    }   
}   
   
   
//query table   
- (void)queryTable   
{   
    const char *selectSql="select id,name from persons";    
    sqlite3_stmt *statement;    
    if (sqlite3_prepare_v2(database, selectSql, -1, &statement, nil)==SQLITE_OK)   
    {    
        NSLog(@"select ok.");    
        while (sqlite3_step(statement)==SQLITE_ROW)//SQLITE_OK SQLITE_ROW   
        {    
            int _id=sqlite3_column_int(statement, 0);    
            NSString *name=[[NSString alloc] initWithCString:(char *)sqlite3_column_text(statement, 1) encoding:NSUTF8StringEncoding];    
            NSLog(@"row>>id %i, name>> %@",_id,name);    
        }   
           
    }   
    else    
    {   
        //error   
        [self ErrorReport: (NSString *)selectSql];   
    }   
       
    sqlite3_finalize(statement);   
}   
   
//delete table   
- (void)deleteTable   
{      
    char *errorMsg;   
    [self openDataBase];   
       
    const char *sql = "DELETE FROM persons where id=24";   
    if (sqlite3_exec(database, sql, NULL, NULL, &errorMsg)==SQLITE_OK)    
    {    
        NSLog(@"delete ok.");    
    }   
    else    
    {   
        NSLog( @"can not delete it" );   
        [self ErrorReport: (NSString *)sql];   
    }   
       
}   

命令行：

sqlite3 database  //創(chuàng)建數(shù)據(jù)庫(kù) 
              crate table tableFile(id smallint, file_name varchar(256), up_state smallint, file_size smallint); //創(chuàng)建一個(gè)表格 
        insert into tableFile values(1, "200110101.rcu", 100, 4500);   //插入數(shù)據(jù) 
5 如何訪問(wèn)SQLite3數(shù)據(jù)庫(kù) 
sqlite3_open //打開數(shù)據(jù)庫(kù) 
sqlite3_prepare //將UTF－8格式的SQL語(yǔ)句轉(zhuǎn)換為指向已備語(yǔ)句的指針 
sqlite3_column_string //返回某一行的字符串 
sqlite3_finalize //刪除一條已備語(yǔ)句 
sqlite3_close //關(guān)閉數(shù)據(jù)庫(kù) 
 
6 source code 
 
- (id)lookupSingularSQL:(NSString *)sql forType:(NSString *)rettype { 
 
sqlite3_stmt *statement; 
 
id result; 
 
if (statement = [self prepare:sql]) { 
 
if (sqlite3_step(statement) == SQLITE_ROW) { 
 
if ([rettype compare:@"text"] == NSOrderedSame) { 
 
char temp_buf[256]; 
 
memset(temp_buf, 0, 256); 
 
sprintf(temp_buf, "%s %s %s %s",  
 
(char *)sqlite3_column_text(statement,0), 
 
(char *)sqlite3_column_text(statement,1), 
 
(char *)sqlite3_column_text(statement,2), 
 
(char *)sqlite3_column_text(statement,3) 
 
); 
 
result = [NSString stringWithUTF8String:temp_buf]; 
 
//result = [NSString stringWithUTF8String:(char *)sqlite3_column_text(statement,0)]; 
 
} else if ([rettype compare:@"integer"] == NSOrderedSame) { 
 
result = (id)sqlite3_column_int(statement,0); 
 
            } 
 
} 
 
} 
 
sqlite3_finalize(statement); 
 
return result; 
 
} 

應(yīng)該有個(gè)成員變量，比如我的代碼：

@interface DetailViewController : UIViewController { 
UIPopoverController *popoverController; 
UIToolbar *toolbar; 
id detailItem; 
UILabel *detailDescriptionLabel; 
sqlite3 *database; 

打開數(shù)據(jù)庫(kù)

SQLite數(shù)據(jù)庫(kù)是文件數(shù)據(jù)庫(kù)，是保存在文件系統(tǒng)中的。因此需要知道文件保存到哪里，可參見(jiàn)iOS中對(duì)文件的操作。比如本文保存到Documents目錄下。代碼：

NSArray *documentsPaths=NSSearchPathForDirectoriesInDomains(NSDocumentDirectory 
, NSUserDomainMask 
, YES); 
NSString *databaseFilePath=[[documentsPaths objectAtIndex:0] stringByAppendingPathComponent:@"mydb"]; 
if (sqlite3_open([databaseFilePath UTF8String], &database)==SQLITE_OK) { 
NSLog(@"open sqlite db ok."); 
} 

通過(guò)ssh查看Documents目錄，發(fā)現(xiàn)mydb文件已經(jīng)創(chuàng)建。sqlite的策略是如果有該文件就打開，如果沒(méi)有就創(chuàng)建文件，也就是創(chuàng)建數(shù)據(jù)庫(kù)。

這里要注意，使用的是C語(yǔ)法，sqlite3_open傳入的是database的地址。

關(guān)閉數(shù)據(jù)庫(kù)

數(shù)據(jù)庫(kù)使用完畢后，要關(guān)閉，比如退出應(yīng)用的時(shí)候：

- (void)viewDidUnload { 
// Release any retained subviews of the main view. 
// e.g. self.myOutlet = nil; 
sqlite3_close(database); 
self.popoverController = nil; 
} 

建表語(yǔ)句

數(shù)據(jù)庫(kù)打開以后，如果沒(méi)有表，建表：

char *errorMsg; 
const char *createSql="create table if not exists persons (id integer primary key autoincrement,name text)"; 
if (sqlite3_exec(database, createSql, NULL, NULL, &errorMsg)==SQLITE_OK) { 
NSLog(@"create ok."); 
} 

這里要特別注意errorMsg傳的是地址，因?yàn)樵摵瘮?shù)要通過(guò)地址引用來(lái)寫報(bào)錯(cuò)字符信息。

向表中插入記錄

和建表語(yǔ)句類似：

const char *insertSql="insert into persons (name) values(‘張三’)"; 
if (sqlite3_exec(database, insertSql, NULL, NULL, &errorMsg)==SQLITE_OK) { 
NSLog(@"insert ok."); 
} 

錯(cuò)誤信息的處理

如果在多個(gè)地方使用errorMsg，那么每次使用完畢要清空一下字串，比如這樣：

if (sqlite3_exec(database, createSql, NULL, NULL, &errorMsg)==SQLITE_OK) { 
NSLog(@"create ok."); 
}else { 
NSLog(@"error: %s",errorMsg); 
sqlite3_free(errorMsg); 
} 

查詢結(jié)果集

結(jié)果集的查詢，需要用到statement：

const char *selectSql="select id,name from persons"; 
sqlite3_stmt *statement; 
if (sqlite3_prepare_v2(database, selectSql, -1, &statement, nil)==SQLITE_OK) { 
NSLog(@"select ok."); 
} 
while (sqlite3_step(statement)==SQLITE_ROW) { 
int _id=sqlite3_column_int(statement, 0); 
char *name=(char *)sqlite3_column_text(statement, 1); 
NSLog(@"row>>id %i, name %s",_id,name); 
} 
sqlite3_finalize(statement); 

不過(guò)這里有個(gè)問(wèn)題，看看打印的日志：

亂碼。因?yàn)橹苯佑玫腸har類型來(lái)做的。

解決辦法是，用nsstring替代char：

while (sqlite3_step(statement)==SQLITE_ROW) { 
int _id=sqlite3_column_int(statement, 0); 
NSString *name=[[NSString alloc] initWithCString:(char *)sqlite3_column_text(statement, 1) encoding:NSUTF8StringEncoding]; 
NSLog(@"row>>id %i, name %@",_id,name); 
} 

char生成nsstring的時(shí)候做一次顯式的編碼。問(wèn)題解決：

這說(shuō)明：

寫入數(shù)據(jù)庫(kù)，用char的方式?jīng)]有問(wèn)題，寫入數(shù)據(jù)庫(kù)的編碼是對(duì)的;

從庫(kù)中取出，可能默認(rèn)使用ascii解碼，造成顯示亂碼。

使用sqlite c api，要經(jīng)常參考官方函數(shù)文檔：http://www.sqlite.org/c3ref/funclist.html