PhoneGap API中文帮助文档——File（文件）

用于读取、写入和浏览文件系统层次结构的API。对象：
DirectoryEntry
DirectoryReader
File
FileEntry
FileError
FileReader
FileSystem
FileTransfer
FileTransferError
FileUploadOptions
FileUploadResult
FileWriter
Flags
LocalFileSystem
Metadata

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：

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

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

目录复制总是递归操作 — 也就是说，会拷贝目录中