html5plus IO模块管理本地文件系统

| 阅读数:--次| 作者:html5plus
摘要:IO模块管理本地文件系统,用于对文件系统的目录浏览、文件的读取、文件的写入等操作。通过plus.io可获取文件系统管理对象。

io

IO模块管理本地文件系统,用于对文件系统的目录浏览、文件的读取、文件的写入等操作。通过plus.io可获取文件系统管理对象。

常量:

方法:

对象:

回调方法:

权限:

permissions

"File": {
	"description": "访问本地文件系统"
}
			

DirectoryEntry

文件系统中的目录对象,用于管理特定的本地目录

属性:

方法:

DirectoryReader

读取目录信息对象,用于获取目录中包含的文件及子目录

方法:

File

文件系统中的文件数据对象,用于获取文件的数据

属性:

方法:

FileEntry

文件系统中的文件对象,用于管理特定的本地文件

属性:

方法:

FileReader

文件系统中的读取文件对象,用于获取文件的内容

说明:

FileReader对象是从设备文件系统读取文件FileReader对象是从设备文件系统读取文件的一种方式,文件以文本或者Base64编码的字符串形式读出来。 用户注册自己的事件监听器来接收loadstart、progress、load、loadend、error和abort事件。

构造:

常量:

属性:

方法:

事件:

FileWriter

文件系统中的写文件对象,用于写入文件内容

说明:

FileWriter对象是从设备文件系统写入文件FileWriter对象是从设备文件系统写入文件的一种方式,用户注册自己的事件监听器来接收writestart、progress、write、writeend、error和abort事件。 一个FileWriter对象是为单个文件的操作而创建。你可以使用该对象多次对相应文件进行写入操作。FileWriter维护该文件的指针位置及长度属性,这样你就可以寻找和写入文件的任何地方。 默认情况下,FileWriter从文件的开头开始写入(将覆盖现有数据)。FileWriter对象的seek方法可设置文件操作指定位置,如fw.seek(fw.length-1)写入操作就会从文件的末尾开始。

常量:

属性:

方法:

事件:

FileSystem

文件系统对象,用于管理特定本地文件目录

说明:

文件系统对象表示一个应用可访问的根目录。name属性用于标识此根目录的名称,与LocalFileSystem中的文件系统类型一一对应。root属性为文件目录对象,用于实际操作文件系统,参考DirectoryEntry。

属性:

Flags

JSON对象,获取文件操作的参数

属性:

Metadata

JSON对象,保存文件或目录的状态信息对象

说明:

可通过DirectoryEntry或FileEntry对象的getMetaData方法获取

属性:

FileEvent

文件或目录操作事件对象

说明:

所有文件或目录操作事件回调函数中都创建该对象的实例。 该对象从DOMEvent继承而来,可通过该其target属性获取事件触发的文件或目录操作对象。

属性:

URLType

文件路径类型

说明:

在文件系统中的文件路径需转换成URL格式,已方便runtime快速加载。

RelativeURL

相对路径URL

说明:

只能在扩展API中使用,相对于基座提供的特定目录,以“_”开头。

常量:

LocalURL

本地路径URL

说明:

可在html页面中直接访问本地资源,以“file:///”开头,后面跟随系统的绝对路径。 如示例:“file:///D:/res/hello.html”。

RemoteURL

网络路径URL

说明:

可在html页面中以网络资源模式访问本地资源,以“http://”开头,后面跟随相对路径。 如示例:“http://localhost:13131/_www/res/icon.png”,其中“_www”字段可支持类型与相对路径URL一致。

FileEventCallback

文件事件回调

void onEvent( event ) {
	// Event code.
}
				

说明:

文件或目录操作回调事件。 通常在FileReader和FileWriter对象的事件函数中触发。

参数:

返回值:

void : 无

FileSystemSuccessCallback

请求文件系统成功的回调函数

void onSuccess( fs ) {
	// File System operate code.
}
				

参数:

返回值:

void : 无

FileResolveSuccessCallback

通过URL参数获取目录或文件对象成功的回调函数

void onSuccess( entry ) {
	// File or Direcory entry operate code.
}
				

参数:

返回值:

void : 无

MetadataSuccessCallback

获取文件或目录状态信息成功的回调函数

void onSuccess( metadata ) {
	// Metadata code.
}
				

参数:

返回值:

void : 无

EntrySuccessCallback

操作文件或目录对象成功的回调函数

void onSuccess( entry ) {
	// Entry code.
}
				

参数:

返回值:

void : 无

EntrysSuccessCallback

操作文件或目录对象数组成功的回调函数

void onSuccess( entrys ) {
	// Entrys code.
}
				

参数:

返回值:

void : 无

FileWriterSuccessCallback

写文件操作成功的回调函数

void onSuccess( writer ) {
	// FileWriter code.
}
				

参数:

返回值:

void : 无

FileSuccessCallback

文件操作成功的回调函数

void onSuccess( file ) {
	// file code.
}
				

参数:

返回值:

void : 无

FileErrorCallback

文件操作失败的回调函数

void onError( error ) {
	// Error code.
}
				

参数:

返回值:

void : 无
返回顶部
学到老代码浏览 关闭浏览