harmony 鸿蒙标准化数据定义

2023-10-30
浏览 (565)

标准化数据定义

场景介绍

为了构建OpenHarmony数据跨应用交互的标准定义，降低应用/业务数据交互成本，促进数据生态建设，UDMF提供了标准化的数据定义，统一定义了多种常用的数据类型。应用可以使用统一数据管理框架提供的接口创建和使用这些标准化数据类型。

例如跨应用拖拽场景，拖出方应用可以按照标准化数据定义将拖拽数据写入拖拽事件，拖入方应用从拖拽事件中读取拖拽数据并按照标准化数据定义进行数据的解析。这使得不同应用间的数据交互遵从相同的标准定义，避免了穷举式的数据类型适配，有效减少了跨应用数据交互的开发工作量。

标准化数据类型

UDMF提供的标准化数据类型主要包括以下几类：

基础数据类型： File、Text等，能够进行跨应用与跨平台流转，如图1和图2所示。

图1 UDMF File数据类型示意图

UDMF_FILE

图2 UDMF Text数据类型示意图

UDMF_TEXT

系统相关数据类型（System Defined Type, SDT）： 与具体的平台/操作系统绑定，如Form（UI卡片信息）、AppItem（App描述信息）、PixelMap（缩略图格式）等，该类数据可以实现系统/平台内的跨应用流转，如图3所示。

图3 UDMF SDT数据类型示意图

UDMF_SDT

应用自定义数据类型（App Defined Type, ADT）： 单个应用自定义的数据，该类数据可以实现应用内的跨平台流转，如图4所示为例，应用可自定义MyFile类型文件格式在应用生态内部使用。

图4 UDMF ADT数据类型示意图

UDMF_ADT

约束限制

UDMF中每条数据记录大小不超过2MB。
UDMF支持批量数据记录的分组管理，每个分组整体大小不超过4MB。

接口说明

UDMF提供了统一数据对象UnifiedData，用于封装一组数据记录UnifiedRecord。数据记录UnifiedRecord则是对UDMF支持的数据内容的抽象定义，例如一条文本记录、一条图片记录等。数据记录中的数据内容类型对应为各数据类型UniformDataType。

以下是常见的UDMF的接口说明，更多接口和具体说明，请见标准化数据通路和标准化数据定义与描述。

类名称	接口名称	描述
UnifiedRecord	getType(): string	获取当前数据记录对应的具体数据类型。
UnifiedData	constructor(record: UnifiedRecord)	用于创建带有一条数据记录的统一数据对象。
UnifiedData	addRecord(record: UnifiedRecord): void	在当前统一数据对象中添加一条数据记录。
UnifiedData	getRecords(): Array<UnifiedRecord>	将当前统一数据对象中的所有数据记录取出，通过本接口取出的数据为UnifiedRecord类型，需通过getType获取数据类型后转为子类再使用。

开发步骤

以一次创建统一数据对象（包含图片、纯文本两条数据记录）为例，说明开发步骤。

导入@ohos.data.unifiedDataChannel和@ohos.data.uniformTypeDescriptor模块。

   import unifiedDataChannel from '@ohos.data.unifiedDataChannel';
   import uniformTypeDescriptor from '@ohos.data.uniformTypeDescriptor';

创建图片数据记录，并初始化得到带有该数据记录的UnifiedData对象。

（1）创建图片数据记录。

   let image = new unifiedDataChannel.Image();

（2）修改对象属性。

   // Image对象包含一个属性imageUri
   image.imageUri = '...';

（3）访问对象属性。

   console.info(`imageUri = ${image.imageUri}`);

（4）创建一个统一数据对象实例。

   let unifiedData = new unifiedDataChannel.UnifiedData(image);

创建纯文本数据类型记录，将其添加到刚才创建的UnifiedData对象。

   let plainText = new unifiedDataChannel.PlainText();
   plainText.textContent = 'this is textContent of plainText';
   plainText.abstract = 'abstract of plainText';
   plainText.details = {
     plainKey1: 'plainValue1',
     plainKey2: 'plainValue2',
   };
   unifiedData.addRecord(plainText);

记录添加完成后，可获取当前UnifiedData对象内的所有数据记录。

   let records = unifiedData.getRecords();

遍历每条记录，判断该记录的数据类型，转换为子类对象，得到原数据记录。

   for (let i = 0; i < records.length; i ++) {
     // 读取该数据记录的类型
     let type = records[i].getType();
     switch (type) {
       case uniformTypeDescriptor.UniformDataType.IMAGE:
         // 转换得到原图片数据记录
         let image = records[i] as unifiedDataChannel.Image;
         break;
       case uniformTypeDescriptor.UniformDataType.PLAIN_TEXT:
         // 转换得到原文本数据记录
         let plainText = records[i] as unifiedDataChannel.PlainText;
         break;
       default:
         break;
     }
   }