注：本文翻譯自Google官方的Android Developers Training文檔，譯者技術一般，由于喜愛安卓而產生了翻譯的念頭，純屬個人興趣愛好。
原文鏈接： http://developer.android.com/training/basics/data-storage/databases.html
在數據庫中保存數據，對于重復性的或者結構化的數據來說是很理想的，比如：聯系人信息。這節課我們假定你對SQL數據庫有一個大致的了解，并且幫助你在Android上開始使用SQLite數據庫。你在Android的數據庫上需要使用的APIs在 android.database.sqlite 包中。
?
一）. 定義一個架構（Schema）和契約（Contract）
SQL數據庫的主要核心之一是：一個數據庫是如何組織的正式聲明。架構所對應的就是你用來創建數據庫的SQL語句聲明。你會發現創建一個輔助類（
companion class
），即所謂的合同類（contract
?class
），它通過一個系統的和自文檔化的方式來顯示地指定你的架構布局。
一個合同類是一個容器，它包含了那些定義了URI，表和列的名稱的常量。合同類允許你在同一個包內所有類之間使用相同的名字。這樣可以使你想要改變列名時只需在一個地方修改，就能影響到所有使用到它的代碼。
一個良好的組織合同類的方式是：在類的根位置處，放置那些你的數據庫的全局定義。然后為每一個表創建一個內部類，來枚舉它的列。
Note：
通過實現基列（ BaseColumns ）接口，你的內部類可以繼承一個主鍵字段，叫做：“ _ID ”。一些Android類，比如光標適配器（ cursor adaptors ）會期望它能夠擁有這個。雖然這個不是必須的，但是它能夠幫助你的數據庫和Android更協同地工作。
例如，下例為一個簡單的表定義了表名和列名：
public
final
class
FeedReaderContract {
//
To prevent someone from accidentally instantiating the contract class,
//
give it an empty constructor.
public
FeedReaderContract() {}
/*
Inner class that defines the table contents
*/
public
static
abstract
class
FeedEntry
implements
BaseColumns {
public
static
final
String TABLE_NAME = "entry"
;
public
static
final
String COLUMN_NAME_ENTRY_ID = "entryid"
;
public
static
final
String COLUMN_NAME_TITLE = "title"
;
public
static
final
String COLUMN_NAME_SUBTITLE = "subtitle"
;
...
}
}
?
?二）. 使用SQL助手創建一個數據庫
一旦你定義了你的數據庫，你應該實現一些方法來創建和維護你的數據庫及表。下例是一些標準的創建和刪除數據庫的聲明：
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_ENTRY_ID
+ TEXT_TYPE + COMMA_SEP +
FeedEntry.COLUMN_NAME_TITLE
+ TEXT_TYPE + COMMA_SEP +
...
//
Any other options for the CREATE command
" )"
;
private
static
final
String SQL_DELETE_ENTRIES =
"DROP TABLE IF EXISTS " + FeedEntry.TABLE_NAME;
就好像在設備內存（ internal storage ）中所存儲的文件一樣，Android會將你的數據庫存儲在一個和應用有關聯的私有磁盤空間中。你的數據將是安全的，因為默認情況下這些數據不會被其他應用訪問到。
一個有用的APIs集合在
SQLiteOpenHelper
類中。當你使用這個類來獲取你的數據庫的引用時，系統會僅在需要時（不在應用啟動時）執行一些可能需要消耗較長時間的操作，如：創建，更新數據庫。所有你需要的是調用
getWritableDatabase()
或者
getReadableDatabase()
。
Note：
因為它們可能會消耗比較長的時間，所以請確保你在一個后臺線程調用 getWritableDatabase() 或者 getReadableDatabase() ，比如： AsyncTask 或者 IntentService 。
要使用
SQLiteOpenHelper
，創建一個子類，覆寫
onCreate()
，
onUpgrade()
和
onOpen()
回調函數。你可能還需要實現
onDowngrade()
，但這不是必須的。
例如，下面是一個
SQLiteOpenHelper
的實現，它使用了之前所列舉的一些命令：
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);
}
}
要訪問你的數據庫，實例化你的 SQLiteOpenHelper 子類：
FeedReaderDbHelper mDbHelper =
new
FeedReaderDbHelper(getContext());
?
三）. 將信息添加到數據庫中
可以將一個 ContentValues 對象傳入 insert() 方法，來將數據添加到數據庫中：
//
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_ENTRY_ID, id);
values.put(FeedEntry.COLUMN_NAME_TITLE, title);
values.put(FeedEntry.COLUMN_NAME_CONTENT, content);
//
Insert the new row, returning the primary key value of the new row
long
newRowId;
newRowId
=
db.insert(
FeedEntry.TABLE_NAME,
FeedEntry.COLUMN_NAME_NULLABLE,
values);
insert() 方法的第一個參數就是表名。第二個參數提供了一個列名，當 ContentValues 為空時，框架會插入一個NULL。（如果你將這個參數設置為“ null ”，那么當輸入時空時，框架不會添加一個新列）
?
四）. 從數據庫中讀取數據
為了從數據庫中讀取數據，使用 query() 方法，傳遞給它你的選擇標準和期望查找的列。這個方法結合了 insert() 和 update() ，除了定義了你希望獲取數據 （不是你希望插入的數據） 的列清單。查詢的結果將會以一個 Cursor 對象返回。
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_UPDATED,
...
};
//
How you want the results sorted in the resulting Cursor
String sortOrder =
FeedEntry.COLUMN_NAME_UPDATED
+ " 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
);
為了查詢 cursor中的一行，使用 Cursor 中的一個移動方法，這個方法你必須在開始讀數據時一直調用。一般地，你應該從調用 moveToFirst() 開始，這樣將讀取位置放置到結果的第一個記錄。對于每一行，你可以你可以讀取某一列的值，通過調用 Cursor 的一個get方法，比如： getString() 或者 getLong() 。對于每個get方法，你必須傳入你期望的列的索引號，你可以通過調用 getColumnIndex() 或者 getColumnIndexOrThrow() 來得到索引號。
cursor.moveToFirst();
long
itemId =
cursor.getLong(
cursor.getColumnIndexOrThrow(FeedEntry._ID)
);
?
五）. 從數據庫中刪除數據
為了從數據庫中刪除一行數據，你需要提供一個選擇標準來指定一行。數據庫的API提供了一個創建選擇標準的機制來防止SQL注入攻擊。這個機制將選擇語句分為了選擇命令段（selection clause）和選擇參數。命令段指定了要尋找的列，并且允許你可以結合一些列測試。參數是要測試的值，它是和命令段相對應的。因為這個結果和通常的SQL語句聲明處理起來不一樣，所以能夠方式SQL注入。
//
Define 'where' part of query.
String selection = FeedEntry.COLUMN_NAME_ENTRY_ID + " LIKE ?"
;
//
Specify arguments in placeholder order.
String[] selectionArgs =
{ String.valueOf(rowId) };
//
Issue SQL statement.
db.delete(table_name, selection, selectionArgs);
?
六）. 更新一個數據庫
當你需要修改一個數據庫值的子集，可以使用 update() 方法。
更新表結合了 insert() 的內容語法和 delete() 的“ where ”語法。
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 ID
String selection = FeedEntry.COLUMN_NAME_ENTRY_ID + " LIKE ?"
;
String[] selectionArgs
=
{ String.valueOf(rowId) };
int
count =
db.update(
FeedReaderDbHelper.FeedEntry.TABLE_NAME,
values,
selection,
selectionArgs);
更多文章、技術交流、商務合作、聯系博主
微信掃碼或搜索：z360901061
微信掃一掃加我為好友
QQ號聯系： 360901061
您的支持是博主寫作最大的動力，如果您喜歡我的文章，感覺我的文章對您有幫助，請用微信掃描下面二維碼支持博主2元、5元、10元、20元等您想捐的金額吧，狠狠點擊下面給點支持吧，站長非常感激您！手機微信長按不能支付解決辦法：請將微信支付二維碼保存到相冊，切換到微信，然后點擊微信右上角掃一掃功能，選擇支付二維碼完成支付。
【本文對您有幫助就好】元
