DIV CSS 佈局教程網

 DIV+CSS佈局教程網 >> 網頁腳本 >> HTML基礎知識 >> HTML5詳解 >> 基於HTML5 FileSystem API的使用介紹
基於HTML5 FileSystem API的使用介紹
編輯:HTML5詳解     

Html5的強大之一就是允許web程序申請一些臨時或者永久的空間(Quota)在這裡可以進行 數據的存儲甚至文件的操作。

FileSystem提供了文件夾和文件的創建、移動、刪除等操作,大大方便了數據的本地處理, 而且所有的數據都是在沙盒(sandboxed)中,不同的web程序不能互相訪問,這就保證了數據 的完整和安全。

在CatWrite項目中,運用了Html5的這個特性進行數據的存儲,很是方便,只是目前來說只有 Chrome浏覽器對FileSystem API支持的比較好,所以只能運行在Chrome浏覽器中。

在完成這個功能的時候,查閱了很多資料,有一些資料是一年前的,但是隨著浏覽器版本的 變化,一些代碼已經老化,在這裡一一總結和整理。這裡只列舉了項目中用到的API,算是 對完成功能的一次梳理。

申請空間
為了進行數據的存儲,必須要向浏覽器進行申請,如果是永久存儲還會向用戶進行詢問,只有 同意後才會繼續執行。

首先必須要聲明想要的權限。

復制代碼代碼如下:
window.requestFileSystem = window.requestFileSystem || window.webkitRequestFileSystem; //文件系統請求標識 
window.resolveLocalFileSystemURL = window.resolveLocalFileSystemURL || window.webkitResolveLocalFileSystemURL; //根據URL取得文件的讀取權限 

得到系統的權限後就可以向浏覽器申請空間

復制代碼代碼如下:
window.requestFileSystem(window.PERSISTENT, //persistent(永久) or temporary(臨時) 
1024*1024, //1M 
onInitFs, //成功後的回調函數 
errorHandler); //錯誤後的回調函數

回調函數

復制代碼代碼如下:
function onInitFs(fs){ 
fs.root.getDirectory('catwrite_documents', {create: true}, function(dirEntry) { 
console.log('You have just created the ' + dirEntry.name + ' directory.'); 
}, errorHandler); 

//錯誤回調 
function errorHandler(err){ 
var msg = 'An error occured: '; 
switch (err.code) { 
case FileError.NOT_FOUND_ERR: 
msg += 'File or directory not found'; 
break; 
case FileError.NOT_READABLE_ERR: 
msg += 'File or directory not readable'; 
break; 
case FileError.PATH_EXISTS_ERR: 
msg += 'File or directory already exists'; 
break; 
case FileError.TYPE_MISMATCH_ERR: 
msg += 'Invalid filetype'; 
break; 
default: 
msg += 'Unknown Error'; 
break; 
}; 
console.log(msg + err); 
}

如果成功後悔調用OnInitFs回調函數,在裡面用了getDirectory方法用來創建一個文件夾,這下面再說。

但是這是有個問題,這樣做的話每次加載頁面都會申請,這肯定不是我們想要的,我們要 的是在有數據的時候就可以讀取數據。

判斷是否申請過空間
所以我們需要讀取浏覽器的數據,看看是否已有存儲。這就用到了另一個API:

復制代碼代碼如下:
void queryUsageAndQuota( 
in DOMString url, 
in EntryCallback successCallback, 
in optional ErrorCallback errorCallback 
); 

這個API可以查詢當前web的空間情況,如果成功的話就會調用successCallback回調函數 並把已用空間和全部空間作為參數傳入方法中。如果失敗則調去errorCallback。

復制代碼代碼如下:
window.webkitStorageInfo.queryUsageAndQuota(webkitStorageInfo.PERSISTENT, 
function(used, remaining){ 
if(remaining == ""){ 
console.log("未申請空間。"); 
}else{ 
console.log("已使用空間"+used); 
console.log("全部空間"+remaining); 

}, 
errorHandler); </p><p>
我們可以通過判斷remaining參數來判斷是否有申請空間,如果沒有申請,則返回上一步申請空間。 如果已經有空間的話,則需要得到空間的跟文件,這樣才能操作數據。

獲取文件入口
FileSystem使用了特殊的文件系統和沙盒模式,在電腦上或者其他web中是無法訪問沙盒中的文件的 ,只能用對應的格式去訪問。

在浏覽器中輸入:

?filesystem:http://catcoder.com/persistent/ 
  

這樣可以訪問catcoder.com這個網站在本機永久數據,把persistent換成temporary則是讀取臨時空間。

然後我們就可以通過URL和對應API獲取文件的入口(Lets you look up the entry for a file or directory with a local URL)。

復制代碼代碼如下:
void resolveLocalFileSystemURL( 
in DOMString url, 
in EntryCallback successCallback, 
in optional ErrorCallback errorCallback 
); 

下面就可以讀取本機存儲的數據了

復制代碼代碼如下:
var url = "filesystem:http://" + window.location.host + "/persistent/catwrite_documents/"; 
window.resolveLocalFileSystemURL(url,function(fileEntry){ 
console.log(fileEntry); 
var dirReader = fileEntry.createReader(); 
var readEntrIEs = function(){ 
dirReader.readEntrIEs(function(results){ 
if(!results.length){ 
create_file_title("默認文件", ""); 
console.log("沒有文件!"); 
}else{ 
console.log("讀取到" + results.length + "個文件"); 
for(var i = 0; i < results.length; i++){ 
console.log(results[i].name); 
getFileContentByName(fileEntry, results[i].name); 


},errorHandler); 
}; 
readEntrIEs(); 
},errorHandler); 
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved