23.1.下載文件

2024-04-27 13:46:58

字體：大中小

來源：轉載

供稿：網(wǎng)友

問題
我想讓用戶從服務器上下載文件
解決辦法
使用FileReference 對象的download( ) 方法
討論
flash.net.FileReference 類定義了一個download( ) 方法允許用戶通過URL下載文件。當Flash播放器調用download( )方法時，它試圖打開一個對話框，標題為"Select location for download."，這個對話框使用標準的系統(tǒng)對話框讓用戶選擇文件保存路徑。

在調用download( )方法之前，先構造一個FileReference 對象，如：

-ActionScript

var fileReference:FileReference = new FileReference( );

download( ) 方法至少需要一個URLRequest 對象作為參數(shù)，指定下載文件的路徑，下面的例子打開保存對話框保存下載的example.txt 文件：

-ActionScript

var urlRequest:URLRequest = new URLRequest("example.txt");
fileReference.download(urlRequest);

文件路徑還可以是絕對路徑：

-ActionScript

var urlRequest:URLRequest = new URLRequest("http://www.myexamplesite.com/example.txt");
fileReference.download(urlRequest);

保存對話框允許對下載的文件進行重命名，默認是與服務器文件的名稱相同，如上面的例子，

保存對話框顯示的名稱為example.txt。但在大多數(shù)情況下，我們喜歡重命名文件，比如一個有服務端腳本產生的靜態(tài)文件采用統(tǒng)一的命名規(guī)則進行命名(如R7AS82892KHWI014.jpg) 可能它不會顯示出這個名字，因為這是由服務端腳本動態(tài)生成，如果URLRequest對象指向這個腳本那么保存對話框顯示的可能就是腳本的名字(如., script.cgi)，這樣很不友好，也將導致文件無法被系統(tǒng)識別，因為文件擴展名并不正確。

download( ) 方法的第二個參數(shù)就是指定顯示在保存對話框的文件名，下面的例子演示用戶下載一個動態(tài)生成的圖片文件，默認的文件名為(script.cgi)，這里指定保存的文件名為example.jpg：

-ActionScript

var urlRequest:URLRequest = new URLRequest("script.cgi");
fileReference.download(urlRequest, "example.jpg");

download( ) 方法最好放在try...catch 語句中執(zhí)行，因為該方法可能會拋出異常，主要兩種異常：
IllegalOperationError和SecurityError。當保存對話框已經(jīng)打開的情況下調用download( )方法會拋出IllegalOperationError，SecurityError異常是由于SWF不允許下載所導致。

-ActionScript

try {
fileReference.download(urlRequest, fileName);
}
catch (illegalOperation:IllegalOperationError) {
// code to handle an illegal operation error
}
catch (security:SecurityError) {
// code to handle a security error
}

還有些不太常見的異常，如ArgumentError和MemoryError。ArgumentError是由于URLRequest 的data屬性不是URLVariables。雖然URLRequest的data屬性可設置為二進制數(shù)組，但是download( )方法只有在data屬性為URLVariables時才有效。memory 異常比較少見，有兩種可能會導致此異常：當URLRequest設置為GET請求而且System.useCodePage為true，F(xiàn)lash播放器將不能把Unicode轉換到字節(jié)字符格式，還有可能就是Flash播放器沒有足夠的內存打開保存對話框。

像SecurityErrorEvent 和IOErrorEvent. 異常必須監(jiān)聽異常處理函數(shù)，如下面的例子為IOErrorEvent添加處理函數(shù)：

-ActionScript

fileReference.addEventListener(IOErrorEvent.IO_ERROR, onIOError);

上一篇：22.3.從HTML中傳遞參數(shù)給Flash

下一篇：23.0.簡介