作者：Vamei 出處：http://www.cnblogs.com/vamei 歡迎轉載，也請保留這段宣告。謝謝！
我之前只使用了一種持續儲存資料的方法，即SharedPreferences。然而，SharedPreferences只能儲存少量鬆散的資料，並不適合大量資料的儲存。安卓帶有SQLite資料庫，它是一個簡單版本的關係型資料庫，可以應對更復雜的資料存取需求。我將在這裡說明安卓中該資料庫的使用方法。這裡只專注於安卓中SQLite資料庫的介面使用，並沒有深入關係型資料庫和SQL語言的背景知識。
《雅典學院》是拉斐爾的畫。他在這幅壁畫中描繪了許多古典時代的哲學家，如蘇格拉底、柏拉圖、亞里士多德等。畫中的哲學家生活在不同的時代，硬是被拉斐爾放在了一起。
描述
這一講，我將繼續擴充應用的功能，讓應用儲存多個聯絡人資訊。相關的安卓知識點包括：
- 使用SQLite資料庫。
- 使用adb命令列工具檢視資料庫。
在這一講中的新增程式碼，都將放入到me.vamei.vamei.model包中。右鍵點選src資料夾，選擇New -> Package，就可以在src中建立新的包。
建立物件模型
在面嚮物件語言中，物件用於描述和運算元據。我使用兩個類Category和Contact的物件：
- Category：聯絡人分類。包括id屬性和name屬性。
- Contact：聯絡人。包括id，url，name和categoryId屬性。其中categoryId是Contact所屬Category物件的id。
Category類與Contact類
Category類有id和name屬性，分別儲存序號和分類姓名。它定義在Category.java中：
package me.vamei.vamei.model;
public class Category {
int id;
String name;
public Category() {}
public Category(String name) {
this.name = name;
}
public Category(int id, String name) {
this.id = id;
this.name = name;
}
public int getId() {
return this.id;
}
public void setId(int id) {
this.id = id;
}
public String getName() {
return this.name;
}
public void setName(String name) {
this.name = name;
}
}
Contact類的定義在Contact.java中。它的id和name屬性，用於記錄聯絡人序號和聯絡人姓名。url用以儲存聯絡人的部落格地址。Contact還有一個Category類的屬性。這是用組合的方式，說明了Contact所歸屬的Category。
package me.vamei.vamei.model;
public class Contact {
int id;
Category category;
String name;
String url;
public Contact() {
}
public Contact(String name, String url, Category category) {
this.name = name;
this.url = url;
this.category = category;
}
public Contact(int id, String name, String url, Category category) {
this.id = id;
this.name = name;
this.url = url;
this.category = category;
}
public int getId() {
return this.id;
}
public void setId(int id) {
this.id = id;
}
public String getName() {
return this.name;
}
public void setName(String name) {
this.name = name;
}
public String getUrl() {
return this.url;
}
public void setUrl(String url) {
this.url = url;
}
public Category getCategory() {
return this.category;
}
public void setCategory(Category category) {
this.category = category;
}
}
上面的物件資料模型只是存活於記憶體中，只能臨時儲存資料。要想持續的儲存資料，我們還要想辦法把物件中的資料放入SQLite的表中。安卓提供了一個類來實現相關的互動，即SQLiteOpenHelper。
SQLiteOpenHelper
SQLiteOpenHelper是物件資料模型和關係型資料庫的一個介面。我通過繼承該類，對每一個資料庫建立一個子類。這個子類即代表了該資料庫。資料庫操作的相關SQL語句都存放在該子類中。
下面的contactsManager類管理了"contactsManager"資料庫。這個類定義在ContactsManager.java中。我需要覆蓋該類的onCreate()和onUpgrade()方法，用於說明建立和升級時，資料庫將採取的行動，比如在建立時新建資料庫的表。SQLite利用SQL語言進行操作，所以建表的過程就是執行SQL的"create table ..."語句。在該類中，我還額外增加CRUD方法，即新建(Create)、讀取(Read)、更新(Update)、刪除(Delete)資料庫記錄。
package me.vamei.vamei.model;
import java.util.LinkedList;
import java.util.List;
import android.content.ContentValues;
import android.content.Context;
import android.database.Cursor;
import android.database.sqlite.SQLiteDatabase;
import android.database.sqlite.SQLiteOpenHelper;
/*
* Database Manager
* Interfacing between the database and the object models
* */
public class ContactsManager extends SQLiteOpenHelper {
// All Static variables
// Database Version
private static final int DATABASE_VERSION = 1;
// Database Name
private static final String DATABASE_NAME = "contactsManager";
// Contacts table name
private static final String TABLE_CONTACTS = "contacts";
private static final String TABLE_CATEGORIES = "categories";
// Contacts Table Columns names
private static final String KEY_ID = "id";
private static final String KEY_CATEGORY_ID = "category_id";
private static final String KEY_NAME = "name";
private static final String KEY_URL = "url";
// Constructor
public ContactsManager(Context context) {
super(context, DATABASE_NAME, null, DATABASE_VERSION);
}
@Override
public void onCreate(SQLiteDatabase db) {
String CREATE_CATEGORIES_TABLE = "CREATE TABLE " + TABLE_CATEGORIES + "("
+ KEY_ID + " INTEGER PRIMARY KEY AUTOINCREMENT,"
+ KEY_NAME + " TEXT UNIQUE" + ")";
String CREATE_CONTACTS_TABLE = "CREATE TABLE " + TABLE_CONTACTS + "("
+ KEY_ID + " INTEGER PRIMARY KEY AUTOINCREMENT," + KEY_NAME + " TEXT,"
+ KEY_CATEGORY_ID + " INTEGER," + KEY_URL + " TEXT,"
+ "FOREIGN KEY(" + KEY_CATEGORY_ID +") REFERENCES "
+ TABLE_CATEGORIES + "(" + KEY_ID + ")"
+ ")";
db.execSQL(CREATE_CATEGORIES_TABLE);
db.execSQL(CREATE_CONTACTS_TABLE);
}
@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
// Drop older table if existed
db.execSQL("DROP TABLE IF EXISTS " + TABLE_CATEGORIES);
db.execSQL("DROP TABLE IF EXISTS " + TABLE_CONTACTS);
// Create tables again
onCreate(db);
}
/**
* All CRUD(Create, Read, Update, Delete) Operations for Contacts
*/
public void createContact(Contact contact) {
SQLiteDatabase db = this.getWritableDatabase();
ContentValues values = new ContentValues();
values.put(KEY_NAME, contact.getName());
values.put(KEY_URL, contact.getUrl());
values.put(KEY_CATEGORY_ID, contact.getCategory().getId());
db.insert(TABLE_CONTACTS, null, values);
db.close();
}
// Getting single contact
public Contact getContact(int id) {
SQLiteDatabase db = this.getReadableDatabase();
Cursor cursor = db.query(TABLE_CONTACTS, new String[] { KEY_ID,
KEY_NAME, KEY_URL, KEY_CATEGORY_ID }, KEY_ID + "=?",
new String[] { String.valueOf(id) }, null, null, null, null);
if (cursor != null)
cursor.moveToFirst();
Category category = getCategory(Integer.parseInt(cursor.getString(3)));
Contact contact = new Contact(Integer.parseInt(cursor.getString(0)),
cursor.getString(1), cursor.getString(2),
category);
// return contact
return contact;
}
// Getting all contacts
public List<Contact> getAllContacts() {
List<Contact> contacts = new LinkedList<Contact>();
// build the query
String query = "SELECT * FROM " + TABLE_CONTACTS;
// get reference to writable DB
SQLiteDatabase db = this.getReadableDatabase();
Cursor cursor = db.rawQuery(query, null);
// iterate over all retrieved rows
Contact contact = null;
if (cursor.moveToFirst()) {
do {
contact = new Contact();
contact.setId(Integer.parseInt(cursor.getString(0)));
contact.setName(cursor.getString(1));
contact.setUrl(cursor.getString(2));
Category category = getCategory(Integer.parseInt(cursor.getString(3)));
contact.setCategory(category);
// Add category to categories
contacts.add(contact);
} while (cursor.moveToNext());
}
// return books
return contacts;
}
// Updating single contact
public int updateContact(Contact contact) {
SQLiteDatabase db = this.getWritableDatabase();
ContentValues values = new ContentValues();
values.put(KEY_NAME, contact.getName());
values.put(KEY_URL, contact.getUrl());
values.put(KEY_CATEGORY_ID, contact.getCategory().getId());
// updating row
return db.update(TABLE_CONTACTS, values, KEY_ID + " = ?",
new String[] { String.valueOf(contact.getId()) });
}
// Deleting single contact
public void deleteContact(Contact contact) {
SQLiteDatabase db = this.getWritableDatabase();
db.delete(TABLE_CONTACTS, KEY_ID + " = ?",
new String[] { String.valueOf(contact.getId()) });
db.close();
}
/**
* All CRUD(Create, Read, Update, Delete) Operations for Contacts
*/
// Adding a single category
public void createCategory(Category category) {
SQLiteDatabase db = this.getWritableDatabase();
ContentValues values = new ContentValues();
values.put(KEY_NAME, category.getName());
db.insert(TABLE_CATEGORIES, null, values);
db.close();
}
// Getting single contact
public Category getCategory(int id) {
SQLiteDatabase db = this.getReadableDatabase();
Cursor cursor = db.query(TABLE_CATEGORIES, new String[] { KEY_ID,
KEY_NAME }, KEY_ID + "=?",
new String[] { String.valueOf(id) }, null, null, null, null);
if (cursor != null)
cursor.moveToFirst();
Category category = new Category(Integer.parseInt(cursor.getString(0)),
cursor.getString(1));
// return contact
return category;
}
// Getting all categories
public List<Category> getAllCategories() {
List<Category> categories = new LinkedList<Category>();
// build the query
String query = "SELECT * FROM " + TABLE_CATEGORIES;
SQLiteDatabase db = this.getWritableDatabase();
Cursor cursor = db.rawQuery(query, null);
// iterate over the categories
Category category = null;
if (cursor.moveToFirst()) {
do {
category = new Category();
category.setId(Integer.parseInt(cursor.getString(0)));
category.setName(cursor.getString(1));
// Add category to categories
categories.add(category);
} while (cursor.moveToNext());
}
// return categories
return categories;
}
// Updating single contact
public int updateCategory(Category category) {
SQLiteDatabase db = this.getWritableDatabase();
ContentValues values = new ContentValues();
values.put(KEY_NAME, category.getName());
// updating row
return db.update(TABLE_CATEGORIES, values, KEY_ID + " = ?",
new String[] { String.valueOf(category.getId()) });
}
// Deleting single contact
public void deleteCategory(Category category) {
SQLiteDatabase db = this.getWritableDatabase();
db.delete(TABLE_CATEGORIES, KEY_ID + " = ?",
new String[] { String.valueOf(category.getId()) });
db.close();
}
}
在屬性中，我說明了資料庫的一些相關引數，如資料庫版本，資料庫名和表名。我還在資料庫中定義了表的屬性名稱。
onCreate()方法負責了表格的建立。而onUpgrade()方法中，則說明了資料庫升級後，需要刪除所有資料，重新建立表格。
此外，我還編寫了進行資料庫操作的CRUD方法。這些方法的核心實際上是一些運算元據庫的SQL語句。如果上面的CRUD方法無法滿足資料庫操作的需求，你還可以根據需要增加方法。
資料庫使用
在之前編寫的MainActivity的onCreate()方法中，呼叫資料庫：
......
@Override
public void onCreate() {
......
ContactsManager cm = new ContactsManager(this);
// add categories to the database
cm.createCategory(new Category("Friend"));
cm.createCategory(new Category("Enermy"));
// add contact to the database
Category cat1 = cm.getCategory(1);
cm.createContact(new Contact("vamei", "http://www.cnblogs.com/vamei", cat1));
// retrieve and display
Toast.makeText(this, cm.getContact(1).getName(), Toast.LENGTH_LONG).show();
}
......
上面進行了簡單的資料儲存和讀取。效果如下：
我將在下一講中，利用資料庫實現更復雜的功能。
adb檢視資料庫
adb是安卓提供的命令列工具。你可以在計算機上使用該命令列，檢視安卓裝置中的SQLite資料庫。首先，檢視連線在計算機上的安卓裝置：
adb devices -l
該命令會列出所有的裝置及其埠。
開啟某個裝置：
adb -s 192.168.56.101:5555 shell
-s引數說明了裝置的埠。這樣就進入了該裝置的命令列Shell。我們可以在該命令列使用常用的如cd, ls, pwd命令。
應用的資料庫存在下面資料夾中：
/data/data/me.vamei.vamei/databases/
其中的me.vamei.vamei是我們正在編寫的應用。
之前部分已經建立了contactsManager資料庫。使用sqlite3開啟：
sqlite3 /data/data/me.vamei.vamei/databases/contactsManager
將進入SQLite提供的命令列。可以按照SQLite終端的使用方法操作。例如
.tables #顯示所有的表格
或者直接使用SQL語句：
select * from categories;
使用結束後，按Ctrl + D推出SQLite終端。
在開發過程中，這一命令列工具可以幫助我們快捷查詢資料庫狀態，方便debug。
總結
SQLiteOpenHelper
adb終端檢視資料庫