【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);