HTML5移動應用開發3HTML5+及MUI四川大學錦城學院李勇IO模塊-基礎篇IO模塊管理本地文件系統，用于對文件系統的目錄瀏覽、文件的讀取、文件的寫入等操作。通過plus.io可獲取文件系統管理對象。常量：1、plus.io.PRIVATE_WWW應用運行資源目錄常量，僅本應用可讀。2、plus.io.PRIVATE_DOC

應用私有文檔目錄常量，僅本應用可讀、寫。3、plus.io.PUBLIC_DOCUMENTS

程序公用文檔目錄常量，所有應用可讀、寫。4、plus.io.PUBLIC_DOWNLOADS

程序公用下載目錄常量，所有應用可讀、寫。IO模塊-基礎篇方法：1、requestFileSystem(type,succesCB,errorCB):請求本地文件系統對象獲取指定的文件系統，可通過type指定獲取文件系統的類型,獲取成功通過succesCB回調返回，失敗則通過errorCB返回。演示代碼：plus.io.requestFileSystem(plus.io.PRIVATE_WWW,function(fs){mui.alert("Requestfilesystemsuccess!");},function(e){mui.alert("Requestfilesystemfailed:"+e.message);});IO模塊-基礎篇方法：2、resolveLocalFileSystemURL(url,succesCB,errorCB):通過URL參數獲取目錄對象或文件對象url值可支持相對路徑URL、本地路徑URL、網絡路徑URL。獲取成功通過succesCB回調返回，如果失敗則通過errorCB回調返回。演示代碼plus.io.resolveLocalFileSystemURL('_www/test.txt',function(entry){mui.alert(entry.fullPath);},function(e){ mui.alert("ResolvefileURLfailed:"+e.message);});IO模塊-基礎篇方法：3、convertLocalFileSystemURL(url):將本地URL路徑轉換成平臺絕對路徑URL地址必須是合法的路徑，如果地址不合法則返回null。返回值是轉換后在平臺上的路徑，在不同平臺或者不同設備返回的值可能存在差異。演示代碼：varpath=plus.io.convertLocalFileSystemURL('_www/a.txt');mui.alert(path);IO模塊-基礎篇方法：4、convertAbsoluteFileSystem(path):將平臺絕對路徑轉換成本地URL路徑功能與convertLocalFileSystemURL方法相反，將絕對路徑轉換成相對路徑。演示代碼：varpath=plus.io.convertLocalFileSystemURL('_www/a.txt');varpathNew=plus.io.convertAbsoluteFileSystem(path);mui.alert(pathNew);DirectoryEntry（文件夾及文件操作）相對路徑URL常量：1、“_www”:應用資源目錄.保存應用的所有html、css、js等資源文件，與文件系統中根目錄PRIVATE_WWW一致，后面加相對路徑如“_www/res/icon.png”。2、“_doc”:應用私有文檔目錄.用于保存應用運行期業務邏輯數據，與文件系統中根目錄PRIVATE_DOCUMENTS，如“_doc/userdata.xml”。3、“_documents”:程序公用文檔目錄.用于保存程序中各應用間可共享文件的目錄，與文件系統中根目錄PUBLIC_DOCUMENTS，如“_document/share.doc”。4、“_downloads”:程序公用下載目錄.用于保存程序下載文件的目錄，與文件系統中根目錄PUBLIC_DOWNLOADS，如“_download/mydoc.doc”。DirectoryEntry（文件夾及文件操作）屬性1、isFile:操作對象是否為文件，DirectoryEntry對象其值為falseplus.io.resolveLocalFileSystemURL('_www/test.txt',function(entry){ if(entry.isFile){mui.toast('是一個文件');} else{mui.toast('不是文件');}},function(e){ mui.toast(e.message);});DirectoryEntry（文件夾及文件操作）屬性2、isDirectory:操作對象是否為目錄，DirectoryEntry對象其值為trueplus.io.resolveLocalFileSystemURL('_www/',function(entry){ if(entry.isDirectory){mui.toast('是一個文件夾'); }else{mui.toast('不是文件夾');}},function(e){ mui.toast(e.message);});DirectoryEntry（文件夾及文件操作）屬性3、name:目錄操作對象的名稱，不包括路徑plus.io.resolveLocalFileSystemURL('_www/',function(entry){ mui.toast();},function(e){ mui.toast(e.message);});DirectoryEntry（文件夾及文件操作）屬性4、fullPath:目錄操作對象的完整路徑，文件系統的絕對路徑plus.io.resolveLocalFileSystemURL('_www/',function(entry){ mui.toast(entry.fullPath);},function(e){ mui.toast(e.message);});DirectoryEntry（文件夾及文件操作）常用方法1、

創建或打開子目錄:entry.getDirectory(path,flag,succesCB,errorCB);創建或打開目錄操作成功通過succesCB回調返回，失敗則errorCB返回。plus.io.resolveLocalFileSystemURL('_documents', function(entry){ entry.getDirectory('mytest',{create:true,exclusive:false}, function(entry1){mui.toast('創建或打開成功');}, function(){mui.toast('創建或者打開子目錄失敗');} )}, function(e){mui.toast('獲取io操作對象失敗');});DirectoryEntry（文件夾及文件操作）常用方法2、刪除目錄

entry.remove(succesCB,errorCB);以下情況刪除目錄將會導致失敗：目錄中存在文件；刪除根目錄。plus.io.resolveLocalFileSystemURL('_documents/mytest', function(entry){ entry.remove(function(){mui.toast('刪除成功');},

function(e){mui.toast(‘刪除文件失敗');}); },function(e){mui.toast('獲取io操作對象失敗');});DirectoryEntry（文件夾及文件操作）3、

創建或打開文件并獲取內容:

getFile(path,flag,succesCB,errorCB);plus.io.resolveLocalFileSystemURL('_www', function(entry){ entry.getFile('1.txt',{create:true,exclusive:false}, function(file){ varfileReader=newplus.io.FileReader(); fileReader.readAsText(file,'utf-8');fileReader.onloadend=function(evt){ mui.alert(evt.target.result);} },function(e){mui.toast('打開文件失敗');} );},function(e){mui.toast('打開文件夾_www失敗');});DirectoryEntry（文件夾及文件操作）4、FileWriter向文件寫入內容plus.io.resolveLocalFileSystemURL(‘_documents’, function(entry){entry.getFile('2.txt',{create:true,exclusive:false}, function(file){ file.createWriter(function(writer){ writer.write(‘你好！');mui.toast('寫入成功'); },function(){mui.toast('寫入失敗'); }); },function(e){mui.toast('打開文件失敗');} );},function(e){mui.toast('打開文件夾_www失敗');});5、readEntries：獲取文件列表plus.io.resolveLocalFileSystemURL(“_www”,function(fs){

vardirectoryReader=fs.root.createReader();

directoryReader.readEntries(function(entries){

vari;

varstr=“文件列表：\n”;

for(i=0;i<entries.length;i++){

str+=entries[i].name+“\n”;

}

mui.alert(str);

},function(e){

mui.alert("Readentriesfailed:"+e.message);

});});DirectoryEntry（文件夾及文件操作）課堂練習：1、點擊創建按鈕彈出對話框，輸入文件名，確認后在指定目錄下創建新文件；失敗顯示提示信息；2、點擊寫入文件按鈕彈出對話框，輸入文件名，確認后打開對應文件并寫入內容；失敗顯示提示信息；3、點擊打開文件按鈕彈出對話框，輸入文件名，確認后打開對應文件讀取文件內容，顯示在對話框中；失敗顯示提示信息；downloader文件下載模塊Downloader模塊管理網絡文件下載任務，用于從服務器下載各種文件，并支持跨域訪問操作。通過plus.downloader獲取下載管理對象。Downloader下載使用HTTP的GET/POST方式請求下載文件，符合標準HTTP/HTTPS傳輸協議。plus.downloader.createDownload(url,options,completedCB);參數：url:(String)要下載文件的url地址，僅支持網絡資源地址。options:可選下載任務的參數，可通過此參數設置下載任務屬性，如保存文件路徑、下載優先級等。completedCB：可選下載任務完成回調函數，當下載任務下載完成時觸發，成功或失敗都會觸發。返回值：Download:新建的下載任務對象核心代碼1：functioncreateDownload(){ vardtask=plus.downloader.createDownload("/a.doc",{}, funct