Android官方开发文档Training系列课程中文版：数据存储之文件存储

原文地址：http://android.xsoftlab.net/training/basics/data-storage/files.html

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权限。

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

警告：目前所有的APP都有能力访问外部存储器而不需要指定权限。然而，这会在未来的发行版做更改。如果你的APP需要读取外部存储器的数据(不是写入),那么你需要声明READ_EXTERNAL_STORAGE权限，来确保你的APP还可以在未来的版本中继续工作，在更改生效之前，你应该现在就声明这项权限。
<manifest ...><uses-permission > android:name="android.permission.READ_EXTERNAL_STORAGE" />...
</manifest>
然而，如果你的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, 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，这会返回APP在外部存储器上私有目录的根目录。

记住在getExternalFilesDir()目录中创建的目录会随着APP的卸载被删除。如果你想在删除之后仍然保留这些文件，比如你的APP是个摄像机应用，用户希望保留下来这些照片，你应该使用getExternalStoragePublicDirectory()方法。

无论你使用的是getExternalStoragePublicDirectory()要共享文件还是使用getExternalFilesDir()保护你APP内的文件，你使用API提供的常量比如DIRECTORY_PICTURES作为目录的名称来说是非常重要的。这些目录的名称可以为系统合适的对待，举个例子，如果文件存储在DIRECTORY_RINGTONES的目录中，系统媒体扫描器会将它识别为铃声文件，而不是音乐文件。

查询剩余空间

如果你可以提前知道你保存的数据有多少，你可以查询是否有足够的空间可以使用，通过调用getFreeSpace()或者getTotalSpace()达到这一点。这些方法分别提供了当前可用空间和磁盘容量上的总空间，这些信息有助于避免填充的磁盘容量超过固定的阈值。

然而，系统不会保证你可以写入与getFreeSpace()返回的剩余空间容量相当的数据。如果返回的数字是几MB，大于你想存储的数据大小，又或者系统当前使用容量少于总容量的90%,那么现在处理可能是安全的。否则，你可能不适合写入到存储器中。

Note:如果你在保存文件之前不检查剩余可用空间，你可以试着以正确的方式写入文件，如果事件发生了，那么可能会引起IOException异常。如果你不知道你需要的精确空间，那么你可能就需要这么去做。举个例子，如果你在存储文件之前从PNG编码改为了JPEG编码，你可能就不会提前知道文件的大小。

删除文件

你应该在文件不再需要的时候将它们删除。最直接了当的方式就是拥有一个已经打开了的文件的引用，然后调用它的delete()方法。

myFile.delete();

如果文件被存在了内部存储器上，你也可以要求Context定位，然后调用deleteFile()方法删除文件。

myContext.deleteFile(fileName);

Note:当用户卸载了你的APP，Android系统会删除以下文件：

所有保存在内部存储器中的文件

所有保存getExternalFilesDir()目录下的外部存储器中的文件

无论如何，你应该定期手动删除所有的缓存文件，即便是通过getCacheDir()方法创建的，还应该定期删除你不再需要的其它文件。