Android创建和使用数据库详细指南

Android创建和使用数据库详细指南(1)

摘要：每个应用程序都要使用数据，Android应用程序也不例外，Android使用开源的、与操作系统无关的SQL数据库--SQLite，本文介绍的就是如何为你的Android应用程序创建和操作SQLite数据库。

数据库支持每个应用程序无论大小的生命线，除非你的应用程序只处理简单的数据，那么就需要一个数据库系统存储你的结构化数据，Android使用SQLite数据库，它是一个开源的、支持多操作系统的SQL数据库，在许多领域广泛使用，如Mozilla FireFox就是使用SQLite 来存储配置数据的，iPhone也是使用SQLite来存储数据的。

在Android中，你为某个应用程序创建的数据库，只有它可以访问，其它应用程序是不能访问的，数据库位于Android设备/data/data//databases文件夹中，在这篇文章中，你将会学习到如何在Android中创建和使用数据库。

1SQLite数据库

使用Eclipse创建一个Android项目，取名为Database，如图1所示：

图1 数据库-使用Eclipse创建你的Android新项目

2创建DBAdapter辅助类

接下来创建一个数据库，取名为bookstitles，字段如图2所示。

图2 数据库字段在DBAdapter.java文件中，定义清单1中的常量。

清单1 定义DBAdapter.java文件中的常量

package net.learn2develop.Database;

import android.content.ContentValues;

import android.content.Context;

import android.database.Cursor;

import android.database.SQLException;

import android.database.sqlite.SQLiteDatabase;

import android.database.sqlite.SQLiteOpenHelper;

import android.util.Log;

public class DBAdapter

{

public static final String KEY_ROWID = "_id";

public static final String KEY_ISBN = "isbn";

public static final String KEY_TITLE = "title";

public static final String KEY_PUBLISHER = "publisher";

private static final String TAG = "DBAdapter";

private static final String DATABASE_NAME = "books";

private static final String DATABASE_TABLE = "titles";

private static final int DATABASE_VERSION =1;

private static final String DATABASE_CREATE =

"create table titles (_id integer primary key autoincrement, "

+ "isbn text not null, title text not null, "

+ "publisher text not null);";

private final Context context;

}

DATABASE_CREATE常量包括创建titles表的SQL语句。

在DBAdapter类中，你可以扩展SQLiteOpenHelper类，它是一个Android辅助类，主要用于数据库创建和版本管理。实际上，你可以覆盖onCreate()和onUpgrade()方法，如清单2所示。

清单2 在DBAdapter类中，扩展SQLiteOpenHelper类覆盖onCreate() 和onUpgrade()方法

package net.learn2develop.Database;

import android.content.ContentValues;

import android.content.Context;

import android.database.Cursor;

import android.database.SQLException;

import android.database.sqlite.SQLiteDatabase;

import android.database.sqlite.SQLiteOpenHelper;

import android.util.Log;

public class DBAdapter

{

public static final String KEY_ROWID = "_id";

public static final String KEY_ISBN = "isbn";

public static final String KEY_TITLE = "title";

public static final String KEY_PUBLISHER = "publisher";

private static final String TAG = "DBAdapter";

private static final String DATABASE_NAME = "books";

private static final String DATABASE_TABLE = "titles";

private static final int DATABASE_VERSION =1;

private static final String DATABASE_CREATE =

"create table titles (_id integer primary key autoincrement, " + "isbn text not null, title text not null, "

+ "publisher text not null);";

private final Context context;

private DatabaseHelper DBHelper;

private SQLiteDatabase db;

public DBAdapter(Context ctx)

{

this.context = ctx;

DBHelper = new DatabaseHelper(context);

}

private static class DatabaseHelper extends SQLiteOpenHelper {

DatabaseHelper(Context context)

{

super(context, DATABASE_NAME, null, DATABASE_VERSION);

}

@Override

public void onCreate(SQLiteDatabase db)

{

db.execSQL(DATABASE_CREATE);

}

@Override

public void onUpgrade(SQLiteDatabase db, int oldVersion,

int newVersion)

{

Log.w(TAG, "Upgrading database from version " + oldVersion

+ " to "

+ newVersion + ", which will destroy all old data");

db.execSQL("DROP TABLE IF EXISTS titles");

onCreate(db);

}

}

}

onCreate()方法创建一个新的数据库，onUpgrade()方法用于升级数据库，这可以通过检查DATABASE_VERSION常量定义的值来实现，对于onUpgrade()方法而言，只不过是简单地删除表，然后在创建表而已。

现在你可以定义不同的方法来打开和关闭数据库，如清单3中的添加/编辑/删除/行的函数。

清单3 定义打开和关闭数据库以及增加/编辑/删除表中行的方法

public class DBAdapter

{

//...

//...

//---打开数据库---

public DBAdapter open() throws SQLException

{

db = DBHelper.getWritableDatabase();

return this;

}

//---关闭数据库---

public void close()

{

DBHelper.close();

}

//---向数据库插入一个标题---

public long insertTitle(String isbn, String title, String publisher)

{

ContentValues initialValues = new ContentValues();

initialValues.put(KEY_ISBN, isbn);

initialValues.put(KEY_TITLE, title);

initialValues.put(KEY_PUBLISHER, publisher);

return db.insert(DATABASE_TABLE, null, initialValues);

}

//---删除一个指定的标题---

public boolean deleteTitle(long rowId)

{

return db.delete(DATABASE_TABLE, KEY_ROWID + "=" + rowId, null) >0; }

//---检索所有标题---

public Cursor getAllTitles()

{

return db.query(DATABASE_TABLE, new String[] {

KEY_ROWID,

KEY_ISBN,

KEY_TITLE,

KEY_PUBLISHER},

null,

null,

null,

null,

null);

}

//---检索一个指定的标题---

public Cursor getTitle(long rowId) throws SQLException

{

Cursor mCursor =

db.query(true, DATABASE_TABLE, new String[] {

KEY_ROWID,

KEY_ISBN,

KEY_TITLE,

KEY_PUBLISHER

},

KEY_ROWID + "=" + rowId,

null,

null,

null,

null,

null);

if (mCursor !=null) {

mCursor.moveToFirst();

}

return mCursor;

}

//---更新一个标题---

public boolean updateTitle(long rowId, String isbn,

String title, String publisher)

{

ContentValues args = new ContentValues();

args.put(KEY_ISBN, isbn);

args.put(KEY_TITLE, title);

args.put(KEY_PUBLISHER, publisher);

return db.update(DATABASE_TABLE, args,

KEY_ROWID + "=" + rowId, null) >0;

}

}

注意Android使用Cursor类返回一个需要的值，Cursor作为一个指针从数据库查询返回结果集，使用Cursor允许Android更有效地管理它们需要的行和列，你使用ContentValues 对象存储键/值对，它的put()方法允许你插入不同数据类型的键值。

清单4显示了完整的DBAdapter.java源代码。

清单4 DBAdapter.java完整源代码

package net.learn2develop.Database;

import android.content.ContentValues;

import android.content.Context;

import android.database.Cursor;

import android.database.SQLException;

import android.database.sqlite.SQLiteDatabase;

import android.database.sqlite.SQLiteOpenHelper;

import android.util.Log;

public class DBAdapter

{

public static final String KEY_ROWID = "_id";

public static final String KEY_ISBN = "isbn";

public static final String KEY_TITLE = "title";

public static final String KEY_PUBLISHER = "publisher";

private static final String TAG = "DBAdapter";

private static final String DATABASE_NAME = "books";

private static final String DATABASE_TABLE = "titles";

private static final int DATABASE_VERSION =1;

private static final String DATABASE_CREATE =

"create table titles (_id integer primary key autoincrement, " + "isbn text not null, title text not null, "

+ "publisher text not null);";

private final Context context;

private DatabaseHelper DBHelper;

private SQLiteDatabase db;

public DBAdapter(Context ctx)

{

this.context = ctx;

DBHelper = new DatabaseHelper(context);

}

private static class DatabaseHelper extends SQLiteOpenHelper {

DatabaseHelper(Context context)

{

super(context, DATABASE_NAME, null, DATABASE_VERSION);

}

@Override

public void onCreate(SQLiteDatabase db)

{

db.execSQL(DATABASE_CREATE);

}

@Override

public void onUpgrade(SQLiteDatabase db, int oldVersion,

int newVersion)

{

Log.w(TAG, "Upgrading database from version " + oldVersion

+ " to "

+ newVersion + ", which will destroy all old data");

db.execSQL("DROP TABLE IF EXISTS titles");

onCreate(db);

}

}

//---打开数据库---

public DBAdapter open() throws SQLException

{

db = DBHelper.getWritableDatabase();

return this;

}

//---关闭数据库---

public void close()

{

DBHelper.close();

}

//---向数据库中插入一个标题---

public long insertTitle(String isbn, String title, String publisher) {

ContentValues initialValues = new ContentValues();

initialValues.put(KEY_ISBN, isbn);

initialValues.put(KEY_TITLE, title);

initialValues.put(KEY_PUBLISHER, publisher);

return db.insert(DATABASE_TABLE, null, initialValues); }

//---删除一个指定标题---

public boolean deleteTitle(long rowId)

{

return db.delete(DATABASE_TABLE, KEY_ROWID +

"=" + rowId, null) >0;

}

//---检索所有标题---

public Cursor getAllTitles()

{

return db.query(DATABASE_TABLE, new String[] {

KEY_ROWID,

KEY_ISBN,

KEY_TITLE,

KEY_PUBLISHER},

null,

null,

null,

null,

null);

}

//---检索一个指定标题---

public Cursor getTitle(long rowId) throws SQLException {

Cursor mCursor =

db.query(true, DATABASE_TABLE, new String[] {

KEY_ROWID,

KEY_ISBN,

KEY_TITLE,

KEY_PUBLISHER

},

KEY_ROWID + "=" + rowId,

null,

null,

null,

null,

null);

if (mCursor !=null) {

mCursor.moveToFirst();

}

return mCursor;

}

//---更新一个标题---

public boolean updateTitle(long rowId, String isbn, String title, String publisher)

{

ContentValues args = new ContentValues();

args.put(KEY_ISBN, isbn);

args.put(KEY_TITLE, title);

args.put(KEY_PUBLISHER, publisher);

return db.update(DATABASE_TABLE, args,

KEY_ROWID + "=" + rowId, null) >0;

}

}

3使用数据库

4增加一个标题

如果想在titles表中增加一个标题，可以使用DBAdapter类的insertTitle()方法：

@Override

public void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(https://www.360docs.net/doc/0e4774246.html,yout.main);

DBAdapter db = new DBAdapter(this);

//---add 2 titles---

db.open();

long id;

id = db.insertTitle(

"0470285818",

"C# 2008 Programmer's Reference",

"Wrox");

id = db.insertTitle(

"047017661X",

"Professional Windows Vista Gadgets Programming",

"Wrox");

db.close();

}

insertTitle()方法返回插入行的ID，如果在添加过程中遇到错误，它就返回-1。

如果你分析Android设备/模拟器的文件系统，你可以看到book数据库创建在database 文件夹下，如图3所示。

图3 database文件夹

5检索所有标题

想要检索titles表中的所有标题，可以使用DBAdapter类的getAllTitles()方法，如清单5所示。

清单5 使用DBAdapter类的getAllTitles()方法检索titles表中的所有标题

package net.learn2develop.Database;

import android.app.Activity;

import android.database.Cursor;

import android.os.Bundle;

import android.widget.Toast;

public class DatabaseActivity extends Activity {

/** Called when the activity is first created. */

@Override

public void onCreate(Bundle savedInstanceState)

{

super.onCreate(savedInstanceState);

setContentView(https://www.360docs.net/doc/0e4774246.html,yout.main);

DBAdapter db = new DBAdapter(this);

//---获取所有标题---

db.open();

Cursor c = db.getAllTitles();

if (c.moveToFirst())

{

do {

DisplayTitle(c);

} while (c.moveToNext());

}

db.close();

}

}

返回的结果是一个Cursor对象，如果要显示所有标题，你首先应该调用Cursor对象的moveToFirst()方法，如果它成功(意味着至少有一行有效)，使用DisplayTitle()方法显示详细

图4显示Toast类，它从数据库中检索并显示一个标题。

图4 Toast类

6检索单个标题

返回的结果是一个Cursor对象，如果返回一行，可以使用DisplayTitle()方法显示标题的详细信息，否则就使用Toast类显示一个错误消息。

7更新一个标题

要更新一个特定的标题，可以调用DBAdapter的updateTitle()方法，传递想要更新的标题的ID给它就可以了，如清单6所示。

清单6 调用DBAdapter类的updateTitle()方法更新标题

@Override

public void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(https://www.360docs.net/doc/0e4774246.html,yout.main);

DBAdapter db = new DBAdapter(this);

//---更新标题---

db.open();

if (db.updateTitle(1,

"0470285818",

"C# 2008 Programmer's Reference",

"Wrox Press"))

Toast.makeText(this, "Update successful.",

Toast.LENGTH_LONG).show();

else

Toast.makeText(this, "Update failed.",

Toast.LENGTH_LONG).show();

//-------------------

//---检索相同的标题---

Cursor c = db.getTitle(1);

if (c.moveToFirst())

DisplayTitle(c);

else

Toast.makeText(this, "No title found",

Toast.LENGTH_LONG).show();

//-------------------

db.close();

}

如果更新成功会显示一条表示成功的消息，同时，你可以检索刚刚更新的标题看更新结果是否正确。

8删除一个标题

想要删除一个标题，可以调用DBAdapter类的deleteTitle()方法，传递你想要删除的标题的ID即可：

@Override

public void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(https://www.360docs.net/doc/0e4774246.html,yout.main);

DBAdapter db = new DBAdapter(this);

//---delete a title---

db.open();

if (db.deleteTitle(1))

Toast.makeText(this, "Delete successful.",

Toast.LENGTH_LONG).show();

else

Toast.makeText(this, "Delete failed.",

Toast.LENGTH_LONG).show();

db.close();

}

如果删除成功会显示一条表示成功的消息。

9升级数据库

要升级数据库，修改DBAdapter类中DATABASE_VERSION常量的值比之前的值大，如之前的值是1，将其改为2：

public class DBAdapter

{

public static final String KEY_ROWID = "_id";

public static final String KEY_ISBN = "isbn";

public static final String KEY_TITLE = "title";

public static final String KEY_PUBLISHER = "publisher";

private static final String TAG = "DBAdapter";

private static final String DATABASE_NAME = "books";

private static final String DATABASE_TABLE = "titles";

//---change this to a higher value---

private static final int DATABASE_VERSION =2;

private static final String DATABASE_CREATE =

"create table titles (_id integer primary key autoincrement, "

+ "isbn text not null, title text not null, "

+ "publisher text not null);";

当你再次运行这个应用程序时，你会在Eclipse的LogCat窗口中看到数据库已经升级的消息，如图5所示。

图5 LogCat窗口-消息显示数据库升级成功

10简化数据库访问

使用DBAdapter类，可以简化你的Android应用程序访问数据库记录的操作，一个重要的事情是在Android中创建的SQLite数据库只有创建它的应用程序可以访问它。如果你要共享数据，你需要使用一个内容提供器，这个将在以后的文章中再介绍了。