此章節(jié)內(nèi)容來(lái)自Android官網(wǎng)先改。
定義架構(gòu)和契約
SQL 數(shù)據(jù)庫(kù)的主要原則之一是架構(gòu):數(shù)據(jù)庫(kù)如何組織的正式聲明。 架構(gòu)體現(xiàn)于您用于創(chuàng)建數(shù)據(jù)庫(kù)的 SQL 語(yǔ)句识椰。您會(huì)發(fā)現(xiàn)它有助于創(chuàng)建伴隨類(lèi)赠潦,即契約類(lèi),其以一種系統(tǒng)性招驴、自記錄的方式明確指定您的架構(gòu)布局篙程。
契約類(lèi)是用于定義 URI、表格和列名稱(chēng)的常數(shù)的容器别厘。 契約類(lèi)允許您跨同一軟件包中的所有其他類(lèi)使用相同的常數(shù)虱饿。 您可以在一個(gè)位置更改列名稱(chēng)并使其在您整個(gè)代碼中傳播。
組織契約類(lèi)的一種良好方法是將對(duì)于您的整個(gè)數(shù)據(jù)庫(kù)而言是全局性的定義放入類(lèi)的根級(jí)別触趴。 然后為枚舉其列的每個(gè)表格創(chuàng)建內(nèi)部類(lèi)氮发。
注:通過(guò)實(shí)現(xiàn) BaseColumns接口,您的內(nèi)部類(lèi)可繼承名為 _ID的主鍵字段冗懦,某些 Android 類(lèi)(比如光標(biāo)適配器)將需要內(nèi)部類(lèi)擁有該字段爽冕。 這并非必需項(xiàng),但可幫助您的數(shù)據(jù)庫(kù)與 Android 框架協(xié)調(diào)工作披蕉。
例如颈畸,該代碼段定義了單個(gè)表格的表格名稱(chēng)和列名稱(chēng):
public final class FeedReaderContract {
// To prevent someone from accidentally instantiating the contract class,
// make the constructor private.
private FeedReaderContract() {}
/* Inner class that defines the table contents */
public static class FeedEntry implements BaseColumns {
public static final String TABLE_NAME = "entry";
public static final String COLUMN_NAME_TITLE = "title";
public static final String COLUMN_NAME_SUBTITLE = "subtitle";
}
}
創(chuàng)建數(shù)據(jù)庫(kù)
在您定義了數(shù)據(jù)庫(kù)的外觀(guān)后前塔,您應(yīng)實(shí)現(xiàn)創(chuàng)建和維護(hù)數(shù)據(jù)庫(kù)和表格的方法。 這里有一些典型的表格創(chuàng)建和刪除語(yǔ)句:
private static final String TEXT_TYPE = " TEXT";
private static final String COMMA_SEP = ",";
private static final String SQL_CREATE_ENTRIES =
"CREATE TABLE " + FeedEntry.TABLE_NAME + " (" +
FeedEntry._ID + " INTEGER PRIMARY KEY," +
FeedEntry.COLUMN_NAME_TITLE + TEXT_TYPE + COMMA_SEP +
FeedEntry.COLUMN_NAME_SUBTITLE + TEXT_TYPE + " )";
private static final String SQL_DELETE_ENTRIES =
"DROP TABLE IF EXISTS " + FeedEntry.TABLE_NAME;
就像您在設(shè)備的內(nèi)部存儲(chǔ)中保存文件那樣承冰,Android 將您的數(shù)據(jù)庫(kù)保存在私人磁盤(pán)空間华弓,即關(guān)聯(lián)的應(yīng)用。 您的數(shù)據(jù)是安全的困乒,因?yàn)樵谀J(rèn)情況下寂屏,其他應(yīng)用無(wú)法訪(fǎng)問(wèn)此區(qū)域。
SQLiteOpenHelper類(lèi)中有一組有用的 API娜搂。當(dāng)您使用此類(lèi)獲取對(duì)您數(shù)據(jù)庫(kù)的引用時(shí)迁霎,系統(tǒng)將只在需要之時(shí)而不是應(yīng)用啟動(dòng)過(guò)程中執(zhí)行可能長(zhǎng)期運(yùn)行的操作:創(chuàng)建和更新數(shù)據(jù)庫(kù)。 您僅需調(diào)用 getWritableDatabase()或 getReadableDatabase() 即可百宇。
注:由于它們可能長(zhǎng)期運(yùn)行考廉,因此請(qǐng)確保您在后臺(tái)線(xiàn)程中調(diào)用 getWritableDatabase()或 getReadableDatabase(),比如使用 AsyncTask 或 IntentService携御。
要使用 SQLiteOpenHelper昌粤,請(qǐng)創(chuàng)建一個(gè)替換 onCreate()、onUpgrade()和onOpen() 回調(diào)方法的子類(lèi)啄刹。您可能還希望實(shí)現(xiàn) onDowngrade()涮坐,但這并非必需操作。
例如誓军,下面是一個(gè)使用如上所示一些命令的 SQLiteOpenHelper的實(shí)現(xiàn):
public class FeedReaderDbHelper extends SQLiteOpenHelper {
// If you change the database schema, you must increment the database version.
public static final int DATABASE_VERSION = 1;
public static final String DATABASE_NAME = "FeedReader.db";
public FeedReaderDbHelper(Context context) {
super(context, DATABASE_NAME, null, DATABASE_VERSION);
}
public void onCreate(SQLiteDatabase db) {
db.execSQL(SQL_CREATE_ENTRIES);
}
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
// This database is only a cache for online data, so its upgrade policy is
// to simply to discard the data and start over
db.execSQL(SQL_DELETE_ENTRIES);
onCreate(db);
}
public void onDowngrade(SQLiteDatabase db, int oldVersion, int newVersion) {
onUpgrade(db, oldVersion, newVersion);
}
}
要訪(fǎng)問(wèn)您的數(shù)據(jù)庫(kù)袱讹,請(qǐng)實(shí)例化 SQLiteOpenHelper的子類(lèi):
FeedReaderDbHelper mDbHelper = new FeedReaderDbHelper(getContext());
增
通過(guò)將一個(gè) ContentValues 對(duì)象傳遞至 insert() 方法將數(shù)據(jù)插入數(shù)據(jù)庫(kù):
// Gets the data repository in write mode
SQLiteDatabase db = mDbHelper.getWritableDatabase();
// Create a new map of values, where column names are the keys
ContentValues values = new ContentValues();
values.put(FeedEntry.COLUMN_NAME_TITLE, title);
values.put(FeedEntry.COLUMN_NAME_SUBTITLE, subtitle);
// Insert the new row, returning the primary key value of the new row
long newRowId = db.insert(FeedEntry.TABLE_NAME, null, values);
insert()的第一個(gè)參數(shù)即為表格名稱(chēng)。
第二個(gè)參數(shù)將指示框架在 ContentValues為空(即昵时,您沒(méi)有 put任何值)時(shí)執(zhí)行哪些操作捷雕。如果指定列名稱(chēng),則框架將插入一行并將該列的值設(shè)置為 null壹甥。如果指定 null(就像此代碼示例中一樣)救巷,則框架不會(huì)在沒(méi)有值時(shí)插入行。
查
要從數(shù)據(jù)庫(kù)中讀取信息盹廷,請(qǐng)使用 query()方法征绸,將其傳遞至選擇條件和所需列。該方法結(jié)合 insert()和update()的元素俄占,除非列列表定義了您希望獲取的數(shù)據(jù)管怠,而不是希望插入的數(shù)據(jù)。 查詢(xún)的結(jié)果將在 Cursor對(duì)象中返回給您缸榄。
SQLiteDatabase db = mDbHelper.getReadableDatabase();
// Define a projection that specifies which columns from the database
// you will actually use after this query.
String[] projection = {
FeedEntry._ID,
FeedEntry.COLUMN_NAME_TITLE,
FeedEntry.COLUMN_NAME_SUBTITLE
};
// Filter results WHERE "title" = 'My Title'
String selection = FeedEntry.COLUMN_NAME_TITLE + " = ?";
String[] selectionArgs = { "My Title" };
// How you want the results sorted in the resulting Cursor
String sortOrder =
FeedEntry.COLUMN_NAME_SUBTITLE + " DESC";
Cursor c = db.query(
FeedEntry.TABLE_NAME, // The table to query
projection, // The columns to return
selection, // The columns for the WHERE clause
selectionArgs, // The values for the WHERE clause
null, // don't group the rows
null, // don't filter by row groups
sortOrder // The sort order
);
要查看游標(biāo)中的某一行渤弛,請(qǐng)使用 Cursor 移動(dòng)方法之一,您必須在開(kāi)始讀取值之前始終調(diào)用這些方法甚带。 一般情況下她肯,您應(yīng)通過(guò)調(diào)用 moveToFirst()開(kāi)始佳头,其將“讀取位置”置于結(jié)果中的第一個(gè)條目中。 對(duì)于每一行晴氨,您可以通過(guò)調(diào)用 Cursor獲取方法之一讀取列的值康嘉,比如 getString() 或 getLong()。對(duì)于每種獲取方法籽前,您必須傳遞所需列的索引位置亭珍,您可以通過(guò)調(diào)用 getColumnIndex()或 getColumnIndexOrThrow()獲取。例如:
cursor.moveToFirst();
long itemId = cursor.getLong(
cursor.getColumnIndexOrThrow(FeedEntry._ID)
);
刪
要從表格中刪除行枝哄,您需要提供識(shí)別行的選擇條件肄梨。 數(shù)據(jù)庫(kù) API 提供了一種機(jī)制,用于創(chuàng)建防止 SQL 注入的選擇條件挠锥。 該機(jī)制將選擇規(guī)范劃分為選擇子句和選擇參數(shù)众羡。 該子句定義要查看的列,還允許您合并列測(cè)試蓖租。 參數(shù)是根據(jù)捆綁到子句的項(xiàng)進(jìn)行測(cè)試的值粱侣。由于結(jié)果并未按照與常規(guī) SQL 語(yǔ)句相同的方式進(jìn)行處理,它不受 SQL 注入的影響菜秦。
// Define 'where' part of query.
String selection = FeedEntry.COLUMN_NAME_TITLE + " LIKE ?";
// Specify arguments in placeholder order.
String[] selectionArgs = { "MyTitle" };
// Issue SQL statement.
db.delete(FeedEntry.TABLE_NAME, selection, selectionArgs);
更新數(shù)據(jù)庫(kù)
當(dāng)您需要修改數(shù)據(jù)庫(kù)值的子集時(shí)甜害,請(qǐng)使用 update()方法。更新表可將 insert()的內(nèi)容值語(yǔ)法與 delete()的 where語(yǔ)法相結(jié)合球昨。
SQLiteDatabase db = mDbHelper.getReadableDatabase();
// New value for one column
ContentValues values = new ContentValues();
values.put(FeedEntry.COLUMN_NAME_TITLE, title);
// Which row to update, based on the title
String selection = FeedEntry.COLUMN_NAME_TITLE + " LIKE ?";
String[] selectionArgs = { "MyTitle" };
int count = db.update(
FeedReaderDbHelper.FeedEntry.TABLE_NAME,
values,
selection,
selectionArgs);