鸿蒙API14开发【@ohos.file.securityLabel (数据标签)】文件基础服务 ...

饭宝  金牌会员 | 2025-3-14 01:33:43 | 显示全部楼层 | 阅读模式
打印 上一主题 下一主题

主题 995|帖子 995|积分 2985

该模块提供文件数据安全品级的相关功能:向应用程序提供查询、设置文件数据安全品级的JS接口。
阐明
本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
导入模块

  1. import { securityLabel } from '@kit.CoreFileKit';
复制代码
使用阐明

使用该功能模块对文件/目录进行操纵前,必要先获取其应用沙箱路径,获取方式及其接口用法请参考:
  1. import { UIAbility } from '@kit.AbilityKit';
  2. import { window } from '@kit.ArkUI';
  3. export default class EntryAbility extends UIAbility {
  4.   onWindowStageCreate(windowStage: window.WindowStage) {
  5.     let context = this.context;
  6.     let pathDir = context.filesDir;
  7.   }
  8. }
复制代码
DataLevel

type DataLevel = ‘s0’ | ‘s1’ | ‘s2’ | ‘s3’ | ‘s4’ |
数据安全级别。
系统能力:SystemCapability.FileManagement.File.FileIO
securityLabel.setSecurityLabel

setSecurityLabel(path:string, typeataLevel)romise
以异步方法设置数据标签,数据标签安全品级仅可由低向高或平级设置,以Promise情势返回结果。
系统能力:SystemCapability.FileManagement.File.FileIO
参数:
参数名范例必填阐明pathstring是文件路径type[DataLevel]是文件品级属性,只支持"s0",“s1”,“s2”,“s3”,“s4” 返回值:
范例阐明PromisePromise实例,用于异步获取结果。本调用将返回空值。 错误码ID错误信息13900001Operation not permitted13900007Arg list too long13900015File exists13900020Invalid argument13900025No space left on device13900037No data available13900041Quota exceeded13900042Unknown error 示例:
  1. import { BusinessError } from '@kit.BasicServicesKit';
  2. let filePath = pathDir + '/test.txt';
  3. securityLabel.setSecurityLabel(filePath, "s0").then(() => {
  4.   console.info("setSecurityLabel successfully");
  5. }).catch((err: BusinessError) => {
  6.   console.error("setSecurityLabel failed with error message: " + err.message + ", error code: " + err.code);
  7. });
复制代码
securityLabel.setSecurityLabel

setSecurityLabel(path:string, typeataLevel, callback: AsyncCallback):void
以异步方法设置数据标签,数据标签安全品级仅可由低向高或平级设置,以callback情势返回结果。
系统能力:SystemCapability.FileManagement.File.FileIO
参数:
参数名范例必填阐明pathstring是文件路径typeDataLevel是文件品级属性,只支持"s0",“s1”,“s2”,“s3”,“s4”callbackAsyncCallback是是否设置数据标签之后的回调 错误码ID错误信息13900001Operation not permitted13900007Arg list too long13900015File exists13900020Invalid argument13900025No space left on device13900037No data available13900041Quota exceeded13900042Unknown error 示例:
  1. import { BusinessError } from '@kit.BasicServicesKit';
  2. let filePath = pathDir + '/test.txt';
  3. securityLabel.setSecurityLabel(filePath, "s0", (err: BusinessError) => {
  4.   if (err) {
  5.     console.error("setSecurityLabel failed with error message: " + err.message + ", error code: " + err.code);
  6.   } else {
  7.     console.info("setSecurityLabel successfully.");
  8.   }
  9. });
复制代码
securityLabel.setSecurityLabelSync

setSecurityLabelSync(path:string, typeataLevel):void
以同步方法设置数据标签,数据标签安全品级仅可由低向高或平级设置。
系统能力:SystemCapability.FileManagement.File.FileIO
参数:
参数名范例必填阐明pathstring是文件路径typeDataLevel是文件品级属性,只支持"s0",“s1”,“s2”,“s3”,“s4” 错误码ID错误信息13900001Operation not permitted13900007Arg list too long13900015File exists13900020Invalid argument13900025No space left on device13900037No data available13900041Quota exceeded13900042Unknown error 示例:
  1. let filePath = pathDir + '/test.txt';
  2. securityLabel.setSecurityLabelSync(filePath, "s0");
复制代码
securityLabel.getSecurityLabel

getSecurityLabel(path:string)romise
异步方法获取数据标签,若未设置过数据标签安全品级则默认返回“s3”,以Promise情势返回结果。
系统能力:SystemCapability.FileManagement.File.FileIO
参数:
参数名范例必填阐明pathstring是文件路径 返回值:
范例阐明Promise返回数据标签 错误码ID错误信息13900001Operation not permitted13900007Arg list too long13900015File exists13900020Invalid argument13900025No space left on device13900037No data available13900041Quota exceeded13900042Unknown error 示例:
  1. import { BusinessError } from '@kit.BasicServicesKit';
  2. let filePath = pathDir + '/test.txt';
  3. securityLabel.getSecurityLabel(filePath).then((type: string) => {
  4.   console.log("getSecurityLabel successfully, Label: " + type);
  5. }).catch((err: BusinessError) => {
  6.   console.error("getSecurityLabel failed with error message: " + err.message + ", error code: " + err.code);
  7. });
复制代码
securityLabel.getSecurityLabel

getSecurityLabel(path:string, callback:AsyncCallback): void
异步方法获取数据标签,若未设置过数据标签安全品级则默认返回“s3”,以callback情势返回结果。
系统能力:SystemCapability.FileManagement.File.FileIO
参数:
参数名范例必填阐明pathstring是文件路径callbackAsyncCallback是异步获取数据标签之后的回调 错误码ID错误信息13900001Operation not permitted13900007Arg list too long13900015File exists13900020Invalid argument13900025No space left on device13900037No data available13900041Quota exceeded13900042Unknown error 示例:
  1. import { BusinessError } from '@kit.BasicServicesKit';
  2. let filePath = pathDir + '/test.txt';
  3. securityLabel.getSecurityLabel(filePath, (err: BusinessError, type: string) => {
  4.   if (err) {
  5.     console.error("getSecurityLabel failed with error message: " + err.message + ", error code: " + err.code);
  6.   } else {
  7.     console.log("getSecurityLabel successfully, Label: " + type);
  8.   }
  9. });
复制代码
securityLabel.getSecurityLabelSync

getSecurityLabelSync(path:string):string
以同步方法获取数据标签,若未设置过数据标签安全品级则默认返回“s3”。
系统能力:SystemCapability.FileManagement.File.FileIO
参数:
参数名范例必填阐明pathstring是文件路径 返回值:
范例阐明string返回数据标签 错误码ID错误信息13900001Operation not permitted13900007Arg list too long13900015File exists13900020Invalid argument13900025No space left on device13900037No data available13900041Quota exceeded13900042Unknown error 示例:
  1. let filePath = pathDir + '/test.txt';
  2. let type = securityLabel.getSecurityLabelSync(filePath);
  3. console.log("getSecurityLabel successfully, Label: " + type);
复制代码
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!更多信息从访问主页:qidao123.com:ToB企服之家,中国第一个企服评测及商务社交产业平台。
回复

使用道具 举报

0 个回复

倒序浏览

快速回复

您需要登录后才可以回帖 登录 or 立即注册

本版积分规则

饭宝

金牌会员
这个人很懒什么都没写!
快速回复 返回顶部 返回列表