Android开发笔记：如何使用预先制作好的SQLite数据库（整理自网络）

参考：[Android]发布Sqlite数据库

在实际开发中，我们经常遇到需使用自己已经定制好数据的数据库，一般的做法是：

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();
        }