DirectoryEntry

该对象代表文件系统中的一个目录，W3C的目录和系统规范对其进行了定义。

属性：

isFile： 总是false。（布尔类型）isFile：总是false。（布尔类型）

isDirectory：总是true。(布尔类型)

name：DirectoryEntry的名称，不包含前置路径。（DOMString类型）

fullPath：从根目录到当前DirectoryEntry的完整绝对路径。（DOMString类型）

备注：以下属性虽然在W3C规范中进行了定义，但PhoneGap并不支持：

filesystem：DirectoryEntry驻留的文件系统。（FileSystem类型）

方法：

DirectoryEntry对象有以下方法可以被调用：

getMetadata： 获得目录的元数据。

moveTo：移动一个目录到文件系统中不同的位置。

copyTo：拷贝一个目录到文件系统中不同的位置。

toURI：返回一个可以定位目录的URI。

remove：删除一个目录，被删除的目录必须是空的。

getParent：查找父级目录。

createReader：创建一个可以从目录中读取条目的新DirectoryReader对象。

getDirectory：创建或查找一个目录。

getFile：创建或查找一个文件。

removeRecursively：删除一个目录以及它的所有内容。

支持的平台：

Android

BlackBerry WebWorks (OS 5.0或更高版本)

iOS

getMetadata：

查找目录的元数据。

参数：

successCallback：获取元数据successCallback：获取元数据成功后回调此函数，参数为一个Metadata 对象。（函数类型）

errorCallback：试图检索元数据发生错误的时候回调此函数，参数为一个FileError对象。（函数类型）

简单的范例：

function success(metadata) { console.log("Last Modified:" + metadata.modificationTime); } function fail(error) { alert(error.code); } // 请求这个条目的元数据对象 entry.getMetadata(success, fail);

moveTo：

移动一个目录到文件系统中不同的位置。在尝试进行以下操作时会发生错误:

移动目录到其自身，或者移动到其任意深度的任意子目录中；

同级移动（将一个目录移动到它的父目录中）时没有提供和当前名称不同的名称；

移动目录到一个文件所占用的路径；

移动目录到一个非空目录所占用的路径。

另外，尝试移动一个目录到另一个已经存在的空目录上时，系统会尝试删除并替换已存在的目录。

参数：

parent：将目录对象移动到的父级目录。(DirectoryEntry类型)

newName：目录的新名字。如果没有指定，默认为当前名字。（DOMString类型）

successCallback：移动成功后调用的回调函数，参数为移动后的新目录的DirectoryEntry对象。（函数类型）

errorCallback：试图移动目录发生错误时调用的回调函数，参数为一个FileError对象。（函数类型）

简单的范例：

function success(entry) { console.log("New Path:" + entry.fullPath); } function fail(error) { alert(error.code); } function moveDir(entry) { var parent = document.getElementById(‘parent‘).value; newName = document.getElementById(‘newName‘).value; parentEntry = new DirectoryEntry({fullPath: parent}); // 移动目录到一个新目录，并将其重命名 entry.moveTo(parentEntry, newName, success, fail); }

copyTo：

拷贝一个目录到文件系统中不同的位置。在尝试进行以下操作时会发生错误:

拷贝一个目录到其任意深度的子目录中；

同级拷贝（将一个目录拷贝到它的父目录中）时没有提供和当前名称不同的名称；

目录总是递归操作 — 也就是说，会拷贝目录中的所有内容。

参数：

parent：将目录对象拷贝到的父级目录。(DirectoryEntry类型)

newName：目录的新名称。如果没有指定，默认为当前名字。（DOMString类型）

successCallback：拷贝成功后调用的回调函数，参数为拷贝后的新目录的DirectoryEntry对象。（函数类型）

errorCallback：试图拷贝目录发生错误时调用的回调函数，其参数为一个FileError对象。（函数类型）

简单的范例：

function win(entry) { console.log("New Path:" + entry.fullPath); } function fail(error) { alert(error.code); } function copyDir(entry) { var parent = document.getElementById(‘parent‘).value, newName = document.getElementById(‘newName‘).value, parentEntry = new DirectoryEntry({fullPath: parent}); // 拷贝目录到一个新的目录，并将其重命名 entry.copyTo(parentEntry, newName, success, fail); }

toURI：

返回一个用于定位该文件的URI。

简单的范例：

// 请求此条目的URI var uri = entry.toURI(); console.log(uri);

remove：

删除一个目录。在尝试进行以下操作时会发生错误:

删除一个非空目录；

删除文件系统的根目录。

参数：

successCallback：目录删除成功后调用的回调函数，无参数。（函数类型）

errorCallback：试图删除目录发生错误时调用的回调函数，其参数为一个FileError对象。（函数类型）

简单的范例：