鸿蒙OS PersistablePacMap

PersistablePacMap

java.lang.Object

|---ohos.utils.BasePacMap

|---|---ohos.utils.PersistablePacMap

public class PersistablePacMap
extends BasePacMap

扩展 BasePacMap 类并使用 JSON 字符串表示永久存储数据。

嵌套类摘要

从接口 ohos.utils.Sequenceable 继承的嵌套类/接口
Sequenceable.ProducerT

字段摘要

从类 ohos.utils.BasePacMap 继承的字段
dataMap

构造函数摘要

构造函数	描述
PersistablePacMap()	用于创建空 PersistablePacMap 实例的构造函数。
PersistablePacMap(int capacity)	用于创建包含容量键值对的空 PersistablePacMap 实例的构造函数。

方法总结

修饰符和类型	方法	描述
PersistablePacMap	deepCopy()	创建 PersistablePacMap 对象的深层副本。
static PersistablePacMap	fromJsonString(String jsonString)	基于给定的 JSON 字符串创建 PersistablePacMap 对象。
boolean[]	getBooleanValueArray(String key)	覆盖 BasePacMap#getBooleanValueArray 方法以获取未编组的 PersistablePacMap 对象中的布尔数组，其中数组已转换为 JsonArray。
double	getDoubleValue(String key)	覆盖 BasePacMap#getDoubleValue 方法以获取 unmarshalled PersistablePacMap 对象中的 double 值，其中 double 已转换为 BigDecimal。
double[]	getDoubleValueArray(String key)	覆盖 BasePacMap#getDoubleValueArray 方法以获取未编组的 PersistablePacMap 对象中的双精度数组，其中数组已转换为 JsonArray。
float	getFloatValue(String key)	重写 BasePacMap#getFloatValue 方法以获取未编组的 PersistablePacMap 对象中的浮点值，其中浮点已转换为 BigDecimal。
float[]	getFloatValueArray(String key)	覆盖 BasePacMap#getFloatValueArray 方法以获取未编组的 PersistablePacMap 对象中的浮点数组，其中数组已转换为 JsonArray。
int[]	getIntValueArray(String key)	覆盖 BasePacMap#getIntValueArray 方法以获取未编组的 PersistablePacMap 对象中的 int 数组，其中数组已转换为 JsonArray。
long	getLongValue(String key)	重写 BasePacMap#getLongValue 方法以获取未编组的 PersistablePacMap 对象中的 long 值，其中 long 已转换为 Integer。
long[]	getLongValueArray(String key)	覆盖 BasePacMap#getLongValueArray 方法以获取未编组的 PersistablePacMap 对象中的长数组，其中数组已转换为 JsonArray。
PersistablePacMap	getPersistablePacMap(String key)	获取具有指定键的 PersistablePacMap 对象。
short	getShortValue(String key)	覆盖 BasePacMap#getShortValue 方法以获取未编组的 PersistablePacMap 对象中的 short 值，其中 short 已转换为 Integer。
short[]	getShortValueArray(String key)	覆盖 BasePacMap#getShortValueArray 方法以获取未编组的 PersistablePacMap 对象中的短数组，其中数组已转换为 JsonArray。
static boolean	isValidValueType(Object value)	检查值对象的类型是否支持对 JSON 字符串进行编组和解组。
void	putPersistablePacMap(String key, PersistablePacMap value)	将具有指定键的 PersistablePacMap 对象添加到此 PersistablePacMap 对象中。
String	toJsonString()	获取 PersistablePacMap 对象的 JSON 字符串表示形式。

从类 ohos.utils.BasePacMap 继承的方法

clear, clone, equals, getAll, getBooleanValue, getBooleanValue, getByteValue, getByteValue, getByteValueArray, getChar, getChar, getCharArray, getClassLoader, getDimension, getDoubleValue, getFloatDimension, getFloatValue, getIntValue, getIntValue, getKeys, getLongValue, getObjectValue, getObjectValue, getPlainArray, getRemoteObject, getShortValue, getSize, getString, getString, getStringArray, hasFileDescriptor, hashCode, hasKey, isEmpty, marshalling, putAll, putAll, putBooleanValue, putBooleanValueArray, putByteValue, putByteValueArray, putChar, putCharArray, putDimension, putDoubleValue, putDoubleValueArray, putFloatDimension, putFloatValue, putFloatValueArray, putIntValue, putIntValueArray, putLongValue, putLongValueArray, putObjectValue, putPlainArray, putRemoteObject, putShortValue, putShortValueArray, putString, putStringArray, remove, setClassLoader, unmarshalling

从类 java.lang.Object 继承的方法
finalize, getClass, notify, notifyAll, toString, wait, wait, wait

构造函数详细信息

PersistablePacMap

public PersistablePacMap()

用于创建空 PersistablePacMap 实例的构造函数。

PersistablePacMap

public PersistablePacMap(int capacity)

用于创建包含容量键值对的空 PersistablePacMap 实例的构造函数。

参数：

参数名称	参数描述
capacity	指示 PersistablePacMap 实例中键值对的数量。

方法详情

deepCopy

public PersistablePacMap deepCopy()

创建 PersistablePacMap 对象的深层副本。

执行深拷贝以创建与原始对象具有相同内容的对象。

返回:

返回 PersistablePacMap 对象的深层副本。

isValidValueType

public static boolean isValidValueType(Object value)

检查值对象的类型是否支持对 JSON 字符串进行编组和解组。

参数：

参数名称	参数描述
value	表示要检查的对象。

返回:

如果值对象支持编组和解组，则返回 true； 否则返回 false。

putPersistablePacMap

public void putPersistablePacMap(String key, PersistablePacMap value)

将具有指定键的 PersistablePacMap 对象添加到此 PersistablePacMap 对象中。

如果指定的键已经存在，它的值将被替换为值。

参数：

参数名称	参数描述
key	表示要添加的对象的键。

getPersistablePacMap

public PersistablePacMap getPersistablePacMap(String key)

获取具有指定键的 PersistablePacMap 对象。

参数：

参数名称	参数描述
key	表示用于查询对象的键。 该值可以为空。

返回:

返回匹配指定键的 PersistablePacMap 对象； 如果匹配的值不是 PersistablePacMap 对象或未获得任何值，则返回 null。

getShortValue

public short getShortValue(String key)

覆盖 BasePacMap#getShortValue 方法以获取未编组的 PersistablePacMap 对象中的 short 值，其中 short 已转换为 Integer。

覆盖：

BasePacMap 类中的 getShortValue

参数：

参数名称	参数描述
key	表示要获取的短值的key。

返回:

返回与指定键匹配的短值。

getLongValue

public long getLongValue(String key)

重写 BasePacMap#getLongValue 方法以获取未编组的 PersistablePacMap 对象中的 long 值，其中 long 已转换为 Integer。

覆盖：

类 BasePacMap 中的 getLongValue

参数：

参数名称	参数描述
key	表示要获取的long值的key。

返回:

返回与指定键匹配的长值。

getDoubleValue

public double getDoubleValue(String key)

覆盖 BasePacMap#getDoubleValue 方法以获取 unmarshalled PersistablePacMap 对象中的 double 值，其中 double 已转换为 BigDecimal。

覆盖：

BasePacMap 类中的 getDoubleValue

参数：

参数名称	参数描述
key	表示要获取的double值的key。

返回:

返回与指定键匹配的双精度值。

getFloatValue

public float getFloatValue(String key)

重写 BasePacMap#getFloatValue 方法以获取未编组的 PersistablePacMap 对象中的浮点值，其中浮点已转换为 BigDecimal。

覆盖：

BasePacMap 类中的 getFloatValue

参数：

参数名称	参数描述
key	表示要获取的浮点值的键。

返回:

返回与指定键匹配的浮点值。

getIntValueArray

public int[] getIntValueArray(String key)

覆盖 BasePacMap#getIntValueArray 方法以获取未编组的 PersistablePacMap 对象中的 int 数组，其中数组已转换为 JsonArray。

覆盖：

类 BasePacMap 中的 getIntValueArray

参数：

参数名称	参数描述
key	指示要获取的 int 数组的键。

返回:

返回与指定键匹配的 int 数组。

getShortValueArray

public short[] getShortValueArray(String key)

覆盖 BasePacMap#getShortValueArray 方法以获取未编组的 PersistablePacMap 对象中的短数组，其中数组已转换为 JsonArray。

覆盖：

BasePacMap 类中的 getShortValueArray

参数：

参数名称	参数描述
key	表示要获取的短数组的key。

返回:

返回与指定键匹配的短数组。

getLongValueArray

public long[] getLongValueArray(String key)

覆盖 BasePacMap#getLongValueArray 方法以获取未编组的 PersistablePacMap 对象中的长数组，其中数组已转换为 JsonArray。

覆盖：

BasePacMap 类中的 getLongValueArray

参数：

参数名称	参数描述
key	表示要获取的长数组的key。

返回:

返回与指定键匹配的长数组。

getBooleanValueArray

public boolean[] getBooleanValueArray(String key)

覆盖 BasePacMap#getBooleanValueArray 方法以获取未编组的 PersistablePacMap 对象中的布尔数组，其中数组已转换为 JsonArray。

覆盖：

类 BasePacMap 中的 getBooleanValueArray

参数：

参数名称	参数描述
key	表示要获取的布尔数组的键。

返回:

返回与指定键匹配的布尔数组； 如果未编组的 PersistablePacMap 对象中的 JsonArray 值无法转换为布尔数组，则返回 null。

getDoubleValueArray

public double[] getDoubleValueArray(String key)

覆盖 BasePacMap#getDoubleValueArray 方法以获取未编组的 PersistablePacMap 对象中的双精度数组，其中数组已转换为 JsonArray。

覆盖：

类 BasePacMap 中的 getDoubleValueArray

参数：

参数名称	参数描述
key	表示要获取的双精度数组的键。

返回:

返回与指定键匹配的双精度数组。

getFloatValueArray

public float[] getFloatValueArray(String key)

覆盖 BasePacMap#getFloatValueArray 方法以获取未编组的 PersistablePacMap 对象中的浮点数组，其中数组已转换为 JsonArray。

覆盖：

类 BasePacMap 中的 getFloatValueArray

参数：

参数名称	参数描述
key	指示要获取的浮点数组的键。

返回:

返回与指定键匹配的浮点数组。

fromJsonString

public static PersistablePacMap fromJsonString(String jsonString)

基于给定的 JSON 字符串创建 PersistablePacMap 对象。

参数：

参数名称	参数描述
jsonString	指示用于创建 PersistablePacMap 对象的 JSON 字符串。

返回:

返回一个 PersistablePacMap 对象； 如果 JSON 字符串无效，则返回 null。

toJsonString

public String toJsonString()

获取 PersistablePacMap 对象的 JSON 字符串表示形式。 可以将此 JSON 字符串写入文件以进行持久数据存储。

返回:

返回 PersistablePacMap 对象的 JSON 字符串表示。