Android文件存储

Android文件系统跟其他平台基于磁盘的文件系统类似,这篇教程描述了如何使用文件相关的API在Android文件系统上进行读写操作。

File对象适合读写大量的流式数据,如图片文件或其他文件的网络传输。

这篇教程将演示如何在App中执行基本的文件操作,并假设读者对Linux文件系统和Java标准的文件输入输出有一定基础。

选择内部存储还是外部存储

所有的Android设备都将文件存储区域分为两部分:内部存储和外部存储。这种命名来源于早期的Android系统,当时大部分的设备都有一个内置的不可变的内存(内部存储),另外还有一个可移除的存储介质,如SD卡(外部存储),后来即使设备没有可移除的存储介质了,依然习惯性地将永久存储空间划分为“内部”和“外部”,并且无论外部存储是否可以移除,这两部分存储空间的API行为都是一样的。下面分别总结每个存储空间的特点:

内部存储

1.总是可用的

2.内部存储空间内的文件默认只有你的App可以访问

3.当用户卸载了你的App,系统从内部存储空间中移除所有你的App相关的文件

当你希望用户和其他App都不能访问你的文件时,内部存储是最好的选择。

外部存储

1.并非总是可用的,因为用户可能将外部存储作为USB存储,某些情况下甚至会从设备上移除外部存储

2.它是大家都可以访问的,存储在这里的文件可以被其他应用程序访问

3.当用户卸载了你的App,系统仅仅会移除存储在通过 getExternalFilesDir()获取到的路径中的该App相关的文件

当你的文件不需要访问限制,或者你想将文件分享给其他的App,或者允许用户通过电脑来访问它,那么外部存储是最好的选择。。

小贴士

尽管App默认是被安装到内部存储空间中,但是你可以通过在AndroidManifest中指定android:installLocation属性来使App安装到外部存储空间。当APK文件很大且外部空间比内部空间大时,用户或许会喜欢这样做。如需要了解更多信息,请参考App InstallLocation

获取外部存储的权限

为了在外部存储空间中写入数据,需要在AndroidManifest文件中加入权限:WRITE_EXTERNAL_STORAGE,如下

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

注意:现在应用将获得读取外部存储空间的能力而不需要提供特别的权限,然而,这在以后的版本中可能会改变。如果应用需要读外部存储(但是不需要写),那么需要声明READ_EXTERNAL_STORAGE权限。在这个改变发生之前,为了保证应用能持续地按所期待地工作,那么最好现在就声明读权限,如下:

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

但是,如果应用声明了WRITE_EXTERNAL_STORAGE权限,那么它就默认有了读取外部存储空间的权限。

如果想保存文件到内部存储空间,则不需要声明任何权限。因为应用本身就有权限对内部存储空间进行读写。

保存文件到内部存储空间

当保存一个文件到内部存储空间时,可以通过下面任一个方法来获得一个合适的目录作为File:

getFilesDir()

为你的应用返回一个代表内部目录的File对象。

getCacheDir()

为你的应用返回一个代表内部临时缓存文件目录的File对象。需要对该文件目录设置一个合理的大小,如1M,并且确保在不需要的时候删除里面的文件。如果系统存储空间不足时,可能会在没有警告的条件下删除缓存的文件。

如果要在内部存储目录下创建一个文件,可以使用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;
}

注意:App的内部存储目录位于Android文件系统中通过应用包名决定的特定位置,从技术上讲,如果你的文件设置为可读,其他应用可以读取你的内部文件,但是,其他应用需要知道你应用的包名和文件名。如果你的文件没有设置为可读写,那么其他应用是不能访问该App的内部目录并读写你的文件的。因为只要使用了MODE_PRIVATE的模式,其他应用就不能访问。

保存文件到外部存储空间

因为外部存储空间有时是不可用的,比如将外部存储空间连接到PC或者SD卡被移除的时候,所以应该在访问它的时候检查它的可用性。通常可以使用getExternalStorgeState()来查询外部存储空间的状态,如果状态为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;
}

尽管外部存储可以被用户和其他应用访问修改,有两种类型的文件可以保存在这里:

Public files

这类文件对于用户或其他应用都是可访问的,当用户卸载了你的App时,这些文件依然保留并可被用户访问。例如,你的App所拍摄的照片或下载的文件。

Private files

这类文件仅属于你的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;
}

如果想保存对于App私有的文件,可以调用getExternalFilesDir()来获取合适的文件目录,并传入一个指定文件类型的参数。通过这种方式创建的目录都会被添加到封装了该App所有外部存储文件的目录下,并且会在用户卸载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被卸载后仍然可以使用这些文件,比如一个拍照的App,我们想在卸载后依然保存照片,那么就应该使用getExternalStoragePublicDirectory()。

无论是使用getExternalStoragePublicDirectory()来保存共享文件还是使用getExternalFilesDir()保存App私有的文件,重要的是尽可能使用API常量提供的目录名称,如DIRECTORY_PICTURES,这些目录名称能保证系统正确地对待里面的文件。例如,以DIRECTORY_RINGTONES类型存储的文件会被系统识别为铃声而不是音乐。

查询剩余空间

如果你事先知道要保存的文件的大小,可以通过调用getFreeSpace()或getTotalSpace()来判断是否有足够的空间,从而避免发生IOException。这些方法可以获得当前可用的空间以及总容量的大小,这些信息对于在一定阈值以上的存储空间上存储文件是很有用的。

然而,系统并不能保证可以写入getFreeSpace()大小的文件,如果剩余空间比你想要存储的文件大几M,或者存储空间使用还不到90%,那么继续存储文件一般是安全的,否则最好不要再写入文件。

注意:其实并非强制在保存文件之前一定要对剩余空间进行查询。你可以直接尝试写入文件,然后捕捉IOException,如果你事先不知道到底需要多少存储空间的时候可以这样做。例如,当你把PNG图片转换为JPEG时,事先并不知道生成的图片大小是多少。

删除文件

你应该在不再需要的时候删除文件,最直接的方法是通过调用文件的delete()方法。

myFile.delete();

如果文件是保存在内部存储空间上的,还可以调用Context的deleteFile()方法来定位和删除文件。

myContext.deleteFile(fileName);

注意:当用户卸载了App,Android系统会删除如下文件:

1.所有保存在内部存储空间的文件

2.所有保存在通过getExternalFilesDir()获取的外部存储空间目录的文件

然而,你应该定期地删除所有通过getCacheDir()创建的缓存文件以及那些不再使用的文件。


原文地址:http://developer.android.com/training/basics/data-storage/files.html













评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值