数据标签
该模块提供文件数据安全等级的相关功能:向应用程序提供查询、设置文件数据安全等级的JS接口。
说明: 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
导入模块
import securityLabel from '@ohos.securityLabel';
使用说明
使用该功能模块对文件/目录进行操作前,需要先获取其应用沙箱路径,获取方式及其接口用法请参考:
import featureAbility from '@ohos.ability.featureAbility';
let context = featureAbility.getContext();
let path = '';
context.getFilesDir().then((data) => {
path = data;
})
securityLabel.setSecurityLabel
setSecurityLabel(path:string, type:dataLevel):Promise
以异步方法设置数据标签,以promise形式返回结果。
系统能力:SystemCapability.FileManagement.File.FileIO
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
path | string | 是 | 文件路径 |
type | dataLevel | 是 | 文件等级属性,只支持"s0",“s1”,“s2”,“s3”,“s4” |
返回值:
类型 | 说明 |
---|---|
Promise | Promise实例,用于异步获取结果。本调用将返回空值。 |
示例:
let type = "s4";
securityLabel.setSecurityLabel(path, type).then(function(){
console.info("setSecurityLabel successfully");
}).catch(function(error){
console.info("setSecurityLabel failed with error:" + error);
});
securityLabel.setSecurityLabel
setSecurityLabel(path:string, type:dataLevel, callback: AsyncCallback):void
以异步方法设置数据标签,以callback形式返回结果。
系统能力:SystemCapability.FileManagement.File.FileIO
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
path | string | 是 | 文件路径 |
type | dataLevel | 是 | 文件等级属性,只支持"s0",“s1”,“s2”,“s3”,“s4” |
callback | AsyncCallback | 是 | 是否设置数据标签之后的回调 |
示例:
let type = "s4";
securityLabel.setSecurityLabel(path, type, function(error){
console.info("setSecurityLabel:" + JSON.stringify(error));
});
securityLabel.setSecurityLabelSync
setSecurityLabelSync(path:string, type:dataLevel):void
以同步方法设置数据标签。
系统能力:SystemCapability.FileManagement.File.FileIO
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
path | string | 是 | 文件路径 |
type | dataLevel | 是 | 文件等级属性,只支持"s0",“s1”,“s2”,“s3”,“s4” |
示例:
let type = "s4";
securityLabel.setSecurityLabelSync(path, type);
securityLabel.getSecurityLabel
getSecurityLabel(path:string):Promise
异步方法获取数据标签,以promise形式返回结果。
系统能力:SystemCapability.FileManagement.File.FileIO
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
path | string | 是 | 文件路径 |
返回值:
类型 | 说明 |
---|---|
Promise | 返回数据标签 |
示例:
let type = "s4";
securityLabel.getSecurityLabel(path).then(function(type){
console.log("getSecurityLabel successfully:" + type);
}).catch(function(error){
console.log("getSecurityLabel failed with error:" + error);
});
securityLabel.getSecurityLabel
getSecurityLabel(path:string, callback:AsyncCallback): void
异步方法获取数据标签,以callback形式返回结果。
系统能力:SystemCapability.FileManagement.File.FileIO
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
path | string | 是 | 文件路径 |
callback | AsyncCallback | 是 | 异步获取数据标签之后的回调 |
示例:
let type = "s4";
securityLabel.getSecurityLabel(path,function(error, type){
console.log("getSecurityLabel successfully:" + type);
});
securityLabel.getSecurityLabelSync
getSecurityLabelSync(path:string):string
以同步方法获取数据标签。
系统能力:SystemCapability.FileManagement.File.FileIO
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
path | string | 是 | 文件路径 |
返回值:
类型 | 说明 |
---|---|
string | 返回数据标签 |
示例:
let result = securityLabel.getSecurityLabelSync(path);
console.log("getSecurityLabel successfully:" + result);
标签:getSecurityLabel,setSecurityLabel,鸿蒙,标签,ohos,path,securityLabel,type
From: https://blog.csdn.net/2301_76813281/article/details/139636316