鸿蒙OS PacMap

PacMap

java.lang.Object

|—ohos.utils.BasePacMap

|—|—ohos.utils.PacMap

public class PacMap
extends BasePacMap

提供支持Sequenceable操作的Map对象，可用于存储和读取字符串格式的键值对。

嵌套类摘要

字段摘要

构造函数摘要

方法总结

字段详细信息

EMPTY_PAC_MAP

public static final PacMap EMPTY_PAC_MAP

一个静态变量，表示一个空的 PacMap 对象。

PRODUCER

public static final Sequenceable.ProducerPacMap PRODUCER

指示用于创建 PacMap 实例的静态公共成员。

构造函数详细信息

PacMap

public PacMap(int capacity)

一个构造函数，用于创建一个 PacMap 实例，其键值对的数量由 Map 指定。

参数：

PacMap

public PacMap()

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

方法详情

putAll

public void putAll(MapString,Object map)

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

覆盖：

putAll 在 BasePacMap 类中

参数：

putAll

public void putAll(PacMap map)

将 PacMap 对象中的数据保存到当前对象。

参数：

getAll

public MapString,Object getAll()

获取已存储的所有数据。

覆盖：

BasePacMap 类中的 getAll

返回:

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

putObjectValue

public void putObjectValue(String key, Object value)

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

覆盖：

类 BasePacMap 中的 putObjectValue

参数：

putByteValue

public void putByteValue(String key, byte value)

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

覆盖：

BasePacMap 类中的 putByteValue

参数：

putShortValue

public void putShortValue(String key, short value)

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

覆盖：

BasePacMap 类中的 putShortValue

参数：

putIntValue

public void putIntValue(String key, int value)

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

覆盖：

BasePacMap 类中的 putIntValue

参数：

putLongValue

public void putLongValue(String key, long value)

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

覆盖：

类 BasePacMap 中的 putLongValue

参数：

putFloatValue

public void putFloatValue(String key, float value)

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

覆盖：

BasePacMap 类中的 putFloatValue

参数：

putDoubleValue

public void putDoubleValue(String key, double value)

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

覆盖：

类 BasePacMap 中的 putDoubleValue

参数：

putBooleanValue

public void putBooleanValue(String key, boolean value)

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

覆盖：

BasePacMap 类中的 putBooleanValue

参数：

putChar

public void putChar(String key, char value)

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

覆盖：

类 BasePacMap 中的 putChar

参数：

putString

public void putString(String key, String value)

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

覆盖：

类 BasePacMap 中的 putString

参数：

putByteValueArray

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

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

覆盖：

BasePacMap 类中的 putByteValueArray

参数：

putShortValueArray

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

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

覆盖：

类 BasePacMap 中的 putShortValueArray

参数：

putIntValueArray

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

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

覆盖：

BasePacMap 类中的 putIntValueArray

参数：

putIntegerList

public void putIntegerList(String key, ArrayListInteger value)

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

参数：

putLongValueArray

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

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

覆盖：

BasePacMap 类中的 putLongValueArray

参数：

putFloatValueArray

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

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

覆盖：

BasePacMap 类中的 putFloatValueArray

参数：

putDoubleValueArray

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

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

覆盖：

类 BasePacMap 中的 putDoubleValueArray

参数：

putBooleanValueArray

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

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

覆盖：

BasePacMap 类中的 putBooleanValueArray

参数：

putCharArray

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

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

覆盖：

BasePacMap 类中的 putCharArray

参数：

putStringArray

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

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

覆盖：

类 BasePacMap 中的 putStringArray

参数：

putStringList

public void putStringList(String key, ArrayListString strings)

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

参数：

putPacMap

public void putPacMap(String key, PacMap pacMap)

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

参数：

putSerializableObject

public void putSerializableObject(String key, Serializable serializable)

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

参数：

putSequenceableObject

public void putSequenceableObject(String key, Sequenceable sequenceable)

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

参数：

putSequenceableObjectArray

public void putSequenceableObjectArray(String key, Sequenceable[] sequenceables)

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

参数：

putSequenceableObjectList

public void putSequenceableObjectList(String key, ArrayListSequenceable sequenceables)

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

参数：

getObjectValue

public OptionalObject getObjectValue(String key)

获取具有指定键的对象。

覆盖：

BasePacMap 类中的 getObjectValue

参数：

返回:

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

getByteValue

public byte getByteValue(String key, byte defaultValue)

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

覆盖：

BasePacMap 类中的 getByteValue

参数：

返回:

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

getByteValue

public byte getByteValue(String key)

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

覆盖：

BasePacMap 类中的 getByteValue

参数：

返回:

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

getShortValue

public short getShortValue(String key, short defaultValue)

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

覆盖：

BasePacMap 类中的 getShortValue

参数：

返回:

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

getShortValue

public short getShortValue(String key)

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

覆盖：

BasePacMap 类中的 getShortValue

参数：

返回:

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

getIntValue

public int getIntValue(String key, int defaultValue)

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

覆盖：

BasePacMap 类中的 getIntValue

参数：

返回:

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

getIntValue

public int getIntValue(String key)

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

覆盖：

BasePacMap 类中的 getIntValue

参数：

返回:

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

getLongValue

public long getLongValue(String key, long defaultValue)

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

覆盖：

类 BasePacMap 中的 getLongValue

参数：

返回:

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

getLongValue

public long getLongValue(String key)

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

覆盖：

类 BasePacMap 中的 getLongValue

参数：

返回:

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

getFloatValue

public float getFloatValue(String key, float defaultValue)

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

覆盖：

BasePacMap 类中的 getFloatValue

参数：

返回:

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

getFloatValue

public float getFloatValue(String key)

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

覆盖：

BasePacMap 类中的 getFloatValue

参数：

返回:

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

getDoubleValue

public double getDoubleValue(String key, double defaultValue)

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

覆盖：

BasePacMap 类中的 getDoubleValue

参数：

返回:

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

getDoubleValue

public double getDoubleValue(String key)

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

覆盖：

BasePacMap 类中的 getDoubleValue

参数：

返回:

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

getBooleanValue

public boolean getBooleanValue(String key, boolean defaultValue)

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

覆盖：

BasePacMap 类中的 getBooleanValue

参数：

返回:

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

getBooleanValue

public boolean getBooleanValue(String key)

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

覆盖：

BasePacMap 类中的 getBooleanValue

参数：

返回:

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

getChar

public char getChar(String key, char defaultValue)

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

覆盖：

BasePacMap 类中的 getChar

参数：

返回:

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

getChar

public char getChar(String key)

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

覆盖：

BasePacMap 类中的 getChar

参数：

返回:

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

getString

public String getString(String key, String defaultValue)

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

覆盖：

类 BasePacMap 中的 getString

参数：

返回:

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

getString

public String getString(String key)

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

覆盖：

类 BasePacMap 中的 getString

参数：

返回:

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

getByteValueArray

public byte[] getByteValueArray(String key)

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

覆盖：

类 BasePacMap 中的 getByteValueArray

参数：

返回:

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

getShortValueArray

public short[] getShortValueArray(String key)

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

覆盖：

BasePacMap 类中的 getShortValueArray

参数：

返回:

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

getIntValueArray

public int[] getIntValueArray(String key)

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

覆盖：

类 BasePacMap 中的 getIntValueArray

参数：

返回:

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

getIntegerList

public ArrayListInteger getIntegerList(String key)

获取与指定键匹配的 ArrayList<Integer> 值。

参数：

返回:

返回与指定键匹配的 ArrayList<Integer> 值； 如果没有找到与键匹配的值或找到其他类型的值，则返回 null。

getLongValueArray

public long[] getLongValueArray(String key)

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

覆盖：

BasePacMap 类中的 getLongValueArray

参数：

返回:

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

getFloatValueArray

public float[] getFloatValueArray(String key)

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

覆盖：

类 BasePacMap 中的 getFloatValueArray

参数：

返回:

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

getDoubleValueArray

public double[] getDoubleValueArray(String key)

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

覆盖：

类 BasePacMap 中的 getDoubleValueArray

参数：

返回:

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

getBooleanValueArray

public boolean[] getBooleanValueArray(String key)

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

覆盖：

类 BasePacMap 中的 getBooleanValueArray

参数：

返回:

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

getCharArray

public char[] getCharArray(String key)

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

覆盖：

类 BasePacMap 中的 getCharArray

参数：

返回:

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

getStringArray

public String[] getStringArray(String key)

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

覆盖：

BasePacMap 类中的 getStringArray

参数：

返回:

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

getStringList

public ArrayListString getStringList(String key)

获取与指定键匹配的 ArrayList<String> 值。

参数：

返回:

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

getPacMap

public OptionalPacMap getPacMap(String key)

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

参数：

返回:

返回 PacMap 值，封装在 Optional 中； 如果没有找到与键匹配的值或找到其他类型的值，则返回 null。

getSerializable

public OptionalSerializable getSerializable(String key)

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

参数：

返回:

返回 Serializable 值，封装在 Optional 中； 如果没有找到与键匹配的值或找到其他类型的值，则返回 null。

getSequenceable

public OptionalSequenceable getSequenceable(String key)

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

参数：

返回:

返回 Seqenceable 值，封装在 Optional 中； 如果没有找到与键匹配的值或找到其他类型的值，则返回 null。

getSequenceableArray

public Sequenceable[] getSequenceableArray(String key)

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

参数：

返回:

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

getSequenceableList

public ArrayListSequenceable getSequenceableList(String key)

获取与指定键匹配的 ArrayList<Sequenceable> 值。

参数：

返回:

返回与指定键匹配的 ArrayList<Sequenceable> 值； 如果没有找到与键匹配的值或找到其他类型的值，则返回 null。

getSize

public int getSize()

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

覆盖：

BasePacMap 类中的 getSize

返回:

返回键值对的数量。

isEmpty

public boolean isEmpty()

检查当前对象是否为空。

覆盖：

BasePacMap 类中的 isEmpty

返回:

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

getKeys

public SetString getKeys()

获取当前对象的所有键。

覆盖：

BasePacMap 类中的 getKeys

返回:

返回当前对象的所有键。

hasKey

public boolean hasKey(String key)

检查是否包含指定的键。

覆盖：

BasePacMap 类中的 hasKey

参数：

返回:

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

remove

public void remove(String key)

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

覆盖：

在类 BasePacMap 中删除

参数：

clear

public void clear()

清除当前对象。

覆盖：

在 BasePacMap 类中清除

marshalling

public boolean marshalling(Parcel out)

将此 Sequenceable 对象编组为 Parcel。

指定者：

接口 Sequenceable 中的编组

覆盖：

BasePacMap 类中的编组

参数：

返回:

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

unmarshalling

public boolean unmarshalling(Parcel in)

从 Parcel 中解组此 Sequenceable 对象。

指定者：

在接口 Sequenceable 中解组

覆盖：

在 BasePacMap 类中解组

参数：

返回:

如果解组成功，则返回 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 方法的一般约定，即相等的对象必须具有相等的哈希码。

覆盖：

类 BasePacMap 中的等于

参数：

返回:

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

hashCode

public int hashCode()

从类复制的描述：对象

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

hashCode 的一般合约是：

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

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

覆盖：

BasePacMap 类中的 hashCode

返回:

此对象的哈希码值。

clone

public 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 方法将导致在运行时抛出异常。

覆盖：

在 BasePacMap 类中克隆

返回:

此实例的克隆。

Throws:

deepCopy

public PacMap deepCopy()

创建此 PacMap 对象的深层副本。

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

注意：深拷贝仅支持原始数据类型、对象、它们的数组和 PacMap。

返回:

返回 PacMap 对象的深层副本。