在实际开发中,我们经常遇到需使用自己已经定制好数据的数据库,一般的做法是:
1、用Sqlite数据库工具制作数据库文件,网上有许多这类工具,可以自己搜索下载,我用的是SqliteStudio。
需要注意的是android对其使用的Sqlite数据库有一些固定的要求,包括:
(1)数据库文件中必须有一个名为“android_metadata”的表,这个表只包括一个字段:locale,也只需要一条记录,默认值为“en_US”。
CREATE TABLE "android_metadata" ("locale" TEXT DEFAULT 'zh_CN') INSERT INTO "android_metadata" VALUES ('zh_CN')
(2)数据库文件中的其它表,必须包括一个名字“_id”的关键字字段,ListView等使用的适配器自动绑定’_id’如果没有会报错。
2、将制作好的数据库文件放在Android项目的assets文件夹或res/raw文件夹下(我习惯放在assets文件夹下)。
3、Android项目使用的数据库文件一般在/data/data/项目包名/databases/下,使用代码使程序在运行时进行判断,如该路径下没有指定的文件,则进行复制,否则不做任何操作。
4、如数据库文件不超过1M,可以直接复制,否则需要预先将数据库文分割为几个不超过1M的文件,复制到目标路径后再组合一一起。
实例:
使用一个DBHelper类来实现判断和复制数据库的操作,这个类继承自SQLiteOpenHelper类。
package com.bluehowk.homecooking; import java.io.File; import java.io.FileOutputStream; import java.io.IOException; import java.io.InputStream; import java.io.OutputStream; import android.content.Context; import android.database.sqlite.SQLiteDatabase; import android.database.sqlite.SQLiteDatabase.CursorFactory; import android.database.sqlite.SQLiteException; import android.database.sqlite.SQLiteOpenHelper; /** * 用法: * DBHelper dbHelper = new DBHelper(this); * dbHelper.createDataBase(); * SQLiteDatabase db = dbHelper.getWritableDatabase(); * Cursor cursor = db.query() * db.execSQL(sqlString); * 注意:execSQL不支持带;的多条SQL语句 * 见execSQL的源码注释 (Multiple statements separated by ;s are not supported.) * 将把assets下的数据库文件直接复制到DB_PATH,但数据库文件大小限制在1M以下 * 如果有超过1M的大文件,则需要先分割为N个小文件,然后使用copyBigDatabase()替换copyDatabase() */ public class DBHelper extends SQLiteOpenHelper { //用户数据库文件的版本 private static final int DB_VERSION = 1; //数据库文件目标存放路径为系统默认位置,cn.arthur.examples 是你的包名 private static String DB_PATH = "/data/data/com.bluehowk.homecooking/databases/"; /* //如果你想把数据库文件存放在SD卡的话 private static String DB_PATH = android.os.Environment.getExternalStorageDirectory().getAbsolutePath() + "目标路径"; */ //下面两个静态变量分别是目标文件的名称和在assets文件夹下的文件名 private static String DB_NAME = "cookdata.db"; private static String ASSETS_NAME = "cookdata.db"; private SQLiteDatabase myDataBase = null; private final Context myContext; /** * 如果数据库文件较大,使用FileSplit分割为小于1M的小文件 * 此例中分割为 hello.db.101 hello.db.102 hello.db.103 */ //第一个文件名后缀 private static final int ASSETS_SUFFIX_BEGIN = 101; //最后一个文件名后缀 private static final int ASSETS_SUFFIX_END = 103; /** * 在SQLiteOpenHelper的子类当中,必须有该构造函数 * @param context 上下文对象 * @param name 数据库名称 * @param factory 一般都是null * @param version 当前数据库的版本,值必须是整数并且是递增的状态 */ public DBHelper(Context context, String name, CursorFactory factory, int version) { //必须通过super调用父类当中的构造函数 super(context, name, null, version); this.myContext = context; } public DBHelper(Context context, String name, int version){ this(context,name,null,version); } public DBHelper(Context context, String name){ this(context,name,DB_VERSION); } public DBHelper (Context context) { this(context, DB_PATH + DB_NAME); } public void createDataBase() throws IOException{ boolean dbExist = checkDataBase(); if(dbExist) { //数据库已存在,不做任何操作 } else { //创建数据库 try { File dir = new File(DB_PATH); if(!dir.exists()){ dir.mkdirs(); } File dbf = new File(DB_PATH + DB_NAME); if(dbf.exists()){ dbf.delete(); } SQLiteDatabase.openOrCreateDatabase(dbf, null); // 复制asseets中的数据库文件到DB_PATH下 copyDataBase(); } catch (IOException e) { throw new Error("数据库创建失败"); } } } //检查数据库是否有效 private boolean checkDataBase(){ SQLiteDatabase checkDB = null; String myPath = DB_PATH + DB_NAME; try{ checkDB = SQLiteDatabase.openDatabase(myPath, null, SQLiteDatabase.OPEN_READONLY); }catch(SQLiteException e){ //database does't exist yet. } if(checkDB != null){ checkDB.close(); } return checkDB != null ? true : false; } /** * 复制assets文件中的数据库到指定路径 * 使用输入输出流进行复制 **/ private void copyDataBase() throws IOException{ InputStream myInput = myContext.getAssets().open(ASSETS_NAME); String outFileName = DB_PATH + DB_NAME; OutputStream myOutput = new FileOutputStream(outFileName); byte[] buffer = new byte[1024]; int length; while ((length = myInput.read(buffer))>0){ myOutput.write(buffer, 0, length); } myOutput.flush(); myOutput.close(); myInput.close(); } //复制assets下的大数据库文件时用这个 private void copyBigDataBase() throws IOException{ InputStream myInput; String outFileName = DB_PATH + DB_NAME; OutputStream myOutput = new FileOutputStream(outFileName); for (int i = ASSETS_SUFFIX_BEGIN; i < ASSETS_SUFFIX_END+1; i++) { myInput = myContext.getAssets().open(ASSETS_NAME + "." + i); byte[] buffer = new byte[1024]; int length; while ((length = myInput.read(buffer))>0){ myOutput.write(buffer, 0, length); } myOutput.flush(); myInput.close(); } myOutput.close(); } @Override public synchronized void close() { if(myDataBase != null){ myDataBase.close(); } super.close(); } @Override public void onCreate(SQLiteDatabase db) { } /** * 数据库创建时执行,如果不是预制的数据库,可以在这些写一些创建表和添加初始化数据的操作 * 如:db.execSQL("create table cookdata (_id integer primary key,cook_name * varchar(20),cook_sort varchar(20))"); */ @Override public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { /** * 数据库升级时执行,前面我们定义的DB_VERSION就是数据库版本,在版本升高时执行 * 一般做一些数据备份和恢复到新数据库的操作。 */ } }
可以使用如下代码进行调用:
helper=new DBHelper(context); try { helper.createDataBase(); } catch (IOException e) { // TODO Auto-generated catch block e.printStackTrace(); }