前面说了Android文件的存放区域,这篇文章将说说数据的存放方式之一SQL数据库,这个对于重复或结构化数据(比如联系人信息)而言是理想之选,使用到的SQL相关API所在的包为android.database.sqlite
Define a Schema and Contract
SQL数据库的主要原则之一是Schema:声明了数据库是如何组织的. 对于创建类似于Contract类等Companion类很有帮助.
一个Contract类是一个用于存放定义URI名字,表名,列名的常量的容器,通过这个类你可以在同一个包下的其他类中使用这些常量.Android API中的一些Contract类如ContactsContract,CalendarContract,TvContract等等.
组织Contract类的一种良好方法是将对于整个数据库而言是全局性的定义放入该类顶层,然后为每个表表创建内部类。
- 注意: 通过实现BaseColumns接口,你的类就会带有有个两个常量_ID和_COUNT,其中_ID对于一些类是有用的,虽然这不是必须的,但是这样做对于数据库与Android framework的和谐工作是有帮助的.
如下片段,一个Contract类中定义表明和列名:
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";
...
}
}
Create a Database Using a SQL Helper
定义了数据库的结构后,就可以来创建和维护数据了,下面是创建和删除Table的语句:
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中操作数据库,有一个类提供了很多有用的API,这个就是SQLiteOpenHelper,里面提供了许多数据库操作方法的回调,你可以override它们然后实现自己的逻辑操作. 同时该类还提供了getWritableDatabase()和getReadableDatabase(),通过这两个方法可以获取到SQLiteDatabase实例对象,这样就可以对数据库进行操作.
- 注意: 数据库操作可能是long-running的,所以要保证对数据库的操作放到异步来进行,比如用AsyncTask或IntentService来操做getWritableDatabase()或getReadableDatabase().
由于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);
}
}
使用时只需实例化一个FeedReaderDbHelper的对象即可:
FeedReaderDbHelper mDbHelper = new FeedReaderDbHelper(getContext());
Put Information into a Database
使用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()的第一个参数是表名,第二个参数是当第二个参数ContantValues的对象中无数据时在相应的列插入NULL的列名.(若第三个参数为null则不会插入空数据).
Read Information from a Database
调用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_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对象的读取,通常先调用moveToFirst()方法,来把指针移到结果的第一个entry,也就是整行的数据,可以通过Cursor的getString(),getLong()等方法来获取具体值,这些方法需要列的索引,而列的索引可以用 getColumnIndex()或getColumnIndexOrThrow()方法来获取,如下示例:
cursor.moveToFirst();
long itemId = cursor.getLong(
cursor.getColumnIndexOrThrow(FeedEntry._ID)
);
Delete Information from a Database
删除数据需要指定某行,我们这个数据库的API为创建选择条件提供了一套机制来防止SQL注入. 这套机制把整个选择分成了选择语句和选择参数,其中选择语句定义了要查找的列,同时也允许你进行组合测试. 而选择参数则是根据绑定到选择语句来测试的值,因为这个结果的处理与常规的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 a Database
数据常规操作增删改查中的改,使用update()方法,如下示例:
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);
总结
Android中使用数据库,只需要自定义一个SQLiteOpenHelper的实现类,最好再写个Contract类将要列名表名等写成全局静态常量,然后在SQLiteOpenHelper中进行相应的操作,除了上面的一些方法,可以直接调用SQLiteDatabase的execSQL相关方法来直接执行原生sql语句.
但是对于稍微复杂点的数据,比如要存放多个类的数据,那要写的就比较多,而现在有一些工具和方案可以帮我们简化数据库的操作,SQLite封装的工具如:
你可以选择你觉得好用的作为你的解决方案,还是不错的.
