同步操作将从 OpenHarmony/applications_contacts_data 强制同步,此操作会覆盖自 Fork 仓库以来所做的任何修改,且无法恢复!!!
确定后同步将在后台操作,完成时将刷新页面,请耐心等待。
联系人数据库应用是每一个用户管理联系人数据库的不可缺少的一个信息管理应用,
它的内容对于用户管理者来说是至关重要的,所以联系人数据库应该能够为每一个
用户的管理提供充足的信息和快捷查询手段,大大方便用户合理的管理联系人数据库信息。
/foundation/contactsdataability/
├── ability
│ ├── account #账户管理
│ ├── common #公共方法:log,utils等
│ ├── datadisasterrecovery #数据损坏恢复
│ ├── merge #联系人合并
│ └── sinicization #汉字转拼音相关
├── contacts #NAPI
├── dataBusiness
│ ├── calllog #通话记录
│ ├── contacts #联系人
│ ├── quicksearch #快速检索
│ └── voicemail #语音信箱
├── test #测试目录
├── BUILD.gn
└── ohos.build
提供联系人数据和通话记录以及语音信箱增、删、改、查、等接口。 接口参数主要有string类型的uri和对象类型的value、DataAbilityPredicates
使用功能接口前,需要导入相关模块。
import featureAbility from '@ohos.ability.featureAbility';
import ohos_data_ability from '@ohos.data.dataability';
接口说明
通话记录插入
insert参数描述
名称 | 读写属性 | 类型 | 必填 | 描述 |
---|---|---|---|---|
uri | 只读 | string | 是 | 具体操作的uri |
value | 只读 | ValuesBucket | 是 | 数据库字段key-value对象 |
返回值为 通话记录id
更新示例
import featureAbility from '@ohos.ability.featureAbility';
import ohos_data_ability from '@ohos.data.dataability';
var calllogDAhelperUri= "dataability:///com.ohos.calllogability";
var calllogUri = "dataability:///com.ohos.calllogability/calls/calllog";
var value = {"phone_number" : "xxxxx","display_name" : "xxx"};
// 获取DAHelper
let DAHelper = featureAbility.acquireDataAbilityHelper(calllogDAhelperUri);
// 调用insert方法
DAHelper.insert(calllogUri, value).then((data) => {
console.info("calllogId = " + data);
});
接口说明
通话记录修改
update参数描述
名称 | 读写属性 | 类型 | 必填 | 描述 |
---|---|---|---|---|
uri | 只读 | string | 是 | 具体操作的uri |
value | 只读 | ValuesBucket | 是 | 数据库字段key-value对象 |
condition | 只读 | DataAbilityPredicates | 是 | 更新条件 |
返回值为 成功为0否则为-1
修改示例
import featureAbility from '@ohos.ability.featureAbility';
import ohos_data_ability from '@ohos.data.dataability';
var calllogDAhelperUri= "dataability:///com.ohos.calllogability";
var calllogUri = "dataability:///com.ohos.calllogability/calls/calllog";
var value = {"phone_number" : "xxxxx","display_name" : "xxx"};
// 获取DAHelper
let DAHelper = featureAbility.acquireDataAbilityHelper(calllogDAhelperUri);
// 条件参数
let condition = new ohos_data_ability.DataAbilityPredicates();
condition.equalTo("id", "xxx");
// 调用update方法
DAHelper.update(calllogUri, value, condition).then((data) => {
console.info("resultCode = " + data);
});
接口说明
通话记录删除
delete参数描述
名称 | 读写属性 | 类型 | 必填 | 描述 |
---|---|---|---|---|
uri | 只读 | string | 是 | 具体操作的uri |
condition | 只读 | DataAbilityPredicates | 是 | 删除条件 |
返回值为 成功为0否则为-1
删除示例
import featureAbility from '@ohos.ability.featureAbility';
import ohos_data_ability from '@ohos.data.dataability';
var calllogDAhelperUri= "dataability:///com.ohos.calllogability";
var calllogUri = "dataability:///com.ohos.calllogability/calls/calllog";
// 获取DAHelper
let DAHelper = featureAbility.acquireDataAbilityHelper(calllogDAhelperUri);
// 条件参数
let condition = new ohos_data_ability.DataAbilityPredicates();
condition.equalTo("id", "xxx");
// 调用delete方法
DAHelper.delete(calllogUri, condition).then((data) => {
console.info("deleteCode = " + data);
});
接口说明
通话记录查询
查询参数描述
名称 | 读写属性 | 类型 | 必填 | 描述 |
---|---|---|---|---|
uri | 只读 | string | 是 | 具体操作的uri |
resultColumns | 只读 | array | 是 | 需要查询的列字段名称 |
condition | 只读 | DataAbilityPredicates | 是 | 查询条件 |
返回值为 ResultSet 查询结果集
查询示例
import featureAbility from '@ohos.ability.featureAbility';
import ohos_data_ability from '@ohos.data.dataability';
var calllogDAhelperUri= "dataability:///com.ohos.calllogability";
var calllogUri = "dataability:///com.ohos.calllogability/calls/calllog";
// 获取DAHelper
let DAHelper = featureAbility.acquireDataAbilityHelper(calllogDAhelperUri);
// 条件参数
let condition = new ohos_data_ability.DataAbilityPredicates();
condition.equalTo("id", "xxx");
var resultColumns = [ "id", "display_name", "phone_number"];
// 调用query方法
DAHelper.query(calllogUri, resultColumns, condition).then((data) => {
if (resultSet.goToFirstRow()) {
do {
var displayName = resultSet.getString(resultSet.getColumnIndex("display_name"));
var id = resultSet.getInt(resultSet.getColumnIndex("id"));
var phoneNumber = resultSet.getString(resultSet.getColumnIndex("phone_number"));
} while (resultSet.goToNextRow());
}
resultSet.close();
});
返回值为 ResultSet 查询结果集
接口说明
语音信箱插入
insert参数描述
名称 | 读写属性 | 类型 | 必填 | 描述 |
---|---|---|---|---|
uri | 只读 | string | 是 | 具体操作的uri |
value | 只读 | ValuesBucket | 是 | 数据库字段key-value对象 |
返回值为 语音信箱表id
更新示例
import featureAbility from '@ohos.ability.featureAbility';
import ohos_data_ability from '@ohos.data.dataability';
var voicemailDAhelperUri= "dataability:///com.ohos.voicemailability";
var voicemaiUri = "dataability:///com.ohos.voicemailability/calls/voicemail";
var value = {"phone_number" : "xxxxx","display_name" : "xxx"};
// 获取DAHelper
let DAHelper = featureAbility.acquireDataAbilityHelper(voicemailDAhelperUri);
// 调用insert方法
DAHelper.insert(voicemaiUri, value).then((data) => {
console.info("calllogId = " + data);
});
接口说明
语音信箱修改
update参数描述
名称 | 读写属性 | 类型 | 必填 | 描述 |
---|---|---|---|---|
uri | 只读 | string | 是 | 具体操作的uri |
value | 只读 | ValuesBucket | 是 | 数据库字段key-value对象 |
condition | 只读 | DataAbilityPredicates | 是 | 更新条件 |
返回值为 成功为0否则为-1
修改示例
import featureAbility from '@ohos.ability.featureAbility';
import ohos_data_ability from '@ohos.data.dataability';
var voicemailDAhelperUri= "dataability:///com.ohos.voicemailability";
var voicemaiUri = "dataability:///com.ohos.voicemailability/calls/voicemail";
var value = {"phone_number" : "xxxxx","display_name" : "xxx"};
// 获取DAHelper
let DAHelper = featureAbility.acquireDataAbilityHelper(voicemailDAhelperUri);
// 条件参数
let condition = new ohos_data_ability.DataAbilityPredicates();
condition.equalTo("id", "xxx");
// 调用update方法
DAHelper.update(voicemaiUri, value, condition).then((data) => {
console.info("resultCode = " + data);
});
接口说明
语音信箱删除
delete参数描述
名称 | 读写属性 | 类型 | 必填 | 描述 |
---|---|---|---|---|
uri | 只读 | string | 是 | 具体操作的uri |
condition | 只读 | DataAbilityPredicates | 是 | 删除条件 |
返回值为 成功为0否则为-1
删除示例
import featureAbility from '@ohos.ability.featureAbility';
import ohos_data_ability from '@ohos.data.dataability';
var voicemailDAhelperUri= "dataability:///com.ohos.voicemailability";
var voicemaiUri = "dataability:///com.ohos.voicemailability/calls/voicemail";
// 获取DAHelper
let DAHelper = featureAbility.acquireDataAbilityHelper(voicemailDAhelperUri);
// 条件参数
let condition = new ohos_data_ability.DataAbilityPredicates();
condition.equalTo("id", "xxx");
// 调用delete方法
DAHelper.delete(voicemaiUri, condition).then((data) => {
console.info("deleteCode = " + data);
});
接口说明
语音信箱查询
查询参数描述
名称 | 读写属性 | 类型 | 必填 | 描述 |
---|---|---|---|---|
uri | 只读 | string | 是 | 具体操作的uri |
resultColumns | 只读 | array | 是 | 需要查询的列字段名称 |
condition | 只读 | DataAbilityPredicates | 是 | 查询条件 |
返回值为 ResultSet 查询结果集
查询示例
import featureAbility from '@ohos.ability.featureAbility';
import ohos_data_ability from '@ohos.data.dataability';
var voicemailDAhelperUri= "dataability:///com.ohos.voicemailability";
var voicemaiUri = "dataability:///com.ohos.voicemailability/calls/voicemail";
// 获取DAHelper
let DAHelper = featureAbility.acquireDataAbilityHelper(calllogDAhelperUri);
// 条件参数
let condition = new ohos_data_ability.DataAbilityPredicates();
condition.equalTo("id", "xxx");
var resultColumns = [ "id", "display_name", "phone_number"];
// 调用query方法
DAHelper.query(voicemaiUri, resultColumns, condition).then((data) => {
if (resultSet.goToFirstRow()) {
do {
var displayName = resultSet.getString(resultSet.getColumnIndex("display_name"));
var id = resultSet.getInt(resultSet.getColumnIndex("id"));
var phoneNumber = resultSet.getString(resultSet.getColumnIndex("phone_number"));
} while (resultSet.goToNextRow());
}
resultSet.close();
});
接口说明
联系人插入
insert参数描述
名称 | 读写属性 | 类型 | 必填 | 描述 |
---|---|---|---|---|
uri | 只读 | string | 是 | 具体操作的uri |
value | 只读 | ValuesBucket | 是 | 数据库字段key-value对象 |
返回值为 联系人数据表id
更新示例
import featureAbility from '@ohos.ability.featureAbility';
import ohos_data_ability from '@ohos.data.dataability';
var contactsUri= "dataability:///com.ohos.contactsdataability";
var rawContactUri = "dataability:///com.ohos.contactsdataability/contacts/raw_contact";
var contactDataUri = "dataability:///com.ohos.contactsdataability/contacts/contact_data";
var value = {"display_name" : "xxx"};
// 获取DAHelper
let DAHelper = featureAbility.acquireDataAbilityHelper(contactsUri);
// 调用insert方法
DAHelper.insert(rawContactUri, value).then((rawContactId) => {
console.info("rawContactId = " + rawContactId);
// 联系人详细信息插入
var contactDataValues = {
"raw_contact_id" : rawContactId,
"content_type" : "name",
"detail_info" : "xxxxxxx"
};
DAHelper.insert(contactDataUri, contactDataValues).then((contactDataId) => {
console.info("rawContactId = " + contactDataId);
};
});
接口说明
联系人修改
update参数描述
名称 | 读写属性 | 类型 | 必填 | 描述 |
---|---|---|---|---|
uri | 只读 | string | 是 | 具体操作的uri |
value | 只读 | ValuesBucket | 是 | 数据库字段key-value对象 |
condition | 只读 | DataAbilityPredicates | 是 | 更新条件 |
返回值为 成功为0否则为-1
修改示例
import featureAbility from '@ohos.ability.featureAbility';
import ohos_data_ability from '@ohos.data.dataability';
var contactsUri= "dataability:///com.ohos.contactsdataability";
var rawContactUri = "dataability:///com.ohos.contactsdataability/contacts/raw_contact";
var contactDataUri = "dataability:///com.ohos.contactsdataability/contacts/contact_data";
var value = {"display_name" : "xxx"};
// 获取DAHelper
let DAHelper = featureAbility.acquireDataAbilityHelper(contactsUri);
// 条件参数
let condition = new ohos_data_ability.DataAbilityPredicates();
condition.equalTo("id", "xxx");
// 调用update方法
DAHelper.update(rawContactUri, value, condition).then((data) => {
console.info("resultCode = " + data);
});
接口说明
联系人删除
delete参数描述
名称 | 读写属性 | 类型 | 必填 | 描述 |
---|---|---|---|---|
uri | 只读 | string | 是 | 具体操作的uri |
condition | 只读 | DataAbilityPredicates | 是 | 删除条件 |
返回值为 成功为0否则为-1
删除示例
import featureAbility from '@ohos.ability.featureAbility';
import ohos_data_ability from '@ohos.data.dataability';
var contactsUri= "dataability:///com.ohos.contactsdataability";
var rawContactUri = "dataability:///com.ohos.contactsdataability/contacts/raw_contact";
var contactDataUri = "dataability:///com.ohos.contactsdataability/contacts/contact_data";
// 获取DAHelper
let DAHelper = featureAbility.acquireDataAbilityHelper(contactsUri);
// 条件参数
let condition = new ohos_data_ability.DataAbilityPredicates();
condition.equalTo("id", "xxx");
// 调用delete方法
DAHelper.delete(contactDataUri, condition).then((data) => {
console.info("deleteCode = " + data);
});
接口说明
联系人查询
查询参数描述
名称 | 读写属性 | 类型 | 必填 | 描述 |
---|---|---|---|---|
uri | 只读 | string | 是 | 具体操作的uri |
resultColumns | 只读 | array | 是 | 需要查询的列字段名称 |
condition | 只读 | DataAbilityPredicates | 是 | 查询条件 |
返回值为 ResultSet 查询结果集
查询示例
import featureAbility from '@ohos.ability.featureAbility';
import ohos_data_ability from '@ohos.data.dataability';
var contactsUri= "dataability:///com.ohos.contactsdataability";
var rawContactUri = "dataability:///com.ohos.contactsdataability/contacts/raw_contact";
// 获取DAHelper
let DAHelper = featureAbility.acquireDataAbilityHelper(contactsUri);
// 条件参数
let condition = new ohos_data_ability.DataAbilityPredicates();
condition.equalTo("id", "xxx");
var resultColumns = [ "id", "display_name"];
// 调用query方法
DAHelper.query(rawContactUri, resultColumns, condition).then((data) => {
if (resultSet.goToFirstRow()) {
do {
var displayName = resultSet.getString(resultSet.getColumnIndex("display_name"));
} while (resultSet.goToNextRow());
}
resultSet.close();
});
系统公共uri |
---|
dataability:///com.ohos.contactsdataability |
dataability:///com.ohos.contactsdataability/contacts/contact |
dataability:///com.ohos.contactsdataability/contacts/raw_contact |
dataability:///com.ohos.contactsdataability/contacts/contact_data |
dataability:///com.ohos.contactsdataability/contacts/raw_contact/query_merge_list |
dataability:///com.ohos.contactsdataability/contacts/raw_contact/split_contact |
dataability:///com.ohos.contactsdataability/contacts/raw_contact/manual_merge |
dataability:///com.ohos.contactsdataability/contacts/raw_contact/auto_merge |
dataability:///com.ohos.contactsdataability/contacts/contact_type |
dataability:///com.ohos.contactsdataability/contacts/groups |
dataability:///com.ohos.contactsdataability/contacts/photo_files |
dataability:///com.ohos.contactsdataability/contacts/contact_blocklist |
dataability:///com.ohos.contactsdataability/contacts/deleted_raw_contact |
dataability:///com.ohos.contactsdataability/contacts/search_contact |
dataability:///com.ohos.contactsdataability/contacts/deleted_raw_contact |
dataability:///com.ohos.contactsdataability/contacts/deleted_raw_contact_record |
dataability:///com.ohos.contactsdataability/contacts/backup |
dataability:///com.ohos.contactsdataability/contacts/recover |
dataability:///com.ohos.contactsdataability/profile/contact |
dataability:///com.ohos.contactsdataability/profile/raw_contact |
dataability:///com.ohos.contactsdataability/profile/contact_data |
dataability:///com.ohos.contactsdataability/profile/raw_contact/query_merge_list |
dataability:///com.ohos.contactsdataability/profile/raw_contact/split_contact |
dataability:///com.ohos.contactsdataability/profile/raw_contact/manual_merge |
dataability:///com.ohos.contactsdataability/profile/raw_contact/auto_merge |
dataability:///com.ohos.contactsdataability/profile/contact_type |
dataability:///com.ohos.contactsdataability/profile/groups |
dataability:///com.ohos.contactsdataability/profile/photo_files |
dataability:///com.ohos.contactsdataability/profile/contact_blocklist |
dataability:///com.ohos.contactsdataability/profile/deleted_raw_contact |
dataability:///com.ohos.contactsdataability/profile/search_contact |
dataability:///com.ohos.contactsdataability/profile/deleted_raw_contact |
dataability:///com.ohos.contactsdataability/profile/deleted_raw_contact_record |
dataability:///com.ohos.contactsdataability/profile/backup |
dataability:///com.ohos.contactsdataability/profile/recover |
dataability:///com.ohos.calllogability |
dataability:///com.ohos.calllogability/calls/calllog |
dataability:///com.ohos.voicemailability |
dataability:///com.ohos.voicemailability/calls/voicemail |
系统应用
applications_contactsdata
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。