diff --git "a/zh-cn/readme/\345\210\206\345\270\203\345\274\217\346\226\207\344\273\266\345\255\220\347\263\273\347\273\237.md" "b/zh-cn/readme/\345\210\206\345\270\203\345\274\217\346\226\207\344\273\266\345\255\220\347\263\273\347\273\237.md" index 1ae22c7b5e18d0fd0e47b68a7b3156fddade4ee9..13be58d41a57e6a02b0ad6bed14e0f167917f45e 100644 --- "a/zh-cn/readme/\345\210\206\345\270\203\345\274\217\346\226\207\344\273\266\345\255\220\347\263\273\347\273\237.md" +++ "b/zh-cn/readme/\345\210\206\345\270\203\345\274\217\346\226\207\344\273\266\345\255\220\347\263\273\347\273\237.md" @@ -60,7 +60,7 @@ foundation/distributeddatamgr/distributedfile

需要用户提供绝对路径或文件描述符(fd),提供创建、修改及访问文件,或修改文件权限的能力

-

@OHOS.distributedfile.fileio

+

@ohos.distributedfile.fileio

accessSync

chownSync

@@ -71,7 +71,7 @@ foundation/distributeddatamgr/distributedfile

需要用户提供绝对路径,提供读取目录及判断文件类型的能力

-

@OHOS.distributedfile.fileio

+

@ohos.distributedfile.fileio

Dir.openDirSync

@@ -80,7 +80,7 @@ foundation/distributeddatamgr/distributedfile

需要用户提供绝对路径,提供包括文件大小、访问权限、修改时间在内的基本统计信息

-

@OHOS.distributedfile.fileio

+

@ohos.distributedfile.fileio

Stat.statSync

@@ -89,7 +89,7 @@ foundation/distributeddatamgr/distributedfile

需要用户提供绝对路径或文件描述符,提供流式读写文件的能力

-

@OHOS.distributedfile.fileio

+

@ohos.distributedfile.fileio

Stream.createStreamSync

Stream.fdopenStreamSync

@@ -109,50 +109,6 @@ foundation/distributeddatamgr/distributedfile -其中,沙盒文件接口所使用的 URI 具体可划分为三种类型: - -**表 2** URI类型表 - - - - - - - - - - - - - - - - - - - - - - - - -

目录类型

-

路径前缀

-

访问可见性

-

说明

-

临时目录

-

internal://cache/

-

仅本应用可见

-

可读写,随时可能清除,不保证持久性。一般用作下载临时目录或缓存目录。

-

应用私有目录

-

internal://app/

-

仅本应用可见

-

随应用卸载删除。

-

外部存储

-

internal://share/

-

所有应用可见

-

随应用卸载删除。其他应用在有相应权限的情况下可读写此目录下的文件。

-
### 使用说明 @@ -165,7 +121,7 @@ foundation/distributeddatamgr/distributedfile 下例以只读的方式打开一个文件流,接着试图读取其中前 4096 个字节并将之转换为 UTF-8 编码的字符串,最后关闭该文件流。 ``` - import fileio from '@OHOS.distributedfile.fileio'; + import fileio from '@ohos.distributedfile.fileio'; try { var ss = fileio.Stream.createStreamSync("tmp", "r") @@ -182,12 +138,13 @@ foundation/distributeddatamgr/distributedfile - 异步编程模型:Promise - @OHOS.distributedfile.fileio 模块中,名称不含 Sync 的接口,在不提供最后一个函数型参数 callback 的时候,即实现为 Promsie 异步模型。Promise 异步模型是 OHOS 标准异步模型之一。用户在调用这些接口的时候,接口实现将异步执行任务,同时返回一个 promise 对象,其代表异步操作的结果。在返回的结果的个数超过一个时,其以对象属性的形式返回。 + @ohos.distributedfile.fileio 模块中,名称不含 Sync 的接口,在不提供最后一个函数型参数 callback 的时候,即实现为 Prom + ise 异步模型。Promise 异步模型是 ohos 标准异步模型之一。用户在调用这些接口的时候,接口实现将异步执行任务,同时返回一个 promise 对象,其代表异步操作的结果。在返回的结果的个数超过一个时,其以对象属性的形式返回。 下例通过 Promise 链依次完成:以只读方式打开文件流、尝试读取文件前 4096 个字节、显示读取内容的长度,最后关闭文件。 ``` - import fileio from '@OHOS.distributedfile.fileio'; + import fileio from '@ohos.distributedfile.fileio'; try { let openedStream @@ -215,12 +172,12 @@ foundation/distributeddatamgr/distributedfile - 异步编程模型:Callback - @OHOS.distributedfile.fileio 模块中,名字不含 Sync 的接口,在提供最后一个函数性参数 callback 的时候,即实现为 Callback 异步模型。Callback 异步模型是 OHOS 标准异步模型之一。用户在调用这些接口的时候,接口实现将异步执行任务。任务执行结果以参数的形式提供给用户注册的回调函数。这些参数的第一个是 Error 或 undefined 类型,分别表示执行出错与正常。 + @ohos.distributedfile.fileio 模块中,名字不含 Sync 的接口,在提供最后一个函数性参数 callback 的时候,即实现为 Callback 异步模型。Callback 异步模型是 ohos 标准异步模型之一。用户在调用这些接口的时候,接口实现将异步执行任务。任务执行结果以参数的形式提供给用户注册的回调函数。这些参数的第一个是 Error 或 undefined 类型,分别表示执行出错与正常。 下例异步创建文件流,并在文件流的回调函数中异步读取文件的前 4096 字节,接着在读取文件的回调函数中异步关闭文件。 ``` - import fileio from '@OHOS.distributedfile.fileio'; + import fileio from '@ohos.distributedfile.fileio'; try { fileio.Stream.createStream("./testdir/test_stream.txt", "r", function (err, ss) {