Android官方开发文档Training系列课程中文版:数据存储之文件存储
Android使用的文件系统和其它平台的磁碟式文件系统很相似。这节课描述了如何通过FileAPI在Android文件系统上进行读取文件和写入文件的操作。
一个File对象适合被用来按照从头到尾的方式读取或写入大量的数据,它不适合被用来跳跃式访问,也就是随机访问。举个例子,这对图片文件或者任何基于网络的数据交换是非常适合的。
这节课展示了如何执行APP中最基本的文件相关任务。这节课假定你有Linux的文件系统基础以及Java标准的输入输出基础。
选择内部或外部存储器
所有的Android设备有两个文件存储分区:”internal”和”external”分区。这些名词来自于较早的Android版本,当大多数的设备提供了内置的固定内存,会添加一个可移除的存储器媒体比如micro SD卡(外部存储器)。一些设备固定的存储器空间划分为”internal”和”external”分区,所以甚至是没有可移除的存储媒体,那么仍然还是会有两个存储器空间。API会表现出相同的行为,无论外部存储器是不是可移除的。下面是对每个存储器空间的事实总结。
Internal storage:
它总是可用的。 默认情况下APP将文件保存在这里,只允许该APP可以访问。 如果用户卸载了你的APP,那么系统会将APP的所有文件从这里移除。如果你不想让用户或者其它APP访问你文件的话,内部存储器是一个合适的地方。
External storage:
它并不总是可用的,因为用户可能将外部存储挂载为USB存储器,和另外一些可能会被从设备上移除的情况。 它是全局可访问的,所以如果文件存储在这里,它可能会你的控制范围之外被访问。 当用户卸载了你的APP,系统只会删除你在getExternalFilesDir()返回目录中保存的文件。如果不需要访问限制的话,外部存储器是一个合适的地方,它可以另其它的APP访问你的文件,用户也可以通过电脑访问这些文件。
Note:尽管APP安装的时候会默认被安装在内部存储器内,不过你可以在清单文件中通过指定android:installLocation属性来指定应用安装的位置。如果APK的尺寸很大,并且外部存储空间比内部存储空间大的话,用户会很欣赏这点。更多相关信息,请参见: App Install Location。
获取外部存储器的权限
如果要在外部存储器写入文件,你必须在清单文件中请求WRITE_EXTERNAL_STORAGE权限。
...
警告:目前所有的APP都有能力访问外部存储器而不需要指定权限。然而,这会在未来的发行版做更改。如果你的APP需要读取外部存储器的数据(不是写入),那么你需要声明READ_EXTERNAL_STORAGE权限,来确保你的APP还可以在未来的版本中继续工作,在更改生效之前,你应该现在就声明这项权限。
android:name="android.permission.READ_EXTERNAL_STORAGE" /> ... 然而,如果你的APP使用了WRITE_EXTERNAL_STORAGE权限,那么它会隐性的含有读取外部存储器的权限。
你在内部存储器中保存文件不要任何权限。你的应用程序总是有权读取和写入文件到内部存储器目录。
保存文件到内部存储器
当要保存文件到内部存储器时,你可以通过下面两个方法中的一个获得一个合适的目录对象File:
getFilesDir() 返回一个代表APP的内部存储器目录的File对象。
getCacheDir() 返回一个File对象,这个对象代表了APP在内部存储器中的临时文件缓存目录。为了确保文件不再需要的时候可以删除到它,应该在任何给定时间内对内存的数量实现一个合理的尺寸限制,比如1MB。如果系统开始在存储器上缓慢运行,那么可能会删除你的临时文件,而不会有任何警告。
为了在这些目录中创建一个文件,你可以使用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;
}
**Note:**APP的内部存储路径是通过APP的包名特别指定的,并且被放置在Android文件系统中一个特殊的位置。技术上讲,其它的APP是可以读取你的内部文件的,如果你设置的文件模式是可读的。然而,其它的APP也应该知道你APP的包名和文件名。其它的APP不能浏览你的内部目录,并且没有访问和写入的权限,除非你特别设置了文件是和读写的。所以,一旦你对内部存储器文件使用了MODE_PRIVATE模式,那么其它APP永远不可能访问到这些文件。
保存文件到外部存储器
因为外部存储器有可能是不可用的,比如当用户将它挂载到了PC上,或者将SD卡移除了,所以你应该在访问它之前检查它是否可用。你可以通过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文件:
在这种情况下,文件应该会被其它APP或者用户随便访问。当用户卸载了你的APP,那么这些文件还会保留给用户。
举个例子,APP捕获的照片或者下载的其它文件。
Private文件:
这些文件会正当的属于你的APP,并且在用户卸载APP的时候会删除它们。尽管这些文件从技术上讲是可以被用户或者其它APP访问的,因为这些文件是在外部存储器上。实际上这些文件不会提供给APP之外的用户。当用户卸载了APP,那么系统会将这些文件从外部存储器中删除。
举个例子,APP下载的附加资源或者临时的媒体文件。
如果你想在外部存储器上保存公开的文件,使用getExternalStoragePublicDirectory()方法获得一个代表合适目录的File对象。这个方法携带的参数指定了你需要存储的文件类型,可以使系统对其它公开文件进行逻辑上的组织,比如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()方法获取合适的目录,然后给它传你喜欢的一个类型的目录名称。每一个目录会通过这种方式创建并被添加到父目录中,以便封装所有在外部存储器上的文件,当用户卸载APP的时候会删除它们。
下面这个方法你可使用它创建一个个人的相册目录:
public File getAlbumStorageDir(Context context