1# @ohos.data.commonType (数据通用类型)
2
3数据通用类型（commonType）是数据管理中通用的数据类型。
4
5> **说明：**
6>
7> 本模块首批接口从API version 11开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
8
9## 导入模块
10
11```ts
12import { commonType } from '@kit.ArkData';
13```
14
15## AssetStatus
16
17描述资产附件的状态枚举。请使用枚举名称而非枚举值。
18
19**系统能力：** SystemCapability.DistributedDataManager.CommonType
20
21| 名称              | 值  | 说明                         |
22| ----------------- | --- | ---------------------------- |
23| ASSET_NORMAL      | 1   | 表示资产状态正常。           |
24| ASSET_INSERT      | 2   | 表示资产需要插入到云端。     |
25| ASSET_UPDATE      | 3   | 表示资产需要更新到云端。     |
26| ASSET_DELETE      | 4   | 表示资产需要在云端删除。     |
27| ASSET_ABNORMAL    | 5   | 表示资产状态异常。           |
28| ASSET_DOWNLOADING | 6   | 表示资产正在下载到本地设备。 |
29
30## Asset
31
32记录资产附件（文件、图片、视频等类型文件）的相关信息。
33
34**系统能力：** SystemCapability.DistributedDataManager.CommonType
35
36| 名称       | 类型                        | 必填 | 说明                               |
37| ---------- | --------------------------- | ---- | ---------------------------------- |
38| name       | string                      | 是   | 资产的名称。                       |
39| uri        | string                      | 是   | 资产的uri，在系统里的绝对路径。    |
40| path       | string                      | 是   | 资产在应用沙箱里的路径。           |
41| createTime | string                      | 是   | 资产被创建出来的时间。             |
42| modifyTime | string                      | 是   | 资产最后一次被修改的时间。         |
43| size       | string                      | 是   | 资产占用空间的大小。               |
44| status     | [AssetStatus](#assetstatus) | 否   | 资产的状态，默认值为ASSET_NORMAL。 |
45
46## Assets
47
48type Assets = Array\<Asset>
49
50表示[Asset](#asset)类型的数组。
51
52**系统能力：** SystemCapability.DistributedDataManager.CommonType
53
54| 类型                         | 说明                  |
55| ---------------------------- | --------------------- |
56| Array&lt;[Asset](#asset)&gt; | 表示Asset类型的数组。 |
57
58## ValueType
59
60type ValueType = null | number | string | boolean | Uint8Array | Asset | Assets
61
62用于表示允许的数据字段类型，接口参数具体类型根据其功能而定。
63
64**系统能力：** SystemCapability.DistributedDataManager.CommonType
65
66| 类型       | 说明                                    |
67| ---------- | --------------------------------------- |
68| null       | 表示值类型为空。                        |
69| number     | 表示值类型为数字。                      |
70| string     | 表示值类型为字符串。                    |
71| boolean    | 表示值类型为布尔值。                    |
72| Uint8Array | 表示值类型为Uint8类型的数组。           |
73| Asset      | 表示值类型为附件[Asset](#asset)。       |
74| Assets     | 表示值类型为附件数组[Assets](#assets)。 |
75
76## ValuesBucket
77
78type ValuesBucket = Record<string, ValueType>
79
80用于存储键值对的类型。该类型不是多线程安全的，如果应用中存在多线程同时操作该类派生出的实例，注意加锁保护。
81
82**系统能力：** SystemCapability.DistributedDataManager.CommonType
83
84| 类型 | 说明                  |
85| ------ | ----------------------- |
86| Record<string, [ValueType](#valuetype)> | 表示键值对类型。键的类型为string，值的类型为[ValueType](#valuetype)。|
87