Android入门(十)SQLite创建升级数据库

时间:2022-05-20 23:41:39

原文链接:http://www.orlion.ga/603/

一、创建数据库

Android为了让我们能够更加方便地管理数据库,专门提供了一个 SQLiteOpenHelper帮助类, 借助这个类就可以非常简单地对数据库进行创建和升级。

SQLiteOpenHelper是一个抽象类,其中有两个抽象方法分别是onCreate()和onUpgrade(),分别在这两个方法中实现创建和升级数据库的逻辑

SQLiteOpenHelper还有两个十分重要的实例方法,getReadableDatabase()和getWritableDatabase()。这两个方法都可以创建或打开一个现有的数据库(如果数据库已存在则直接打开,如果不存在则创建一个),并返回一个可对数据库进行读写操作的对象。不同的是,当数据库不可写入的时候(如磁盘空间已满)getReadableDatabase()方法返回的对象将以只读的方式去打开数据库,而getWritableDatabase()将抛出异常。

SQLiteOpenHelper中有两个构造方法可以重写,一般使用参数少的那个构造方法即可。这个构造方法接收四个参数,第一个是Context 。第二个是数据库名。第三个参数允许我们在查询数据的时候返回一个自定义的Cursor,一般都是传入null。第四个参数是当前数据库的版本号,可用于对数据库进行升级操作。构建出SQLiteOpenHelper的实例之后,再调用它的getReadableDatabase()或getWritableDatabase()方法就能够创建数据库了,数据库文件会存放在/data/data/<package name>/databases/目录下。此时重写的onCreate()方法也会得到执行,所以通常会在这里去处理一些创建表的逻辑。

创建一个项目DatabaseDemo,新建MyDatabaseHelper类从SQLiteOpenHelper继承:

package ga.orlion.databasedemo;

import android.content.Context;

import android.database.sqlite.SQLiteDatabase;

import android.database.sqlite.SQLiteDatabase.CursorFactory;

import android.widget.Toast;

import android.database.sqlite.SQLiteOpenHelper;

public class MyDatabaseHelper extends SQLiteOpenHelper {

public static final String CREATE_BOOK = "create table book ("

+ "id integer primary key autoincrement, "

+ "author text, "

+ "price real, "

+ "pages integer, "

+ "name text)";

private Context mContext;

public MyDatabaseHelper(Context context, String name, CursorFactory factory, int version) {

super(context, name, factory, version);

mContext = context;

}

@Override

public void onCreate(SQLiteDatabase db) {

db.execSQL(CREATE_BOOK);

Toast.makeText(mContext, "数据库创建了", Toast.LENGTH_SHORT).show();

}

@Override

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

}

}

其中建表语句:

create table Book (

id integer primary key autoincrement,

author text,

price real,

pages integer,

name text)

SQLite不像其他的数据库拥有众多繁杂的数据类型, 它的数据类型很简单, integer表示整型,real表示浮点型,text表示文本类型,blob表示二进制类型。另外,上述建表语句中我们还使用了 primary key将 id列设为主键,并用 autoincrement关键字表示 id列是自增长的。

我们把建表语句定义成了一个字符串常量,然后在 onCreate()方法中又调用了 SQLiteDatabase的 execSQL()方法去执行这条建表语句,并弹出一个 Toast提示创建成功。

修改activity_main.xml:

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"

android:layout_width="match_parent"

android:layout_height="match_parent"

android:orientation="vertical" >

<Button

android:id="@+id/create_database"

android:layout_width="match_parent"

android:layout_height="wrap_content"

android:text="创建数据库" />

</LinearLayout>

布局文件很简单,就是加入了一个按钮,用于创建数据库。最后修改 MainActivity中的代码:

super.onCreate(savedInstanceState);

setContentView(R.layout.activity_main);

dbHelper = new MyDatabaseHelper(this , "BookStore.db" , null , 1);

Button button = (Button) findViewById(R.id.create_database);

button.setOnClickListener(new View.OnClickListener() {

@Override

public void onClick(View v) {

dbHelper.getWritableDatabase();

}

});

这里我们在 onCreate()方法中构建了一个 MyDatabaseHelper对象,并且通过构造函数的参数将数据库名指定为 BookStore.db,版本号指定为 1,然后在 Create database按钮的点击事件里调用了getWritableDatabase()方法。这样当第一次点击Create database按钮时,就会检测到当前程序中并没有BookStore.db这个数据库, 于是会创建该数据库并调用MyDatabaseHelper中的 onCreate()方法,这样 Book表也就得到了创建,然后会弹出一个 Toast提示创建成功。再次点击 Create database按钮时,会发现此时已经存在 BookStore.db数据库了,因此不会再创建一次。

接下来我们使用adb shell来对数据库和表的创建情况进行查看,adb工具在Android SDK中自带,这个工具可以对连接在电脑上的手机或模拟器进行调试操作,它存放在sdk的platform-tools目录下。先将这个目录添加到环境变量中。然后控制台中输入 "adb shell",然后使用"cd"命令进入/data/data/ga.orlion.databasedemo/databases/目录下,使用ls查看所有文件会看到有两个文件,一个是我们创建的BookStore.db,另一个BookStore.db-journal则是为了数据库能够支持事务而产生的临时日志文件,通常情况下该文件的大小是0。接下来我们通过sqlite3命令打开数据库,只需要输入sqlite3后边跟上数据库名即可。这时就打开BookStore.db数据库了,现在就可以对这个数据库的表进行管理了,可以通过".table"命令来查看有哪些表

,此时有两个表,android_meatdata是每个数据库都会自动生成的,另外一个表book是我们创建的。还可以通过".schema"命令来查看他们的建表语句。

二、升级数据库

如果我们想再添加一个表到我们创建的数据库BookStore.db中不能像创建第一个表book时那样简单的写到oncreate方法中了,因为我们的数据库已经创建了,onCreate()不会再执行了,所以就用到了onUpgrade()方法。

可以将MyDatabaseHelper改为:

package ga.orlion.databasedemo;

import android.content.Context;

import android.database.sqlite.SQLiteDatabase;

import android.database.sqlite.SQLiteDatabase.CursorFactory;

import android.widget.Toast;

import android.database.sqlite.SQLiteOpenHelper;

public class MyDatabaseHelper extends SQLiteOpenHelper {

public static final String CREATE_BOOK = "create table book ("

+ "id integer primary key autoincrement, "

+ "author text, "

+ "price real, "

+ "pages integer, "

+ "name text)";

public static final String CREATE_CATEGORY = "create table Category ("

+ "id integer primary key autoincrement, "

+ "category_name text, "

+ "category_code integer)";

private Context mContext;

public MyDatabaseHelper(Context context, String name, CursorFactory factory, int version) {

super(context, name, factory, version);

mContext = context;

}

@Override

public void onCreate(SQLiteDatabase db) {

db.execSQL(CREATE_BOOK);

db.execSQL(CREATE_CATEGORY);

Toast.makeText(mContext, "数据库创建了", Toast.LENGTH_SHORT).show();

}

@Override

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

db.execSQL("drop table if exists Book");

db.execSQL("drop table if exists Category");

onCreate(db);

}

}

可以看到,我们在 onUpgrade()方法中执行了两条 DROP语句,如果发现数据库中已经存在 Book表或 Category表了,就将这两张表删除掉,然后再调用 onCreate()方法去重新创建。这里先将已经存在的表删除掉,是因为如果在创建表时发现这张表已经存在了,就会直接报错。

接下来就是让 onUpgrade()方法能够执行了,SQLiteOpenHelper的构造方法里接收的第四个参数吗?它表示当前数据库的版本号,现在只要传入一个比 1大的数, 就可以让 onUpgrade()方法得到执行了。

dbHelper = new MyDatabaseHelper(this , "BookStore.db" , null , 2);