鸿蒙OS BasePacMap

BasePacMap

java.lang.Object

|—ohos.utils.BasePacMap

public class BasePacMap
extends Object
implements Sequenceable, Cloneable

存储和读取基本类型的数据。

该类是 PacMap 的基类。 不建议您直接使用此类。

嵌套类摘要

字段摘要

构造函数摘要

方法总结

字段详细信息

dataMap

protected HashMapString,Object dataMap

BasePacMap中存储键值对的Hashmap。 子类可以访问此变量。

构造函数详细信息

BasePacMap

public BasePacMap(int capacity)

用于创建具有 Map 指定的键值对数量的 BasePacMap 实例的构造函数。

参数：

BasePacMap

public BasePacMap()

用于创建 BasePacMap 实例的默认构造函数，其中 Map 对象没有键值对。

方法详情

putAll

public void putAll(BasePacMap map)

将键值对保存在当前对象的 BasePacMap 对象中。

参数：

putAll

protected void putAll(MapString,Object map)

将 Map 对象的所有键值对插入到内置数据对象中。

参数：

putObjectValue

protected void putObjectValue(String key, Object value)

添加具有指定键的通用对象。 如果已存在具有相同键的对象，则该对象将被添加的对象替换。

参数：

putByteValue

public void putByteValue(String key, byte value)

添加与指定键匹配的字节值。 如果与键匹配的值已经存在，它将被添加的值替换。

参数：

putShortValue

public void putShortValue(String key, short value)

添加与指定键匹配的短值。 如果与键匹配的值已经存在，它将被添加的值替换。

参数：

putIntValue

public void putIntValue(String key, int value)

添加与指定键匹配的 int 值。 如果与键匹配的值已经存在，它将被添加的值替换。

参数：

putLongValue

public void putLongValue(String key, long value)

添加与指定键匹配的长值。 如果与键匹配的值已经存在，它将被添加的值替换。

参数：

putFloatValue

public void putFloatValue(String key, float value)

添加与指定键匹配的浮点值。 如果与键匹配的值已经存在，它将被添加的值替换。

参数：

putDoubleValue

public void putDoubleValue(String key, double value)

添加与指定键匹配的双精度值。 如果与键匹配的值已经存在，它将被添加的值替换。

参数：

putBooleanValue

public void putBooleanValue(String key, boolean value)

添加与指定键匹配的布尔值。 如果与键匹配的值已经存在，它将被添加的值替换。

参数：

putChar

public void putChar(String key, char value)

添加与指定键匹配的 char 值。 如果与键匹配的值已经存在，它将被添加的值替换。

参数：

putString

public void putString(String key, String value)

添加与指定键匹配的字符串值。 如果与键匹配的值已经存在，它将被添加的值替换。

参数：

putByteValueArray

public void putByteValueArray(String key, byte[] value)

添加与指定键匹配的 byte[] 值。 如果与键匹配的值已经存在，它将被添加的值替换。

参数：

putShortValueArray

public void putShortValueArray(String key, short[] value)

添加一个与指定键匹配的 short[] 值。 如果与键匹配的值已经存在，它将被添加的值替换。

参数：

putIntValueArray

public void putIntValueArray(String key, int[] value)

添加与指定键匹配的 int[] 值。 如果与键匹配的值已经存在，它将被添加的值替换。

参数：

putLongValueArray

public void putLongValueArray(String key, long[] value)

添加与指定键匹配的 long[] 值。 如果与键匹配的值已经存在，它将被添加的值替换。

参数：

putFloatValueArray

public void putFloatValueArray(String key, float[] value)

添加与指定键匹配的 float[] 值。 如果与键匹配的值已经存在，它将被添加的值替换。

参数：

putDoubleValueArray

public void putDoubleValueArray(String key, double[] value)

添加与指定键匹配的 double[] 值。 如果与键匹配的值已经存在，它将被添加的值替换。

参数：

putBooleanValueArray

public void putBooleanValueArray(String key, boolean[] value)

添加与指定键匹配的 boolean[] 值。 如果与键匹配的值已经存在，它将被添加的值替换。

参数：

putCharArray

public void putCharArray(String key, char[] value)

添加与指定键匹配的 char[] 值。 如果与键匹配的值已经存在，它将被添加的值替换。

参数：

putStringArray

public void putStringArray(String key, String[] value)

添加与指定键匹配的 String[] 值。 如果与键匹配的值已经存在，它将被添加的值替换。

参数：

setClassLoader

public void setClassLoader(ClassLoader loader)

设置用于在此 PacMap 实例中创建内部对象的 ClassLoader。

参数：

getClassLoader

public ClassLoader getClassLoader()

获取此 PacMap 实例中的内部对象使用的 ClassLoader。

返回:

返回此 PacMap 实例的内部对象使用的 ClassLoader。

putPlainArray

public void putPlainArray(String key, PlainArray<? extends Sequenceable> value)

将键为 String 且值为 PlainArray 的键值对插入 PacMap。

如果键已存在，则其值将替换为 PlainArray。 否则，插入这个新的键值对。 PlainArray 的元素类型必须继承自 Sequenceable。

参数：

getPlainArray

public PlainArray<?> getPlainArray(String key)

根据指定键获取 PlainArray<T> 对象。

PlainArray 的元素类型必须继承自 Sequenceable。

参数：

返回:

返回存储在此 PacMap 实例中的 PlainArray 对象； 如果 PlainArray 不存在或转换为指定类型失败，则返回 null。

putRemoteObject

public void putRemoteObject(String key, Object value)

将键为 String 且值为 Object 的键值对插入到 PacMap 中。

如果键已存在，则其值将替换为 Object。 否则，插入这个新的键值对。 该方法是使用反射机制实现的，因此 value 必须是 IRemoteObject 类型。 在编组或解组此 BasePacMap 时，您必须使用继承自 Parcel 的 MessageParcel 以获得正确的 ohos.rpc.IRemoteObject 值。

参数：

Throws:

getRemoteObject

public <T> T getRemoteObject(String key, Class<T> clz)

根据指定键获取 IRemoteObject。

该方法是通过反射机制实现的，所以返回的T值必须是ohos.rpc.IRemoteObject。在编组或解组这个BasePacMap时，必须使用继承自Parcel的MessageParcel，才能得到正确的ohos.rpc.IRemoteObject值。

类型参数：

参数:

返回:

返回存储在此 PacMap 实例中的 IRemoteObject； 如果 Object 不存在或转换为 <T> 类型失败，则返回 null。

Throws:

putDimension

public void putDimension(String key, Dimension value)

将键为 String 且值为 Dimension 的键值对插入 PacMap。

参数：

getDimension

public Dimension getDimension(String key)

根据指定键获取 PacMap 中的 Dimension 对象。

参数：

返回:

返回指定键的 Dimension 对象； 如果查询失败，则返回 null。

putFloatDimension

public void putFloatDimension(String key, FloatDimension value)

将键为 String 且值为 FloatDimension 的键值对插入 PacMap。

参数：

getFloatDimension

public FloatDimension getFloatDimension(String key)

根据指定键获取 PacMap 中的 FloatDimension 对象。

参数：

返回:

返回指定键的 FloatDimension 对象； 如果查询失败，则返回 null。

getAll

protected MapString,Object getAll()

获取已存储的所有数据。

返回:

返回一个包含字符串格式键的 Map 对象。

getObjectValue

public OptionalObject getObjectValue(String key)

获取具有指定键的对象。

参数：

返回:

返回指定key的对象，封装在Optional中； 如果没有找到这样的对象，则返回 null。

getObjectValue

protected final <T> Optional<T> getObjectValue(String key, Class<T> clazz)

获取具有指定键和对象类型的对象。

类型参数：

参数:

返回:

返回具有指定键值对的对象，由 Optional 封装； 如果没有找到这样的对象，则返回 null。

getByteValue

public byte getByteValue(String key, byte defaultValue)

获取与指定键匹配的字节值。

参数：

返回:

返回匹配指定键的字节值； 如果没有找到与键匹配的值或找到其他类型的值，则返回 defaultValue。

getByteValue

public byte getByteValue(String key)

获取与指定键匹配的字节值。

参数：

返回:

返回匹配指定键的字节值； 如果没有找到与键匹配的值或找到其他类型的值，则返回 0。

getShortValue

public short getShortValue(String key, short defaultValue)

获取与指定键匹配的短值。

参数：

返回:

返回与指定键匹配的短值； 如果没有找到与键匹配的值或找到其他类型的值，则返回 defaultValue。

getShortValue

public short getShortValue(String key)

获取与指定键匹配的短值。

参数：

返回:

返回与指定键匹配的短值； 如果没有找到与键匹配的值或找到其他类型的值，则返回 0。

getIntValue

public int getIntValue(String key, int defaultValue)

获取与指定键匹配的 int 值。

参数：

返回:

返回与指定键匹配的 int 值； 如果没有找到与键匹配的值或找到其他类型的值，则返回 defaultValue。

getIntValue

public int getIntValue(String key)

获取与指定键匹配的 int 值。

参数：

返回:

返回与指定键匹配的 int 值； 如果没有找到与键匹配的值或找到其他类型的值，则返回 0。

getLongValue

public long getLongValue(String key, long defaultValue)

获取与指定key匹配的long值。

参数：

返回:

返回匹配指定key的long值； 如果没有找到与键匹配的值或找到其他类型的值，则返回 defaultValue。

getLongValue

public long getLongValue(String key)

获取与指定key匹配的long值。

参数：

返回:

返回匹配指定key的long值； 如果没有找到与键匹配的值或找到其他类型的值，则返回 0。

getFloatValue

public float getFloatValue(String key, float defaultValue)

获取与指定键匹配的浮点值。

参数：

返回:

返回与指定键匹配的浮点值； 如果没有找到与键匹配的值或找到其他类型的值，则返回 defaultValue。

getFloatValue

public float getFloatValue(String key)

获取与指定键匹配的浮点值。

参数：

返回:

返回与指定键匹配的浮点值； 如果没有找到与键匹配的值或找到其他类型的值，则返回 0。

getDoubleValue

public double getDoubleValue(String key, double defaultValue)

获取与指定键匹配的双精度值。

参数：

返回:

返回与指定键匹配的双精度值； 如果没有找到与键匹配的值或找到其他类型的值，则返回 defaultValue。

getDoubleValue

public double getDoubleValue(String key)

获取与指定键匹配的双精度值。

参数：

返回:

返回与指定键匹配的双精度值； 如果没有找到与键匹配的值或找到其他类型的值，则返回 0。

getBooleanValue

public boolean getBooleanValue(String key, boolean defaultValue)

获取与指定键匹配的布尔值。

参数：

返回:

返回与指定键匹配的布尔值； 如果没有找到与键匹配的值或找到其他类型的值，则返回 defaultValue。

getBooleanValue

public boolean getBooleanValue(String key)

获取与指定键匹配的布尔值。

参数：

返回:

返回与指定键匹配的布尔值； 如果没有找到与键匹配的值或找到其他类型的值，则返回 false。

getChar

public char getChar(String key, char defaultValue)

获取与指定键匹配的字符值。

参数：

返回:

返回与指定键匹配的 char 值； 如果没有找到与键匹配的值或找到其他类型的值，则返回 defaultValue。

getChar

public char getChar(String key)

获取与指定键匹配的字符值。

参数：

返回:

返回与指定键匹配的 char 值； 如果没有找到与键匹配的值或找到其他类型的值，则返回 0。

getString

public String getString(String key, String defaultValue)

获取与指定键匹配的字符串值。

参数：

返回:

返回与指定键匹配的字符串值； 如果没有找到与键匹配的值或找到其他类型的值，则返回 defaultValue。

getString

public String getString(String key)

获取与指定键匹配的字符串值。

参数：

返回:

返回与指定键匹配的字符串值； 如果没有找到与键匹配的值或找到其他类型的值，则返回 null。

getByteValueArray

public byte[] getByteValueArray(String key)

获取匹配指定key的byte[]值。

参数：

返回:

返回匹配指定key的byte[]值； 如果没有找到与键匹配的值或找到其他类型的值，则返回 null。

getShortValueArray

public short[] getShortValueArray(String key)

获取与指定键匹配的 short[] 值。

参数：

返回:

返回与指定键匹配的 short[] 值； 如果没有找到与键匹配的值或找到其他类型的值，则返回 null。

getIntValueArray

public int[] getIntValueArray(String key)

获取与指定键匹配的 int[] 值。

参数：

返回:

返回与指定键匹配的 int[] 值； 如果没有找到与键匹配的值或找到其他类型的值，则返回 null。

getLongValueArray

public long[] getLongValueArray(String key)

获取与指定键匹配的 long[] 值。

参数：

返回:

返回与指定键匹配的 long[] 值； 如果没有找到与键匹配的值或找到其他类型的值，则返回 null。

getFloatValueArray

public float[] getFloatValueArray(String key)

获取与指定键匹配的 float[] 值。

参数：

返回:

返回与指定键匹配的 float[] 值； 如果没有找到与键匹配的值或找到其他类型的值，则返回 null。

getDoubleValueArray

public double[] getDoubleValueArray(String key)

获取与指定键匹配的 double[] 值。

参数：

返回:

返回与指定键匹配的 double[] 值； 如果没有找到与键匹配的值或找到其他类型的值，则返回 null。

getBooleanValueArray

public boolean[] getBooleanValueArray(String key)

获取与指定键匹配的 boolean[] 值。

参数：

返回:

返回与指定键匹配的 boolean[] 值； 如果没有找到与键匹配的值或找到其他类型的值，则返回 null。

getCharArray

public char[] getCharArray(String key)

获取与指定键匹配的 char[] 值。

参数：

返回:

返回与指定键匹配的 char[] 值； 如果没有找到与键匹配的值或找到其他类型的值，则返回 null。

getStringArray

public String[] getStringArray(String key)

获取与指定键匹配的 String[] 值。

参数：

返回:

返回与指定键匹配的 String[] 值； 如果没有找到与键匹配的值或找到其他类型的值，则返回 null。

getSize

public int getSize()

获取当前对象中存储的键值对的数量。

返回:

返回键值对的数量。

isEmpty

public boolean isEmpty()

检查当前对象是否为空。

返回:

如果当前对象为空，则返回 true； 否则返回 false。

getKeys

public SetString getKeys()

获取当前对象的所有键。

返回:

返回当前对象的所有键。

hasKey

public boolean hasKey(String key)

检查是否包含指定的键。

参数：

返回:

如果包含键，则返回 true； 否则返回 false。

remove

public void remove(String key)

删除具有指定键的键值对。

参数：

clear

public void clear()

清除当前对象。

marshalling

public boolean marshalling(Parcel out)

将 Sequenceable 对象写入 Parcel。

指定者：

接口 Sequenceable 中的编组

参数：

返回:

如果编组成功，则返回 true； 否则返回 false。

unmarshalling

public boolean unmarshalling(Parcel in)

从 Parcel 中恢复一个 Sequenceable 对象。

指定者：

在接口 Sequenceable 中解组

参数：

返回:

如果解组成功，则返回 true； 否则返回 false。

equals

public boolean equals(Object object)

从类复制的描述：对象

指示其他对象是否“等于”这个对象。

equals 方法在非空对象引用上实现等价关系：

• 它是自反的：对于任何非空引用值 x，x.equals(x) 应该返回 true。
• 它是对称的：对于任何非空引用值 x 和 y，当且仅当 y.equals(x) 返回 true 时，x.equals(y) 才应该返回 true。
• 它是可传递的：对于任何非空引用值 x、y 和 z，如果 x.equals(y) 返回 true 并且 y.equals(z) 返回 true，则 x.equals(z) 应该返回 true。
• 它是一致的：对于任何非空引用值 x 和 y，x.equals(y) 的多次调用始终返回 true 或始终返回 false，前提是没有修改对象上 equals 比较中使用的信息。
• 对于任何非空引用值 x，x.equals(null) 应该返回 false。

Object 类的 equals 方法实现了对象上最有区别的可能等价关系； 也就是说，对于任何非空引用值 x 和 y，当且仅当 x 和 y 引用同一个对象（x == y 的值为 true）时，此方法才返回 true。

请注意，每当重写该方法时，通常都需要重写 hashCode 方法，以维护 hashCode 方法的一般约定，即相等的对象必须具有相等的哈希码。

覆盖：

类 Object 中的等于

参数：

返回:

如果此对象与 obj 参数相同，则为 true； 否则为 false。

hashCode

public int hashCode()

从类复制的描述：对象

返回对象的哈希码值。 支持这种方法是为了有利于哈希表，例如 HashMap 提供的那些。

hashCode 的一般合约是：

• 每当在 Java 应用程序执行期间对同一对象多次调用时，hashCode 方法必须始终返回相同的整数，前提是没有修改对象上相等比较中使用的信息。 该整数不需要从应用程序的一次执行到同一应用程序的另一次执行保持一致。
• 如果两个对象根据 equals(Object) 方法相等，则对两个对象中的每一个调用 hashCode 方法必须产生相同的整数结果。
• 如果根据 Object.equals(java.lang.Object) 方法，如果两个对象不相等，则不要求对两个对象中的每一个调用 hashCode 方法必须产生不同的整数结果。 但是，程序员应该意识到，为不相等的对象生成不同的整数结果可能会提高哈希表的性能。

在合理可行的情况下，由 Object 类定义的 hashCode 方法确实为不同的对象返回不同的整数。 （这通常通过将对象的内部地址转换为整数来实现，但 Java™ 编程语言不需要这种实现技术。）

覆盖：

类 Object 中的 hashCode

返回:

此对象的哈希码值。

clone

protected Object clone() throws CloneNotSupportedException

从类复制的描述：对象

创建并返回此对象的副本。 “复制”的确切含义可能取决于对象的类别。 一般意图是，对于任何对象 x，表达式：

 x.clone() != x

将为 true，并且表达式：

 x.clone().getClass() == x.getClass()

将为 true，但这些不是绝对的要求。 虽然通常是这样的：

 x.clone().equals(x)

将为 true，这不是一个绝对的要求。

按照约定，返回的对象应该通过调用 super.clone 来获取。如果一个类及其所有超类（Object 除外）都遵守这个约定，那么 x.clone().getClass() == x.getClass() 就是这种情况。

按照惯例，此方法返回的对象应独立于此对象（正在克隆）。为了实现这种独立性，可能需要在返回 super.clone 之前修改对象的一个或多个字段。通常，这意味着复制任何包含被克隆对象的内部“深层结构”的可变对象，并将对这些对象的引用替换为对副本的引用。如果一个类只包含原始字段或对不可变对象的引用，那么通常情况下 super.clone 返回的对象中不需要修改任何字段。

类 Object 的方法 clone 执行特定的克隆操作。首先，如果该对象的类没有实现接口 Cloneable，则抛出 CloneNotSupportedException。请注意，所有数组都被认为实现了接口 Cloneable，并且数组类型 T[] 的克隆方法的返回类型是 T[]，其中 T 是任何引用或原始类型。否则，此方法会创建此对象的类的新实例，并使用此对象的相应字段的内容来初始化其所有字段，就像通过赋值一样；字段的内容本身不会被克隆。因此，此方法执行此对象的“浅拷贝”，而不是“深拷贝”操作。

Object 类本身并没有实现接口 Cloneable，因此在类为 Object 的对象上调用 clone 方法将导致在运行时抛出异常。

覆盖：

在类 Object 中克隆

返回：

此实例的克隆。

Throws:

hasFileDescriptor

public boolean hasFileDescriptor()

从接口复制的描述：Sequenceable

检查此 Sequenceable 的实现类是否包含 FileDescriptor 对象数据。

如果自定义 Sequenceable 类包含任何 FileDescriptor 数据，则应覆盖此方法。 此方法默认返回 false。

指定者：

接口 Sequenceable 中的 hasFileDescriptor

返回:

如果它包含 FileDescriptor 数据，则返回 true； 否则返回 false。