Activites 可以通過 Content Provider 或者 Service 訪問一個數據庫。下面會詳細講解如果創建數據庫,添加數據和查詢數據庫。
Android 不自動提供數據庫。在 Android 應用程序中使用 SQLite,必須自己創建數據庫,然後創建表、索引,填充數據。Android 提供了 SQLiteOpenHelper 幫助你創建一個數據庫,你只要繼承 SQLiteOpenHelper 類,就可以輕鬆的創建數據庫。SQLiteOpenHelper 類根據開發應用程序的需要,封裝了創建和更新數據庫使用的邏輯。SQLiteOpenHelper 的子類,至少需要實現三個方法:
- 構造函數,調用父類 SQLiteOpenHelper 的構造函數。這個方法需要四個參數:上下文環境(例如,一個 Activity),數據庫名字,一個可選的遊標工廠(通常是 Null),一個代表你正在使用的數據庫模型版本的整數。
- onCreate()方法,它需要一個 SQLiteDatabase 對象作爲參數,根據需要對這個對象填充表和初始化數據。
- onUpgrage() 方法,它需要三個參數,一個 SQLiteDatabase 對象,一箇舊的版本號和一個新的版本號,這樣你就可以清楚如何把一個數據庫從舊的模型轉變到新的模型。
下面示例代碼展示瞭如何繼承 SQLiteOpenHelper 創建數據庫:
public class DatabaseHelper extends SQLiteOpenHelper {
DatabaseHelper(Context context, String name, CursorFactory cursorFactory, int version)
{
super(context, name, cursorFactory, version);
}
@Override
public void onCreate(SQLiteDatabase db) {
// TODO 創建數據庫後,對數據庫的操作
}
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
// TODO 更改數據庫版本的操作
}
@Override
public void onOpen(SQLiteDatabase db) {
super.onOpen(db);
// TODO 每次成功打開數據庫後首先被執行
}
}
|
接下來討論具體如何創建表、插入數據、刪除表等等。調用 getReadableDatabase() 或 getWriteableDatabase() 方法,你可以得到 SQLiteDatabase 實例,具體調用那個方法,取決於你是否需要改變數據庫的內容:
db=(new DatabaseHelper(getContext())).getWritableDatabase();
return (db == null) ? false : true;
|
上面這段代碼會返回一個 SQLiteDatabase 類的實例,使用這個對象,你就可以查詢或者修改數據庫。
當你完成了對數據庫的操作(例如你的 Activity 已經關閉),需要調用 SQLiteDatabase 的 Close() 方法來釋放掉數據庫連接。
爲了創建表和索引,需要調用 SQLiteDatabase 的 execSQL() 方法來執行 DDL 語句。如果沒有異常,這個方法沒有返回值。
例如,你可以執行如下代碼:
db.execSQL("CREATE TABLE mytable (_id INTEGER PRIMARY KEY
AUTOINCREMENT, title TEXT, value REAL);");
|
這條語句會創建一個名爲 mytable 的表,表有一個列名爲 _id,並且是主鍵,這列的值是會自動增長的整數(例如,當你插入一行時,SQLite 會給這列自動賦值),另外還有兩列:title( 字符 ) 和 value( 浮點數 )。 SQLite 會自動爲主鍵列創建索引。
通常情況下,第一次創建數據庫時創建了表和索引。如果你不需要改變表的 schema,不需要刪除表和索引 . 刪除表和索引,需要使用 execSQL() 方法調用 DROP INDEX 和 DROP TABLE 語句。
上面的代碼,已經創建了數據庫和表,現在需要給表添加數據。有兩種方法可以給表添加數據。
像上面創建表一樣,你可以使用 execSQL() 方法執行 INSERT, UPDATE, DELETE 等語句來更新表的數據。execSQL() 方法適用於所有不返回結果的 SQL 語句。例如:
db.execSQL("INSERT INTO widgets (name, inventory)"+
"VALUES ('Sprocket', 5)");
|
另一種方法是使用 SQLiteDatabase 對象的 insert(), update(), delete() 方法。這些方法把 SQL 語句的一部分作爲參數。示例如下:
ContentValues cv=new ContentValues();
cv.put(Constants.TITLE, "example title");
cv.put(Constants.VALUE, SensorManager.GRAVITY_DEATH_STAR_I);
db.insert("mytable", getNullColumnHack(), cv);
|
update()方法有四個參數,分別是表名,表示列名和值的 ContentValues 對象,可選的 WHERE 條件和可選的填充 WHERE 語句的字符串,這些字符串會替換 WHERE 條件中的“?”標記。update() 根據條件,更新指定列的值,所以用 execSQL() 方法可以達到同樣的目的。
WHERE 條件和其參數和用過的其他 SQL APIs 類似。例如:
String[] parms=new String[] {"this is a string"};
db.update("widgets", replacements, "name=?", parms);
|
delete() 方法的使用和 update() 類似,使用表名,可選的 WHERE 條件和相應的填充 WHERE 條件的字符串。
類似 INSERT, UPDATE, DELETE,有兩種方法使用 SELECT 從 SQLite 數據庫檢索數據。
1 .使用 rawQuery() 直接調用 SELECT 語句;
使用 query() 方法構建一個查詢。
-
Raw Queries
正如 API 名字,rawQuery() 是最簡單的解決方法。通過這個方法你就可以調用 SQL SELECT 語句。例如:
Cursor c=db.rawQuery( "SELECT name FROM sqlite_master WHERE type='table' AND name='mytable'", null);
在上面例子中,我們查詢 SQLite 系統表(sqlite_master)檢查 table 表是否存在。返回值是一個 cursor 對象,這個對象的方法可以迭代查詢結果。
如果查詢是動態的,使用這個方法就會非常複雜。例如,當你需要查詢的列在程序編譯的時候不能確定,這時候使用 query() 方法會方便很多。
-
Regular Queries
query() 方法用 SELECT 語句段構建查詢。SELECT 語句內容作爲 query() 方法的參數,比如:要查詢的表名,要獲取的字段名,WHERE 條件,包含可選的位置參數,去替代 WHERE 條件中位置參數的值,GROUP BY 條件,HAVING 條件。
除了表名,其他參數可以是 null。所以,以前的代碼段可以可寫成:
String[] columns={"ID", "inventory"}; String[] parms={"snicklefritz"}; Cursor result=db.query("widgets", columns, "name=?",parms, null, null, null);
不管你如何執行查詢,都會返回一個 Cursor,這是 Android 的 SQLite 數據庫遊標,使用遊標,你可以:
通過使用 getCount() 方法得到結果集中有多少記錄;
通過 moveToFirst(), moveToNext(), 和 isAfterLast() 方法遍歷所有記錄;
通過 getColumnNames() 得到字段名;
通過 getColumnIndex() 轉換成字段號;
通過 getString(),getInt() 等方法得到給定字段當前記錄的值;
通過 requery() 方法重新執行查詢得到遊標;
通過 close() 方法釋放遊標資源;
例如,下面代碼遍歷 mytable 表
Cursor result=db.rawQuery("SELECT ID, name, inventory FROM mytable");
result.moveToFirst();
while (!result.isAfterLast()) {
int id=result.getInt(0);
String name=result.getString(1);
int inventory=result.getInt(2);
// do something useful with these
result.moveToNext();
}
result.close();
|
在其他數據庫上作開發,一般都使用工具來檢查和處理數據庫的內容,而不是僅僅使用數據庫的 API。使用 Android 模擬器,有兩種可供選擇的方法來管理數據庫。
首先,模擬器綁定了 sqlite3 控制檯程序,可以使用 adb shell 命令來調用他。只要你進入了模擬器的 shell,在數據庫的路徑執行 sqlite3 命令就可以了。數據庫文件一般存放在:
/data/data/your.app.package/databases/your-db-name
如果你喜歡使用更友好的工具,你可以把數據庫拷貝到你的開發機上,使用 SQLite-aware 客戶端來操作它。這樣的話,你在一個數據庫的拷貝上操作,如果你想要你的修改能反映到設備上,你需要把數據庫備份回去。
把數據庫從設備上考出來,你可以使用 adb pull 命令(或者在 IDE 上做相應操作)。存儲一個修改過的數據庫到設備上,使用 adb push 命令。
一個最方便的 SQLite 客戶端是 FireFox SQLite Manager 擴展,它可以跨所有平臺使用。
圖 2. SQLite Manager
本文轉載自http://www.ibm.com/developerworks/cn/opensource/os-cn-sqlite/,感謝原作者。
下面給出一個實例,該實例是來源於http://dev.10086.cn/cmdn/wiki/index.php?doc-view-6525.html,經驗證無誤,貼上來供大家學習,在此感謝原作者。
我們大家都知道Android平臺提供給我們一個數據庫輔助類來創建或打開數據庫,這個輔助類繼承自SQLiteOpenHelper類,在該類的構造器中,調用Context中的方法創建並打開一個指定名稱的數據庫對象。繼承和擴展SQLiteOpenHelper類主要做的工作就是重寫以下兩個方法。
onCreate(SQLiteDatabase db) : 當數據庫被首次創建時執行該方法,一般將創建表等初始化操作在該方法中執行。
onUpgrade(SQLiteDatabse dv, int oldVersion,int new Version):當打開數據庫時傳入的版本號與當前的版本號不同時會調用該方法。
除了上述兩個必須要實現的方法外,還可以選擇性地實現onOpen 方法,該方法會在每次打開數據庫時被調用。
SQLiteOpenHelper 類的基本用法是:當需要創建或打開一個數據庫並獲得數據庫對象時,首先根據指定的文件名創建一個輔助對象,然後調用該對象的getWritableDatabase 或 getReadableDatabase方法 獲得SQLiteDatabase 對象。
調用getReadableDatabase 方法返回的並不總是隻讀數據庫對象,一般來說該方法和getWriteableDatabase 方法的返回情況相同,只有在數據庫僅開放只讀權限或磁盤已滿時纔會返回一個只讀的數據庫對象。
下面通過一個簡單的小例子說明SQLiteOpenDatabase的用法,其中包括創建數據庫、插入數據、更新 、查詢等等,我們將查詢後獲取到的數據顯示到TextView上。
Java代碼:
- package eoe.demo;
- import android.content.Context;
- import android.database.sqlite.SQLiteDatabase;
- import android.database.sqlite.SQLiteOpenHelper;
- import android.database.sqlite.SQLiteDatabase.CursorFactory;
- public class MySQLiteHelper extends SQLiteOpenHelper{
- //調用父類構造器
- public MySQLiteHelper(Context context, String name, CursorFactory factory,int version) {
- super(context, name, factory, version);
- }
- /**
- * 當數據庫首次創建時執行該方法,一般將創建表等初始化操作放在該方法中執行.
- * 重寫onCreate方法,調用execSQL方法創建表
- * */
- @Override
- public void onCreate(SQLiteDatabase db) {
- db.execSQL("create table if not exists hero_info("+ "id integer primary key,"
- + "name varchar,"+ "level integer)");
- }
- //當打開數據庫時傳入的版本號與當前的版本號不同時會調用該方法
- @Override
- public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
- }
- }
java代碼:
- package eoe.demo;
- import android.app.Activity;
- import android.content.ContentValues;
- import android.database.Cursor;
- import android.database.sqlite.SQLiteDatabase;
- import android.graphics.Color;
- import android.os.Bundle;
- import android.widget.TextView;
- public class Activity01 extends Activity {
- MySQLiteHelper myHelper;
- TextView tv;
- @Override
- public void onCreate(Bundle savedInstanceState) {
- super.onCreate(savedInstanceState);
- setContentView(R.layout.main);
- tv = (TextView)findViewById(R.id.tv);
- //創建MySQLiteOpenHelper輔助類對象
- myHelper = new MySQLiteHelper(this, "my.db", null, 1);
- //向數據庫中插入和更新數據
- insertAndUpdateData(myHelper);
- //查詢數據
- String result = queryData(myHelper);
- tv.setTextColor(Color.RED);
- tv.setTextSize(20.0f);
- tv.setText("名字\t等級\n"+result);
- }
- //向數據庫中插入和更新數據
- public void insertAndUpdateData(MySQLiteHelper myHelper){
- //獲取數據庫對象
- SQLiteDatabase db = myHelper.getWritableDatabase();
- //使用execSQL方法向表中插入數據
- db.execSQL("insert into hero_info(name,level) values('bb',0)");
- //使用insert方法向表中插入數據
- ContentValues values = new ContentValues();
- values.put("name", "xh");
- values.put("level", 5);
- //調用方法插入數據
- db.insert("hero_info", "id", values);
- //使用update方法更新表中的數據
- //清空ContentValues對象
- values.clear();
- values.put("name", "xh");
- values.put("level", 10);
- //更新xh的level 爲10
- db.update("hero_info", values, "level = 5", null);
- //關閉SQLiteDatabase對象
- db.close();
- }
- //從數據庫中查詢數據
- public String queryData(MySQLiteHelper myHelper){
- String result = "";
- //獲得數據庫對象
- SQLiteDatabase db = myHelper.getReadableDatabase();
- //查詢表中的數據
- Cursor cursor = db.query("hero_info", null, null, null, null, null, "id asc");
- //獲取name列的索引
- int nameIndex = cursor.getColumnIndex("name");
- //獲取level列的索引
- int levelIndex = cursor.getColumnIndex("level");
- for (cursor.moveToFirst();!(cursor.isAfterLast());cursor.moveToNext()) {
- result = result + cursor.getString(nameIndex)+ "\t\t";
- result = result + cursor.getInt(levelIndex)+" \n";
- }
- cursor.close();//關閉結果集
- db.close();//關閉數據庫對象
- return result;
- }
- @Override
- protected void onDestroy() {
- SQLiteDatabase db = myHelper.getWritableDatabase();//獲取數據庫對象
- //刪除hero_info表中所有的數據 傳入1 表示刪除所有行------>點擊back按鈕
- db.delete("hero_info", "1", null);
- super.onDestroy();
- }
- }