Android数据存取之Databases.doc

Android数据存取之Databases在Android平台上可以操作数据库，这是第一次接触Android时的惊艳之一。在Android平台上，绑定了SQLite数据库，这个数据库系统也是极具性格的，它的最大的应用场景是嵌入式系统，进一步了解可以参看这里。如果有JDBC的经验，那么在这里会容易的多。Android中操作数据库首先要通过一个 类：android.database.sqlite.SQLiteOpenHelper。它封装了如何打开一个数据库，其中当然也包含如果数据库不存在 就创建这样的逻辑。看一个例子：view plaincopy to clipboardprint?1. pubilcclassDatabaseHelperextendsSQLiteOpenHelper 2. privatestaticfinalStringDATABASE_NAME=com.roiding.simple.note; 3. privatestaticfinalintDATABASE_VERSION=1; 4. privatestaticfinalStringNOTES_TABLE_NAME=notes; 5. 6. DatabaseHelper(Contextcontext) 7. super(context,DATABASE_NAME,null,DATABASE_VERSION); 8. 9. 10. Override 11. publicvoidonCreate(SQLiteDatabasedb) 12. db.execSQL(CREATETABLE+NOTES_TABLE_NAME 13. +(idintegerprimarykeyautoincrement,nametext);); 14. 15. 16. Override 17. publicvoidonUpgrade(SQLiteDatabasedb,intoldVersion,intnewVersion) 18. db.execSQL(DROPTABLEIFEXISTSnotes); 19. onCreate(db); 20. 21. pubilc class DatabaseHelper extends SQLiteOpenHelper private static final String DATABASE_NAME = com.roiding.simple.note;private static final int DATABASE_VERSION = 1;private static final String NOTES_TABLE_NAME = notes;DatabaseHelper(Context context) super(context, DATABASE_NAME, null, DATABASE_VERSION);Overridepublic void onCreate(SQLiteDatabase db) db.execSQL(CREATE TABLE + NOTES_TABLE_NAME+ (id integer primary key autoincrement, name text););Overridepublic void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) db.execSQL(DROP TABLE IF EXISTS notes);onCreate(db);这里面，如下的语句需要解释： super(context, DATABASE_NAME, null, DATABASE_VERSION)数据库连接的初始化，中间的那个null，是一个CursorFactory参数，没有仔细研究这个参数，暂时置空吧。 public void onCreate(SQLiteDatabase db)这里面的onCreate是指数据库onCreate时，而不是DatabaseHelper的onCreate。也就是说，如果已经指定 database已经存在，那么在重新运行程序的时候，就不会执行这个方法了。要不然，岂不是每次重新启动程序都要重新创建一次数据库了！在这个方法中，完成了数据库的创建工作。也就是那个execSQL()方法。 public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion)在程序的开发维护过程中，数据库的结构可能会有变化，那么这个方法就有用处了。在DatabaseHelper这个对象一创建时，就已经把参数 DATABASE_VERSION传入，这样，如果Android发现此版本与现有版本不一致，就会调用这个onUpgrate方法。于是，可以在这里面实现一些数据的upgrade工作，比如说创建一个临时表，将数据由临时表中转到新的表结构中。需要注意的是，这里面的onUpgrade是在版本不一致时调用，也就是说不管当前需要的版本高于现有版本还是低于现有版本，都会出发这个方法，类似的这种情况，就需要对oldVersion和 newVersion进行判断之后再决定使用什么策略来更新数据。 在Android中，数据库存放在 /data/data/PACKAGE_NAME/databases 目录下。接下来就可以使用这个Helper来操作数据库了，操作数据库也就无非是增、删、改、查。先看一个增的例子：view plaincopy to clipboardprint?1. publicstaticvoidinsert(Contextcontext,Strings) 2. DatabaseHelpermOpenHelper=newDatabaseHelper(context); 3. 4. Stringtable=notes; 5. StringnullColumnHack=id; 6. 7. ContentValuesvalues=newContentValues(); 8. values.put(name,); 9. 10. longid=mOpenHelper.getReadableDatabase().insert(table, 11. nullColumnHack,values); 12. 13. mOpenHelper.getReadableDatabase().close(); 14. public static void insert(Context context, String s) DatabaseHelper mOpenHelper = new DatabaseHelper(context);String table = notes;String nullColumnHack = id;ContentValues values = new ContentValues();values.put(name, );long id = mOpenHelper.getReadableDatabase().insert(table,nullColumnHack, values);mOpenHelper.getReadableDatabase().close(); DatabaseHelper mOpenHelper = new DatabaseHelper(context);如果和JDBC例子的话，这一步貌似就像是获得了一个Statement，用它就可以操作数据库了。 ContentValues values = new ContentValues();Android在向数据库中插入数据的时候，要求数据存放到ContentValues中，这里面的ContentValues其实就是一个 Map，Key值是字段名称，Value值是字段的值。这样，也许你会发现一个问题，那数据类型怎么办？其实在SQLite数据库中就是没有数据类型的， 一切都是字符串。 mOpenHelper.getReadableDatabase().insert(table,nullColumnHack, values);将数据入库，注意这里面有一个nullColumnHack，看文档是和所有字段都是空的记录有关系，我没有去实验他具体的效果，只是随便给他一个字段名称。 再看一个查的例子：view plaincopy to clipboardprint?1. publicstaticvoidselect(Contextcontext) 2. DatabaseHelpermOpenHelper=newDatabaseHelper(context); 3. 4. Stringtable=notes; 5. Stringcolumns=newStringid,name; 6. Stringselection=id?andname?; 7. StringselectionArgs=newString0,; 8. StringgroupBy=null; 9. Stringhaving=null; 10. StringorderBy=iddesc; 11. Stringlimit=1; 12. 13. Cursorc=mOpenHelper.getReadableDatabase().query(table, 14. columns,selection,selectionArgs,groupBy,having,orderBy,limit); 15. 16. c.moveToFirst(); 17. for(inti=0;i? and name?;String selectionArgs = new String 0, ;String groupBy = null;String having = null;String orderBy = id desc;String limit = 1;Cursor c = mOpenHelper.getReadableDatabase().query(table,columns, selection, selectionArgs, groupBy, having, orderBy, limit);c.moveToFirst();for (int i = 0; i ?andname?; 6. StringselectionArgs=newString0,; 7. StringwhereClause=selection; 8. StringwhereArgs=selectionArgs; 9. 10. mOpenHelper.getWritableDatabase().delete(table,whereClause,whereArgs); 11. mOpenHelper.getWritableDatabase().close(); 12. public static void delete(Context context) DatabaseHelper mOpenHelper = new DatabaseHelper(context);String table = notes;String selection = id? and name?;String selectionArgs = new String 0, ;String whereClause = selection;String whereArgs = selectionArgs;mOpenHelper.getWritableDatabase().delete(table, whereClause, whereArgs);mOpenHelper.getWritableDatabase().close();有了上面的基础这里就容易理解了，这里的whereClause相当于前面的selection，whereArgs相当于前面的selectionArgs。view plaincopy to clipboardprint?1. publicstaticvoidupdate(Contextcontext) 2. DatabaseHelpermOpenHelper=newDatabaseHelper(context); 3. 4. Stringtable=notes; 5. Stringselection=id?andname?; 6. StringselectionArgs=newString0,; 7. StringwhereClause=selection; 8. StringwhereArgs=selectionArgs; 9. 10. ContentValuesvalues=newContentValues(); 11. values.put(name,); 12. 13. mOpenHelper.getWritableDatabase().update(table,values, 14. whereClause,whereArgs); 15. mOpenHelper.getWritableDatabase().close(); 16. public static void update(Context context) DatabaseHelper mOpenHelper = new DatabaseHelper(context);String table = notes;String selection = id? and name?;String selectionArgs = new String 0, ;String whereClause = selection;String whereArgs = selectionArgs;ContentValues values = new ContentValues();values.put(name, );mOpenHelper.getWritableDatabase().update(table, values,whereClause, whereArgs);mOpenHelper.getWritableDatabase().close();这个update的用法，综合select和delete就可以理解。注意： Cursor和Databases要及时关闭，不然也会有异常。 getWritableDatabase()和getReadableDatabase()在当前的Android版本中貌似可以通用，像上面的insert，用的就是getReadableDatabase。 在真实的应用中，会对上面这些基本操作做更高一级的抽象和封装，使之更容易使用。在select时，除了用上述的方法，将分段的SQL语句传进去之外，Android还支持一种方法：使用SQLiteQueryBuilder。如果使用的是上述的分段SQL语句的方法，在Android的内部实现中，也是先将分段的SQL使用SQLiteQueryBuilder的静态方法来生成一个真正的SQL的，而且，我没有看出来使用SQLiteQueryBuilder的优势。Tags: delete, getReadableDatabase, getWritableDatabase, insert, query, SQLite, SQLiteOpenHelper, update每个应用程序都要使用数据，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所示：图1 数据库-使用Eclipse创建你的Android新项目创建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所示。图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 DBAdapterpublic 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 DBAdapterpublic 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 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, 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 SQLExceptiondb = 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 SQLExceptionCursor 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 DBAdapterpublic 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 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, 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 SQLExceptiondb = 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);initialValu