【Android Developers Training】 26. 在SQL数据库中保存数据

注：本文翻译自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);