SQLiteOpenHelper类与自动升级数据库
SQLiteOpenHelper类与自动升级数据库
SQLiteDatabase是Android SDK中操作数据库的核心类之一。使用SQLiteDatabase可以打开数据库，也可以对数据库进行操作。然而为了数据库升级的需要以及使用更方便，往往使用SQLiteOpenHelper的子类来完成创建、打开数据库及各种数据库操作。
SQLiteOpenHelper是个抽象类，在该类中有如下两个抽象方法，SQLiteOpenHelper的子类必须实现这两个方法。
public abstract void onCreate(SQLiteDatabase db);
public abstract void onUpdate(SQLiteDatabase db,int oldVersion,int newVersion);
SQLiteOpenHelper会自动检测数据库文件是否存在。如果存在，会打开这个数据库，在这种情况下就不会调用onCreate()方法。如果数据库文件不存在，SQLiteOpenHelper首先会创建一个数据库文件，然后打开这个数据库，最后调用onCreate()方法。因此，onCreate()方法一般用来在新创建的数据库中建立表、视图等数据库组建。也就是说oncreate()方法在数据库文件第一次创建时调用。
先看看SQLiteOpenHelper类的构造方法再解释onUpdate()方法何时会被调用。
public SQLiteOpenHelper(Context context,String name,CursorFactory factory,int version);
其中name参数表示数据库文件名（不包括文件路径），SQLiteOpenHelper会根据这个文件名创建数据库文件。version表示数据库的版本号。如果当前传入的数据库版本号比上次创建或升级的版本号高，SQLiteOpenHelper就会调用onUpdate()方法。也就是说，当数据库第一次创建时会有一个初始的版本号。当需要对数据库中的表、视图等组建升级时可以增大版本号，再重新创建它们。现在总结一下oncreate()和onUpdate()调用过程。
1.如果数据库文件不存在，SQLiteOpenHelper在自动创建数据库后会调用oncreate()方法，在该方法中一般需要创建表、视图等组件。在创建前数据库一般是空的，因此不需要先删除数据库中相关的组件。
2.如果数据库文件存在，并且当前版本号高于上次创建或升级的版本号，SQLiteOpenHelper会调用onUpdate()方法，调用该方法后会更新数据库的版本号。在onupdate()方法中除了创建表、视图等组件外，还需要先删除这些相关的组件，因此，在调用onupdate()方法前，数据库是存在的，里面还原许多数据库组建。
综合上述两点，可以得出一个结论。如果数据库文件不存在，只有oncreate()被调用（该方法在创建数据库时被调用一次）。如果数据库文件存在，会调用onupdate()方法升级数据库，并更新版本号。转：http://www.eoeandroid.com/thread-54750-1-1.html
Android 使用SQLiteOpenHelper类对数据库进行操作
一、 SQLite介绍
SQLite是android内置的一个很小的关系型数据库。
SQLite的官网是http://www.sqlite.org/，可以去下载一些文档或相关信息。
博客中有一篇有稍微详细一点的介绍，大家可以去看一下。
二、 SQLiteOpenHelper的使用方法
SQLiteOpenHelper是一个辅助类来管理数据库的创建和版本。
可以通过继承这个类，实现它的一些方法来对数据库进行一些操作。
所有继承了这个类的类都必须实现下面这样的一个构造方法：
public DatabaseHelper(Context context, String name, CursorFactory factory, int version)
第一个参数：Context类型，上下文对象。
第二个参数：String类型，数据库的名称
第三个参数：CursorFactory类型
第四个参数：int类型，数据库版本
下面是这个类的几个方法：
方法名 返回类型 描述 备注
getReadableDatabase() synchronized SQLiteDatabase 创建或打开一个数据库 可以通过这两个方法返回的SQLiteDatabase对象对数据库进行一系列的操作，如新建一个表，插入一条数据等
getWritableDatabase() synchronized SQLiteDatabase 创建或打开一个可以读写的数据库
onCreate(SQLiteDatabase db) abstract void 第一次创建的时候调用
onOpen(SQLiteDatabase db) void 打开数据库
onUpgrade(SQLiteDatabase db,int oldVersion,int newVersion) abstract void 升级数据库
close() synchronized void 关闭所有打开的数据库对象
介于代码中有详细备注了，在此我就不多写了，直接贴代码了，代码如下：
DatabaseHelper类：
package android.sqlite;
import android.content.Context;
import android.database.sqlite.SQLiteDatabase;
import android.database.sqlite.SQLiteOpenHelper;
import android.database.sqlite.SQLiteDatabase.CursorFactory;
/**
* SQLiteOpenHelper是一个辅助类，用来管理数据库的创建和版本他，它提供两个方面的功能
* 第一，getReadableDatabase()、getWritableDatabase()可以获得SQLiteDatabase对象，通过该对象可以对数据库进行操作
* 第二，提供了onCreate()、onUpgrade()两个回调函数，允许我们再创建和升级数据库时，进行自己的操作
*/
public class DatabaseHelper extends SQLiteOpenHelper {
private static final int VERSION = 1;
/**
* 在SQLiteOpenHelper的子类当中，必须有该构造函数
* @param context 上下文对象
* @param name 数据库名称
* @param factory
* @param version 当前数据库的版本，值必须是整数并且是递增的状态
*/
public DatabaseHelper(Context context, String name, CursorFactory factory,
int version) {
//必须通过super调用父类当中的构造函数
super(context, name, factory, version);
}
public DatabaseHelper(Context context, String name, int version){
this(context,name,null,version);
}
public DatabaseHelper(Context context, String name){
this(context,name,VERSION);
}
//该函数是在第一次创建的时候执行，实际上是第一次得到SQLiteDatabase对象的时候才会调用这个方法
@Override
public void onCreate(SQLiteDatabase db) {
// TODO Auto-generated method stub
System.out.println("create a database");
//execSQL用于执行SQL语句
db.execSQL("create table user(id int,name varchar(20))");
}
@Override
public void onUpgrade(SQLiteDatabase arg0, int arg1, int arg2) {
// TODO Auto-generated method stub
System.out.println("upgrade a database");
}
}
Activity类：
package android.sqlite;
import android.app.Activity;
import android.content.ContentValues;
import android.database.Cursor;
import android.database.sqlite.SQLiteDatabase;
import android.os.Bundle;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
public class SQLiteActivity extends Activity {
/** Called when the activity is first created. */
private Button createDatabaseButton = null;
private Button updateDatabaseButton = null;
private Button insertButton = null;
private Button updateButton = null;
private Button selectButton = null;
private Button deleteButton = null;
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
// 根据控件id获得相应的控件对象
createDatabaseButton = (Button) findViewById(R.id.createDatabase);
updateDatabaseButton = (Button) findViewById(R.id.updateDatabase);
insertButton = (Button) findViewById(R.id.insert);
updateButton = (Button) findViewById(R.id.update);
selectButton = (Button) findViewById(R.id.select);
deleteButton = (Button) findViewById(R.id.delete);
// 为按钮设置监听器
createDatabaseButton
.setOnClickListener(new CreateDatabaseOnClickListener());
updateDatabaseButton
.setOnClickListener(new UpdateDatabaseOnClickListener());
insertButton.setOnClickListener(new InsertOnClickListener());
updateButton.setOnClickListener(new UpdateOnClickListener());
selectButton.setOnClickListener(new SelectOnClickListener());
deleteButton.setOnClickListener(new DeleteOnClickListener());
}
// createDatabaseButton点击事件监听器
class CreateDatabaseOnClickListener implements OnClickListener {
public void onClick(View v) {
// 创建了一个DatabaseHelper对象，只执行这句话是不会创建或打开连接的
DatabaseHelper dbHelper = new DatabaseHelper(SQLiteActivity.this,
"test_yangyz_db");
// 只有调用了DatabaseHelper的getWritableDatabase()方法或者getReadableDatabase()方法之后，才会创建或打开一个连接
SQLiteDatabase sqliteDatabase = dbHelper.getReadableDatabase();
}
}
// updateDatabaseButton点击事件监听器
class UpdateDatabaseOnClickListener implements OnClickListener {
public void onClick(View v) {
// TODO Auto-generated method stub
DatabaseHelper dbHelper = new DatabaseHelper(SQLiteActivity.this,
"test_yangyz_db", 2);
// 得到一个只读的SQLiteDatabase对象
SQLiteDatabase sqliteDatabase = dbHelper.getReadableDatabase();
}
}
// insertButton点击事件监听器
class InsertOnClickListener implements OnClickListener {
public void onClick(View v) {
// 创建ContentValues对象
ContentValues values = new ContentValues();
// 向该对象中插入键值对，其中键是列名，值是希望插入到这一列的值，值必须和数据库当中的数据类型一致
values.put("id", 1);
values.put("name", "yangyz");
// 创建DatabaseHelper对象
DatabaseHelper dbHelper = new DatabaseHelper(SQLiteActivity.this,
"test_yangyz_db", 2);
// 得到一个可写的SQLiteDatabase对象
SQLiteDatabase sqliteDatabase = dbHelper.getWritableDatabase();
// 调用insert方法，就可以将数据插入到数据库当中
// 第一个参数:表名称
// 第二个参数：SQl不允许一个空列，如果ContentValues是空的，那么这一列被明确的指明为NULL值
// 第三个参数：ContentValues对象
sqliteDatabase.insert("user", null, values);
}
}
// updateButton点击事件监听器
class UpdateOnClickListener implements OnClickListener {
public void onClick(View v) {
// 创建一个DatabaseHelper对象
DatabaseHelper dbHelper = new DatabaseHelper(SQLiteActivity.this,
"test_yangyz_db", 2);
// 得到一个可写的SQLiteDatabase对象
SQLiteDatabase sqliteDatabase = dbHelper.getWritableDatabase();
// 创建一个ContentValues对象
ContentValues values = new ContentValues();
values.put("name", "zhangsan");
// 调用update方法
// 第一个参数String：表名
// 第二个参数ContentValues：ContentValues对象
// 第三个参数String：where字句，相当于sql语句where后面的语句，？号是占位符
// 第四个参数String[]：占位符的值
sqliteDatabase.update("user", values, "id=?", new String[] { "1" });
System.out.println("-----------update------------");
}
}
// selectButton点击事件监听器
class SelectOnClickListener implements OnClickListener {
public void onClick(View v) {
String id = null;
String name = null;
//创建DatabaseHelper对象
DatabaseHelper dbHelper = new DatabaseHelper(SQLiteActivity.this,
"test_yangyz_db", 2);
// 得到一个只读的SQLiteDatabase对象
SQLiteDatabase sqliteDatabase = dbHelper.getReadableDatabase();
// 调用SQLiteDatabase对象的query方法进行查询，返回一个Cursor对象：由数据库查询返回的结果集对象
// 第一个参数String：表名
// 第二个参数String[]:要查询的列名
// 第三个参数String：查询条件
// 第四个参数String[]：查询条件的参数
// 第五个参数String:对查询的结果进行分组
// 第六个参数String：对分组的结果进行限制
// 第七个参数String：对查询的结果进行排序
Cursor cursor = sqliteDatabase.query("user", new String[] { "id",
"name" }, "id=?", new String[] { "1" }, null, null, null);
// 将光标移动到下一行，从而判断该结果集是否还有下一条数据，如果有则返回true，没有则返回false
while (cursor.moveToNext()) {
id = cursor.getString(cursor.getColumnIndex("id"));
name = cursor.getString(cursor.getColumnIndex("name"));
}
System.out.println("-------------select------------");
System.out.println("id: "+id);
System.out.println("name: "+name);
}
}
// deleteButton点击事件监听器
class DeleteOnClickListener implements OnClickListener {
public void onClick(View v) {
//创建DatabaseHelper对象
DatabaseHelper dbHelper = new DatabaseHelper(SQLiteActivity.this,"test_yangyz_db",2);
//获得可写的SQLiteDatabase对象
SQLiteDatabase sqliteDatabase = dbHelper.getWritableDatabase();
//调用SQLiteDatabase对象的delete方法进行删除操作
//第一个参数String：表名
//第二个参数String：条件语句
//第三个参数String[]：条件值
sqliteDatabase.delete("user", "id=?", new String[]{"1"});
System.out.println("----------delete----------");
}
}
}
布局文件：
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:orientation="vertical"
android:layout_width="fill_parent"
android:layout_height="fill_parent"
>
<TextView
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:text="@string/hello"
/>
<Button
android:id="@+id/createDatabase"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:text="@string/createDatabaseButton"
/>
<Button
android:id="@+id/updateDatabase"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:text="@string/updateDatabaseButton"
/>
<Button
android:id="@+id/insert"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:text="@string/insertButton"
/>
<Button
android:id="@+id/update"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:text="@string/updateButton"
/>
<Button
android:id="@+id/select"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:text="@string/selectButton"
/>
<Button
android:id="@+id/delete"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:text="@string/deleteButton"
/>
</LinearLayout>
String文件：
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="hello">Hello World, SQLiteActivity!</string>
<string name="app_name">SQLiteTest</string>
<string name="createDatabaseButton">createDatabase</string>
<string name="updateDatabaseButton">updateDatabase</string>
<string name="insertButton">insert</string>
<string name="updateButton">update</string>
<string name="selectButton">select</string>
<string name="deleteButton">delete</string>
</resources>