DzzOffice开发手册文件系统篇

Dzz文件系统概述：

• Dzz文件系统提供统一的文件操作接口，包括读取、上传、删除等。
• 通过通用接口IO，应用可以方便地调用文件，无论文件存储在本地磁盘还是云端。

文件上传流程：

• 应用通过IO接口发起文件上传请求。
• Dzz文件系统接收请求并处理文件上传。
• 文件上传完成后，系统返回确认信息给应用。

文件获取流程：

• 应用通过IO接口发起文件获取请求。
• Dzz文件系统根据请求查找文件位置（本地或云端）。
• 系统将文件内容返回给应用。

文件路径规则

概述

Dzz文件系统采用特定的文件路径（DzzPath）来识别文件位置，其中包含文件所在存储位置的信息。以下为常见的文件DzzPath类型：

整数地址

• 使用文件rid值作为地址，通常用于网盘等内部文件。
• 删除文件后，此类地址将失效。

附件地址

• 使用格式为"attach::+附件aid"，例如"attach::15219"。
• 直接调用附件系统，桌面图标删除不会影响附件的调用。

云端文件地址

• 使用特定格式的云端地址，如"baiduPCS:8:/apps/DzzCloud/文集/1.png"（百度网盘文件）和"ALIOSS:6:dzzoffice-qingdao/文档查看器.png"（阿里云文件）。
• 地址由三段组成，分别为云标志符、云ID和云地址。

预览分享文件地址

• 使用格式为"preview_+文件rid"，例如"preview_123"。
• 标记该文件是以分享的方式打开的，而不是直接从网盘中调用的。

注意

此类地址仅用于Dzz文件系统内部标识文件位置。为确保安全，外部程序在使用接口时需对地址进行加密处理，避免安全问题。例如，使用以下加密函数：

dzzencode('ALIOSS:6:dzzoffice-qingdao/文档查看器.png');

将得到加密地址：MGU3ZXpIcURaaGs1SkFIQ2s4L09aUG5RTDJMRmIwcUhnQjhtcEJST1hvbEd1Q0xvaUlJM3J6NmI5TEVBMUwvRnJYUG5nZllWSXlUd1JYWWN0QzVEMkswNkVML0h5b0tOcXE4Mg

解密时使用：

dzzdecode('MGU3ZXpIcURaaGs1SkFIQ2s4L09aUG5RTDJMRmIwcUhnQjhtcEJST1hvbEd1Q0xvaUlJM3J6NmI5TEVBMUwvRnJYUG5nZllWSXlUd1JYWWN0QzVEMkswNkVML0h5b0tOcXE4Mg');

以还原原始地址。