在实际开发中,我们经常遇到需使用自己已经定制好数据的数据库,一般的做法是:
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类。
1 package com.bluehowk.homecooking; 2 import java.io.File; 3 import java.io.FileOutputStream; 4 import java.io.IOException; 5 import java.io.InputStream; 6 import java.io.OutputStream; 7 8 import android.content.Context; 9 import android.database.sqlite.SQLiteDatabase; 10 import android.database.sqlite.SQLiteDatabase.CursorFactory; 11 import android.database.sqlite.SQLiteException; 12 import android.database.sqlite.SQLiteOpenHelper; 13 14 /** 15 * 用法: 16 * DBHelper dbHelper = new DBHelper(this); 17 * dbHelper.createDataBase(); 18 * SQLiteDatabase db = dbHelper.getWritableDatabase(); 19 * Cursor cursor = db.query() 20 * db.execSQL(sqlString); 21 * 注意:execSQL不支持带;的多条SQL语句 22 * 见execSQL的源码注释 (Multiple statements separated by ;s are not supported.) 23 * 将把assets下的数据库文件直接复制到DB_PATH,但数据库文件大小限制在1M以下 24 * 如果有超过1M的大文件,则需要先分割为N个小文件,然后使用copyBigDatabase()替换copyDatabase() 25 */ 26 public class DBHelper extends SQLiteOpenHelper { 27 //用户数据库文件的版本 28 private static final int DB_VERSION = 1; 29 //数据库文件目标存放路径为系统默认位置,cn.arthur.examples 是你的包名 30 private static String DB_PATH = "/data/data/com.bluehowk.homecooking/databases/"; 31 /* 32 //如果你想把数据库文件存放在SD卡的话 33 private static String DB_PATH = android.os.Environment.getExternalStorageDirectory().getAbsolutePath() 34 + "目标路径"; 35 */ 36 //下面两个静态变量分别是目标文件的名称和在assets文件夹下的文件名 37 private static String DB_NAME = "cookdata.db"; 38 private static String ASSETS_NAME = "cookdata.db"; 39 40 private SQLiteDatabase myDataBase = null; 41 private final Context myContext; 42 43 /** 44 * 如果数据库文件较大,使用FileSplit分割为小于1M的小文件 45 * 此例中分割为 hello.db.101 hello.db.102 hello.db.103 46 */ 47 //第一个文件名后缀 48 private static final int ASSETS_SUFFIX_BEGIN = 101; 49 //最后一个文件名后缀 50 private static final int ASSETS_SUFFIX_END = 103; 51 52 /** 53 * 在SQLiteOpenHelper的子类当中,必须有该构造函数 54 * @param context 上下文对象 55 * @param name 数据库名称 56 * @param factory 一般都是null 57 * @param version 当前数据库的版本,值必须是整数并且是递增的状态 58 */ 59 public DBHelper(Context context, String name, CursorFactory factory, int version) { 60 //必须通过super调用父类当中的构造函数 61 super(context, name, null, version); 62 this.myContext = context; 63 } 64 65 public DBHelper(Context context, String name, int version){ 66 this(context,name,null,version); 67 } 68 69 public DBHelper(Context context, String name){ 70 this(context,name,DB_VERSION); 71 } 72 73 public DBHelper (Context context) { 74 this(context, DB_PATH + DB_NAME); 75 } 76 77 public void createDataBase() throws IOException{ 78 boolean dbExist = checkDataBase(); 79 if(dbExist) 80 { 81 //数据库已存在,不做任何操作 82 } 83 else 84 { 85 //创建数据库 86 try { 87 File dir = new File(DB_PATH); 88 if(!dir.exists()){ 89 dir.mkdirs(); 90 } 91 File dbf = new File(DB_PATH + DB_NAME); 92 if(dbf.exists()){ 93 dbf.delete(); 94 } 95 SQLiteDatabase.openOrCreateDatabase(dbf, null); 96 // 复制asseets中的数据库文件到DB_PATH下 97 copyDataBase(); 98 } catch (IOException e) { 99 throw new Error("数据库创建失败"); 100 } 101 } 102 } 103 104 //检查数据库是否有效 105 private boolean checkDataBase(){ 106 SQLiteDatabase checkDB = null; 107 String myPath = DB_PATH + DB_NAME; 108 try{ 109 checkDB = SQLiteDatabase.openDatabase(myPath, null, SQLiteDatabase.OPEN_READONLY); 110 }catch(SQLiteException e){ 111 //database does't exist yet. 112 } 113 if(checkDB != null){ 114 checkDB.close(); 115 } 116 return checkDB != null ? true : false; 117 } 118 119 /** 120 * 复制assets文件中的数据库到指定路径 121 * 使用输入输出流进行复制 122 **/ 123 private void copyDataBase() throws IOException{ 124 125 InputStream myInput = myContext.getAssets().open(ASSETS_NAME); 126 String outFileName = DB_PATH + DB_NAME; 127 OutputStream myOutput = new FileOutputStream(outFileName); 128 byte[] buffer = new byte[1024]; 129 int length; 130 while ((length = myInput.read(buffer))>0){ 131 myOutput.write(buffer, 0, length); 132 } 133 myOutput.flush(); 134 myOutput.close(); 135 myInput.close(); 136 } 137 138 //复制assets下的大数据库文件时用这个 139 private void copyBigDataBase() throws IOException{ 140 InputStream myInput; 141 String outFileName = DB_PATH + DB_NAME; 142 OutputStream myOutput = new FileOutputStream(outFileName); 143 for (int i = ASSETS_SUFFIX_BEGIN; i < ASSETS_SUFFIX_END+1; i++) { 144 myInput = myContext.getAssets().open(ASSETS_NAME + "." + i); 145 byte[] buffer = new byte[1024]; 146 int length; 147 while ((length = myInput.read(buffer))>0){ 148 myOutput.write(buffer, 0, length); 149 } 150 myOutput.flush(); 151 myInput.close(); 152 } 153 myOutput.close(); 154 } 155 156 @Override 157 public synchronized void close() { 158 if(myDataBase != null){ 159 myDataBase.close(); 160 } 161 super.close(); 162 } 163 164 165 @Override 166 public void onCreate(SQLiteDatabase db) 167 { 168 } 169 170 /** 171 * 数据库创建时执行,如果不是预制的数据库,可以在这些写一些创建表和添加初始化数据的操作 172 * 如:db.execSQL("create table cookdata (_id integer primary key,cook_name 173 * varchar(20),cook_sort varchar(20))"); 174 */ 175 @Override 176 public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) 177 { 178 /** 179 * 数据库升级时执行,前面我们定义的DB_VERSION就是数据库版本,在版本升高时执行 180 * 一般做一些数据备份和恢复到新数据库的操作。 181 */ 182 } 183 }