建站
咨詢
售后
建站咨詢
新聞中心
使用 Data 模板的 Ability 形式仍然是 Ability，因此，開發(fā)者需要為應用添加一個或多個 Ability 的子類，來提供程序與其他應用之間的接口。Data 為結(jié)構(gòu)化數(shù)據(jù)和文件提供了不同 API 接口供用戶使用，因此，開發(fā)者需要首先確定好使用何種類型的數(shù)據(jù)。本章節(jié)主要講述了創(chuàng)建 Data 的基本步驟和需要使用的接口。
網(wǎng)站建設哪家好，找創(chuàng)新互聯(lián)！專注于網(wǎng)頁設計、網(wǎng)站建設、微信開發(fā)、微信小程序開發(fā)、集團企業(yè)網(wǎng)站建設等服務項目。為回饋新老客戶創(chuàng)新互聯(lián)還提供了沛縣免費建站歡迎大家使用！
確定數(shù)據(jù)存儲方式
確定數(shù)據(jù)的存儲方式，Data 支持以下兩種數(shù)據(jù)形式：
- 文件數(shù)據(jù)：如文本、圖片、音樂等。
- 結(jié)構(gòu)化數(shù)據(jù)：如數(shù)據(jù)庫等。
實現(xiàn) UserDataAbility
UserDataAbility 接收其他應用發(fā)送的請求，提供外部程序訪問的入口，從而實現(xiàn)應用間的數(shù)據(jù)訪問。Data 提供了文件存儲和數(shù)據(jù)庫存儲兩組接口供用戶使用。
文件存儲
開發(fā)者需要在 Data 中重寫 FileDescriptor openFile (Uri uri, String mode)方法來操作文件：uri 為客戶端傳入的請求目標路徑；mode 為開發(fā)者對文件的操作選項，可選方式包含“r”(讀), “w”(寫), “rw”(讀寫)等。
MessageParcel 類提供了一個靜態(tài)方法，用于獲取 MessageParcel 實例。通過dupFileDescriptor() 函數(shù)復制待操作文件流的文件描述符，并將其返回，供遠端應用使用。
示例：根據(jù)傳入的 uri 打開對應的文件
// 創(chuàng)建 messageParcel
MessageParcel messageParcel = MessageParcel.obtain();
File file = new File(uri.getDecodedPathList().get(1));
if (mode == null || !"rw".equals(mode)) {
file.setReadOnly();
}
FileInputStream fileIs = new FileInputStream(file);
FileDescriptor fd = fileIs.getFD();
// 綁定文件描述符
return messageParcel.dupFileDescriptor(fd);數(shù)據(jù)庫存儲
- 初始化數(shù)據(jù)庫連接。
系統(tǒng)會在應用啟動時調(diào)用 onStart()方法創(chuàng)建 Data 實例。在此方法中，開發(fā)者應該創(chuàng)建數(shù)據(jù)庫連接，并獲取連接對象，以便后續(xù)和數(shù)據(jù)庫進行操作。為了避免影響應用啟動速度，開發(fā)者應當盡可能將非必要的耗時任務推遲到使用時執(zhí)行，而不是在此方法中執(zhí)行所有初始化。
示例：初始化的時候連接數(shù)據(jù)庫
private static final String DATABASE_NAME ="UserDataAbility.db";
private static final String DATABASE_NAME_ALIAS = "UserDataAbility";
private OrmContext ormContext = null;
@Override
public void onStart(Intent intent) {
super.onStart(intent);
DatabaseHelper manager = new DatabaseHelper(this);
ormContext = manager.getOrmContext(DATABASE_NAME_ALIAS, DATABASE_NAME, BookStore.class);
}- 編寫數(shù)據(jù)庫操作方法。
Ability 定義了 6 個方法供用戶處理對數(shù)據(jù)庫表數(shù)據(jù)的增刪改查。這 6 個方法在 Ability 中已默認實現(xiàn)，開發(fā)者可按需重寫。
| 方法 | 描述 |
|---|---|
| ResultSet query(Uri uri, String[] columns, DataAbilityPredicates predicates) | 查詢數(shù)據(jù)庫 |
| int insert(Uri uri, ValuesBucket value) | 向數(shù)據(jù)庫中插入單條數(shù)據(jù) |
| int batchInsert(Uri uri, ValuesBucket[] values) | 向數(shù)據(jù)庫中插入多條數(shù)據(jù) |
| int delete(Uri uri, DataAbilityPredicates predicates) | 刪除一條或多條數(shù)據(jù) |
| int update(Uri uri, ValuesBucket value, DataAbilityPredicates predicates) | 更新數(shù)據(jù)庫 |
| DataAbilityResult[] executeBatch(ArrayList | 批量操作數(shù)據(jù)庫 |
這些方法的使用說明如下：
- query()
該方法接收三個參數(shù)，分別是查詢的目標路徑，查詢的列名，以及查詢條件，查詢條件由類 DataAbilityPredicates 構(gòu)建。根據(jù)傳入的列名和查詢條件查詢用戶表的代碼示例如下：
public ResultSet query(Uri uri, String[] columns, DataAbilityPredicates predicates) {
if (ormContext == null) {
HiLog.error(this.getClass().getSimpleName(), "failed to query, ormContext is null");
return null;
}
// 查詢數(shù)據(jù)庫
OrmPredicates ormPredicates = DataAbilityUtils.createOrmPredicates(predicates,User.class);
ResultSet resultSet = ormContext.query(ormPredicates, columns);
if (resultSet == null) {
HiLog.info(this.getClass(), "resultSet is null");
}
// 返回結(jié)果
return resultSet;
}- insert()
該方法接收兩個參數(shù)，分別是插入的目標路徑和插入的數(shù)據(jù)值。其中，插入的數(shù)據(jù)由 ValuesBucket 封裝，服務端可以從該參數(shù)中解析出對應的屬性，然后插入到數(shù)據(jù)庫中。此方法返回一個 int 類型的值用于標識結(jié)果。接收到傳過來的用戶信息并把它保存到數(shù)據(jù)庫中的代碼示例如下：
public int insert(Uri uri, ValuesBucket value) {
// 參數(shù)校驗
if (ormContext == null) {
HiLog.error(this.getClass().getSimpleName(), "failed to insert, ormContext is null");
return -1;
}
String path = uri.getPath();
if (buildPathMatcher().getPathId(path) != PathId) {
HiLog.info(this.getClass(), "UserDataAbility insert path is not matched");
return -1;
}
// 構(gòu)造插入數(shù)據(jù)
User user = new User();
user.setUserId(value.getInteger("userId"));
user.setFirstName(value.getString("firstName"));
user.setLastName(value.getString("lastName"));
user.setAge(value.getInteger("age"));
user.setBalance(value.getDouble("balance"));
// 插入數(shù)據(jù)庫
boolean isSuccessed = true;
try {
isSuccessed = ormContext.insert(user);
} catch (DataAbilityRemoteException e) {
HiLog.error(TAG, "insert fail: " + e.getMessage());
throw new RuntimeException(e);
}
if (!isSuccessed) {
HiLog.error(this.getClass().getSimpleName(), "failed to insert");
return -1;
}
isSuccessed = ormContext.flush();
if (!isSuccessed) {
HiLog.error(this.getClass().getSimpleName(), "failed to insert flush");
return -1;
}
DataAbilityHelper.creator(this, uri).notifyChange(uri);
int id = Math.toIntExact(user.getRowId());
return id;
}- batchInsert()
該方法為批量插入方法，接收一個 ValuesBucket 數(shù)組用于單次插入一組對象。它的作用是提高插入多條重復數(shù)據(jù)的效率。該方法系統(tǒng)已實現(xiàn)，開發(fā)者可以直接調(diào)用。
- delete()
該方法用來執(zhí)行刪除操作。刪除條件由類 DataAbilityPredicates 構(gòu)建，服務端在接收到該參數(shù)之后可以從中解析出要刪除的數(shù)據(jù)，然后到數(shù)據(jù)庫中執(zhí)行。根據(jù)傳入的條件刪除用戶表數(shù)據(jù)的代碼示例如下：
public int delete(Uri uri, DataAbilityPredicates predicates) {
if (ormContext == null) {
HiLog.error(this.getClass().getSimpleName(), "failed to delete, ormContext is null");
return -1;
}
OrmPredicates ormPredicates = DataAbilityUtils.createOrmPredicates(predicates,User.class);
int value = ormContext.delete(ormPredicates);
DataAbilityHelper.creator(this, uri).notifyChange(uri);
return value;
}- update()
此方法用來執(zhí)行更新操作。用戶可以在 ValuesBucket 參數(shù)中指定要更新的數(shù)據(jù)，在 DataAbilityPredicates 中構(gòu)建更新的條件等。更新用戶表的數(shù)據(jù)的代碼示例如下：
public int update(Uri uri, ValuesBucket value, DataAbilityPredicates predicates) {
if (ormContext == null) {
HiLog.error(this.getClass().getSimpleName(), "failed to update, ormContext is null");
return -1;
}
OrmPredicates ormPredicates = DataAbilityUtils.createOrmPredicates(predicates,User.class);
int index = ormContext.update(ormPredicates, value);
HiLog.info(this.getClass(), "UserDataAbility update value:" + index);
DataAbilityHelper.creator(this, uri).notifyChange(uri);
return index;
}- executeBatch()
此方法用來批量執(zhí)行操作。DataAbilityOperation 中提供了設置操作類型、數(shù)據(jù)和操作條件的方法，用戶可自行設置自己要執(zhí)行的數(shù)據(jù)庫操作。該方法系統(tǒng)已實現(xiàn)，開發(fā)者可以直接調(diào)用。
注冊UserDataAbility
和 Service 類似，開發(fā)者必須在配置配置文件中注冊 Data。并且配置以下屬性：
- type: 類型設置為 data
- uri: 對外提供的訪問路徑，全局唯一
- permissions: 訪問該 data ability 時需要申請的訪問權限
{
"name": ".UserDataAbility",
"type": "data",
"visible": true,
"uri": "dataability://com.example.myapplication5.DataAbilityTest",
"permissions": [
"com.example.myapplication5.DataAbility.DATA"
]
}當前標題：創(chuàng)新互聯(lián)鴻蒙OS教程：鴻蒙OS創(chuàng)建Data
分享網(wǎng)址：http://m.5511xx.com/article/cdiigjd.html
