AIR使用文件对象操作文件和目录

文件对象是啥？
文件对象(File对象)是在文件系统中指向文件或目录的指针。由于安全原因，只在AIR中可用。

文件对象能做啥？

1. 获取特定目录，包括用户目录、用户文档目录、该应用程序启动的目录和程序目录
2. 拷贝文件和目录
3. 移动文件和目录
4. 删除文件和目录（或移至回收站）
5. 列出某目录中的文件和目录
6. 创建临时文件和文件夹
7. 创建目录
8. 读取文件信息
9. 获取文件系统信息

在AIR中，我们用FileStream读写文件的前提就是用File对象来指向文件。

那么文件对象具体怎么玩呢？

功能1、指向目录和文件
File对象有两个属性都能定义文件路径，它们是nativePath和url。nativePath是在特定平台使用的文件路径（主要就是Windows和MacOs上的路径表示不同），url则是统一的”file:///c:/Sample%20directory/test.txt”这样的表示方法。

我们来看几个指向目录的实例，其中1－7演示了如何获取特殊目录：

1. AS3代码
   1. var file:File = File.userDirectory; //指向用户文件夹
   2. var file:File = File.documentsDirectory; //指向用户文档文件夹
   3. var file:File = File.desktopDirectory; //指向桌面
   4. var file:File = File.applicationStorageDirectory; //指向应用程序存储目录
   5. （参见AIR的URL方案）
   6. var dir:File = File.applicationDirectory; //应用程序安装目录
   7. var dir:File = File.getRootDirectories(); //文件系统根目录

2. 还有一招，指向请求启动该应用程序的目录，先空着，以后补上。参考资料见《Capturing command
   line arguments》
3. AS3代码
   1. var file:File = new File();
   2. file.nativePath = "C://Mousebomb//";
   3. //(windows平台)指向一个具体的目录，这里使用了nativePath属性，”C://Mousebomb//”只适用windows中。

4. AS3代码
   1. var file:File = File.userDirectory;
   2. file = file.resolvePath(”Mousebomb”);
   3. //跳转到用户目录下的Mousebomb目录
   4. var urlStr:String = "file:///C:/Mousebomb/";
   5. var file:File = new File()
   6. file.url = urlStr;
   7. //指向c盘下的Mousebomb目录，这里使用了url属性
   8. /*让用户选择目录*/
   9. var file:File = new File();
   10. file.addEventListener(Event.SELECT, dirSelected);
   11. file.browseForDirectory("Select a directory");
   12. function dirSelected(e:Event):void {
   13. trace(file.nativePath);
   14. }

下面看看指向文件的实例：

1. 指向明确的文件地址：

   AS3代码

   1. var file:File = File.applicationStorageDirectory;
   2. file = file.resolvePath("Flashj.txt");
2. 使用url属性的例子：

   AS3代码

   1. var urlStr:String = "file:///C:/Mousebomb/Flashj.txt";
   2. var file:File = new File()
   3. file.url = urlStr;
3. 当然你也可以直接这样写

   AS3代码

   1. var urlStr:String = "file:///C: /Mousebomb/Flashj.txt";
   2. var file:File = new File(urlStr);
   3. //url中的空格会被%20替换
4. 使用nativePath属性：

   AS3代码

   1. var file:File = new File();
   2. file.nativePath = "C:/ Mousebomb/Flashj.txt";
5. 或者

   AS3代码

   1. var file:File = new File("C:/ Mousebomb/Flashj.txt");
   2. //(Windows下)
6. 通过对话框让用户选择文件
   实现这个功能需要认识三个方法：
   browseForOpen()
   browseForSave()
   browseForOpenMultiple()
   三个方法都是异步的，browseForOpen() 和 browseForSave()方法在用户选择文件时会触发select事件，在选择了某文件时，File指向选择的文件。 而browseForOpenMultiple()方法会触发selectMultiple事件，该事件属于FileListEvent型，它的属性中具有指向所选文件的File对象数组。
   例子：

   AS3代码

   1. var fileToOpen:File = File.documentsDirectory;
   2. selectTextFile(fileToOpen);
   3. function selectTextFile(root:File):void
   4. {
   5. var txtFilter:FileFilter = new FileFilter("Text", "*.as;*.css;*.html;*.txt;*.xml");
   6. root.browseForOpen("Open", [txtFilter]);
   7. root.addEventListener(Event.SELECT, fileSelected);
   8. }
   9. function fileSelected(event:Event):void
   10. {
   11. trace(fileToOpen.nativePath);
   12. }

功能2、拷贝文件和目录
拷贝文件使用到的方法有copyTo()和copyToAsync()，详见AIR文件基础，前者为同步方法，后者为异步方法。
要拷贝文件，需要创建2个File对象，一个指向原文件，一个指向目标文件。像下面两例：
1.同步拷贝例：

AS3代码

1. var original:File = File.documentsDirectory.resolvePath("Mousebomb/FlashJ.txt");
2. var newFile:File = File.resolvePath("Mousebomb/FlashJcn.txt");
3. original.copyTo(newFile, true);

第二个参数true表示覆盖存在的文件，默认值是false，若设置为false，而拷贝的目标文件已经存在，则AIR会发出IOErrorEvent事件。
2.异步拷贝例：

AS3代码

1. var original = File.documentsDirectory;
2. original = original.resolvePath("Mousebomb/FlashJ.txt");
3. var destination:File = File.documentsDirectory;
4. destination = destination.resolvePath("FlashJ/FlashJcn.txt");
5. original.addEventListener(Event.COMPLETE, fileCopyCompleteHandler);
6. original.addEventListener(IOErrorEvent.IO_ERROR, fileCopyIOErrorEventHandler);
7. original.CopyToAsync(destination);
8. function fileCopyCompleteHandler(event:Event):void {
9. trace(event.target); // [object File]
10. }
11. function fileCopyIOErrorEventHandler(event:IOErrorEvent):void {
12. trace("I/O Error.");
13. }

功能3、移动文件和目录
移动文件使用的方法有moveTo()和MoveToAsync()，不仅长相类似，连使用方法都与拷贝文件一样，可以直接参考上文。

功能4、删除文件和目录（或移至回收站）
deleteFile()和deleteFileAsync()负责删除功能，而moveToTrash()和moveToTrashAsync()功能是移至回收站。先创建一个File对象指向某个文件或目录，然后执行四个方法之一，处理异步方法要加事件监听。

AS3代码

1. var file:File = File.documentsDirectory.resolvePath("DeleteMe.txt");
2. file.moveToTrash();

功能5、列出某目录中的文件和目录
可以使用getDirectoryListing()方法和getDirectoryListingAsync()方法获取某个目录下文件与子目录的File指针数组。
例如：

AS3代码

1. var directory:File = File.documentsDirectory;
2. var contents:Array = directory.getDirectoryListing();
3. for (var i:uint = 0; i < contents.length; i++)
4. {
5. trace(contents[i].name, contents[i].size);
6. }

本例输出了用户文档目录中的文件名和大小。
若使用异步方法，例如：

AS3代码

1. var directory:File = File.documentsDirectory;
2. directory.getDirectoryListingAsync();
3. directory.addEventListener(FileListEvent.DIRECTORY_LISTING, dirListHandler);
4. function dirListHandler(event:FileListEvent):void
5. {
6. var contents:Array = event.files;
7. for (var i:uint = 0; i < contents.length; i++)
8. {
9. trace(contents[i].name, contents[i].size);
10. }
11. }

其中directoryListing事件对象中有个files属性，为目录下内容的File指针数组。

功能6、创建临时文件和文件夹
使用createTempFile()和createTempDirectory()方法可以创建临时文件和文件夹。
var temp:File = File.createTempFile(); //在系统临时文件夹下创建临时文件
createTempFile()方法会自动创建一个唯一的临时文件。
createTempDirectory ()方法会自动创建一个唯一的临时文件夹。
你可以用临时文件来临时存储应用程序回话中的信息。
由于临时文件不会自动删除，所以你可能得让应用程序在关闭前删除它。

功能7、创建目录
使用createDirectory()方法可以创建目录，例如：

AS3代码

1. var dir:File = File.userDirectory.resolvePath("Mousebomb");
2. dir.createDirectory();

这个例子在用户文件夹下创建了Mousebomb目录，如果Mousebomb目录存在，则不会作出操作。

功能8、读取文件信息
File类中包含以下属性，提供File对象所指向文件或目录的信息。

详细参见AIR ActionScript. 3.0 Language Reference for Adobe AIR.

功能9、获取文件系统信息
File类包含一下静态属性，提供有用的文件系统信息（主要是跨平台使用）：