数据库存储数据

https://developer.android.google.cn/training/basics/data-storage/databases.html

 

SQL 数据库的主要原则之一是架构：数据库如何组织的正式声明。 架构体现于用于创建数据库的 SQL 语句。它有助于创建伴随类，即契约类，其以一种系统性、自记录的方式明确指定您的架构布局。

契约类是用于定义 URI、表格和列名称的常数的容器。 契约类允许您跨同一软件包中的所有其他类使用相同的常数。 您可以在一个位置更改列名称并使其在您整个代码中传播。

一种良好的使用组织契约类的方法是将数据库中的全局性的定义放入类的根级别。 然后为枚举其列的每个表格创建内部类。

 

通过实现 BaseColumns 接口，内部类可继承名为 _ID 的主键字段，某些 Android 类（比如CursorAdapter）将需要内部类拥有该字段。 这并非必需项，但可帮助数据库与 Android 框架协调工作

新建一张表：

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";
    }
}

 

建立表和删除表：

一旦你决定了数据库的结构，就该引用那些创建和维护数据库与表的方法了。下面是一种建立和删除表的常见代码：

private static final String SQL_CREATE_ENTRIES =
    "CREATE TABLE " + FeedEntry.TABLE_NAME + " (" +
    FeedEntry._ID + " INTEGER PRIMARY KEY," +
    FeedEntry.COLUMN_NAME_TITLE + " TEXT," +
    FeedEntry.COLUMN_NAME_SUBTITLE + " TEXT)";

private static final String SQL_DELETE_ENTRIES =
    "DROP TABLE IF EXISTS " + FeedEntry.TABLE_NAME;

数据库存放的数据默认情况下不开放给任何外部应用访问，相对安全。

默认的数据库建立的数据都为应用内私有，如果希望可以开放给别的APP，可以使用SQLiteOpenHelper的API getWritableDatabase()  和 getReadableDatabase(). 

处理过程较长，尽量放在后台进程中。

SQLiteOpenHelper使用方法：继承SQLiteOpenHelper类，覆盖 onCreate(), onUpgrade() 和 onOpen() 方法

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

 实例化父类：

FeedReaderDbHelper mDbHelper = new FeedReaderDbHelper(getContext())

 

写入数据：

在insert() 方法中传入一个 ContentValues对象

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

 

传入的第一个参数是表名，第二个参数为如果values为空时ContentValues将要进行的操作。如果指明了列名，则会在此列中插入一行，然后设置整列为空。如记为null则不做任何操作。

读取数据：

使用query() 方法，传入筛选条件和目标列。查询结果返回为一个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_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 cursor = 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的移动方法。既然cursor的起始位置为-1，先调用 moveToNext()  把“read position”放在结果中的第一个入口，然后不论cursor是否已经把最后的入口传递给结果列都会返回。对于每一行来说，你可以使用Cursor的get方法来读取每一列的值，比如 getString()或者 getLong() 。对于每一种get方法，你必须使用 getColumnIndex() 或者 getColumnIndexOrThrow() 方法可以获取的你想查询那列的索引位置传递过去。当你重复查询完结果后，调用 cursor的 close() 方法释放它的资源。

List itemIds = new ArrayList<>();
while(cursor.moveToNext()) {
  long itemId = cursor.getLong(
      cursor.getColumnIndexOrThrow(FeedEntry._ID));
  itemIds.add(itemId);
}
cursor.close();

 

删除数据：

想要删除表里的数据，你必须提供能明确指定行的筛选标准。数据库API提供了一种建立筛选标准的机制来防止SQL注入攻击。这种机制会把筛选标准分割成子句或者参数。子句定义了你要查询的列，同时也允许你合并列的测试。 参数是根据捆绑到子句的项进行测试的值。由于结果并未按照与常规 SQL 语句相同的方式进行处理，它不受 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);

 

修改数据库：

当您需要修改数据库值的子集时，请使用 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 title
String selection = FeedEntry.COLUMN_NAME_TITLE + " LIKE ?";
String[] selectionArgs = { "MyTitle" };

int count = db.update(
    FeedReaderDbHelper.FeedEntry.TABLE_NAME,
    values,
    selection,
    selectionArgs);