Android使用sqllite執行個體

在Android平台上，整合了一個嵌入式關係型資料庫—SQLite，SQLite3支援 NULL、INTEGER、REAL（浮點數字）、TEXT(字串文本)和BLOB(二進位對象)資料類型，雖然它支援的類型只有五種，但實際上sqlite3也接受varchar(n)、char(n)、decimal(p,s) 等資料類型，只不過在運算或儲存時會轉成對應的五種資料類型。 SQLite最大的特點是你可以儲存任何類型的資料到任何欄位中，無論這列聲明的資料類型是什麼。例如：可以在Integer類型的欄位中存放字串，或者在布爾型欄位中存放浮點數，或者在字元型欄位中存放日期型值。 但有一種情況例外：定義為INTEGER PRIMARY KEY的欄位只能儲存64位整數， 當向這種欄位中儲存除整數以外的資料時，將會產生錯誤。 另外， SQLite 在解析CREATE TABLE 語句時，會忽略 CREATE TABLE 語句中跟在欄位名後面的資料類型資訊，如下面語句會忽略 name欄位的類型資訊：
CREATE TABLE person (personid integer primary key autoincrement, name varchar(20))

SQLite可以解析大部分標準SQL語句，如：
查詢語句：select * from 表名 where 條件子句 group by 分組字句 having ... order by 排序子句
如：select * from person
        select * from person order by id desc
        select name from person group by name having count(*)>1
分頁SQL與mysql類似，下面SQL語句擷取5條記錄，跳過前面3條記錄
select * from Account limit 5 offset 3 或者 select * from Account limit 3,5
插入語句：insert into 表名(欄位列表) values(值列表)。如： insert into person(name, age) values(‘昌龍’,3)
更新語句：update 表名 set 欄位名=值 where 條件子句。如：update person set name=‘昌龍‘ where id=10
刪除語句：delete from 表名 where 條件子句。如：delete from person  where id=10

 

 

使用SQLiteOpenHelper對資料庫進行版本管理

 因為我們開發的軟體可能會安裝在成百上千個使用者的手機上，如果應用使用到了SQLite資料庫，我們必須在使用者初次使用軟體時建立出應用使用到的資料庫表結構及添加一些初始化記錄，另外在軟體升級的時候，也需要對資料表結構進行更新。那麼，我們如何才能實現在使用者初次使用或升級軟體時自動在使用者的手機上建立出應用需要的資料庫表呢？總不能在每個需要安裝此軟體的手機上通過手工方式建立資料庫表吧？因為這種需求是每個資料庫應用都要面臨的，所以在Android系統，為我們提供了一個名為SQLiteOpenHelper的抽象類別，必須繼承它才能使用，它是通過對資料庫版本進行管理來實現前面提出的需求。

為了實現對資料庫版本進行管理，SQLiteOpenHelper類提供了兩個重要的方法，分別是onCreate(SQLiteDatabase db)和onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion)，前者用於初次使用軟體時產生資料庫表，後者用於升級軟體時更新資料庫表結構。當調用SQLiteOpenHelper的getWritableDatabase()或者getReadableDatabase()方法擷取用於操作資料庫的SQLiteDatabase執行個體的時候，如果資料庫不存在，Android系統會自動產生一個資料庫，接著調用onCreate()方法，onCreate()方法在初次產生資料庫時才會被調用，在onCreate()方法裡可以產生資料庫表結構及添加一些應用使用到的初始化資料。onUpgrade()方法在資料庫的版本發生變化時會被調用，一般在軟體升級時才需改變版本號碼，而資料庫的版本是由程式員控制的，假設資料庫現在的版本是1，由於業務的變更，修改了資料庫表結構，這時候就需要升級軟體，升級軟體時希望更新使用者手機裡的資料庫表結構，為了實現這一目的，可以把原來的資料庫版本設定為2(有同學問設定為3行不行？當然可以，如果你願意，設定為100也行)，並且在onUpgrade()方法裡面實現表結構的更新。當軟體的版本升級次數比較多，這時在onUpgrade()方法裡面可以根據原版號和目標版本號碼進行判斷，然後作出相應的表結構及資料更新。

getWritableDatabase()和getReadableDatabase()方法都可以擷取一個用於操作資料庫的SQLiteDatabase執行個體。但getWritableDatabase() 方法以讀寫方式開啟資料庫，一旦資料庫的磁碟空間滿了，資料庫就只能讀而不能寫，倘若使用的是getWritableDatabase() 方法就會出錯。getReadableDatabase()方法先以讀寫方式開啟資料庫，如果資料庫的磁碟空間滿了，就會開啟失敗，當開啟失敗後會繼續嘗試以唯讀方式開啟資料庫。
public class DatabaseHelper extends SQLiteOpenHelper {
    //類沒有執行個體化,是不能用作父類構造器的參數,必須聲明為靜態
         private static final String name = "partner4java"; //資料庫名稱
         private static final int version = 1; //資料庫版本
         public DatabaseHelper(Context context) {
//第三個參數CursorFactory指定在執行查詢時獲得一個遊標執行個體的工廠類,設定為null,代表使用系統預設的工廠類
                super(context, name, null, version);
         }
        @Override public void onCreate(SQLiteDatabase db) {
              db.execSQL("CREATE TABLE IF NOT EXISTS person (personid integer primary key autoincrement, name varchar(20), age INTEGER)");   
         }
        @Override public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
               db.execSQL("DROP TABLE IF EXISTS person");
               onCreate(db);
         }
}
上面onUpgrade()方法在資料庫版本每次發生變化時都會把使用者手機上的資料庫表刪除，然後再重新建立。一般在實際項目中是不能這樣做的，正確的做法是在更新資料庫表結構時，還要考慮使用者存放於資料庫中的資料不會丟失。

 

 

使用SQLiteDatabase操作SQLite資料庫

Android提供了一個名為SQLiteDatabase的類，該類封裝了一些操作資料庫的API，使用該類可以完成對資料進行添加(Create)、查詢(Retrieve)、更新(Update)和刪除(Delete)操作（這些操作簡稱為CRUD）。對SQLiteDatabase的學習，我們應該重點掌握execSQL()和rawQuery()方法。 execSQL()方法可以執行insert、delete、update和CREATE TABLE之類有更改行為的SQL語句； rawQuery()方法可以執行select語句。
execSQL()方法的使用例子：
SQLiteDatabase db = ....;
db.execSQL("insert into person(name, age) values('王昌龍', 4)");
db.close();
執行上面SQL語句會往person表中添加進一條記錄，在實際應用中， 語句中的“王昌龍”這些參數值會由使用者輸入介面提供，如果把使用者輸入的內容原樣組拼到上面的insert語句， 當使用者輸入的內容含有單引號時，組拼出來的SQL語句就會存在語法錯誤。要解決這個問題需要對單引號進行轉義，也就是把單引號轉換成兩個單引號。有些時候使用者往往還會輸入像“ & ”這些特殊SQL符號，為保證組拼好的SQL語句文法正確，必須對SQL語句中的這些特殊SQL符號都進行轉義，顯然，對每條SQL語句都做這樣的處理工作是比較煩瑣的。 SQLiteDatabase類提供了一個重載後的execSQL(String sql, Object[] bindArgs)方法，使用這個方法可以解決前面提到的問題，因為這個方法支援使用預留位置參數(?)。使用例子如下：
SQLiteDatabase db = ....;
db.execSQL("insert into person(name, age) values(?,?)", new Object[]{"王昌龍", 4}); 
db.close();
execSQL(String sql, Object[] bindArgs)方法的第一個參數為SQL語句，第二個參數為SQL語句中預留位置參數的值，參數值在數組中的順序要和預留位置的位置對應。
SQLiteDatabase的rawQuery() 用於執行select語句，使用例子如下： SQLiteDatabase db = ....;
Cursor cursor = db.rawQuery(“select * from person”, null);
while (cursor.moveToNext()) {
 int personid = cursor.getInt(0); //擷取第一列的值,第一列的索引從0開始
 String name = cursor.getString(1);//擷取第二列的值
 int age = cursor.getInt(2);//擷取第三列的值
}
cursor.close();
db.close(); 
rawQuery()方法的第一個參數為select語句；第二個參數為select語句中預留位置參數的值，如果select語句沒有使用預留位置，該參數可以設定為null。帶預留位置參數的select語句使用例子如下：
Cursor cursor = db.rawQuery("select * from person where name like ? and age=?", new String[]{"%昌龍%", "4"});

Cursor是結果集遊標，用於對結果集進行隨機訪問，如果大家熟悉jdbc， 其實Cursor與JDBC中的ResultSet作用很相似。使用moveToNext()方法可以將遊標從當前行移動到下一行，如果已經移過了結果集的最後一行，返回結果為false，否則為true。另外Cursor 還有常用的moveToPrevious()方法（用於將遊標從當前行移動到上一行，如果已經移過了結果集的第一行，傳回值為false，否則為true ）、moveToFirst()方法（用於將遊標移動到結果集的第一行，如果結果集為空白，傳回值為false，否則為true ）和moveToLast()方法（用於將遊標移動到結果集的最後一行，如果結果集為空白，傳回值為false，否則為true ） 。
除了前面給大家介紹的execSQL()和rawQuery()方法， SQLiteDatabase還專門提供了對應於添加、刪除、更新、查詢的操作方法： insert()、delete()、update()和query() 。這些方法實際上是給那些不太瞭解SQL文法的菜鳥使用的，對於熟悉SQL文法的程式員而言，直接使用execSQL()和rawQuery()方法執行SQL語句就能完成資料的添加、刪除、更新、查詢操作。
Insert()方法用於添加資料，各個欄位的資料使用ContentValues進行存放。 ContentValues類似於MAP，相對於MAP，它提供了存取資料對應的put(String key, Xxx value)和getAsXxx(String key)方法，  key為欄位名稱，value為欄位值，Xxx指的是各種常用的資料類型，如：String、Integer等。
SQLiteDatabase db = databaseHelper.getWritableDatabase();
ContentValues values = new ContentValues();
values.put("name", "王昌龍");
values.put("age", 4);
long rowid = db.insert(“person”, null, values);//返回新添記錄的行號，與主鍵id無關
不管第三個參數是否包含資料，執行Insert()方法必然會添加一條記錄，如果第三個參數為空白，會添加一條除主鍵之外其他欄位值為Null的記錄。Insert()方法內部實際上通過構造insert陳述式完成資料的添加，Insert()方法的第二個參數用於指定空值欄位的名稱，相信大家對此參數會感到疑惑，此參數的作用是幹嘛的？是這樣的：如果第三個參數values 為Null或者元素個數為0， Insert()方法必然要添加一條除了主鍵之外其它欄位為Null值的記錄，為了滿足這條insert語句的文法， insert語句必須給定一個欄位名，如：insert into person(name) values(NULL)，倘若不給定欄位名 ， insert語句就成了這樣： insert into person() values()，顯然這不滿足標準SQL的文法。對於欄位名，建議使用主鍵之外的欄位，如果使用了INTEGER類型的主鍵欄位，執行類似insert into person(personid) values(NULL)的insert語句後，該主鍵欄位值也不會為NULL。如果第三個參數values 不為Null並且元素的個數大於0 ，可以把第二個參數設定為null。

 delete()方法的使用：
SQLiteDatabase db = databaseHelper.getWritableDatabase();
db.delete("person", "personid<?", new String[]{"2"});
db.close();
上面代碼用於從person表中刪除personid小於2的記錄。

update()方法的使用：
SQLiteDatabase db = databaseHelper.getWritableDatabase();
ContentValues values = new ContentValues();
values.put(“name”, “王昌龍”);//key為欄位名，value為值
db.update("person", values, "personid=?", new String[]{"1"}); 
db.close();
上面代碼用於把person表中personid等於1的記錄的name欄位的值改為“王昌龍”。
query()方法實際上是把select語句拆分成了若干個組成部分，然後作為方法的輸入參數：
SQLiteDatabase db = databaseHelper.getWritableDatabase();
Cursor cursor = db.query("person", new String[]{"personid,name,age"}, "name like ?", new String[]{"%昌龍%"}, null, null, "personid desc", "1,2");
while (cursor.moveToNext()) {
         int personid = cursor.getInt(0); //擷取第一列的值,第一列的索引從0開始
        String name = cursor.getString(1);//擷取第二列的值
        int age = cursor.getInt(2);//擷取第三列的值
}
cursor.close();
db.close(); 
上面代碼用於從person表中尋找name欄位含有“昌龍”的記錄，匹配的記錄按personid降序排序，對排序後的結果略過第一條記錄，只擷取2條記錄。
query(table, columns, selection, selectionArgs, groupBy, having, orderBy, limit)方法各參數的含義：
table：表名。相當於select語句from關鍵字後面的部分。如果是多表聯集查詢，可以用逗號將兩個表名分開。
columns：要查詢出來的列名。相當於select語句select關鍵字後面的部分。
selection：查詢條件子句，相當於select語句where關鍵字後面的部分，在條件子句允許使用預留位置“?”
selectionArgs：對應於selection語句中預留位置的值，值在數組中的位置與預留位置在語句中的位置必須一致，否則就會有異常。
groupBy：相當於select語句group by關鍵字後面的部分
having：相當於select語句having關鍵字後面的部分
orderBy：相當於select語句order by關鍵字後面的部分，如：personid desc, age asc;
limit：指定位移量和擷取的記錄數，相當於select語句limit關鍵字後面的部分。

 

使用SQLiteOpenHelper擷取用於操作資料庫的SQLiteDatabase執行個體

 public class DatabaseHelper extends SQLiteOpenHelper {
         private static final String name = "partner4java"; //資料庫名稱
         private static final int version = 1; //資料庫版本
         ......略
}
public class HelloActivity extends Activity {
    @Override public void onCreate(Bundle savedInstanceState) {
        ......
        Button button =(Button) this.findViewById(R.id.button);
        button.setOnClickListener(new View.OnClickListener(){
 public void onClick(View v) {
  DatabaseHelper databaseHelper = new DatabaseHelper(HelloActivity.this);
  SQLiteDatabase db = databaseHelper.getWritableDatabase();
  db.execSQL("insert into person(name, age) values(?,?)", new Object[]{"王昌龍", 4}); 
  db.close();  
 }});        
    }
}
第一次調用getWritableDatabase()或getReadableDatabase()方法後，SQLiteOpenHelper會緩衝當前的SQLiteDatabase執行個體，SQLiteDatabase執行個體正常情況下會鑑效組資料庫的開啟狀態，所以在你不再需要SQLiteDatabase執行個體時，請及時調用close()方法釋放資源。一旦SQLiteDatabase執行個體被緩衝，多次調用getWritableDatabase()或getReadableDatabase()方法得到的都是同一執行個體。

使用事務操作SQLite資料庫

使用SQLiteDatabase的beginTransaction()方法可以開啟一個事務，程式執行到endTransaction() 方法時會檢查事務的標誌是否為成功，如果程式執行到endTransaction()之前調用了setTransactionSuccessful() 方法設定事務的標誌為成功則提交事務，如果沒有調用setTransactionSuccessful() 方法則復原事務。使用例子如下： SQLiteDatabase db = ....;
db.beginTransaction();//開始事務
try {
    db.execSQL("insert into person(name, age) values(?,?)", new Object[]{"王昌龍", 4});
    db.execSQL("update person set name=? where personid=?", new Object[]{"昌龍", 1});
    db.setTransactionSuccessful();//調用此方法會在執行到endTransaction() 時提交當前事務，如果不調用此方法會復原事務
} finally {
    db.endTransaction();//由事務的標誌決定是提交事務，還是復原事務
} 
db.close(); 
上面兩條SQL語句在同一個事務中執行。