本节书摘来异步社区《OpenGL ES 3.x游戏开发（上卷）》一书中的第2章，第2.4节，作者： 吴亚峰 责编： 张涛，更多章节内容可以访问云栖社区“异步社区”公众号查看。
2.4 文件I/O
I/O即输入与输出，几乎所有文件操作的工作都离不开I/O。对于Android游戏开发来说，I/O操作尤为重要，游戏中的地图数据、人物图片资源等的流畅读取是保证游戏可玩性的重要方面。因此，在开发时，不同的场合必须选用合适的I/O操作方式，才能保证满足用户的需求。
Android中文件I/O分为3种方式：SD卡文件读取、手机中文件夹的访问和应用程序中assets文件的读取，本节将结合简单的小案例对这几种文件I/O操作进行介绍。
2.4.1 访问SD卡中的文件
伴随着游戏品质的不断提高，游戏数据占用的存储空间也成几何级数增加，以往几十KB、几MB的手机游戏已经发展为几十MB、几百MB甚至几个GB的大型手机游戏。为了适应存储需求的增长，SD卡也一直在进行更新换代，4GB、8GB、16GB大小的SD卡已随处可见。
Android的设计者自然不会忽略这一点，在Android平台上可以轻松地对手机SD卡中的文件进行读取和操作。下面通过一个案例来详细讲解在Android开发中如何访问SD卡中的文件。
1．案例的运行效果
运行本节案例Sample2_5，在输入框中输入要读取的文件名，然后单击“打开文件”按钮。若SD卡中存在该文本文件，则在文本区域显示出文件的内容，反之则提示没有找到指定文件。本案例的运行效果如图2-15和图2-16所示。
提示
运行本案例时要注意SD卡中文本文件的编码格式，在Android系统中一般要采用UTF-8编码才能保证没有乱码出现。编码格式为UTF-8的文本文件，见随书中源代码/第2章目录下的AndroidIO.txt，读者可以将该文件导入到手机或模拟器的SD卡中再对本案例进行测试。
2．案例的开发
介绍完本案例的运行效果以及文本文件编码的注意事项后，接下来将对本案例的主控制类Sample2_5_Activity进行开发，其代码如下。
1 package com/bn/pp5;
2 import java.io.File; //引入相关包
3 public class Sample2_5_Activity extends Activity { //创建Activity
4 @Override
5 public void onCreate(Bundle savedInstanceState) { //重写onCreate方法
6 super.onCreate(savedInstanceState);
7 setContentView(R.layout.main); //跳转到主界面
8 Button ok=(Button)this.findViewById(R.id.Button01);//获取打开按钮的引用
9 ok.setOnClickListener( //为打开按钮添加监听器
10 new OnClickListener(){
11 public void onClick(View v) {
12 EditText et1=(EditText)findViewById(R.id.EditText01);
13 String nr=loadText(et1.getText().toString().trim());
14 EditText et2=(EditText)findViewById(R.id.EditText02);
15 et2.setText(nr); //设置显示框内容
16 }});}
17 public String loadText(String name){ //加载SD卡文件方法
18 String nr=null; //内容字符串
19 try{
20 File f=new File("/sdcard/"+name); //创建对应文件
21 byte[] buff=new byte[(int) f.length()]; //创建响应大小的byte数组
22 FileInputStream fis=new FileInputStream(f);
23 fis.read(buff); //读入文件
24 fis.close(); //关闭输入流
25 nr=new String(buff,"utf-8"); //转码生成字符串
26 nr=nr.replaceAll("\\r\\n","\n"); //替换换行符
27 }catch (Exception e) {
28 Toast.makeText(getBaseContext(), //Toast提示用户
29 "对不起，没有找到指定文件。",
30 Toast.LENGTH_LONG).show();
31 }
32 return nr; //返回内容字符串
33 }}
- 第8-16行是为打开文件的按钮添加监听器，监听器的功能为首先获取文本框中用户输入的文件名，然后调用从SD卡加载文本文件的方法，获取SD卡中的对应文件内容并送入EditText控件显示。
- 第17-32行为加载SD卡中文本文件的方法，其入口参数为要加载文件的文件名。工作过程为首先用Java 标准的I/O操作来加载指定文本文件中的数据，然后将数据编码为字符串，并替换换行符等空白字符，最后返回加载的内容。
提示
通过上面的小案例可以看出，Android中对SD卡文件的I/O实现与标准Java相同，因此，开发成本很低，易于上手。
2.4.2 访问手机中的文件夹
前一小节中是将文件存放到SD卡中，其实文件也可以存放在手机内部存储（ROM，相当于PC的硬盘）中。不过在Android系统中，其为每个应用程序在手机的ROM中都分配了一个私有的目录，命名规则为“/data/data/<应用程序的包名>”。例如，应用程序的包名为“com.bn”，则系统分配的私有目录为“/data/data/com.bn”。
应用程序开发时，若需要在ROM中存放文件，一般应该存放到系统分配的私有目录中。启动Eclipse，进入其中的DDMS面板，打开File Explorer，即可查看手机ROM中的文件组织情况，如图2-17所示。
下面给出一个浏览手机ROM中文件夹的小案例，通过单击文件夹的名称，可以打开相应的文件夹，显示其中的文件列表。运行本案例，其运行效果如图2-18、图2-19和图2-20所示。
提示
图2-18为程序一开始运行，显示“/”目录下内容的情况。图2-19为单击进入了dev目录，图2-20为单击了不允许进入或不是文件夹的条目。
了解了本案例的运行效果之后，接下来对本案例中唯一的类——Sample2_6_Activity进行开发，具体代码如下。
1 package com.bn.pp6; //声明包
2 import java.io.File; //引入相关类
3 ……//此处省略了部分类的引入代码，读者可自行查看随书的源代码
4 import android.widget.AdapterView.OnItemClickListener; //引入相关类
5 public class Sample2_6_Activity extends Activity { //创建Activity
6 String currPath; //当前路径字符串
7 String rootPath = "/"; //根目录路径
8 TextView currDirTV; //显示当前路径的TextView引用
9 @Override
10 public void onCreate(Bundle savedInstanceState) {
11 super.onCreate(savedInstanceState);
12 setContentView(R.layout.main); //跳转到主界面
13 final ListView lv = (ListView) this.findViewById(R.id.lv);//获取ListView
14 Button back = (Button) this.findViewById(R.id.back); //获取返回按钮
15 final File[] files = getFiles(rootPath);
//调用getFiles方法获取根目录下文件列表
16 currDirTV = (TextView) this.findViewById(R.id.currDirTV); //获取ListView
17 currPath = rootPath;
18 currDirTV.setText("当前路径：" + currPath); //设置当前路径
19 initListView(files, lv); //初始化显示列表
20 back.setOnClickListener //返回按钮监听器
21 (new OnClickListener() {
22 @Override
23 public void onClick(View v) {
24 if (!currPath.equals(rootPath)) {
//若当前路径不是根目录，返回到上一层目录
25 File f = new File(currPath); //获取当前路径下的文件列表
26 f = f.getParentFile(); //获取当前路径的上层路径
27 currPath = f.getPath(); //更改当前路径
28 currDirTV.setText("当前路径：" + currPath);//设置当前路径
29 initListView(getFiles(currPath), lv); //初始化显示列表
30 }}});}
31 //获取当前目录下的文件列表的方法
32 public File[] getFiles(String filePath) {
33 File[] files = new File(filePath).listFiles();//获取当前目录下的文件列表
34 return files; //返回文件列表
35 }
36 ……//此处省略了初始化ListView的方法，读者可以自行查阅随书中的源代码
37 }
- 第9-30行为案例整体功能的实现代码。程序运行时，首先调用initListView方法初始化文件显示列表，显示根目录下的文件情况。然后给“返回上一层”按钮添加了监听器，监听器功能为若存在上一层目录，则刷新文件显示列表为上一层目录下的情况。
- 第32-35行为获取当前路径下所有文件列表的方法。该方法中首先需要获得当前路径对应的File对象，之后返回其下对应的文件列表。
提示
由于篇幅所限，初始化文件列表的代码省略，有需要的读者请自行查阅中的源代码进行学习。
2.4.3 读取assets文件夹下的内容
Android还能将应用程序所需的数据文件打包到apk文件中，省去了使用者安装应用程序后还需要下载数据包的情况。但是要注意的是，打包到apk文件中的数据文件并不是可以放在任何位置，一般应该放到项目中的assets文件夹下。
提示
对于特别大（如50MB）的数据文件，在实际开发中一般还是与apk安装文件分开的。对于不大的数据文件，就非常适合打包到apk包中的assets文件夹下。
下面将通过一个小案例来说明如何编程访问assets文件夹下的内容，其主要功能是完成对应用程序内部的assets文件夹下文件的读取。操作过程为首先在案例初始界面输入文件名，然后单击打开按钮。若存在该文件，则在下方显示出文件内容；反之，则弹出Toast提示用户重新输入。案例运行效果如图2-21和图2-22所示。
了解了本案例的功能后，下面来介绍本案例的开发过程，具体步骤如下。
（1）首先将AndroidIO.txt文本文件复制到项目中的assets文件夹中，如图2-23所示。
（2）将AndroidIO.txt文本文件复制到项目中的assets文件夹后，接下来将开发本案例中唯一的类Sample2_7_Activity，其代码如下。
1 package com.bn.pp7;
2 import java.io.ByteArrayOutputStream; //引入相关包
3 public class Sample2_7_Activity extends Activity { //创建Activity
4 @Override
5 public void onCreate(Bundle savedInstanceState) { //重写onCreate方法
6 super.onCreate(savedInstanceState);
7 setContentView(R.layout.main); //跳转至主界面
8 Button ok=(Button)this.findViewById(R.id.Button01); //获取打开按钮引用
9 ok.setOnClickListener( //为打开按钮添加监听器
10 new OnClickListener() {
11 public void onClick(View v) {
12 EditText et1=(EditText)findViewById(R.id.EditText01);
13 //调用loadText方法获取对应文件名的文件
14 String nr=loadText(et1.getText().toString().trim());
15 EditText et2=(EditText)findViewById(R.id.EditText02);
16 et2.setText(nr); //设置显示框内容
17 }});}
18 public String loadText(String name){ //加载assets文件方法
19 String nr=null; //内容字符串
20 try { //打开对应名称文件的输入流
21 InputStream is=this.getResources().getAssets().open(name);
22 int ch=0;
23 //创建字节数组输出流
24 ByteArrayOutputStream baos=new ByteArrayOutputStream();
25 while((ch=is.read())!=-1){baos.write(ch);} //读取文件
26 byte[] buff=baos.toByteArray(); //转化为字节数组
27 baos.close(); //关闭输入输出流
28 is.close(); //关闭输入输出流
29 nr=new String(buff,"utf-8"); //转码生成新字符串
30 nr=nr.replaceAll("\\r\\n","\n"); //替换换行符等空白字符
31 } catch (Exception e) { //没有找到对应文件，进行提示
32 Toast.makeText(getBaseContext(), "对不起，没有找到指定文件。",
33 Toast.LENGTH_LONG).show();
34 }
35 return nr; //返回内容字符串
36 }}
- 第8-17行首先获取了打开按钮的引用，然后给此按钮添加了监听器。监听器的功能为读取用户输入名称的文件内容，并显示到界面上。
- 第18-36行为从assets中加载指定名称文本文件的方法，其首先获取了指向指定文件的输入流，然后从输入流中读取数据，接着将数据编码为字符串，并替换换行符等空白字符，最后返回加载的内容。
提示
通过上述案例的介绍，相信读者对Android平台下文件的存储和读取已经有所掌握。在真正的开发过程中，开发人员应该考虑各方面的因素，在需要时采用最适合自己的存储方式进行存储。
