快速上手例:

例1.讀xml

1. vartestXML:XML;
2. varfile:File = File.documentsDirectory.resolvePath("Mousebomb/test.xml");
3. varfileStream:FileStream = newFileStream();
4. fileStream.open(file, FileMode.READ);
5. testXML = XML(fileStream.readUTFBytes(fileStream.bytesAvailable));
6. fileStream.close();

例中使用readUTFBytes()方法讀取內容並轉換為XML物件。

例2.寫xml

1. vartestXML:XML =<mousebomb><site>www.mousebomb.org</site><blog>www.flashj.cn</blog></mousebomb>;
2. var file:File = File.documentsDirectory.resolvePath("Mousebomb/test.xml");
3. var fileStream:FileStream = new FileStream();
4. fileStream.open(file, FileMode.WRITE);
5. var outputString:String = '<?xml version=
   "1.0" encoding="utf-8"?>\n';
6. outputString += testXML.toXMLString();
7. fileStream.writeUTFBytes(outputString);
8. fileStream.close();

寫XML也一樣簡單，建立File物件和FileStream物件，使用writeUTFBytes()寫入資料。

工作流程

要完成讀寫檔案操作無非就是這幾步：
1. 建立File物件指向檔案路徑
2. 初始化FileStream物件
3. 使用FileStream的open()或openAsync()方法
4. 若使用的是非同步的openAsync()方法則需要為FileStream設定事件監聽
5. 加入所需的讀寫資料程式碼
6. 完成檔案操作後執行FileStream的close()方法

使用FileStream要了解的知識

1. FileMode
FileStream的open()和openAsync()方法都包含一個fileMode引數，該引數用於設定：

• 讀取檔案能力
• 寫入檔案能力
• 是否總在檔案末尾追加資料（寫資料時）
• 檔案不存在時如何操作（或檔案的父級不存在時）

具體值包括

2. position
該屬性決定下一個資料讀寫操作進行的位置。
在讀寫操作前，設定position屬性為檔案中的有效位置，比如：

1. varmyFile:File = File.documentsDirectory.resolvePath("Mousebomb/site.txt");
2. varmyFileStream:FileStream = newFileStream();
3. myFileStream.open(myFile, FileMode.UPDATE);
4. myFileStream.position = 8;
5. myFileStream.writeUTFBytes("hello");

該例在位置8處寫入UTF編碼的字串“hello”

新開啟的FileStream物件的position值為0，在讀檔案操作前，position的值必最小為0並小於檔案總位元組數。
position的值僅會在以下情況下改變：

1. 直接設定該屬性值
2. 執行讀取操作
3. 執行寫入操作

當執行讀/寫操作時，position的值會立即自增讀/寫的位元組數，再次執行讀/寫操作時會從新的position位置開始:

1. varmyFile:File = File.documentsDirectory.resolvePath("Mousebomb/test.txt");
2. varmyFileStream:FileStream = newFileStream();
3. myFileStream.open(myFile, FileMode.UPDATE);
4. myFileStream.position = 4000;
5. trace(myFileStream.position); // 4000
6. myFileStream.writeBytes(myByteArray, 0, 200);
7. trace(myFileStream.position); // 4200

position有一個例外：若檔案開啟模式設定為append（追加模式），則position屬性不會隨著寫操作變化。在追加模式下，資料總是往檔案末尾寫，與position無關。

非同步方式開啟檔案，寫資料操作在下一行程式碼執行時並沒有結束。這怎麼辦呢？沒關係，你可以按順序的呼叫多個非同步操作，AIR執行環境會逐個執行:

1. varmyFile:File = File.documentsDirectory.resolvePath("Mousebomb/test.txt");
2. varmyFileStream:FileStream = newFileStream();
3. myFileStream.openAsync(myFile, FileMode.WRITE);
4. myFileStream.writeUTFBytes("hello");
5. myFileStream.writeUTFBytes("world");
6. myFileStream.addEventListener(Event.CLOSE, closeHandler);
7. myFileStream.close();
8. trace("started.");
9. closeHandler(event:Event):void
10. {
11. trace("finished.");
12. }

該例會輸出：
started.
finished.

你可以在非同步讀寫操作呼叫後，立即設定position的值，下次讀寫操作將換作從那個位置開始。比如：

1. varmyFile:File = File.documentsDirectory.resolvePath("Mousebomb/test.txt");
2. varmyFileStream:FileStream = newFileStream();
3. myFileStream.openAsync(myFile, FileMode.UPDATE);
4. myFileStream.position = 4000;
5. trace(myFileStream.position); // 4000
6. myFileStream.writeBytes(myByteArray, 0, 200);
7. myFileStream.position = 300;
8. trace(myFileStream.position); // 300

3. 根據資料格式，選擇合適的讀寫操作
硬碟上的每個檔案都是位元組集合。在AS中，檔案中的資料總是可以描述為ByteArray.比如下面的程式碼把檔案資料讀取到bytes這個ByteArray中：

1. varmyFile:File = File.documentsDirectory.resolvePath("Mousebomb/test.txt");
2. varmyFileStream:FileStream = newFileStream();
3. myFileStream.addEventListener(Event.COMPLETE, completed);
4. myFileStream.openAsync(myFile, FileMode.READ);
5. varbytes:ByteArray = newByteArray();
6. functioncompleteHandler(event:Event):void
7. {
8. myFileStream.readBytes(bytes, 0, myFileStream.bytesAvailable);
9. }

下面的程式碼把資料從bytes這個ByteArray中寫入檔案：

1. varmyFile:File = File.documentsDirectory.resolvePath("Mousebomb/test.txt");
2. varmyFileStream:FileStream = newFileStream();
3. myFileStream.open(myFile, FileMode.WRITE);
4. myFileStream.writeBytes(bytes, 0, bytes.length);

往往我們並不希望把資料作ByteArray處理，有時候要處理的檔案是特定格式，比如檔案中的資料是字串。因此FileStream類也包含ByteArray以外的資料格式讀寫方法，比如readMultiByte()方法，可將檔案讀取暫存為字串，如下程式碼：

1. varmyFile:File = File.documentsDirectory.resolvePath("Mousebomb/test.txt");
2. varmyFileStream:FileStream = newFileStream();
3. myFileStream.addEventListener(Event.COMPLETE, completed);
4. myFileStream.openAsync(myFile, FileMode.READ);
5. varstr:String = "";
6. functioncompleteHandler(event:Event):void
7. {
8. str = myFileStream.readMultiByte(myFileStream.bytesAvailable, "iso-8859-1");
9. }

FileStream 類還具有readUTFBytes()方法，從讀快取中以UTF－8字符集讀取資料。由於UTF8字符集為可變長，讀快取末尾資料並不一定是完整字元，所以不要在處理progress 事件的方法中使用readUTFBytes()方法（用readMultiByte()讀取可變長字元編碼也應遵循此項），而應在FileStream的complete事件發生時讀取完整資料集。

同樣，有類似的寫操作writeMultiByte()和writeUTFBytes()，用來處理字串物件和文字檔案。

readUTF()和writeUTF()方法同樣是讀寫文字資料，不過它們假定文字資料在指定文字資料長度之前，該文字資料是不在標準文字檔案裡普遍應用的。
有些UTF編碼文字檔案以一個UTF-BOM(Byte Order Mark)字元開頭，像編碼格式(如UTF16和UTF32)一樣，也宣告位元組序。

readObject() 和writeObject()方法便於為複雜AS物件存取資料，資料作AMF(ActionScript. Message Format)編碼，此格式為ActionScript私有，AIR、Flash Player、Flash Media Server、Flex Data Services以外的程式都沒有操作該格式的內建API。
此外還有一些讀寫操作，像readDouble()和writeDouble()之類的，使用它們需確保所操作檔案格式與之對應。

一般的檔案結構往往比文字檔案要複雜的多。比如mp3檔案包含只能被mp3解壓解碼演算法解釋的壓縮資料格式。其他檔案，像圖片、資料庫、應用程式檔案等等都有不同的結構，要想用AS操作它們的資料，得對其結構十分了解。

至此，學習筆記《AIR檔案操作》結束。