Android中的数据存储

Android中的数据存储主要分为三种基本方法：

1.利用shared preferences存储一些轻量级的键值对数据。

2.传统文件系统。

3.利用SQLite的数据库管理系统。

对SharedPreferences对象和SQLite数据库，它们的数据仅对创建它们的应用是可访问的。

（比如，MODE_WORLD_READABLE 和 MODE_WORLD_WRITEABLE现在（since API 17）已经被标记为deprecated）。

换句话说，它们不是共享的，如果需要在不同的应用之间共享数据，需要建立content provider，本文对这部分内容不作介绍。

本文基本是官方文档翻译，原文请见文后链接。

 

本文目录

一.利用shared preferences存储键值对

1.获得SharedPreferences的Handle

2.向Shared Preferences写数据

3.从Shared Preferences读取数据

二.存储文件

选择内部或外部存储

获取外部存储设备的权限

向内部存储存文件

向外部存储存储文件

查询剩余空间

删除文件

三.在SQL数据库中存储文件

定义一个构架和契约Define a Schema and Contract

用SQL Helper创建一个数据库

向数据库中存入数据

从数据库中读取数据

删除数据库中的信息

更新数据库

 

利用shared preferences存储键值对

SharedPreferences 提供了一种存储键值对的方法，可以用于存储原生数据类型（boolean, float, int, long, String）。

这些数据在用户工作阶段一直被保持，即便应用被关闭也还是保持。

所以可以用来保存一些数据，比如用户设定的字体，背景，用户名等，在下一次打开应用时，不用重新设定这些数据。

 

1. 获得SharedPreferences的Handle

获得SharedPreferences对象可以使用下面两种方法：

getSharedPreferences()这是 Context 中的方法，可以通过第一个参数指定你需要获得的文件名。

getPreferences()这是 Activity 中的方法，获取Activity中默认的shared preference文件，这个文件是Activity私有的，所以不需要指定名字。

 

2.向Shared Preferences写数据

向Shared Preferences写数据，首先需要调用edit()方法创建一个 SharedPreferences.Editor对象，然后调用这个对象的putXXX()方法存储键值对，键都是String类型，值是XXX所对应的数据类型（boolean, float, int, long, String, String集合）。

最后需要调用commit() 方法把改变从Editor对象转移到SharedPreferences对象。

 

3.从Shared Preferences读取数据

读取数据时需要调用SharedPreferences对象的getXXX()方法，来获得给定键（第一个参数）对应的值，如果给定键不存在，则会返回给定的默认值（第二个参数）。

 

 

存储文件

Android文件系统和其他平台上的类似，使用File APIs可以读写文件。

这部分内容需要你已经了解了Linux文件系统的基础，并且也了解了java.io包中的标准文件输入输出APIs。

 

选择内部或外部存储

所有的Android设备都有两块文件存储区域：内部和外部存储。

内部存贮一般指设备自带的非易失性存储器，外部存储指可拆卸的存储介质，比如微型的SD卡。

一些设备把永久的存储区域分为"internal"和"external"的分区，所以即便没有可拆卸的存储介质，这些设备永远都有两种存储区域，并且不管外部存储区到底是可拆卸的还是内置的，APIs的行为是一致的。

 

内部存储：

永远可用。

存储在内部存储区域的数据默认情况下只对你的app可用。无论是用户或者是其他app都不能访问你的数据。

当用户卸载你的app时，系统会自动移除app在内部存储上的所有文件。

外部存储：

不一定一直可以访问，因为用户可以拆卸外部存储设备。

存储在外部存储的文件是全局可读的，没有访问限制，不受你的控制。可以和其他apps分享数据，用户使用电脑也可以访问在外部存储中的文件。

当用户卸载你的app时，只有当你把文件存储在以 getExternalFilesDir().获得的路径下时，系统才会帮你自动移除。

注意：默认情况下app是安装在内存上的，可以通过在manifest中指定android:installLocation 属性来安排app的安装位置。具体见App Install Location.

 

获取外部存储设备的权限

为了向外部存储中写入数据，需要在manifest中指定权限 WRITE_EXTERNAL_STORAGE ：

<manifest ...>
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    ...
</manifest>

 

注意：现在所有的app都可以读取外部存储中的数据，而不需要特殊的权限说明。

但是，这点在新版本的更新中有可能会改变，如果你的应用需要读取外部存储中的数据而不需要写数据，应该声明READ_EXTERNAL_STORAGE 权限。

为了保证应用能够持续工作，应该现在开始就加入读取权限：

<manifest ...>
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
    ...
</manifest>

 

然而，如果你的应用包含了WRITE_EXTERNAL_STORAGE 权限，它隐式地包含了读取权限。

 

向内部存储存文件

向内部存储存文件时，可以通过下面两个方法获取合适的路径，返回值是一个File对象。

getFilesDir()返回一个File，表示的是app的应用文件在内部存储的绝对路径。

getCacheDir()返回一个File，表示的是app的缓存文件在内部存储的绝对路径。

在如上路径中创建一个新文件，可以利用File() 的构造方法。将上面两个方法获得的File对象作为参数传入，如：

File file = new File(context.getFilesDir(), filename);

另外，也可以调用 openFileOutput()来获取FileOutputStream ，然后向你的内部目录写入数据，如下：

String filename = "myfile";
String string = "Hello world!";
FileOutputStream outputStream;

try {
  outputStream = openFileOutput(filename, Context.MODE_PRIVATE);
  outputStream.write(string.getBytes());
  outputStream.close();
} catch (Exception e) {
  e.printStackTrace();
}

 

或者，如果你需要缓存一些文件，你应该使用createTempFile().

比如，下面的例子从一个URL中提取了文件名，然后利用该文件名创建了一个文件存储在应用的内部缓存路径下：

public File getTempFile(Context context, String url) {
    File file;
    try {
        String fileName = Uri.parse(url).getLastPathSegment();
        file = File.createTempFile(fileName, null, context.getCacheDir());
    catch (IOException e) {
        // Error while creating file
    }
    return file;
}

注意：

你应用的内部存储路径是由应用的包名指定的，在Android文件系统上的一个特定位置。

技术上来说，如果你把文件的模式设置为可读的，其他应用是可以读取你的内部文件的，但是，另外的应用需要知道你的应用的包名和文件的名字。

如果不明确指明，其他应用是不可浏览你的内部文件路径的，也不拥有读取和写入的权限。

所以，只要你对内部存储上的文件使用MODE_PRIVATE，它们对其他应用来说就是不可用的。

 

向外部存储存储文件

因为外部存储很有可能不可用，所以每次使用前都需要检查可用性。

通过getExternalStorageState()方法可以查询外部存储状态，如果返回状态为MEDIA_MOUNTED, 你可以继续对文件进行读写操作。

比如下面的方法：

/* Checks if external storage is available for read and write */
public boolean isExternalStorageWritable() {
    String state = Environment.getExternalStorageState();
    if (Environment.MEDIA_MOUNTED.equals(state)) {
        return true;
    }
    return false;
}

/* Checks if external storage is available to at least read */
public boolean isExternalStorageReadable() {
    String state = Environment.getExternalStorageState();
    if (Environment.MEDIA_MOUNTED.equals(state) ||
        Environment.MEDIA_MOUNTED_READ_ONLY.equals(state)) {
        return true;
    }
    return false;
}

尽管外部存储可以被用户和其他app修改，仍然有两种类型的文件你可以选择：

Public files：

这些文件对用户和其他应用都是可用的。当用户卸载应用时，这些文件对用户仍然是可用的。比如，应用拍摄的照片文件或者是下载的文件。

Private files：

属于你应用的文件，应当在应用被卸载的时候同时被删除。

尽管从技术上来说，这些文件可以被用户和其他文件访问，因为它们是存储在外部存储介质上的，但是它们在你的应用外部并不提供什么实际价值。当用户卸载应用时，系统会删除外部存储上应用私有路径下的所有文件。

比如，应用下载的一些额外的资源或者临时的媒体文件。

 

存储公有文件，首先用getExternalStoragePublicDirectory()获得路径，这个方法需要一个参数指明文件类型，比如 DIRECTORY_MUSIC 或 DIRECTORY_PICTURES. 如：

public File getAlbumStorageDir(String albumName) {
    // Get the directory for the user's public pictures directory. 
    File file = new File(Environment.getExternalStoragePublicDirectory(
            Environment.DIRECTORY_PICTURES), albumName);
    if (!file.mkdirs()) {
        Log.e(LOG_TAG, "Directory not created");
    }
    return file;
}

 

如果想要创建私有文件，利用getExternalFilesDir() 方法获得路径，并且传递给它一个名字指明路径类型。

每一个用这种方法创建的路径都会被加在一个父目录中，这个目录包装了你的应用的所有外部文件，当你卸载应用时，系统会删除它们。

比如，下面的方法为相册创建了一个路径：

public File getAlbumStorageDir(Context context, String albumName) {
    // Get the directory for the app's private pictures directory. 
    File file = new File(context.getExternalFilesDir(
            Environment.DIRECTORY_PICTURES), albumName);
    if (!file.mkdirs()) {
        Log.e(LOG_TAG, "Directory not created");
    }
    return file;
}

 

如果所有预定义的子目录都不适合于你的文件，你可以调用getExternalFilesDir()并且传入null。这样会返回你的应用在外部存储上私有路径的根目录。

 

要记住getExternalFilesDir()在一个卸载应用时系统要删除的目录中创建目录。如果你的文件在应用删除之后仍需要保存，你应该使用getExternalStoragePublicDirectory()。

无论使用哪种方法，比较重要的一点是，要使用API提供的路径名常量，如DIRECTORY_PICTURES等。这些路径名保证了文件会被系统正确处理。

 

查询剩余空间

如果你提前知道你要存储多少数据，你可以实现查询是否有足够的存储空间，而不必引起一个IOException 。

通过调用 getFreeSpace() 和getTotalSpace()方法，你可以获取当前的空闲空间和当前卷的总空间。

但是，系统并不保证你可以存储的容量和getFreeSpace() 方法获取的字节数一样多，如果该方法返回的容量要比你实际存储的数据大小多几个MB，或者存储后系统的填满程度小于90%，那么很可能是可以安全处理的。否则，可能就存储不下了。

并没有要求你必须先检查剩余空间再存储文件，你可以把存储的语句写入一个try块中，然后catch IOException。在你并不知道文件多大时你需要这么做。

 

删除文件

在你不需要文件时你需要将其删除。

最直接的方法：获得文件引用然后调用delete() 方法：

myFile.delete();

 

如果文件存储在内部存储上，可以请求 Context 去定位和删除文件，通过调用deleteFile():

myContext.deleteFile(fileName);

 

注意，当用户卸载你的app时，Android系统删除如下：

所有在内部存储上的文件。

所有用getExternalFilesDir()存储在外部存储上的文件。

然而，你需要定期手工地删除利用getCacheDir() 创建的所有缓存文件。并且，需要定期清除所有不再需要的文件。

 

在SQL数据库中存储文件

对于重复或结构性强的数据来说，把它们存储在数据库中是一种理想的做法。

Android系统上你将会用到的数据库相关的APIs都在这个包中：android.database.sqlite 。

 

定义一个构架和契约Define a Schema and Contract

SQL数据库中的主要原则之一就是构架（schema）：一个关于这个数据库是如何组织的一个正式的声明。

构架反映在创建SQL数据库的语句中。

你可能会发现创建一个同伴类（companion class）很有用，同伴类同时被称作合约类（contract class），其中明确规定了你的构架的布局，以一种系统且自说明的方式。

 

一个合约类（contract class）是一个常量的容器，这些常量定义了URI，表的名字，列的名字。

合约类允许你在同一个包的其他类中使用这些名字常量。

这就允许了你在一个地方改变列名，而同时把它传播到代码的其他地方去。

组织合约类的一个好方法是：把对于你的整个数据库来说是全局的那些定义放在类的根级上；然后对于每一个表（table）创建一个内部类，列举其列。

 

注意：通过实现BaseColumns 接口，你的内部类要继承一个基本的关键字域叫做_ID，一些Android的类比如cursor adaptors将需要它。

它不是必须的，但是它能帮助你的数据库更和谐地和Android framework工作。

 

比如，下面这个代码段定义了表名和列名：

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

 

为了阻止不小心实例化合约类，给它一个私有的空构造函数：

// Prevents the FeedReaderContract class from being instantiated.
private FeedReaderContract() {}

 

用SQL Helper创建一个数据库

一旦你定义好了你的数据库看起来什么样，你就应该实现一些方法，用来创建和维护数据库和数据表。

下面是创建和删除表的一些典型的语句：

private static final String TEXT_TYPE = " TEXT";
private static final String COMMA_SEP = ",";
private static final String SQL_CREATE_ENTRIES =
    "CREATE TABLE " + FeedReaderContract.FeedEntry.TABLE_NAME + " (" +
    FeedReaderContract.FeedEntry._ID + " INTEGER PRIMARY KEY," +
    FeedReaderContract.FeedEntry.COLUMN_NAME_ENTRY_ID + TEXT_TYPE + COMMA_SEP +
    FeedReaderContract.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 " + TABLE_NAME_ENTRIES;

 

就好像你存储文件到设备的内部存储上一样，Android在你应用相关的私有磁盘空间上存储你的数据库数据。

你的数据是安全的，因为默认情况下其他应用无法访问这块区域。

SQLiteOpenHelper 类提供了一些有用的APIs，当你使用这个类来获取数据库的引用时，系统仅在需要时执行可能长时间的操作：创建和更新数据库，而不是在应用启动的时候执行。

你需要做的仅仅是调用 getWritableDatabase()或getReadableDatabase()方法。

注意：因为它们是长时间运行的，所以请确保你在背景线程中调用：

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

 

 

向数据库中存入数据

想数据库中插入数据：通过向  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(FeedReaderContract.FeedEntry.COLUMN_NAME_ENTRY_ID, id);
values.put(FeedReaderContract.FeedEntry.COLUMN_NAME_TITLE, title);
values.put(FeedReaderContract.FeedEntry.COLUMN_NAME_CONTENT, content);

// Insert the new row, returning the primary key value of the new row
long newRowId;
newRowId = db.insert(
         FeedReaderContract.FeedEntry.TABLE_NAME,
         FeedReaderContract.FeedEntry.COLUMN_NAME_NULLABLE,
         values);

 

insert()方法接收的第一个参数是表的名字，第二个参数是列的名字：可以通过这个参数设定一个列名，如果ContentValues是空值，这样这个列就会插入NULL；如果第二个参数是null，那么如果ContentValues是空值将不会被插入表中。

 

从数据库中读取数据

从数据库中读取，是通过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 = {
    FeedReaderContract.FeedEntry._ID,
    FeedReaderContract.FeedEntry.COLUMN_NAME_TITLE,
    FeedReaderContract.FeedEntry.COLUMN_NAME_UPDATED,
    ...
    };

// How you want the results sorted in the resulting Cursor
String sortOrder =
    FeedReaderContract.FeedEntry.COLUMN_NAME_UPDATED + " DESC";

Cursor c = db.query(
    FeedReaderContract.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 类中的各种move方法中的一个，当你开始读取值时你必须先调用它。

一般情况下，你应该先调用moveToFirst()方法，它将把读取位置指向结果中的第一项。

对每一行，你可以通过Cursor类的get方法读取各列内容，比如 getString()或 getLong()。

对每一个get方法，你必须指定你想要的列的索引，你可以通过 getColumnIndex() 或 getColumnIndexOrThrow()方法来获得索引。

比如：

cursor.moveToFirst();
long itemId = cursor.getLong(
    cursor.getColumnIndexOrThrow(FeedReaderContract.FeedEntry._ID)
);

 

 

删除数据库中的信息

要删除表中的行，你需要提供一定的选择标准来确定要删除的行。

数据库API提供了一种机制，用于创建选择标准，防止SQL注入。

该机制将选择标准分为一个选择从句和一些选择参数。这个从句定义了需要查看的列，也允许你结合列的测试。这些参数是和从句绑定的需要测试的值。

因为结果不像常规的SQL语句那样处理，所以它是防SQL注入的。

// Define 'where' part of query.
String selection = FeedReaderContract.FeedEntry.COLUMN_NAME_ENTRY_ID + " LIKE ?";
// Specify arguments in placeholder order.
String[] selelectionArgs = { String.valueOf(rowId) };
// Issue SQL statement.
db.delete(table_name, selection, selectionArgs);

 

 

更新数据库

当你需要修改你的数据库中值的一个子集时，运用update()方法。

更新数据表结合了insert()方法中的content values语义和 delete()方法中的where语义。

SQLiteDatabase db = mDbHelper.getReadableDatabase();

// New value for one column
ContentValues values = new ContentValues();
values.put(FeedReaderContract.FeedEntry.COLUMN_NAME_TITLE, title);

// Which row to update, based on the ID
String selection = FeedReaderContract.FeedEntry.COLUMN_NAME_ENTRY_ID + " LIKE ?";
String[] selectionArgs = { String.valueOf(rowId) };

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

 

 

 

 

参考资料

《Beginning Android 4 Application Development》Chapter6：Data Persistence

Android官方文档：Training：Saving Data

http://developer.android.com/training/basics/data-storage/index.html

API Guides: Storage Options

http://developer.android.com/guide/topics/data/data-storage.html