使用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");
- }
- }
- 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>