Android中使用SQLiteOpenHelper管理SD卡中的数据库

使用Android中自带的SQLiteOpenHelper可以完成数据库的创建与管理，但有两点局限：

（1）数据库创建在 内存卡中，大小受限，创建位置位于/data/data/应用程序名/databases中（ 可使用Eclispe的DDMS查看）。

（2）如果无法获取Root权限，则无法直接查看创建的数据库。

 

鉴于上述限制及实际需要，打算使用SQLiteOpenHelper管理SD卡上的数据库，通过 研究SQLiteOpenHelper的源码，发现其创建或打开数据库的代码位于getWritableDatabase()函数中(getReadableDatabase本身也是调用了getWritableDatabase)：

 if (mName == null) {

     db = SQLiteDatabase.create(null);

     } 

else {

     db = mContext.openOrCreateDatabase(mName, 0, mFactory);

     }

 分析上述代码发现，当数据库名字为非空时，创建数据库或打开由mContext完成，这个mContext由SQLiteOpenHelper的构造函数传入：SQLiteOpenHelper(Context context, String name, SQLiteDatabase.CursorFactory factory, int version)。那么我们对于传入的context，重载其openOrCreateDatabase函数，使其将数据库创建到SD卡中就可完成我们的目标了~。

 

对应的SQLiteOpenHelper实现类SdCardDBHelper

 

import android.content.Context;

import android.database.SQLException;

import android.database.sqlite.SQLiteDatabase;

import android.database.sqlite.SQLiteOpenHelper;

import android.util.Log;



/**

 * 数据库管理和维护类

**/

public class SdCardDBHelper extends SQLiteOpenHelper{

    

    public static final String TAG = "SdCardDBHelper";

    /**

     * 数据库名称

    **/

    public static String DATABASE_NAME = "sddb.db";

    

    /**

     * 数据库版本

    **/

    public static int DATABASE_VERSION = 1;

        

    /**

     * 构造函数

     * 

     * @param    context 上下文环境

    **/

    public SdCardDBHelper(Context context){

        super(context, DATABASE_NAME, null, DATABASE_VERSION);

    }    

     

    /**

     * 创建数据库时触发，创建离线存储所需要的数据库表

     *

     * @param    db

    **/

    @Override

    public void onCreate(SQLiteDatabase db) {

         Log.e(TAG, "开始创建数据库表");

        try{

            //创建用户表(user)

             db.execSQL("create table if not exists user" +

                     "(_id integer primary key autoincrement,name varchar(20),password varchar(20),role varchar(10),updateTime varchar(20))");

            Log.e(TAG, "创建离线所需数据库表成功");

        }

        catch(SQLException se){

            se.printStackTrace();

            Log.e(TAG, "创建离线所需数据库表失败");

        }        

    }

    

    /** 更新数据库时触发，

     *

     * @param    db

     * @param    oldVersion

     * @param    newVersion

    **/

    @Override

    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {

        //db.execSQL("ALTER TABLE person ADD COLUMN other STRING");  

     }

}

 

重载的openOrCreateDatabase在sd卡上创建数据库的Context

import java.io.File;

import java.io.IOException;



import android.content.Context;

import android.content.ContextWrapper;

import android.database.DatabaseErrorHandler;

import android.database.sqlite.SQLiteDatabase;

import android.database.sqlite.SQLiteDatabase.CursorFactory;

import android.util.Log;



/**

 * 用于支持对存储在SD卡上的数据库的访问

**/

public class DatabaseContext extends ContextWrapper {        

           

        /**

         * 构造函数

         * @param    base 上下文环境

         */

        public DatabaseContext(Context base){

            super(base);

        }

     

        /**

         * 获得数据库路径，如果不存在，则创建对象对象

         * @param    name

         * @param    mode

         * @param    factory

         */

        @Override

        public File getDatabasePath(String name) {

            //判断是否存在sd卡

            boolean sdExist = android.os.Environment.MEDIA_MOUNTED.equals(android.os.Environment.getExternalStorageState());

            if(!sdExist){//如果不存在,

                Log.e("SD卡管理：", "SD卡不存在，请加载SD卡");

                return null;

            } 

            else{//如果存在

                //获取sd卡路径

                String dbDir=android.os.Environment.getExternalStorageDirectory().getAbsolutePath();

                dbDir += "/database";//数据库所在目录

                String dbPath = dbDir+"/"+name;//数据库路径

                //判断目录是否存在，不存在则创建该目录

                File dirFile = new File(dbDir);

                if(!dirFile.exists())

                    dirFile.mkdirs();

                

                //数据库文件是否创建成功

                boolean isFileCreateSuccess = false; 

                //判断文件是否存在，不存在则创建该文件

                File dbFile = new File(dbPath);

                if(!dbFile.exists()){

                    try {                    

                        isFileCreateSuccess = dbFile.createNewFile();//创建文件

                    } catch (IOException e) {

                        // TODO Auto-generated catch block

                        e.printStackTrace();

                    }

                }

                else     

                    isFileCreateSuccess = true;

                

                //返回数据库文件对象

                if(isFileCreateSuccess)

                    return dbFile;

                else 

                    return null;

            }

        }

     

        /**

         * 重载这个方法，是用来打开SD卡上的数据库的，android 2.3及以下会调用这个方法。

         * 

         * @param    name

         * @param    mode

         * @param    factory

         */

        @Override

        public SQLiteDatabase openOrCreateDatabase(String name, int mode, 

                SQLiteDatabase.CursorFactory factory) {

            SQLiteDatabase result = SQLiteDatabase.openOrCreateDatabase(getDatabasePath(name), null);

            return result;

        }

        

        /**

         * Android 4.0会调用此方法获取数据库。

         * 

         * @see android.content.ContextWrapper#openOrCreateDatabase(java.lang.String, int, 

         *              android.database.sqlite.SQLiteDatabase.CursorFactory,

         *              android.database.DatabaseErrorHandler)

         * @param    name

         * @param    mode

         * @param    factory

         * @param     errorHandler

         */

        @Override

        public SQLiteDatabase openOrCreateDatabase(String name, int mode, CursorFactory factory,

                DatabaseErrorHandler errorHandler) {

            SQLiteDatabase result = SQLiteDatabase.openOrCreateDatabase(getDatabasePath(name), null);

            return result;

        }

    } 

 调用程序：

DatabaseContext dbContext = new DatabaseContext(this);

SdCardDBHelper dbHelper = new SdCardDBHelper(dbContext);

 

这里尤其值得注意的是，不同版本的android API会调用不同的openOrCreateDatabase函数。

当然也可直接使用SQLiteDatabase创建SD卡上的数据库，或者直接修改SQLiteOpenHelper 的源码重新编译，不过前者没有对数据库进行一些检验容错处理，也不及 SQLiteOpenHelper对数据库操作方便。后者工作量较大，不建议采用。

 

最后注意记得 加入对SD卡的读写权限：

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"></uses-permission>

 

SQLite桌面查看工具： sqlite administrator、sqlite man或者firefox插件sqlite manager等。

 

参考资料：

1. 在android中查看和管理SQlite数据库

2. 梳理SQLiteDatabase、openOrCreateDatabase、context、SQLiteOpenHelper

3. 低版本Android读取放在SD卡上的数据库文件的方法