Android 为了让我们能够更加方便的管理数据库,特意提供了一个SQLiteOpenHelper帮助类,通过借助这个类就可以非常简单的对数据库进行创建和升级。
SQLiteOpenHelper是一个抽象类,我们要创建一个自己的帮助类去继承它。SQLiteOpenHelper有两个抽象方法,分别是onCreat()和onUpgrade(),我们必须在自己的帮助类里面重这两个方法,然后分别在这两个方法中去实现创建、升级数据库的逻辑。
SQLiteOpenHelper中还有两个非常重要的实例方法:getReadableDatabase()和getWritableDatabase()。这两个方法都可以创建或打开一个现有的数据库,并返回一个可对数据库进行读写操作的对象。不同的是,当数据不可写入的时候(如磁盘已满),getReadableDatabase()方法返回的对象将以只可读的方式去打开数据库,而getWriteableDatabase()方法将出现异常。
SQLiteOpenHelper中有两个构造方法可供重写,一般使用参数少一点的构造方法即可。
这个构造方法中接收4个参数,第一个参数是Context,第二个参数是数据库名,创建数据库时使用的就是这里指定的名称。第三个参数允许我们在查询数据的时候返回一个自定义的Cursor,一般都是传入null。第四个参数表示当前数据库的版本号。
构建出SQLiteOpenHelper的实例之后,再调用他的getReadableDatabase()或getWritableDatabase()方法就能够创建数据库了。数据库文件通常会放在/data/data/<pack name>/database/目录下。此时,重写的onCreate()方法也会得到执行。所以通常会在这里去处理一些创建表的逻辑。
新建项目DatabaseTest。
我们希望创建一个名为BookStore.db的数据库,然后在这个数据库中新建一张Book表,表中包含主键id、作者、价格、页数和书名等列。创建数据库表当然还是需要用建表语句的。
新建MyDatabaseHelper类继承SQLiteOpenHelper,代码如下:
package com.example.databasetest;import android.content.Context;
import android.database.sqlite.SQLiteDatabase;
import android.database.sqlite.SQLiteOpenHelper;
import android.widget.Toast;/*** Created by ZHJ on 2018/3/3.*/public class MyDatabaseHelper extends SQLiteOpenHelper {public static final String CREATE_BOOK ="create table Book("+"id integer primary key autoincrement,"+"auto text,"+"price real,"+"pages integer"+"name text)";private Context mContext;public MyDatabaseHelper(Context context, String name, SQLiteDatabase.CursorFactory factory, int version){super(context,name,factory,version);mContext = context;}@Overridepublic void onCreate(SQLiteDatabase db) {db.execSQL(CREATE_BOOK);Toast.makeText(mContext,"Create succeeded",Toast.LENGTH_SHORT).show();}@Overridepublic void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {}
}
我们把建表语句定义为一个字符串常量,然后在Oncreate()方法中又调用了SQLiteDatabase的execSQL()方法去执行这条建表语句,并弹出一个Toast提示创建成功,这样我们在保证创建数据库的同时还是成功创建Book表。
修改activity_main.xml的代码,如下:
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"xmlns:app="http://schemas.android.com/apk/res-auto"android:layout_width="match_parent"android:layout_height="match_parent"><Buttonandroid:id="@+id/create_database"android:layout_width="match_parent"android:layout_height="wrap_content"android:text="Create database"/></LinearLayout>
仅仅加入一个按钮,用于创建数据库。最后修改MainActivity中的代码,如下:
package com.example.databasetest;import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;public class MainActivity extends AppCompatActivity { private MyDatabaseHelper dbHelper;@Overrideprotected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_main);dbHelper = new MyDatabaseHelper(this,"BookStore.db",null,1);Button createDatabase = (Button) findViewById(R.id.create_database);createDatabase.setOnClickListener(new View.OnClickListener() {@Overridepublic void onClick(View view) {dbHelper.getWritableDatabase();}});}
}
我们在onCreate()方法中构建了一个MyDatabaseHelper对象,并且通过构造函数的参数将数据库指定为BookStore.db,版本号指定为1,然后在Create database按钮的点击事件里面调用了getWritableDatabase()方法,这样,当第一次点击Create database按钮时,就会检测到当前程序中并没有BookStore.db这个数据库于是会创建数据库并调用MyDatabaseHelper中的onCreate()方法,这样Book表也就得到了创建,然后会弹出一个Toast提示创建成功。再次点击Create database按钮时,会发现此时已经存在BookStore.db数据库了,不会再创建一次。
现在可以运行一下代码。
怎么样才能证明数据库已经创建成功了呢?
我们使用adb shell 来对数据库和表的创建情况进行检查。