Android 数据存储02之文件读写

Android文件读写

版本	修改内容	日期	修改人
V1.0	原始版本	2013/2/25	skywang

Android文件读写的有两种方式。一种，是通过标准的JavaIO库去读写。另一种，是通过Context提供的接口去读写。

两种方式的原理是一样的，只是API接口不同。下面分别对两种方式进行介绍。

1 通过Java IO库读写文件

当我们想读写公用的目录，如图片、提示音；或者读写外部扩展卡上的文件时，一般都选择通过Java IO库去读写。当通过Java IO库去读写文件时，一般会用到Android Enviroment的接口(如读取外部sdcard的路径、状态等)。

1.1 Android Enviroment

下面分别对Android Eviroment涉及到的函数和变量进行说明

表01_ Enviroment API接口

Enviroment API接口
API名称	说明
staticFile getDataDirectory()	获取Android的数据目录。
staticFile getDownloadCacheDirectory()	获取的Andr​​oid下载/缓存内容的目录。
staticFile getExternalStorageDirectory()	获取Android的外部存储目录(即sdcard目录)。
staticFile getExternalStoragePublicDirectory(String type)	获取为特定类型的文件放在顶层的公共外部存储目录。
staticString getExternalStorageState()	获取的主要外部存储设备的当前状态(即sdcard目录的状态)。
staticFile getRootDirectory()	获取Android的根目录。
static boolean isExternalStorageEmulated()	返回设备是否有外部存储设备的仿真。
static boolean isExternalStorageRemovable()	返回主“外部存储设备是否是可拆卸的。

表02_Enviroment sdcard卡状态说明

Enviroment 公用目录参数
类型	名称	说明
public static String	DIRECTORY_ALARMS	标准的铃声目录
public static String	DIRECTORY_DCIM	相机拍照或录像文件的存储目录
public static String	DIRECTORY_DOWNLOADS	下载目录
public static String	DIRECTORY_MOVIES	电影目录
public static String	DIRECTORY_MUSIC	音乐目录
public static String	DIRECTORY_NOTIFICATIONS	提示音目录
public static String	DIRECTORY_PICTURES	图片目录
public static String	DIRECTORY_PODCASTS	播客目录
public static String	DIRECTORY_RINGTONES	铃声目录

表03_ Enviroment sdcard卡状态说明

Enviroment sdcard卡状态说明
状态名称	说明
MEDIA_BAD_REMOVAL	非法移除状态：移除sdcard之前，没有卸载sdcard。
MEDIA_CHECKING	检查状态：检查sdcard的有效性
MEDIA_MOUNTED	挂载状态：sdcard卡已经成功挂载。
MEDIA_MOUNTED_READ_ONLY	只读状态：sdcard已经挂载，但是是只读的。
MEDIA_NOFS	NOFS状态：识别到sdcard卡，但无法挂载。无法挂载原因，可能是sdcard无存储介质，或者sdcard卡的文件系统与android无兼容。
MEDIA_REMOVED	移除状态：sdcard成功移除。
MEDIA_SHARED	共享状态：识别到sdcard卡，但sdcard未挂载，而是作为mass storage等设备(如以u盘的方式连接到电脑上)。
MEDIA_UNMOUNTABLE	无法挂载状态：识别到sdcard卡，但无法挂载。无法挂载的原因，可能是sdcard的存储介质部分损坏。
MEDIA_UNMOUNTED	未挂载：识别到sdcard，但没有挂载。

1.2 Android Enviroment实例

AndroidManifest.xml

<?xml version="1.0"encoding="utf-8"?>
<manifestxmlns:android="http://schemas.android.com/apk/res/android"
package="com.yarin.Android.HelloAndroid"
android:versionCode="1"
android:versionName="1.0">

<!-- 往SDCard写入数据权限 -->
<uses-permissionandroid:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

<application android:icon="@drawable/icon"android:label="@string/app_name">
<activity android:name=".HelloAndroid"
android:label="@string/app_name">
<intent-filter>
<actionandroid:name="android.intent.action.MAIN" />
<categoryandroid:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
</application>
<uses-sdk android:minSdkVersion="5" />
</manifest>

HelloAndroid.java

package com.yarin.Android.HelloAndroid;

import android.app.Activity;
import android.os.Bundle;
import android.util.Log;
import java.io.*;
import android.os.Environment;

// 测试Enviroment环境变量
public class HelloAndroid extends Activity {
private static final String TAG = "skywang-->HelloAndroid";

@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);

isSdcardMounted() ;
publicDirTest() ;
enviromentAPITest() ;
}

private boolean isSdcardMounted() {
String str = Environment.getExternalStorageState();
boolean ret = Environment.MEDIA_MOUNTED.equals(str);

Log.d(TAG, "isSdcardMounted ret="+ret);

return ret;
}

private void enviromentAPITest() {

Log.d(TAG, "isExternalStorageEmulated="+Environment.isExternalStorageEmulated());
Log.d(TAG, "isExternalStorageRemovable="+Environment.isExternalStorageRemovable());

File file = null;
file = Environment.getDataDirectory();
Log.d(TAG, "getDataDirectory()="+file.getPath());

file = Environment.getExternalStorageDirectory();
Log.d(TAG, "getExternalStorageDirectory()="+file.getPath());

file = Environment.getDownloadCacheDirectory();
Log.d(TAG, "getDownloadCacheDirectory()="+file.getPath());

file = Environment.getRootDirectory();
Log.d(TAG, "getRootDirectory()="+file.getPath());
}

private void publicDirTest() {
File file = null;
file = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_NOTIFICATIONS);
Log.d(TAG, "DIRECTORY_NOTIFICATIONS="+file.getPath());

file = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_ALARMS);
Log.d(TAG, "DIRECTORY_ALARMS="+file.getPath());

file = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DCIM);
Log.d(TAG, "DIRECTORY_DCIM="+file.getPath());

file = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS);
Log.d(TAG, "DIRECTORY_DOWNLOADS="+file.getPath());

file = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_MOVIES);
Log.d(TAG, "DIRECTORY_MOVIES="+file.getPath());

file = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_MUSIC);
Log.d(TAG, "DIRECTORY_MUSIC="+file.getPath());

file = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PICTURES);
Log.d(TAG, "DIRECTORY_PICTURES="+file.getPath());

file = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PODCASTS);
Log.d(TAG, "DIRECTORY_PODCASTS="+file.getPath());

file = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_RINGTONES);
Log.d(TAG, "DIRECTORY_RINGTONES="+file.getPath());
}
}

打印结果如下：

D/skywang-->HelloAndroid( 3076):isSdcardMounted ret=true

D/skywang-->HelloAndroid( 3076):DIRECTORY_NOTIFICATIONS=/mnt/sdcard/Notifications

D/skywang-->HelloAndroid( 3076):DIRECTORY_ALARMS=/mnt/sdcard/Alarms

D/skywang-->HelloAndroid( 3076):DIRECTORY_DCIM=/mnt/sdcard/DCIM

D/skywang-->HelloAndroid( 3076):DIRECTORY_DOWNLOADS=/mnt/sdcard/Download

D/skywang-->HelloAndroid( 3076):DIRECTORY_MOVIES=/mnt/sdcard/Movies

D/skywang-->HelloAndroid( 3076):DIRECTORY_MUSIC=/mnt/sdcard/Music

D/skywang-->HelloAndroid( 3076):DIRECTORY_PICTURES=/mnt/sdcard/Pictures

D/skywang-->HelloAndroid( 3076):DIRECTORY_PODCASTS=/mnt/sdcard/Podcasts

D/skywang-->HelloAndroid( 3076):DIRECTORY_RINGTONES=/mnt/sdcard/Ringtones

D/skywang-->HelloAndroid( 3076):isExternalStorageEmulated=false

D/skywang-->HelloAndroid( 3076):isExternalStorageRemovable=false

D/skywang-->HelloAndroid( 3076):getDataDirectory()=/data

D/skywang-->HelloAndroid( 3076):getExternalStorageDirectory()=/mnt/sdcard

D/skywang-->HelloAndroid( 3076):getDownloadCacheDirectory()=/cache

D/skywang-->HelloAndroid( 3076):getRootDirectory()=/system

1.3 Java IO库读写实例

AndroidManifest.xml

<?xml version="1.0"encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.yarin.Android.HelloAndroid"
android:versionCode="1"
android:versionName="1.0">

<!-- 往SDCard写入数据权限 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

<application android:icon="@drawable/icon"android:label="@string/app_name">
<activity android:name=".HelloAndroid"
android:label="@string/app_name">
<intent-filter>
<actionandroid:name="android.intent.action.MAIN" />
<categoryandroid:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
</application>
<uses-sdk android:minSdkVersion="5" />
</manifest>

HelloAndroid.java

package com.yarin.Android.HelloAndroid;

import android.app.Activity;
import android.os.Bundle;
import android.util.Log;
import java.io.*;
import android.os.Environment;
// 通过Java IO去读写文件
public class HelloAndroid extends Activity{
privatestatic final String TAG = "skywang-->HelloAndroid";

privateFile sdcardDir = Environment.getExternalStorageDirectory();
privatestatic final String TEST_FILE_NAME = "file.txt";

@Override
publicvoid onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);

originalJavaIOWriteTest();
originalJavaIOReadTest();
}

privateboolean isSdcardMounted() {

returnEnvironment.MEDIA_MOUNTED.equals(
Environment.getExternalStorageState());
}

privatevoid originalJavaIOReadTest() {
if(!isSdcardMounted())
return;

try {
Filefile = new File(sdcardDir, TEST_FILE_NAME);
FileInputStream in =
new FileInputStream(file);
byte[] bb = new byte[64];
intlen=0;
while ((len=in.read(bb))!=-1) {
Log.d(TAG, "bb="+newString(bb, 0, len));
}
in.close();
} catch (IOException e) {
e.printStackTrace();
}
}

private void originalJavaIOWriteTest() {
if(!isSdcardMounted())
return;

try {
Filefile = new File(sdcardDir, TEST_FILE_NAME);
FileOutputStream out =
new FileOutputStream(file);
String str = "i am skywang!";

byte[] bb = str.getBytes();
for (int i=0; i<bb.length; i++)
out.write(bb[i]);
out.close();
} catch (IOException e) {
e.printStackTrace();
}
}
}

打印结果如下：

D/skywang-->HelloAndroid( 3298): bb=i am skywang!

2 通过Context提供的接口去读写

Android的Context提供了API用来读写该Activity的私有文件；默认路径是：/data/data/<包>/files/***.***

Context提供了openFileInput()、openFileOutput()、deleteFile()等操作文件。下面简要进行说明

2.1 Context接口说明

public abstract FileInputStreamopenFileInput (String name)

作 用：打开Activity的私有文件，用于读数据。

参数说明：

name —— 文件名

public abstract FileOutputStreamopenFileOutput (String name,int mode)

作 用：打开Activity的私有文件，用于写数据。

参数说明：

name —— 文件名

mode —— 写文件的方式，有一下几种值可以选择。

MODE_APPEND：将内容以追加的方式写到文件末尾。

MODE_PRIVATE：默认的方式，创建的文件只能被本Activity所访问。

MODE_WORLD_READABLE：Android API LEVEL 17以后不建议使用。

MODE_WORLD_WRITEABLE：Android API LEVEL 17以后不建议使用。

public abstract String[] fileList ()

作 用：返回Activity私有的文件名组成的列表。

参数说明：无

public abstract boolean deleteFile (String name)

作 用：删除Activity私有的文件。

参数说明：name —— 文件名

2.2 Context实例

HelloAndroid.java

package com.yarin.Android.HelloAndroid;

import android.app.Activity;
import android.os.Bundle;
import android.util.Log;
import java.io.*;
import android.os.Environment;

public class HelloAndroid extends Activity{
privatestatic final String TAG = "skywang-->HelloAndroid";

privatestatic final String TEST_FILE_NAME = "file.txt";
@Override
publicvoid onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);

//读写测试
activityFileWriteTest();
activityFileReadTest();

//列出当前文件
listActivityFiles();

//删除后再列举
Log.d(TAG,"deleteFile "+TEST_FILE_NAME);
deleteFile(TEST_FILE_NAME);
listActivityFiles();
}
//fileList接口测试
privatevoid listActivityFiles() {
String[]arrStr = fileList();
for(int i=0; i<arrStr.length; i++)
Log.d(TAG,"index="+i+", file_name ="+arrStr[i]);
}
//openFileInput接口测试
privatevoid activityFileReadTest() {
try {
FileInputStream in = openFileInput(TEST_FILE_NAME);
byte[] bb = new byte[64];
int len = in.read(bb);
Log.d(TAG,"bb="+new String(bb, 0, len));
in.close();
} catch (FileNotFoundException e) {
Log.d(TAG,"read file "+TEST_FILE_NAME+" not exist!");
} catch (IOException e){
e.printStackTrace();
}
}
//openFileOutput接口测试
privatevoid activityFileWriteTest() {
try {
FileOutputStream out =openFileOutput(TEST_FILE_NAME,MODE_WORLD_READABLE);
Stringstr = "this is a activity file test.";
out.write(str.getBytes());
out.close();
} catch (FileNotFoundException e) {
Log.d(TAG,"write file "+TEST_FILE_NAME+" not exist!");
} catch (IOException e){
e.printStackTrace();
}
}
}

打印结果如下：

D/skywang-->HelloAndroid( 3414): bb=thisis a activity file test.

D/skywang-->HelloAndroid( 3414):index=0, file_name =file.txt

D/skywang-->HelloAndroid( 3414):deleteFile file.txt

文件保存路径为：/data/data/com.yarin.Android.HelloAndroid/files/file.txt

说明：不同的实例，保存路径可能不一样！

参考文件：

1，Android API文档

2，Java API文档

3，Android实现数据存储技术：/article/4951193.html