Android--创建和使用数据库详细指南
每个应用程序都要使用数据,Android应用程序也不例外,Android使用开源的、与操作系统无关的SQL数据库--SQLite,本文介绍的就是如何为你的Android应用程序创建和操作SQLite数据库。 |
数据库支持每个应用程序无论大小的生命线,除非你的应用程序只处理简单的数据,那么就需要一个数据库系统存储你的结构化数据,Android使用SQLite数据库,它是一个开源的、支持多操作系统的SQL数据库,在许多领域广泛使用,如Mozilla FireFox就是使用SQLite来存储配置数据的,iPhone也是使用SQLite来存储数据的。
在Android中,你为某个应用程序创建的数据库,只有它可以访问,其它应用程序是不能访问的,数据库位于Android设备/data/data//databases文件夹中,在这篇文章中,你将会学习到如何在Android中创建和使用数据库。
SQLite数据库
使用Eclipse创建一个Android项目,取名为Database,如图1所示:
创建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,字段如图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);}@Overridepublic void onCreate(SQLiteDatabase db){db.execSQL(DATABASE_CREATE);}@Overridepublic 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;}}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);}@Overridepublic void onCreate(SQLiteDatabase db){db.execSQL(DATABASE_CREATE);}@Overridepublic 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;}}
注意Android使用Cursor类返回一个需要的值,Cursor作为一个指针从数据库查询返回结果集,使用Cursor允许Android更有效地管理它们需要的行和列,你使用ContentValues对象存储键/值对,它的put()方法允许你插入不同数据类型的键值。
清单4显示了完整的DBAdapter.java源代码。
清单4 DBAdapter.java完整源代码
现在你已经可以利用创建的辅助类来使用数据库了,在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. */@Overridepublic void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.main);DBAdapter db = new DBAdapter(this);}}增加一个标题
如果想在titles表中增加一个标题,可以使用DBAdapter类的insertTitle()方法:
@Overridepublic 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();}insertTitle()方法返回插入行的ID,如果在添加过程中遇到错误,它就返回-1。
如果你分析Android设备/模拟器的文件系统,你可以看到book数据库创建在database文件夹下,如图3所示。
检索所有标题
想要检索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. */@Overridepublic 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();}}
返回的结果是一个Cursor对象,如果要显示所有标题,你首先应该调用Cursor对象的moveToFirst()方法,如果它成功(意味着至少有一行有效),使用DisplayTitle()方法显示详细的标题,要移动到下一个标题,可以调用Cursor对象的moveToNext()方法,下面是DisplayTitle()方法的定义:public void DisplayTitle(Cursor c){Toast.makeText(this,"id: " + c.getString(0) + "\n" +"ISBN: " + c.getString(1) + "\n" +"TITLE: " + c.getString(2) + "\n" +"PUBLISHER: " + c.getString(3),Toast.LENGTH_LONG).show();}
图4显示Toast类,它从数据库中检索并显示一个标题。
更多相关文章
- 初学Android,数据存储之使用SQLite数据库(四十六)
- Android高手进阶教程(十六)---Android中Intent传递对象的两种方
- Android 资源文件使用方法详解
- 64位win7下Android SDK Manager闪退的解决方法
- 最新Android Studio更换应用图标方法
- Android 中几种更新UI界面的方法
- 安卓(Android)系统的检测方法
- 【Android】私有目录获取方法
- 【Android 开发】:数据存储之 SQLite 数据库操作(三)