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

1、An droid创建和使用数据库详细指南(1)摘要：每个应用程序都要使用数据，An droid应用程序也不例外，An droid使用开源的、与操作系统无关的SQL数据库-SQLite，本文介绍的就是如何为你的An droid应用程序创建和操作SQLite数据库。数据库支持每个应用程序无论大小的生命线，除非你的应用程序只处理简单的数据，那么就需要一个数据库系统存储你的结构化数据，An droid使用SQLite数据库，它是一个开源的、支持多操作系统的 SQL数据库，在许多领域广泛使用，如Mozilla FireFox就是使用SQLite 来存储配置数据的，iPhone也是使用SQLite来存储数

2、据的。在An droid中，你为某个应用程序创建的数据库，只有它可以访问，其它应用程序是不能访问的，数据库位于 An droid设备/data/data/databases文件夹中，在这篇文章中，你将会 学习到如何在An droid中创建和使用数据库。1 SQLite数据库使用Eclipse创建一个 An droid项目，取名为 Database,如图1所示:图1数据库-使用Eclipse创建你的An droid新项目2创建DBAdapter辅助类操作数据库的最佳实践是创建一个辅助类，由它封装所有对数据库的复杂访问，对于调用代码而言它是透明的，因此我创建了一个DBAdapter的辅助类，由它创

3、建、打开、关闭和使用SQLite数据库。首先，在src/文件夹（在这个例子中是 src/net.learn2develop.Database）下添加一个 DBAdapter.java 文件。在DBAdapter.java文件中，导入所有你要使用到的命名空间：package net.learn2develop.Databases;import android.content.ContentValues;.Cursor ; .SQLException;.sqlite.SQLiteDatabase; .sqlite.SQLiteOpenHelper;import android.content.Co

4、ntext; import android.databaseimport android.databaseimport android.databaseimport android.databaseimport android.util.Log ;public class DBAdapter接下来创建一个数据库，取名为 bookstitles，字段如图2所示。idisbntitlepublisher图2数据库字段在DBAdapter.java文件中，定义清单1中的常量。清单1定义DBAdapter.java文件中的常量package net.learn2develop.Database ;im

5、port 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 DBAdapterpublic static final Stri

6、ng 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= &qu

7、ot;books"private static final String DATABASE_TABLE= "titles"private static finalintDATABASE.VERSION = 1 ;private static final String DATABASE._CREATE="create tabletitles (_idintegerprimarykey autoincrement,"+ "isbntextnot null,titletextnot null ,"+ "publisher

8、text notnull);"private final Context context;DATABASE_CREATE 常量包括创建 titles表的SQL语句。在DBAdapter类中，你可以扩展 SQLiteOpe nH elper类，它是一个 An droid辅助类，主 要用于数据库创建和版本管理。实际上，你可以覆盖 onCreate()和onUpgrade()方法，如清单2所示。清单 2 在 DBAdapter 类中，扩展 SQLiteOpenHelper 类覆盖 onCreate()和 onUpgrade() 方法package net.learn2develop.Dat

9、abaseimport 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.Logpublic class DBAdapterpublic static final

10、 String KEY_ROWID= "_id"Log .w(TAG, "Upgradingdatabase from version+ oldVersionpublic static final String KEY_ISBN="isbn"publicstatic final String KEY_TITLEpublicstatic final String KEY_PUBLISHERprivate static final String TAG private static final String DATABASE_NAME privat

11、e static final String DATABASE_TABLE="title"="publisher"="DBAdapter"="books"="titles"private static finalint DATABASE_VERSION = 1;private static final String DATABASE_CREATE="create table titles (_idinteger primary key autoincrement,+ "isbn

12、 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 extend

13、s SQLiteOpenHelperDatabaseHelper(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, "Upgradingdatabase from ver

14、sion+ oldVersion+ " to "+ newVersion + ", which will destroyall old data");db.execSQL(”DROP TABLE IF EXISTS titles");onCreate(db);on Create()方法创建一个新的数据库，on Upgrade。方法用于升级数据库，这可以通过检查DATABASE_VERSION常量定义的值来实现，对于onUpgrade()方法而言，只不过是简单地删除表，然后在创建表而已。现在你可以定义不同的方法来打开和关闭数据库，如清单3中的添加

15、/编辑/删除/行的函数。清单3定义打开和关闭数据库以及增加/编辑/删除表中行的方法public class DBAdapter/ ./ ./ -打开数据库-public DBAdapter open () throws SQLExceptiondb = DBHelper.getWritableDatabase();return this;/ -关闭数据库-public void close ()DBHelper. close ();/ -向数据库插入一个标题-public long insertTitle(String isbn, String title, String publisher)

16、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)null ) > 0;return db. de

17、lete (DATABASE_TABLE, KEY_ROWID + " =" + rowId,/ - 检索所有标题-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 =d

18、b.query(true, DATABASE_TABLE, new StringKEY_ROWID,KEY_ISBN,KEY_TITLE,KEY_PUBLISHER,KEY_ROWID + " =" + rowld,null ,null ,null ,null ,null );if (mCursor != null ) mCursor.moveToFirst();return mCursor;/ - 更新一个标题-public boolean updateTitle(long rowId, String isbn,String title, String publisher

19、)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;注意An droid使用Cursor类返回一个需要的值，Cursor作为一个指针从数据库查询返回结果集，使用 Cursor允许An droid更有效地管理它们需要的行

20、和列，你使用Con te ntValues对象存储键/值对，它的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.databas

21、e.sqlite.SQLiteDatabase;import android.database.sqlite.SQLiteOpenHelper;import android.util.Logpublic class DBAdapterpublic static final String KEY_ROWID= "_id"public static final String KEY_ISBN= "isbn"public static final String KEY_TITLE= "title"public static final St

22、ring 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 finalintDATABASE.VERSION = 1 ;private static final String DATABASE._

23、CREATE="create tabletitles (_idintegerprimarykey autoincrement,"+ "isbntextnot null,titletextnot null ,"+ "publishertext notnull);"private final Context context;private DatabaseHelper DBHelper;private SQLiteDatabase db;public DBAdapter(Context ctx)this.context= ctx;DBHe

24、lper = new DatabaseHelper(context);private static class DatabaseHelper extends SQLiteOpenHelperDatabaseHelper(Context context)super(context, DATABASE_NAME,null , DATABASE_VERSION);Overridepublic void onCreate(SQLiteDatabase db)db.execSQL(DATABASE_CREATE);Overridepublic void onUpgrade(SQLiteDatabase

25、db,int oldVersion,int newVersion)Log .w(TAG, "Upgradingdatabase from version "+ oldVersion+ " to "+ newVersion + ", which will destroyall old data");db.execSQL(" DROP TABLE IF EXISTS titles");onCreate(db);/ -打开数据库-public DBAdapter open () throws SQLExceptiondb

26、 = 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);init

27、ialValues.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 getAIITitles()return db.query(DATABASE_TABLE,

28、new String KEY_ROWID,KEY_ISBN,KEY_TITLE,KEY_PUBLISHER,null ,null ,null ,null ,null );/ -检索一个指定标题-public Cursor getTitle( long rowId) throws SQLExceptionCursor mCursor =db.query(true, DATABASE_TABLE, new StringKEY_ROWID,KEY_ISBN,KEY_TITLE,KEY_PUBLISHER,KEY_ROWID + " =" + rowld,null ,null ,n

29、ull ,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);ret

30、urn db. update (DATABASE_TABLE, args,KEY_ROWID + " =" + rowId, null )> 0;3使用数据库现在你已经可以利用创建的辅助类来使用数据库了，在DatabaseActivity.java文件中,创建一个DBAdapter类的实例：package net.learn2develop.Database ;import android.app.Activity;import android.os.Bundle;public class DatabaseActivity extends Activity /* Ca

31、lled when the activity is first created. */Overridepublic void onCreate(Bundle savedlnstanceState) super.onCreate(savedlnstanceState);setContentView(R.layout.main);DBAdapter db = new DBAdapter(this);4增加一个标题如果想在titles表中增加一个标题，可以使用DBAdapter类的insertTitle()方法:Overridepublic void onCreate(Bundle savedIns

32、tanceState) super.onCreate(savedlnstanceState);setContentView(R.layout.main);DBAdapter db = new DBAdapter(this);/ add 2 titlesdb. open ();long id;id = db.insertTitle(" 0470285818","C# 2008 Programmer 's Reference","Wrox");id = db.insertTitle("047017661X",&

33、quot;Professional Windows Vista Gadgets Programming","Wrox");db.close();insertTitle()方法返回插入行的ID，如果在添加过程中遇到错误，它就返回-1。如果你分析An droid设备/模拟器的文件系统，你可以看到book数据库创建在database文件夹下，如图3所示。F? books5120图3 database文件夹5检索所有标题想要检索titles表中的所有标题，可以使用DBAdapter类的getAIITitles()方法，如清单5 所示。清单5使用DBAdapter类的get

34、AIITitIes()方法检索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 onCre

35、ate(Bundle savedInstanceState)super.onCreate(savedlnstanceState);setContentView(R.layout.main);DBAdapter db = new DBAdapter(this);/ -获取所有标题-db. open ();Cursor c = db.getAIITitIes();if (c.moveToFirst()do DisplayTitle(c); while (c.moveToNext();db. close ();返回的结果是一个 Cursor对象，如果要显示所有标题，你首先应该调用Cursor对象的m

36、oveToFirst()方法，如果它成功(意味着至少有一行有效)，使用DispIayTitIe()方法显示详细的标题，要移动到下一个标题，可以调用Cursor对象的moveToNext()方法，下面是DisplayTitle()方法的定义:Cursor c)public void DisplayTitle(Toast.makeText(this,"id: "+ c.getString(0) + "n"+"ISBN:"+ c.getString(1) + "n"+"TITLE:"+ c.getSt

37、ring(2) + "n"+3),"PUBLISHER: "+ c.getString(Toast.LENGTH_LONG).show();图4显示Toast类，它从数据库中检索并显示一个标题。图4 Toast类6检索单个标题想要通过ID检索单个标题，可以使用 DBAdapter类的getTitle()方法：Overridepublic void onCreate(Bundle savedlnstanceState) super.onCreate(savedlnstanceState);setContentView(R.layout.main);DBAd

38、apter db = new DBAdapter(this);/ get a titledb. open ();Cursor c = db.getTitle( 2);if (c.moveToFirst()DisplayTitle(c);elseToast.makeText(this, "No title found",Toast.LENGTH_LONG).show();db. close ();返回的结果是一个Cursor对象，如果返回一行，可以使用 DisplayTitle()方法显示标题的详细信息，否则就使用Toast类显示一个错误消息。7更新一个标题要更新一个特定的标

39、题，可以调用DBAdapter的updateTitle()方法，传递想要更新的标题的ID给它就可以了，如清单6所示。清单6调用DBAdapter类的updateTitle()方法更新标题Overridepublic void onCreate(Bundle savedInstanceState) super.onCreate(savedlnstanceState);setContentView(R.layout.main);DBAdapter db = new DBAdapter(this);/ 更新标题db. open ();if (db.updateTitle(1 ," 0470

40、285818","C# 2008 Programmer 's Reference","Wrox Press")Toast.makeText(this, "Update successful.",Toast.LENGTH_LONG).show();elseToast.makeText(this, "Update failed.",Toast.LENGTH_LONG).show();/-检索相同的标题-Cursor c = db.getTitle(1);if (c.moveToFirst()Displ

41、ayTitle(c);elseToast.makeText(this, "No title found",Toast.LENGTH_LONG).show();/db.close();如果更新成功会显示一条表示成功的消息，同时，你可以检索刚刚更新的标题看更新结果是否正确。8删除一个标题想要删除一个标题，可以调用DBAdapter类的deleteTitle()方法，传递你想要删除的标题的ID即可：Overridepublic void onCreate(Bundle savedInstanceState) super.onCreate(savedlnstanceState);s

42、etContentView(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();elseToast.makeText(this,"Delete failed.",Toast.LENGTH_LONG).show();db. close ();如果删除成功会显示一条表示成功的消息。9升级数据库要升级数据库，修改 DBAdapter类中DATABASE_VERSION 常量的值比之前的值大, 如之前的值是1，将其改为2：public class DB