鸿蒙语言基础类库：【@system.storage (数据存储)】

数据存储

说明：

• 从API Version 6开始，该模块不再维护，可以使用模块[@ohos.data.storage]。在API Version 9后，推荐使用新模块[@ohos.data.preferences]。
• 本模块首批接口从API version 3开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import storage from '@system.storage';

storage.get

get(Object): void

通过索引读取缓存中存储的值。

系统能力： SystemCapability.DistributedDataManager.Preferences.Core

参数：

参数名	类型	必填	说明
key	string	是	内容索引。
default	string	否	key不存在则返回的默认值。
success	Function	否	接口调用成功的回调函数，data为返回key对应的value。
fail	Function	否	接口调用失败的回调函数，data为错误信息，code为错误码。
complete	Function	否	接口调用结束的回调函数。

示例：

export default {    storageGet() {        storage.get({            key: 'storage_key',            success: function(data) {                console.log('call storage.get success: ' + data);            },            fail: function(data, code) {                console.log('call storage.get fail, code: ' + code + ', data: ' + data);            },            complete: function() {                console.log('call complete');            },});    }
}

storage.set

set(Object): void

修改缓存中索引对应的值。

系统能力： SystemCapability.DistributedDataManager.Preferences.Core

参数：

参数名	类型	必填	说明
key	string	是	要修改的存储值的索引。
value	string	是	新值。长度需小于128字节。
success	Function	否	接口调用成功的回调函数。
fail	Function	否	接口调用失败的回调函数，data为错误信息，code为错误码。
complete	Function	否	接口调用结束的回调函数。

示例：

export default {    storageSet() {        storage.set({            key: 'storage_key',            value: 'storage value',            success: function() {                console.log('call storage.set success.');            },            fail: function(data, code) {                console.log('call storage.set fail, code: ' + code + ', data: ' + data);            },        });    }
}

storage.clear

clear(Object): void

清空缓存中存储的键值对。

系统能力： SystemCapability.DistributedDataManager.Preferences.Core

参数：

参数名	类型	必填	说明
success	Function	否	接口调用成功的回调函数。
fail	Function	否	接口调用失败的回调函数，data为错误信息，code为错误码。
complete	Function	否	接口调用结束的回调函数。

示例：

export default {    storageClear() {        storage.clear({            success: function() {                console.log('call storage.clear success.');            },            fail: function(data, code) {                console.log('call storage.clear fail, code: ' + code + ', data: ' + data);            },        });    }
}

storage.delete

delete(Object): void

删除缓存中索引对应的键值对。

系统能力： SystemCapability.DistributedDataManager.Preferences.Core

参数：

参数名	类型	必填	说明
key	string	是	内容索引。
success	Function	否	接口调用成功的回调函数。
fail	Function	否	接口调用失败的回调函数，data为错误信息，code为错误码。
complete	Function	否	接口调用结束的回调函数。

示例：

export default {    storageDelete() {        storage.delete({            key: 'Storage1',            success: function() {                console.log('call storage.delete success.');            },            fail: function(data, code) {                console.log('call storage.delete fail, code: ' + code + ', data: ' + data);            },        });    }
}