IT博客汇
  • 首页
  • 精华
  • 技术
  • 设计
  • 资讯
  • 扯淡
  • 权利声明
  • 登录 注册

    [原]Android中的Sqlite中的onCreate方法和onUpgrade方法的执行时机

    jiangwei0910410003发表于 2015-06-17 19:56:29
    love 0

    今天在做数据库升级的时候,遇到一个问题,就是onCreate方法和onUpgrade方法的执行时机的问题,这个当时在操作的时候,没有弄清楚,很是迷糊,所以写代码的时候出现了很多的问题,所以没办法就去扒源代码看了。不过在此之前我讲解过一篇关于数据库升级的文章,但是那里没有详细的讲解一下这两个方法的执行时机,所以这里就在单独说一下

    关于数据库升级的文章:http://blog.csdn.net/jiangwei0910410003/article/details/39670813

    不多说,下面直接进入主题吧:

    首先我们看看SQLiteOpenHelper类的源码:

    它里面有一个重要的方法:getDatabaseLocked


    这里我们看到当我们的mName变量为null的时候,就会创建一个内存数据库,数据的生命周期是Application级别的,这个mName就是创建数据库的文件名。


    当然正常情况下,我们都会传入一个数据库文件名的,所以这个方法一般不会执行的,那么就走下面的代码。下面的代码就是直接打开一个数据库。不过我们看到一个特点,就是创建数据库和Context有关系呢。我们看一下Context中的代码。不过这里我们知道Context是一个抽象类,我们一般会看他的子类ContextImpl实现:

    主要看一下getDatabasePath方法和openOrCreateDatabase方法:

    首先来看一下openOrCreateDatabase方法:

    @Override
    public SQLiteDatabase openOrCreateDatabase(String name, int mode, CursorFactory factory,
            DatabaseErrorHandler errorHandler) {
        File f = validateFilePath(name, true);
        int flags = SQLiteDatabase.CREATE_IF_NECESSARY;
        if ((mode & MODE_ENABLE_WRITE_AHEAD_LOGGING) != 0) {
            flags |= SQLiteDatabase.ENABLE_WRITE_AHEAD_LOGGING;
        }
        SQLiteDatabase db = SQLiteDatabase.openDatabase(f.getPath(), factory, flags, errorHandler);
        setFilePermissionsFromMode(f.getPath(), mode, 0);
        return db;
    }
    这里我们看到其实还是调用了SQLiteDatabase的openDatabase方法


    再来看一下getDatabasePath方法:

    @Override
    public File getDatabasePath(String name) {
        return validateFilePath(name, false);
    }


    我们看到这两个方法都是有一个核心的方法:validateFilePath

    private File validateFilePath(String name, boolean createDirectory) {
        File dir;
        File f;
    
        if (name.charAt(0) == File.separatorChar) {
            String dirPath = name.substring(0, name.lastIndexOf(File.separatorChar));
            dir = new File(dirPath);
            name = name.substring(name.lastIndexOf(File.separatorChar));
            f = new File(dir, name);
        } else {
            dir = getDatabasesDir();
            f = makeFilename(dir, name);
        }
    
        if (createDirectory && !dir.isDirectory() && dir.mkdir()) {
            FileUtils.setPermissions(dir.getPath(),
                FileUtils.S_IRWXU|FileUtils.S_IRWXG|FileUtils.S_IXOTH,
                -1, -1);
        }
    
        return f;
    }
    这个方法其实很简单,就是通过传递过来的数据库名称name,然后构建一个数据库文件File对象返回即可。


    那么上面的几个方法我们可以总结功能:

    通过传递过来的数据库名称name,创建一个File对象,然后得到数据库文件的path..传递给SQLDatabase的openDatabase方法中,打开数据库文件


    下面我们继续来看那个流程:

    final int version = db.getVersion();
    if (version != mNewVersion) {
        if (db.isReadOnly()) {
            throw new SQLiteException("Can't upgrade read-only database from version " +
                    db.getVersion() + " to " + mNewVersion + ": " + mName);
        }
    
        db.beginTransaction();
        try {
            if (version == 0) {
                onCreate(db);
            } else {
                if (version > mNewVersion) {
                    onDowngrade(db, version, mNewVersion);
                } else {
                    onUpgrade(db, version, mNewVersion);
                }
            }
            db.setVersion(mNewVersion);
            db.setTransactionSuccessful();
        } finally {
            db.endTransaction();
        }
    }
    当打开数据库文件的时候,我们就开始进行操作了,今天讲的内容最主要的就是上面的判断了:

    首先获取数据库的当前版本,当版本号为0的时候,就会执行onCreate方法(当数据库文件第一次创建的时候版本号就是0)如果版本号不为0,同时和最新版本号进行比较,如果大于的话,就执行升级操作onUpgrade方法,否则就执行降级onDowngrade方法,不过降级方法实现很简单:


    直接抛出异常,也就是说数据库不允许降级操作的,这个也符合正常情况。


    好了。通过上面的分析,下面我们就对这两个方法做一下总结:

    public abstract void onCreate(SQLiteDatabase db);
    public abstract void onUpgrade(SQLiteDatabase db,int oldVersion,int newVersion);


    SQLiteOpenHelper会自动检测数据库文件是否存在。如果存在,会打开这个数据库,在这种情况下就不会调用onCreate()方法。如果数据库文件不存在,SQLiteOpenHelper首先会创建一个数据库文件,然后打开这个数据库,最后调用onCreate()方法。因此,onCreate()方法一般用来在新创建的数据库中建立表、视图等数据库组建。

    也就是说onCreate()方法在数据库文件第一次创建时调用。


    先看看SQLiteOpenHelper类的构造方法再解释onUpdate()方法何时会被调用。
    public SQLiteOpenHelper(Context context,String name,CursorFactory factory,int version);
    其中name参数表示数据库文件名(不包括文件路径),SQLiteOpenHelper会根据这个文件名创建数据库文件。version表示数据库的版本号。如果当前传入的数据库版本号比上次创建或升级的版本号高,SQLiteOpenHelper就会调用onUpdate()方法。也就是说,当数据库第一次创建时会有一个初始的版本号。当需要对数据库中的表、视图等组建升级时可以增大版本号,再重新创建它们。现在总结一下onCreate()和onUpgrade()调用过程。


    1.如果数据库文件不存在,SQLiteOpenHelper在自动创建数据库后会调用onCreate()方法,在该方法中一般需要创建表、视图等组件。在创建前数据库一般是空的,因此不需要先删除数据库中相关的组件。
    2.如果数据库文件存在,并且当前版本号高于上次创建或升级的版本号,SQLiteOpenHelper会调用onUpgrade()方法,调用该方法后会更新数据库的版本号。在onUpgrade()方法中除了创建表、视图等组件外,还需要先删除这些相关的组件,因此,在调用onUpgrade()方法前,数据库是存在的,里面还原许多数据库组建。


    综合上述两点,可以得出一个结论:

    如果数据库文件不存在,只有onCreate()被调用(该方法在创建数据库时被调用一次)。如果数据库文件存在,会调用onUpgrade()方法升级数据库,并更新版本号。




沪ICP备19023445号-2号
友情链接