• 探索HTML5之本地文件系统API File System API


    日期:2012-4-12  来源:GBin1.com

    探索HTML5之本地文件系统API - File System API

    新的HTML5标准给我们带来了大量的新特性和惊喜,例如,画图的画布Canvas,多媒体的audio和video等等。除了上面我们提到的,还有比较新的特性 - File System API,它能够帮助我们来突破沙箱访问我们本地的文件系统,从而有效的弥补桌面和web应用之间的鸿沟。在今天这篇文章中,我们将会介绍基本的File system API的知识,探索HTML5的本地文件系统API的新特性,希望大家能够喜欢!

    介绍

    “我们不再需要下载并且安装软件。一个简单的web浏览器和一个可供使用的互联网就足以让我们在任何时间,任何地点,还有任何平台上使用任何web应用程序。”

    简 单来说,web应用很酷,但是相对于桌面应用来说,它们有比较显著的弱点:它们无法在一个有层次的文件夹结构体即文件系统中互动和组织。 幸运的是,如果我们使用Filesystem API,我们可以做到。这个API帮助我们控制私有的本地文件系统“沙箱(sandbox)",在这里我们可以读和写文件,创建和排列文件夹。虽然在我们 写这篇文章的时候,只有Google的Chrome完整的支持Filesystem API,我觉得我们还是有必要学习这个强大并且方便的本地存储特性。

    本地文件系统API包含了俩个不同的版本。异步API,对于一般的应用来说非常有用。同步API,特别为web设计。这篇文章中,我们将介绍异步版本的API。

    步骤一:开始

    首先我们需要通过请求一个LocalFile对象来得到HTML5文件系统的访问,使用window.requetFileSystem全局方法:

    window.requestFileSystem(type, size, successCallback, opt_errorCallback)

    前俩个参数,你指定需要的生命周期类型和文件系统的大小。一个持久性的(Persistent)文件系统非常适合长期保存用户数据。浏览器不会删除,除非用户特意要求。一个临时性(Temporary)的文件系统非常适合web应用来缓存数据,但是在浏览器删除文件系统后任然可以操作。size用来指定字节大小,一般指定有效的最大访问存储大小。

    第 三个参数是一个回调函数(callback),当用户代理成功的提供了一个文件系统后触发。它的主要参数是一个FileSystem对象。并且我们可以添 加一个可选的callback函数,用来在出错的时候调用,或者请求被拒绝的时候。参数是一个FileError对象。虽然这个对象是可选的,最好还是捕 捉这些错误,因为很多地方可能会出错。

    文件系统得到这些方法依赖于最初包含的document。所有的document或者web应用来自 于同一个最初来源共享一个文件系统。两个document或者应用来自于不同的来源完全不同并且不可联系。一个文件系统严格被限制访问一个应用,不能访问 另外一个应用保存的数据。同时也对于其它的文件独立。这是一件好事:让文件访问不相干的系统文件资源,例如,操作系统的文件,完全没有必要,也不安全。

    我们看看这个例子:

    window.requestFileSystem = window.requestFileSystem || window.webkitRequestFileSystem;
    window.requestFileSystem(window.TEMPORARY, 5*1024*1024, initFS, errorHandler);
    function initFS(fs){
      alert("Welcome to Filesystem! It's showtime :)"); // Just to check if everything is OK :)
      // place the functions you will learn bellow here
    }
    function errorHandler(){
      console.log('An error occured');
    }

    这 里我们创建而来一个临时的5M文件系统存储。提供了一个成功的callback函数,用阿里操作我们的文件系统。并且添加了一个错误处理,用来处理错误。 这里errorhandler()方法非常具有一般性。 如果你想的话,你可以创建一个优化版本,显示给用户更加详细的error信息。

    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);
    };

    这 个你得到的文件对象拥有一个name(一个唯一的文件系统名称,由浏览器赋值)并且ROOT属性参考文件系统的ROOT目录。这是一个 DirectoryEntry对象,可以嵌套使用。每一个文件目录都可以包含文件,由FileEntry对象标示。DirectoryEntry对象定义 使用路径名称得到DirectoryEntry和FileEntry的方法(如果不存在路径名,会创建新的目录)。DirectoryEntry同时定义 了createReader()工厂方法用来返回一个DirectoryReader对象用来列出一个文件夹。FileEntry类定义了一个得到 File对象的方。你可以使用FileReader对象来读取文件。FileEntry定义了另外一个方法用来返回一个FileWriter对象,你可以 将内容写到文件中。

    听起来是不是有点儿复杂?通过下面的例子我们会更清楚的理解。

    步骤二:处理文件夹

    很显然,第一件我们需要做的事就是创建一些目录。虽然ROOT目录已经村存在,你不希望把所有的文件都保存在那里。文件夹使用DirectoryEntry对象来创建。在下面的例子中我们将在ROOT文件夹中创建一个文件夹:Documents

    fs.root.getDirectory('Documents', {create: true}, function(dirEntry) {
      alert('You have just created the ' + dirEntry.name + ' directory.');
    }, errorHandler);

    getDiretory()方法用来读和创建目录。作为第一个参数,你可以传递一个名字或者路径来寻找或者创建。我们设计第二个参数为true,因为我们需要创建一个目录 - 不是读一个已存在的目录。当然我们在最后添加了一个错误的callback方法。

    这 里我们创建了一个目录,接着我们创建一个子目录。这个方法类似除了一下一点,我们修改第一个参数为”Documents/Music“。很简单是不是,如 果你想创建一个子目录,Sky,使用俩个父目录那么怎么做呢? 如果你使用Documents/Music/Nature/Sky作为路径参数,你会得到错误,因为你不能创建一个没有父目录的目录。解决方式是一个一个 的创建。但是这样很低效并且麻烦。更好的解决方式:创建一个方法用来自动创建目录:

    function createDir(rootDir, folders) {
      rootDir.getDirectory(folders[0], {create: true}, function(dirEntry) {
        if (folders.length) {
          createDir(dirEntry, folders.slice(1));
        }
      }, errorHandler);
    };
    createDir(fs.root, 'Documents/Images/Nature/Sky/'.split('/'));

    使用这个小技巧,我们只需要提供完整的路径就能自动为我们创建文件夹。

    接下来我们需要检查我们的文件系统。我们创建一个DirectoryReader对象,使用ReadEntries()方法来读取目录中的内容。

    fs.root.getDirectory('Documents', {}, function(dirEntry){<br>
      var dirReader = dirEntry.createReader();
      dirReader.readEntries(function(entries) {<br>
        for(var i = 0; i < entries.length; i++) {
          var entry = entries[i];
          if (entry.isDirectory){
            console.log('Directory: ' + entry.fullPath);
          }
          else if (entry.isFile){
            console.log('File: ' + entry.fullPath);
          }
        }

      }, errorHandler);
    }, errorHandler);

    在以上代码中,isDirectory和isFile属性用来得到不同的输出文件或者文件夹。而且我们使用fullPath属性来得到完整的输入内容,而不是仅仅名字。

    ...

    ...

    原文来自:探索HTML5之本地文件系统API - File System API

  • 相关阅读:
    Notes of Daily Scrum Meeting(12.22)
    一个合格的程序员应该读过哪些书
    snprintf vs sprintf
    Centos 关闭图形界面
    oracle selinux 问题
    struct 和typedef struct的区别
    c语言字符串函数
    504. Base 7
    汉诺塔python实现
    VIM字符编码基础知识
  • 原文地址:https://www.cnblogs.com/gbin1/p/2446069.html
Copyright © 2020-2023  润新知