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