iPhone中数据库使用方法

iPhone中数据库使用方法是本文要介绍的内容，直接进入话题介绍，iPhone 中使用名为 SQLite 的数据库管理系统。它是一款轻型的数据库，是遵守ACID的关联式数据库管理系统，它的设计目标是嵌入式的，而且目前已经在很多嵌入式产品中使用了它，它占用资源非常的低，

在嵌入式设备中，可能只需要几百K的内存就够了。它能够支持Windows/Linux/Unix等等主流的操作系统，同时能够跟很多程序语言相结合，比如 Tcl、PHP、Java 等，还有 ODBC 接口，同样比起 Mysql、PostgreSQL 这两款开源世界著名的数据库管理系统来讲，它的处理速度比他们都快。

其使用步骤大致分为以下几步：

1. 创建DB文件和表格

2. 添加必须的库文件(FMDB for iPhone, libsqlite3.0.dylib)

3. 通过 FMDB 的方法使用 SQLite

创建DB文件和表格

$ sqlite3 sample.db  



sqlite> CREATE TABLE TEST(  




   ...>  id INTEGER PRIMARY KEY,  




   ...>  name VARCHAR(255)  




   ...> ); 

简单地使用上面的语句生成数据库文件后，用一个图形化SQLite管理工具，比如 Lita 来管理还是很方便的。

然后将文件(sample.db)添加到工程中。

添加必须的库文件(FMDB for iPhone, libsqlite3.0.dylib)

首先添加 Apple 提供的 sqlite 操作用程序库 ibsqlite3.0.dylib 到工程中。位置如下

/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS${VER}.sdk/usr/lib/libsqlite3.0.dylib 

这样一来就可以访问数据库了，但是为了更加方便的操作数据库，这里使用 FMDB for iPhone。

svn co http://flycode.googlecode.com/svn/trunk/fmdb fmdb

如上下载该库，并将以下文件添加到工程文件中：

FMDatabase.h  


FMDatabase.m  


FMDatabaseAdditions.h  


FMDatabaseAdditions.m  


FMResultSet.h  


FMResultSet.m 

通过 FMDB 的方法使用 SQLite

使用 SQL 操作数据库的代码在程序库的 fmdb.m 文件中大部分都列出了、只是连接数据库文件的时候需要注意 — 执行的时候，参照的数据库路径位于 Document 目录下，之前把刚才的 sample.db 文件拷贝过去就好了。

位置如下
/Users/xxxx/Library/Application Support/iPhone Simulator/User/Applications/xxxx/Documents/sample.db

BOOL success;  


NSError *error;  



NSFileManager *fm = [NSFileManager defaultManager];  




NSArray  *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);  




NSString *documentsDirectory = [paths objectAtIndex:0];  




NSString *writableDBPath = [documentsDirectory stringByAppendingPathComponent:@"sample.db"];  




success = [fm fileExistsAtPath:writableDBPath];  



if(!success){  



  NSString *defaultDBPath = [[[NSBundle mainBundle] resourcePath] stringByAppendingPathComponent:@"sample.db"];  




  success = [fm copyItemAtPath:defaultDBPath toPath:writableDBPath error:&error];  



  if(!success){  


    NSLog([error localizedDescription]);  


  }  


}  


// 连接DB  



FMDatabase* db = [FMDatabase databaseWithPath:writableDBPath];  



if ([db open]) {  


  [db setShouldCacheStatements:YES];  


 


  // INSERT  


  [db beginTransaction];  



  int i = 0;  




  while (i++ < 20) {  



    [db executeUpdate:@"INSERT INTO TEST (name) values (?)" , [NSString stringWithFormat:@"number %d", i]];  


    if ([db hadError]) {  


      NSLog(@"Err %d: %@", [db lastErrorCode], [db lastErrorMessage]);  


    }  


  }  


  [db commit];  


  // SELECT  



  FMResultSet *rs = [db executeQuery:@"SELECT * FROM TEST"];  



  while ([rs next]) {  


    NSLog(@"%d %@", [rs intForColumn:@"id"], [rs stringForColumn:@"name"]);  


  }  


  [rs close];  


  [db close];  


}else{  


  NSLog(@"Could not open db.");  


} 

以下为链接数据库时的代码：

接下来再看看用 DAO 的形式来访问数据库的使用方法，代码整体构造如下。如图：

首先创建如下格式的数据库文件：

$ sqlite3 sample.db  



sqlite> CREATE TABLE TbNote(  




   ...>  id INTEGER PRIMARY KEY,  




   ...>  title VARCHAR(255),  




   ...>  body VARCHAR(255)  




   ...> );  



创建DTO（Data Transfer Object）  


//TbNote.h  



#import <Foundation/Foundation.h> 



 


@interface TbNote : NSObject {  


  int index;  


  NSString *title;  


  NSString *body;  


}  


@property (nonatomic, retain) NSString *title;  


@property (nonatomic, retain) NSString *body;  


- (id)initWithIndex:(int)newIndex Title:(NSString *)newTitle Body:(NSString *)newBody;  


- (int)getIndex;  


@end  


//TbNote.m  


#import "TbNote.h"  


@implementation TbNote  


@synthesize title, body;  


- (id)initWithIndex:(int)newIndex Title:(NSString *)newTitle Body:(NSString *)newBody{  



  if(self = [super init]){  




    index = newIndex;  




    self.title = newTitle;  




    self.body = newBody;  



  }  


  return self;  


}  


- (int)getIndex{  


  return index;  


}  


- (void)dealloc {  


  [title release];  


  [body release];  


  [super dealloc];  


}  


@end 

创建DAO（Data Access Objects）

这里将 FMDB 的函数调用封装为 DAO 的方式。

//BaseDao.h  



#import <Foundation/Foundation.h> 



 


@class FMDatabase;  


 


@interface BaseDao : NSObject {  


  FMDatabase *db;  


}  


 


@property (nonatomic, retain) FMDatabase *db;  


 


-(NSString *)setTable:(NSString *)sql;  


 


@end  


 


//BaseDao.m  


#import "SqlSampleAppDelegate.h"  


#import "FMDatabase.h"  


#import "FMDatabaseAdditions.h"  


#import "BaseDao.h"  


@implementation BaseDao  


@synthesize db;  


- (id)init{  



  if(self = [super init]){  



    // 由 AppDelegate 取得打开的数据库  



    SqlSampleAppDelegate *appDelegate = (SqlSampleAppDelegate *)[[UIApplication sharedApplication] delegate];  




    db = [[appDelegate db] retain];  



  }  


  return self;  


}  


// 子类中实现  


-(NSString *)setTable:(NSString *)sql{  


  return NULL;  


}  


- (void)dealloc {  


  [db release];  


  [super dealloc];  


}  


@end 

下面是访问 TbNote 表格的类。

//TbNoteDao.h  



#import <Foundation/Foundation.h> 



#import "BaseDao.h"  


@interface TbNoteDao : BaseDao {  


}  


-(NSMutableArray *)select;  


-(void)insertWithTitle:(NSString *)title Body:(NSString *)body;  


-(BOOL)updateAt:(int)index Title:(NSString *)title Body:(NSString *)body;  


-(BOOL)deleteAt:(int)index;  


@end  


//TbNoteDao.m  


#import "FMDatabase.h"  


#import "FMDatabaseAdditions.h"  


#import "TbNoteDao.h"  


#import "TbNote.h"  


@implementation TbNoteDao  


-(NSString *)setTable:(NSString *)sql{  


  return [NSString stringWithFormat:sql,  @"TbNote"];  


}  


// SELECT  


-(NSMutableArray *)select{  



  NSMutableArray *result = [[[NSMutableArray alloc] initWithCapacity:0] autorelease];  




  FMResultSet *rs = [db executeQuery:[self setTable:@"SELECT * FROM %@"]];  



  while ([rs next]) {  



    TbNote *tr = [[TbNote alloc]  



              initWithIndex:[rs intForColumn:@"id"]  


              Title:[rs stringForColumn:@"title"]  


              Body:[rs stringForColumn:@"body"]  


              ];  


    [result addObject:tr];  


    [tr release];  


  }  


  [rs close];  


  return result;  


}  


// INSERT  


-(void)insertWithTitle:(NSString *)title Body:(NSString *)body{  


  [db executeUpdate:[self setTable:@"INSERT INTO %@ (title, body) VALUES (?,?)"], title, body];  


  if ([db hadError]) {  


    NSLog(@"Err %d: %@", [db lastErrorCode], [db lastErrorMessage]);  


  }  


}  


// UPDATE  


-(BOOL)updateAt:(int)index Title:(NSString *)title Body:(NSString *)body{  



  BOOL success = YES;  




  [db executeUpdate:[self setTable:@"UPDATE %@ SET title=?, body=? WHERE id=?"], title, body, [NSNumber numberWithInt:index]];  



  if ([db hadError]) {  


    NSLog(@"Err %d: %@", [db lastErrorCode], [db lastErrorMessage]);  



    success = NO;  



  }  


  return success;  


}  


// DELETE  


- (BOOL)deleteAt:(int)index{  



  BOOL success = YES;  




  [db executeUpdate:[self setTable:@"DELETE FROM %@ WHERE id = ?"], [NSNumber numberWithInt:index]];  



  if ([db hadError]) {  


    NSLog(@"Err %d: %@", [db lastErrorCode], [db lastErrorMessage]);  



    success = NO;  



  }  


  return success;  


}  


- (void)dealloc {  


  [super dealloc];  


}  


@end 

为了确认程序正确，我们添加一个 UITableView。使用 initWithNibName 测试 DAO。

//NoteController.h  



#import <UIKit/UIKit.h> 



@class TbNoteDao;  



@interface NoteController : UIViewController <UITableViewDataSource, UITableViewDelegate>{  



  UITableView *myTableView;  


  TbNoteDao *tbNoteDao;  


  NSMutableArray *record;  


}  


@property (nonatomic, retain) UITableView *myTableView;  


@property (nonatomic, retain) TbNoteDao *tbNoteDao;  


@property (nonatomic, retain) NSMutableArray *record;  


@end  


//NoteController.m  


#import "NoteController.h"  


#import "TbNoteDao.h"  


#import "TbNote.h"  


@implementation NoteController  


@synthesize myTableView, tbNoteDao, record;  


 


- (id)initWithNibName:(NSString *)nibNameOrNil bundle:(NSBundle *)nibBundleOrNil {  



  if (self = [super initWithNibName:nibNameOrNil bundle:nibBundleOrNil]) {  




    tbNoteDao = [[TbNoteDao alloc] init];  



    [tbNoteDao insertWithTitle:@"TEST TITLE" Body:@"TEST BODY"];  


//    [tbNoteDao updateAt:1 Title:@"UPDATE TEST" Body:@"UPDATE BODY"];  


//    [tbNoteDao deleteAt:1];  



    record = [[tbNoteDao select] retain];  



  }  


  return self;  


}  


- (void)viewDidLoad {  


  [super viewDidLoad];  



  myTableView = [[UITableView alloc] initWithFrame:[[UIScreen mainScreen] applicationFrame]];  




  myTableView.delegate = self;  




  myTableView.dataSource = self;  




  self.view = myTableView;  



}  


- (NSInteger)numberOfSectionsInTableView:(UITableView *)tableView {  


  return 1;  


}  


- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {  


  return [record count];  


}  


- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {  



  static NSString *CellIdentifier = @"Cell";  




  UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:CellIdentifier];  




  if (cell == nil) {  




    cell = [[[UITableViewCell alloc] initWithFrame:CGRectZero reuseIdentifier:CellIdentifier] autorelease];  



  }  



  TbNote *tr = (TbNote *)[record objectAtIndex:indexPath.row];  




  cell.text = [NSString stringWithFormat:@"%i %@", [tr getIndex], tr.title];  



  return cell;  


}  


- (void)didReceiveMemoryWarning {  


  [super didReceiveMemoryWarning];  


}  


- (void)dealloc {  


  [super dealloc];  


}  


@end 

最后我们开看看连接DB，和添加 ViewController 的处理。这一同样不使用 Interface Builder。

//SqlSampleAppDelegate.h  



#import <UIKit/UIKit.h> 



 


@class FMDatabase;  


 



@interface SqlSampleAppDelegate : NSObject <UIApplicationDelegate> {  



  UIWindow *window;  


  FMDatabase *db;  


}  


 


@property (nonatomic, retain) IBOutlet UIWindow *window;  


@property (nonatomic, retain) FMDatabase *db;  


 


- (BOOL)initDatabase;  


- (void)closeDatabase;  


 


@end  


 


//SqlSampleAppDelegate.m  


#import "SqlSampleAppDelegate.h"  


#import "FMDatabase.h"  


#import "FMDatabaseAdditions.h"  


#import "NoteController.h"  


 


@implementation SqlSampleAppDelegate  


 


@synthesize window;  


@synthesize db;  


 


- (void)applicationDidFinishLaunching:(UIApplication *)application {  


  if (![self initDatabase]){  


    NSLog(@"Failed to init Database.");  


  }  



  NoteController *ctrl = [[NoteController alloc] initWithNibName:nil bundle:nil];  



  [window addSubview:ctrl.view];  


  [window makeKeyAndVisible];  


}  


 


- (BOOL)initDatabase{  


  BOOL success;  


  NSError *error;  



  NSFileManager *fm = [NSFileManager defaultManager];  




  NSArray  *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);  




  NSString *documentsDirectory = [paths objectAtIndex:0];  




  NSString *writableDBPath = [documentsDirectory stringByAppendingPathComponent:@"sample.db"];  



 



  success = [fm fileExistsAtPath:writableDBPath];  



  if(!success){  



    NSString *defaultDBPath = [[[NSBundle mainBundle] resourcePath] stringByAppendingPathComponent:@"sample.db"];  




    success = [fm copyItemAtPath:defaultDBPath toPath:writableDBPath error:&error];  



    if(!success){  


      NSLog([error localizedDescription]);  


    }  



    success = NO;  



  }  


  if(success){  



    db = [[FMDatabase databaseWithPath:writableDBPath] retain];  



    if ([db open]) {  


      [db setShouldCacheStatements:YES];  


    }else{  


      NSLog(@"Failed to open database.");  



      success = NO;  



    }  


  }  


  return success;  


}  


 


- (void) closeDatabase{  


  [db close];  


}  


 


- (void)dealloc {  


  [db release];  


  [window release];  


  [super dealloc];  


}  


@end