每个应用程序都要使用数据,Android应用程序也不例外,Android使用开源的、与操作系统无关的SQL数据库--SQLite,本文介绍的就是如何为你的Android应用程序创建和操作SQLite数据库。
数据库支持每个应用程序无论大小的生命线,除非你的应用程序只处理简单的数据,那么就需要一个数据库系统存储你的结构化数据,Android使用SQLite数据库,它是一个开源的、支持多操作系统的SQL数据库,在许多领域广泛使用,如Mozilla FireFox就是使用SQLite来存储配置数据的,iPhone也是使用SQLite来存储数据的。
在Android中,你为某个应用程序创建的数据库,只有它可以访问,其它应用程序是不能访问的,数据库位于Android设备/data/data/ databases文件夹中,在这篇文章中,你将会学习到如何在Android中创建和使用数据库。
SQLite数据库
使用Eclipse创建一个Android项目,取名为Database。
创建DBAdapter辅助类
操作数据库的最佳实践是创建一个辅助类,由它封装所有对数据库的复杂访问,对于调用代码而言它是透明的,因此我创建了一个DBAdapter的辅助类,由它创建、打开、关闭和使用SQLite数据库。
首先,在src/ 文件夹(在这个例子中是src/net.learn2develop.Database)下添加一个DBAdapter.java文件。
在DBAdapter.java文件中,导入所有你要使用到的命名空间:
- package net.learn2develop.Databases;
- 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
- {
- }
接下来创建一个数据库,取名为bookstitles,字段包括id,isbn,title,publisher
在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;
- }
在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;
- }
- }
使用数据库
现在你已经可以利用创建的辅助类来使用数据库了,在DatabaseActivity.java文件中,创建一个DBAdapter类的实例:
- package net.learn2develop.Database;
- import android.app.Activity;
- import android.os.Bundle;
- public class DatabaseActivity extends Activity {
- /** Called when the activity is first created. */
- @Override
- public void onCreate(Bundle savedInstanceState) {
- super.onCreate(savedInstanceState);
- setContentView(R.layout.main);
- DBAdapter db = new DBAdapter(this);
- }
- }
增加一个标题
如果想在titles表中增加一个标题,可以使用DBAdapter类的insertTitle()方法:
- @Override
- public void onCreate(Bundle savedInstanceState) {
- super.onCreate(savedInstanceState);
- setContentView(R.layout.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();
- }
如果你分析Android设备/模拟器的文件系统,你可以看到book数据库创建在database文件夹下,如图3所示。
图3 database文件夹
检索所有标题
想要检索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(R.layout.main);
- DBAdapter db = new DBAdapter(this);
- //---获取所有标题---
- db.open();
- Cursor c = db.getAllTitles();
- if (c.moveToFirst())
- {
- do {
- DisplayTitle(c);
- } while (c.moveToNext());
- }
- db.close();
- }
- }
- public void DisplayTitle(Cursor c)
- {
- Toast.makeText(this,
- "id: " + c.getString(0) + " " +
- "ISBN: " + c.getString(1) + " " +
- "TITLE: " + c.getString(2) + " " +
- "PUBLISHER: " + c.getString(3),
- Toast.LENGTH_LONG).show();
- }
图4 Toast类

检索单个标题
想要通过ID检索单个标题,可以使用DBAdapter类的getTitle()方法:
- @Override
- public void onCreate(Bundle savedInstanceState) {
- super.onCreate(savedInstanceState);
- setContentView(R.layout.main);
- DBAdapter db = new DBAdapter(this);
- //---get a title---
- db.open();
- Cursor c = db.getTitle(2);
- if (c.moveToFirst())
- DisplayTitle(c);
- else
- Toast.makeText(this, "No title found",
- Toast.LENGTH_LONG).show();
- db.close();
- }
返回的结果是一个Cursor对象,如果返回一行,可以使用DisplayTitle()方法显示标题的详细信息,否则就使用Toast类显示一个错误消息。
更新一个标题
要更新一个特定的标题,可以调用DBAdapter的updateTitle()方法,传递想要更新的标题的ID给它就可以了,如清单6所示。
清单6 调用DBAdapter类的updateTitle()方法更新标题
- @Override
- public void onCreate(Bundle savedInstanceState) {
- super.onCreate(savedInstanceState);
- setContentView(R.layout.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();
- }
如果更新成功会显示一条表示成功的消息,同时,你可以检索刚刚更新的标题看更新结果是否正确。
删除一个标题
想要删除一个标题,可以调用DBAdapter类的deleteTitle()方法,传递你想要删除的标题的ID即可:
- @Override
- public void onCreate(Bundle savedInstanceState) {
- super.onCreate(savedInstanceState);
- setContentView(R.layout.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();
- }
如果删除成功会显示一条表示成功的消息。
升级数据库
要升级数据库,修改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窗口-消息显示数据库升级成功

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