信息應用

簡介

內容介紹

Mms應用是OpenHarmony中預置的系統應用，主要的功能包含信息查看、發送短信、接收短信、短信送達報告、刪除短信等功能。

架構圖

MMS_architectural_diagram

/Mms/
├── doc                                        # 資料
├── entry
│   └── src
│       └── main
│           └── ets                            # ets代碼目錄
│               └── default                    # 業務代碼目錄
│                   ├── data                   # 自定義數據類型
│                   ├── model                  # 對接數據庫
│                   ├── pages                  # 所有頁面
│                       ├── conversation       # 會話詳情頁面
│                       ├── conversationlist   # 信息列表頁面
│                       ├── index              # 初始頁面
│                       ├── infomsg            # 通知信息列表頁面
│                       ├── queryreport        # 報告詳情頁面
│                       └── settings           # 設置頁面
│                   ├── service                # 業務邏輯
│                   ├── utils                  # 工具類
│                   ├── views                  # 自定義組件
│                   └── app.ets                # 應用生命周期
│               └── StaticSubscriber           # 靜態事件監聽
│           ├── resources                      # 資源配置文件存放目錄
│           └── config.json                    # 全局配置文件
├── signs                                      # 簽名
└── LICENSE

聯系人應用

簡介

開發前請熟悉鴻蒙開發指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

內容介紹

Contacts應用是OpenHarmony中預置的系統應用，主要的功能包含撥號盤、通話記錄查看、通話記錄批量刪除、聯系人列表、詳情查看和聯系人的新建等功能。

架構圖

該應用架構主要結合MVP+領域驅動設計思路。

/Contacts/
├── doc                                    # 資料
├── common                                 # 通用工具
├── feature                                # 業務模塊
│   └── src
│       └── main
│           └── ets     
|               ├── account                # 聯系人賬號
│               ├── call                   # 通話記錄
│               ├── contact                # 聯系人
│                   ├── contact            # 存儲契約
│                   ├── entity             # 實體
│                   └── repo               # 倉庫
│               ├── dialpad                # 撥號盤
│               ├── phonenumber            # 手機號碼
│               └── simcard                # SIM卡
├── entry                 
│   └── src
│       └── main
│           └── ets                        # js代碼目錄
│               └── MainAbility            # 公共頁面樣式
│                   ├── component          # 組件封裝
│                   ├── feature            # 特性集合
│                   |── model              # 模型
│                   |── pages              # TS聲明式頁面/組件
│                   |── presenter          # 頁面展示邏輯
│                   |── util               # 工具類
│                   └── workers            # JS多線程服務
│               └── app.ets                # 應用生命周期/公共方法存放
│           ├── resources                  # 資源配置文件存放目錄
│           └── config.json                # 全局配置文件
├── infra                                  # 構建腳本
├── signs                                  # 簽名
└── LICENSE

聯系人數據庫子系統

applications_contactsdata

簡介

聯系人數據庫應用是每一個用戶管理聯系人數據庫的不可缺少的一個信息管理應用，它的內容對于用戶管理者來說是至關重要的，所以聯系人數據庫應該能夠為每一個用戶的管理提供充足的信息和快捷查詢手段，大大方便用戶合理的管理聯系人數據庫信息。

架構圖

/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、DataSharePredicates

使用功能接口前，需要導入相關模塊。

import dataShare from '@ohos.data.dataShare';

通話記錄

dataShareHelper.insert(uri: string, value: ValuesBucket)

接口說明
通話記錄插入
insert參數描述
名稱讀寫屬性類型必填描述
uri 只讀 string 是具體操作的uri
value 只讀 ValuesBucket 是數據庫字段key-value對象

名稱	讀寫屬性	類型	必填	描述
uri	只讀	string	是	具體操作的uri
value	只讀	ValuesBucket	是	數據庫字段key-value對象

返回值為通話記錄id

更新示例

import dataShare from '@ohos.data.dataShare';
var calllogData = "datashare:///com.ohos.calllogability";
var calllogUri = "datashare:///com.ohos.calllogability/calls/calllog";
var value = {"phone_number" : "xxxxx","display_name" : "xxx"};
// 獲取dataShareHelper
let dataShareHelper = dataShare.createDataShareHelper(calllogData);
// 調用insert方法
dataShareHelper.insert(calllogUri, value).then((data) = > {
	console.info("calllogId = " + data);
});

dataShareHelper.update(uri: string, condition: DataSharePredicates, value: ValuesBucket)

接口說明
通話記錄修改
update參數描述
名稱讀寫屬性類型必填描述
uri 只讀 string 是具體操作的uri
condition 只讀 DataSharePredicates 是更新條件
value 只讀 ValuesBucket 是數據庫字段key-value對象

名稱	讀寫屬性	類型	必填	描述
uri	只讀	string	是	具體操作的uri
condition	只讀	DataSharePredicates	是	更新條件
value	只讀	ValuesBucket	是	數據庫字段key-value對象

返回值為成功為0否則為-1

修改示例

import dataShare from '@ohos.data.dataShare';
var calllogData = "datashare:///com.ohos.calllogability";
var calllogUri = "datashare:///com.ohos.calllogability/calls/calllog";
var value = {"phone_number" : "xxxxx","display_name" : "xxx"};
// 獲取dataShareHelper
let dataShareHelper = dataShare.createDataShareHelper(calllogData);
// 條件參數
let condition = new dataShare.DataSharePredicates();
condition.equalTo("id", "xxx");
// 調用update方法
dataShareHelper.update(calllogUri, value, condition).then((data) = > {
	console.info("resultCode = " + data);
});

dataShareHelper.delete(uri: string, condition: DataSharePredicates)

接口說明
通話記錄刪除
delete參數描述
名稱讀寫屬性類型必填描述
uri 只讀 string 是具體操作的uri
condition 只讀 DataSharePredicates 是刪除條件

名稱	讀寫屬性	類型	必填	描述
uri	只讀	string	是	具體操作的uri
condition	只讀	DataSharePredicates	是	刪除條件

返回值為成功為0否則為-1

刪除示例

import dataShare from '@ohos.data.dataShare';
var calllogData = "datashare:///com.ohos.calllogability";
var calllogUri = "datashare:///com.ohos.calllogability/calls/calllog";
// 獲取dataShareHelper
let dataShareHelper = dataShare.createDataShareHelper(calllogData);
// 條件參數
let condition = new dataShare.DataSharePredicates();
condition.equalTo("id", "xxx");
// 調用delete方法
dataShareHelper.delete(calllogUri, condition).then((data) = > {
	console.info("deleteCode = " + data);
});

dataShareHelper.query(uri: string, condition: DataSharePredicates, resultColumns: array)

接口說明
通話記錄查詢
查詢參數描述
名稱讀寫屬性類型必填描述
uri 只讀 string 是具體操作的uri
condition 只讀 DataSharePredicates 是查詢條件
resultColumns 只讀 array 是需要查詢的列字段名稱

名稱	讀寫屬性	類型	必填	描述
uri	只讀	string	是	具體操作的uri
condition	只讀	DataSharePredicates	是	查詢條件
resultColumns	只讀	array	是	需要查詢的列字段名稱

返回值為 ResultSet 查詢結果集

查詢示例

import dataShare from '@ohos.data.dataShare';
var calllogData = "datashare:///com.ohos.calllogability";
var calllogUri = "datashare:///com.ohos.calllogability/calls/calllog";
// 獲取dataShareHelper
let dataShareHelper = dataShare.createDataShareHelper(calllogData);
// 條件參數
let condition = new dataShare.DataSharePredicates();
condition.equalTo("id", "xxx");
var resultColumns = [ "id", "display_name", "phone_number"];
// 調用query方法
dataShareHelper.query(calllogUri, resultColumns, condition).then((resultSet) = > {
    if (resultSet.goToFirstRow()) {
        do {
            var displayName = resultSet.getString(resultSet.getColumnIndex("display_name"));
            var id = resultSet.getLong(resultSet.getColumnIndex("id"));
            var phoneNumber = resultSet.getString(resultSet.getColumnIndex("phone_number"));
        } while (resultSet.goToNextRow());
    }
    resultSet.close();	
});

返回值為 ResultSet 查詢結果集

語音信箱

dataShareHelper.insert(uri: string, value: ValuesBucket)

接口說明
語音信箱插入
insert參數描述
名稱讀寫屬性類型必填描述
uri 只讀 string 是具體操作的uri
value 只讀 ValuesBucket 是數據庫字段key-value對象

名稱	讀寫屬性	類型	必填	描述
uri	只讀	string	是	具體操作的uri
value	只讀	ValuesBucket	是	數據庫字段key-value對象

返回值為語音信箱表id

更新示例

import dataShare from '@ohos.data.dataShare';
var voicemailData = "datashare:///com.ohos.voicemailability";
var voicemailUri = "datashare:///com.ohos.voicemailability/calls/voicemail";
var value = {"phone_number" : "xxxxx","display_name" : "xxx"};
// 獲取dataShareHelper
let dataShareHelper = dataShare.createDataShareHelper(voicemailData);
// 調用insert方法
dataShareHelper.insert(voicemailUri, value).then((data) = > {
	console.info("calllogId = " + data);
});

dataShareHelper.update(uri: string, condition:DataSharePredicates, value: ValuesBucket)

接口說明
語音信箱修改
update參數描述
名稱讀寫屬性類型必填描述
uri 只讀 string 是具體操作的uri
condition 只讀 DataSharePredicates 是更新條件
value 只讀 ValuesBucket 是數據庫字段key-value對象

名稱	讀寫屬性	類型	必填	描述
uri	只讀	string	是	具體操作的uri
condition	只讀	DataSharePredicates	是	更新條件
value	只讀	ValuesBucket	是	數據庫字段key-value對象

返回值為成功為0否則為-1

修改示例

import dataShare from '@ohos.data.dataShare';
var voicemailData = "datashare:///com.ohos.voicemailability";
var voicemailUri = "datashare:///com.ohos.voicemailability/calls/voicemail";
var value = {"phone_number" : "xxxxx","display_name" : "xxx"};
// 獲取dataShareHelper
let dataShareHelper = dataShare.createDataShareHelper(voicemailData);
// 條件參數
let condition = new dataShare.DataSharePredicates();
condition.equalTo("id", "xxx");
// 調用update方法
dataShareHelper.update(voicemailUri, value, condition).then((data) = > {
	console.info("resultCode = " + data);
});

dataShareHelper.delete(uri: string, condition: DataSharePredicates)

接口說明
語音信箱刪除
delete參數描述
名稱讀寫屬性類型必填描述
uri 只讀 string 是具體操作的uri
condition 只讀 DataSharePredicates 是刪除條件

名稱	讀寫屬性	類型	必填	描述
uri	只讀	string	是	具體操作的uri
condition	只讀	DataSharePredicates	是	刪除條件

返回值為成功為0否則為-1

刪除示例

import dataShare from '@ohos.data.dataShare';
var voicemailData = "datashare:///com.ohos.voicemailability";
var voicemailUri = "datashare:///com.ohos.voicemailability/calls/voicemail";
// 獲取dataShareHelper
let dataShareHelper = dataShare.createDataShareHelper(voicemailData);
// 條件參數
let condition = new dataShare.DataSharePredicates();
condition.equalTo("id", "xxx");
// 調用delete方法
dataShareHelper.delete(voicemailUri, condition).then((data) = > {
	console.info("deleteCode = " + data);
});

dataShareHelper.query(uri: string, condition: DataSharePredicates, resultColumns:array)

接口說明
語音信箱查詢
查詢參數描述
名稱讀寫屬性類型必填描述
uri 只讀 string 是具體操作的uri
condition 只讀 DataSharePredicates 是查詢條件
resultColumns 只讀 array 是需要查詢的列字段名稱

名稱	讀寫屬性	類型	必填	描述
uri	只讀	string	是	具體操作的uri
condition	只讀	DataSharePredicates	是	查詢條件
resultColumns	只讀	array	是	需要查詢的列字段名稱

返回值為 ResultSet 查詢結果集

查詢示例

import dataShare from '@ohos.data.dataShare';
var voicemailData = "datashare:///com.ohos.voicemailability";
var voicemailUri = "datashare:///com.ohos.voicemailability/calls/voicemail";
// 獲取dataShareHelper
let dataShareHelper = dataShare.createDataShareHelper(voicemailData);
// 條件參數
let condition = new dataShare.DataSharePredicates();
condition.equalTo("id", "xxx");
var resultColumns = [ "id", "display_name", "phone_number"];
// 調用query方法
dataShareHelper.query(voicemailUri, resultColumns, condition).then((resultSet) = > {
    if (resultSet.goToFirstRow()) {
        do {
            var displayName = resultSet.getString(resultSet.getColumnIndex("display_name"));
            var id = resultSet.getLong(resultSet.getColumnIndex("id"));
            var phoneNumber = resultSet.getString(resultSet.getColumnIndex("phone_number"));
        } while (resultSet.goToNextRow());
    }
    resultSet.close();	
});

聯系人

dataShareHelper.insert(uri: string, value: ValuesBucket)

接口說明
聯系人插入
insert參數描述
名稱讀寫屬性類型必填描述
uri 只讀 string 是具體操作的uri
value 只讀 ValuesBucket 是數據庫字段key-value對象

名稱	讀寫屬性	類型	必填	描述
uri	只讀	string	是	具體操作的uri
value	只讀	ValuesBucket	是	數據庫字段key-value對象

返回值為聯系人數據表id

更新示例

import dataShare from '@ohos.data.dataShare';
var contactsData = "datashare:///com.ohos.contactsdataability";
var rawContactUri = "datashare:///com.ohos.contactsdataability/contacts/raw_contact";
var contactDataUri = "datashare:///com.ohos.contactsdataability/contacts/contact_data";
var value = {"display_name" : "xxx"};
// 獲取dataShareHelper
let dataShareHelper = dataShare.createDataShareHelper(contactsData);
// 調用insert方法
dataShareHelper.insert(rawContactUri, value).then((rawContactId) = > {
	console.info("rawContactId = " + rawContactId);
    // 聯系人詳細信息插入
    var contactDataValues = {
        "raw_contact_id" : rawContactId,
        "content_type" : "name",
        "detail_info" : "xxxxxxx"
    };
   dataShareHelper.insert(contactDataUri, contactDataValues).then((contactDataId) = > {
      console.info("rawContactId = " + contactDataId);
   };
});

dataShareHelper.update(uri: string, condition: DataSharePredicates, value: ValuesBucket)

接口說明
聯系人修改
update參數描述
名稱讀寫屬性類型必填描述
uri 只讀 string 是具體操作的uri
condition 只讀 DataSharePredicates 是更新條件
value 只讀 ValuesBucket 是數據庫字段key-value對象

名稱	讀寫屬性	類型	必填	描述
uri	只讀	string	是	具體操作的uri
condition	只讀	DataSharePredicates	是	更新條件
value	只讀	ValuesBucket	是	數據庫字段key-value對象

返回值為成功為0否則為-1

修改示例

import dataShare from '@ohos.data.dataShare';
var contactsData = "datashare:///com.ohos.contactsdataability";
var rawContactUri = "datashare:///com.ohos.contactsdataability/contacts/raw_contact";
var contactDataUri = "datashare:///com.ohos.contactsdataability/contacts/contact_data";
var value = {"display_name" : "xxx"};
// 獲取dataShareHelper
let dataShareHelper = dataShare.createDataShareHelper(contactsData);
// 條件參數
let condition = new dataShare.DataSharePredicates();
condition.equalTo("id", "xxx");
// 調用update方法
dataShareHelper.update(rawContactUri, value, condition).then((data) = > {
	console.info("resultCode = " + data);
});

dataShareHelper.delete(uri: string, condition: DataSharePredicates)

接口說明
聯系人刪除
delete參數描述
名稱讀寫屬性類型必填描述
uri 只讀 string 是具體操作的uri
condition 只讀 DataSharePredicates 是刪除條件

名稱	讀寫屬性	類型	必填	描述
uri	只讀	string	是	具體操作的uri
condition	只讀	DataSharePredicates	是	刪除條件

返回值為成功為0否則為-1

刪除示例

import dataShare from '@ohos.data.dataShare';
var contactsData = "datashare:///com.ohos.contactsdataability";
var rawContactUri = "datashare:///com.ohos.contactsdataability/contacts/raw_contact";
var contactDataUri = "datashare:///com.ohos.contactsdataability/contacts/contact_data";
// 獲取dataShareHelper
let dataShareHelper = dataShare.createDataShareHelper(contactsData);
// 條件參數
let condition = new dataShare.DataSharePredicates();
condition.equalTo("id", "xxx");
// 調用delete方法
dataShareHelper.delete(contactDataUri, condition).then((data) = > {
	console.info("deleteCode = " + data);
});

dataShareHelper.query(uri: string, condition: DataSharePredicates, resultColumns: array)

接口說明
聯系人查詢
查詢參數描述
名稱讀寫屬性類型必填描述
uri 只讀 string 是具體操作的uri
condition 只讀 DataSharePredicates 是查詢條件
resultColumns 只讀 array 是需要查詢的列字段名稱

名稱	讀寫屬性	類型	必填	描述
uri	只讀	string	是	具體操作的uri
condition	只讀	DataSharePredicates	是	查詢條件
resultColumns	只讀	array	是	需要查詢的列字段名稱

返回值為 ResultSet 查詢結果集

查詢示例

import dataShare from '@ohos.data.dataShare';
var contactsData = "datashare:///com.ohos.contactsdataability";
var rawContactUri = "datashare:///com.ohos.contactsdataability/contacts/raw_contact";
// 獲取dataShareHelper
let dataShareHelper = dataShare.createDataShareHelper(contactsData);
// 條件參數
let condition = new dataShare.DataSharePredicates();
condition.equalTo("id", "xxx");
var resultColumns = [ "id", "display_name"];
// 調用query方法
dataShareHelper.query(rawContactUri, resultColumns, condition).then((resultSet) = > {
    if (resultSet.goToFirstRow()) {
        do {
            var displayName = resultSet.getString(resultSet.getColumnIndex("display_name"));
        } while (resultSet.goToNextRow());
    }
    resultSet.close();	
});

`HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`

搜狗高速瀏覽器截圖20240326151344.png

系統公共uri

| datashare:///com.ohos.contactsdataability                                       |
| datashare:///com.ohos.contactsdataability/contacts/contact                      |
| datashare:///com.ohos.contactsdataability/contacts/raw_contact                  |
| datashare:///com.ohos.contactsdataability/contacts/contact_data                 |
| datashare:///com.ohos.contactsdataability/contacts/raw_contact/query_merge_list |
| datashare:///com.ohos.contactsdataability/contacts/raw_contact/split_contact    |
| datashare:///com.ohos.contactsdataability/contacts/raw_contact/manual_merge     |
| datashare:///com.ohos.contactsdataability/contacts/raw_contact/auto_merge       |
| datashare:///com.ohos.contactsdataability/contacts/contact_type                 |
| datashare:///com.ohos.contactsdataability/contacts/groups                       |
| datashare:///com.ohos.contactsdataability/contacts/photo_files                  |
| datashare:///com.ohos.contactsdataability/contacts/contact_blocklist            |
| datashare:///com.ohos.contactsdataability/contacts/deleted_raw_contact          |
| datashare:///com.ohos.contactsdataability/contacts/search_contact               |
| datashare:///com.ohos.contactsdataability/contacts/deleted_raw_contact          |
| datashare:///com.ohos.contactsdataability/contacts/deleted_raw_contact_record   |
| datashare:///com.ohos.contactsdataability/contacts/backup                       |
| datashare:///com.ohos.contactsdataability/contacts/recover                      |
| datashare:///com.ohos.contactsdataability/profile/contact                       |
| datashare:///com.ohos.contactsdataability/profile/raw_contact                   |
| datashare:///com.ohos.contactsdataability/profile/contact_data                  |
| datashare:///com.ohos.contactsdataability/profile/raw_contact/query_merge_list  |
| datashare:///com.ohos.contactsdataability/profile/raw_contact/split_contact     |
| datashare:///com.ohos.contactsdataability/profile/raw_contact/manual_merge      |
| datashare:///com.ohos.contactsdataability/profile/raw_contact/auto_merge        |
| datashare:///com.ohos.contactsdataability/profile/contact_type                  |
| datashare:///com.ohos.contactsdataability/profile/groups                        |
| datashare:///com.ohos.contactsdataability/profile/photo_files                   |
| datashare:///com.ohos.contactsdataability/profile/contact_blocklist             |
| datashare:///com.ohos.contactsdataability/profile/deleted_raw_contact           |
| datashare:///com.ohos.contactsdataability/profile/search_contact                |
| datashare:///com.ohos.contactsdataability/profile/deleted_raw_contact           |
| datashare:///com.ohos.contactsdataability/profile/deleted_raw_contact_record    |
| datashare:///com.ohos.contactsdataability/profile/backup                        |
| datashare:///com.ohos.contactsdataability/profile/recover                       |
| datashare:///com.ohos.calllogability                                            |
| datashare:///com.ohos.calllogability/calls/calllog                              |
| datashare:///com.ohos.voicemailability                                          |
| datashare:///com.ohos.voicemailability/calls/voicemail