学步园

一、前言

数据库作为一种数据载体被我们频繁地使用。一般情况下我们会在程序的入口方法处完成数据库的创建。下面通过实例简单介绍两种创建数据库的方法。

二、需求

在documents目录下创建一个test.sqlite数据库，里面包含表User。User表含username和password两个varchar类型的字段。

方法一:使用SQLiteManager创建数据库和表，并将创建好的数据库文件拖入项目中，最后调用以下代码将数据库复制到documents目录；

/**
 *  将数据库文件复制进沙盒
 */
-(void)createEditableCopyOfDatabaseIfNeeded
{
    // 先判断 sandbox 下面的 documents 子文件夹里面有没有数据库文件 test.sqlite
    NSFileManager *fileManager = [NSFileManager defaultManager];
    NSError *error;
    NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
    NSString *documentsDirectory = [paths objectAtIndex:0];
    NSString *writableDBPath = [documentsDirectory stringByAppendingPathComponent:@"test.sqlite"];
    BOOL ifFind = [fileManager fileExistsAtPath:writableDBPath];
    if (ifFind)
    {
        // NSLog(@"数据库已存在");
        return;
    }
    else{
        NSLog(@"数据库不存在,需要复制");
    }
    // 如果不存在数据库文件，则复制数据库文件
    NSString *defaultDBPath = [[NSBundle mainBundle] pathForResource:@"test" ofType:@"sqlite"];
    BOOL ifSuccess = [fileManager copyItemAtPath:defaultDBPath toPath:writableDBPath error:&error];
    if (!ifSuccess) {
        NSLog(@"Failed to create writable database file with message '%@'.", [error localizedDescription]);
    }else {
        NSLog(@"createEditableCopyOfDatabaseIfNeeded 初始化成功");
    }
    return;
}

方法二:利用开源的FMDB库代码创建数据库；

/**
 *  代码创建数据库
 */
- (void)createDatabaseIfNeeded
{
    // 数据库路径
    NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
    NSString *doc = [paths objectAtIndex:0];
    NSString *path = [doc stringByAppendingPathComponent:@"test.sqlite"];
    
    NSFileManager * fileManager = [NSFileManager defaultManager];
    if ([fileManager fileExistsAtPath:path] == NO) {
        // create it
        FMDatabase * db = [FMDatabase databaseWithPath:path];
        if ([db open]) {
            // 建立User表
            NSMutableString *sql = [NSMutableString stringWithFormat:@"%@",@"CREATE TABLE User"];
            [sql appendString:@"("];
            [sql appendString:@"username varchar,"];
            [sql appendString:@"password varchar"];
            [sql appendString:@")"];
            BOOL res = [db executeUpdate:sql];
            if (!res) {
                debugLog(@"error when creating table User");
            } else {
                debugLog(@"succ to creating table User");
            }
            
            [db close];
        }
        else {
            debugLog(@"error when open db");
        }
    }
}

注:FMDB库使用教程http://blog.devtang.com/blog/2012/04/22/use-fmdb/

三、总结

1、第一种方法创建数据库在需求变动的情况下(如增加几张表)容错率稍高，推荐使用第一种方法；

2、两种方法均是先判断数据库是否存在然后再决定要不要创建/复制数据库。在一种特殊情况下－应用更新版本，其实原来的数据库文件是会从老的版本中拷贝到新版本中(参考:http://blog.csdn.net/zyx586/article/details/18989199)，所以更新版本后数据库文件是不会做任何改变的，就算你在新的版本中完全改变数据库的结构。所以如果存在数据库变动的需要在应用版本升级后重新创建一个全新的数据库并备份旧的数据；