Android入门SQLite创建升级数据库

Posted 2020-07-03 Orlion

原文链接: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);