鸿蒙OS PacMap

PacMap

java.lang.Object

|—ohos.utils.BasePacMap

|—|—ohos.utils.PacMap

public class PacMap
extends BasePacMap

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

嵌套类摘要

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

字段摘要

修饰符和类型 字段 描述
static PacMap EMPTY_PAC_MAP 一个静态变量,表示一个空的 PacMap 对象。
static Sequenceable.ProducerPacMap PRODUCER 指示用于创建 PacMap 实例的静态公共成员。
从类 ohos.utils.BasePacMap 继承的字段
dataMap

构造函数摘要

构造函数 描述
PacMap() 用于创建 PacMap 实例的默认构造函数,其中 Map 对象没有键值对。
PacMap(int capacity) 一个构造函数,用于创建一个 PacMap 实例,其键值对的数量由 Map 指定。

方法总结

修饰符和类型 方法 描述
void clear() 清除当前对象。
Object clone() 创建并返回此对象的副本。
PacMap deepCopy() 创建此 PacMap 对象的深层副本。
boolean equals(Object object) 指示其他对象是否“等于”这个对象。
MapString,Object getAll() 获取已存储的所有数据。
boolean getBooleanValue(String key) 获取与指定键匹配的布尔值。
boolean getBooleanValue(String key, boolean defaultValue) 获取与指定键匹配的布尔值。
boolean[] getBooleanValueArray(String key) 获取与指定键匹配的 boolean[] 值。
byte getByteValue(String key) 获取与指定键匹配的字节值。
byte getByteValue(String key, byte defaultValue) 获取与指定键匹配的字节值。
byte[] getByteValueArray(String key) 获取匹配指定key的byte[]值。
char getChar(String key) 获取与指定键匹配的字符值。
char getChar(String key, char defaultValue) 获取与指定键匹配的字符值。
char[] getCharArray(String key) 获取与指定键匹配的 char[] 值。
double getDoubleValue(String key) 获取与指定键匹配的双精度值。
double getDoubleValue(String key, double defaultValue) 获取与指定键匹配的双精度值。
double[] getDoubleValueArray(String key) 获取与指定键匹配的 double[] 值。
float getFloatValue(String key) 获取与指定键匹配的浮点值。
float getFloatValue(String key, float defaultValue) 获取与指定键匹配的浮点值。
float[] getFloatValueArray(String key) 获取与指定键匹配的 float[] 值。
ArrayListInteger getIntegerList(String key) 获取与指定键匹配的 ArrayList<Integer> 值。
int getIntValue(String key) 获取与指定键匹配的 int 值。
int getIntValue(String key, int defaultValue) 获取与指定键匹配的 int 值。
int[] getIntValueArray(String key) 获取与指定键匹配的 int[] 值。
SetString getKeys() 获取当前对象的所有键。
long getLongValue(String key) 获取与指定key匹配的long值。
long getLongValue(String key, long defaultValue) 获取与指定key匹配的long值。
long[] getLongValueArray(String key) 获取与指定键匹配的 long[] 值。
OptionalObject getObjectValue(String key) 获取具有指定键的对象。
OptionalPacMap getPacMap(String key) 获取与指定键匹配的 PacMap 值。
OptionalSequenceable getSequenceable(String key) 获取与指定key匹配的Sequenceable值。
Sequenceable[] getSequenceableArray(String key) 获取与指定键匹配的 Sequenceable[] 值。
ArrayListSequenceable getSequenceableList(String key) 获取与指定键匹配的 ArrayList<Sequenceable> 值。
OptionalSerializable getSerializable(String key) 获取与指定键匹配的 Serializable 值。
short getShortValue(String key) 获取与指定键匹配的短值。
short getShortValue(String key, short defaultValue) 获取与指定键匹配的短值。
short[] getShortValueArray(String key) 获取与指定键匹配的 short[] 值。
int getSize() 获取当前对象中存储的键值对的数量。
String getString(String key) 获取与指定键匹配的字符串值。
String getString(String key, String defaultValue) 获取与指定键匹配的字符串值。
String[] getStringArray(String key) 获取与指定键匹配的 String[] 值。
ArrayListString getStringList(String key) 获取与指定键匹配的 ArrayList<String> 值。
int hashCode() 返回对象的哈希码值。
boolean hasKey(String key) 检查是否包含指定的键。
boolean isEmpty() 检查当前对象是否为空。
boolean marshalling(Parcel out) 将此 Sequenceable 对象编组为 Parcel。
void putAll(MapString,Object map) 将 Map 对象的所有键值对插入到内置数据对象中。
void putAll(PacMap map) 将 PacMap 对象中的数据保存到当前对象。
void putBooleanValue(String key, boolean value) 添加与指定键匹配的布尔值。
void putBooleanValueArray(String key, boolean[] value) 添加与指定键匹配的 boolean[] 值。
void putByteValue(String key, byte value) 添加与指定键匹配的字节值。
void putByteValueArray(String key, byte[] value) 添加与指定键匹配的 byte[] 值。
void putChar(String key, char value) 添加与指定键匹配的 char 值。
void putCharArray(String key, char[] value) 添加与指定键匹配的 char[] 值。
void putDoubleValue(String key, double value) 添加与指定键匹配的双精度值。
void putDoubleValueArray(String key, double[] value) 添加与指定键匹配的 double[] 值。
void putFloatValue(String key, float value) 添加与指定键匹配的浮点值。
void putFloatValueArray(String key, float[] value) 添加与指定键匹配的 float[] 值。
void putIntegerList(String key, ArrayListInteger value) 添加与指定键匹配的 ArrayList<Integer> 值。
void putIntValue(String key, int value) 添加与指定键匹配的 int 值。
void putIntValueArray(String key, int[] value) 添加与指定键匹配的 int[] 值。
void putLongValue(String key, long value) 添加与指定键匹配的长值。
void putLongValueArray(String key, long[] value) 添加与指定键匹配的 long[] 值。
void putObjectValue(String key, Object value) 添加具有指定键的通用对象。
void putPacMap(String key, PacMap pacMap) 添加与指定键匹配的 PacMap 值。
void putSequenceableObject(String key, Sequenceable sequenceable) 添加与指定键匹配的 Sequenceable 值。
void putSequenceableObjectArray(String key, Sequenceable[] sequenceables) 添加与指定键匹配的 Sequenceable[] 值。
void putSequenceableObjectList(String key, ArrayListSequenceable sequenceables) 添加与指定键匹配的 ArrayList<Sequenceable> 值。
void putSerializableObject(String key, Serializable serializable) 添加与指定键匹配的可序列化值。
void putShortValue(String key, short value) 添加与指定键匹配的短值。
void putShortValueArray(String key, short[] value) 添加一个与指定键匹配的 short[] 值。
void putString(String key, String value) 添加与指定键匹配的字符串值。
void putStringArray(String key, String[] value) 添加与指定键匹配的 String[] 值。
void putStringList(String key, ArrayListString strings) 添加与指定键匹配的 ArrayList<String> 值。
void remove(String key) 删除具有指定键的键值对。
boolean unmarshalling(Parcel in) 从 Parcel 中解组此 Sequenceable 对象。
从类 ohos.utils.BasePacMap 继承的方法
getClassLoader, getDimension, getFloatDimension, getObjectValue, getPlainArray, getRemoteObject, hasFileDescriptor, putAll, putDimension, putFloatDimension, putPlainArray, putRemoteObject, setClassLoader
从类 java.lang.Object 继承的方法
finalize, getClass, notify, notifyAll, toString, wait, wait, wait

字段详细信息

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 指定。

参数:

参数名称 参数描述
capacity 表示 Map 指定的键值对的数量。

PacMap

public PacMap()

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

方法详情

putAll

public void putAll(MapString,Object map)

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

覆盖:

putAll 在 BasePacMap 类中

参数:

参数名称 参数描述
map 表示键为字符串的 Map 对象。

putAll

public void putAll(PacMap map)

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

参数:

参数名称 参数描述
map 指示要保存其数据的 PacMap 对象。

getAll

public MapString,Object getAll()

获取已存储的所有数据。

覆盖:

BasePacMap 类中的 getAll

返回:

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

putObjectValue

public void putObjectValue(String key, Object value)

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

覆盖:

类 BasePacMap 中的 putObjectValue

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。
value 表示要添加的对象。

putByteValue

public void putByteValue(String key, byte value)

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

覆盖:

BasePacMap 类中的 putByteValue

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。
value 表示要添加的字节值。

putShortValue

public void putShortValue(String key, short value)

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

覆盖:

BasePacMap 类中的 putShortValue

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。
value 表示要添加的短值。

putIntValue

public void putIntValue(String key, int value)

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

覆盖:

BasePacMap 类中的 putIntValue

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。
value 表示要添加的 int 值。

putLongValue

public void putLongValue(String key, long value)

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

覆盖:

类 BasePacMap 中的 putLongValue

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。
value 表示要添加的长值。

putFloatValue

public void putFloatValue(String key, float value)

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

覆盖:

BasePacMap 类中的 putFloatValue

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。
value 表示要添加的浮点值。

putDoubleValue

public void putDoubleValue(String key, double value)

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

覆盖:

类 BasePacMap 中的 putDoubleValue

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。
value 指示要添加的双精度值。

putBooleanValue

public void putBooleanValue(String key, boolean value)

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

覆盖:

BasePacMap 类中的 putBooleanValue

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。
value 表示要添加的布尔值。

putChar

public void putChar(String key, char value)

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

覆盖:

类 BasePacMap 中的 putChar

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。
value 表示要添加的 char 值。

putString

public void putString(String key, String value)

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

覆盖:

类 BasePacMap 中的 putString

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。
value 表示要添加的字符串值。

putByteValueArray

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

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

覆盖:

BasePacMap 类中的 putByteValueArray

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。
value 表示要添加的 byte[] 值。

putShortValueArray

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

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

覆盖:

类 BasePacMap 中的 putShortValueArray

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。
value 表示要添加的 short[] 值。

putIntValueArray

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

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

覆盖:

BasePacMap 类中的 putIntValueArray

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。
value 指示要添加的 int[] 值。

putIntegerList

public void putIntegerList(String key, ArrayListInteger value)

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

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。
value 指示要添加的 ArrayList<Integer> 值。

putLongValueArray

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

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

覆盖:

BasePacMap 类中的 putLongValueArray

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。
value 表示要添加的 long[] 值。

putFloatValueArray

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

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

覆盖:

BasePacMap 类中的 putFloatValueArray

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。
value 指示要添加的 float[] 值。

putDoubleValueArray

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

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

覆盖:

类 BasePacMap 中的 putDoubleValueArray

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。
value 表示要添加的 double[] 值。

putBooleanValueArray

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

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

覆盖:

BasePacMap 类中的 putBooleanValueArray

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。
value 指示要添加的 boolean[] 值。

putCharArray

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

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

覆盖:

BasePacMap 类中的 putCharArray

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。
value 表示要添加的 char[] 值。

putStringArray

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

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

覆盖:

类 BasePacMap 中的 putStringArray

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。
value 指示要添加的 String[] 值。

putStringList

public void putStringList(String key, ArrayListString strings)

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

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。
strings 指示要添加的 ArrayList<String> 值。

putPacMap

public void putPacMap(String key, PacMap pacMap)

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

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。
pacMap 指示要添加的 PacMap 值。

putSerializableObject

public void putSerializableObject(String key, Serializable serializable)

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

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。
serializable 指示要添加的 Serializable 值。

putSequenceableObject

public void putSequenceableObject(String key, Sequenceable sequenceable)

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

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。
sequenceable 指示要添加的 Sequenceable 值。

putSequenceableObjectArray

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

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

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。
sequenceables 指示要添加的 Sequenceable[] 值。

putSequenceableObjectList

public void putSequenceableObjectList(String key, ArrayListSequenceable sequenceables)

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

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。
sequenceables 指示要添加的 ArrayList<Sequenceable> 值。

getObjectValue

public OptionalObject getObjectValue(String key)

获取具有指定键的对象。

覆盖:

BasePacMap 类中的 getObjectValue

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。

返回:

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

getByteValue

public byte getByteValue(String key, byte defaultValue)

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

覆盖:

BasePacMap 类中的 getByteValue

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。
defaultValue 表示未找到与该键匹配的值或找到其他类型的值时返回的默认值。

返回:

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

getByteValue

public byte getByteValue(String key)

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

覆盖:

BasePacMap 类中的 getByteValue

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。

返回:

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

getShortValue

public short getShortValue(String key, short defaultValue)

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

覆盖:

BasePacMap 类中的 getShortValue

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。
defaultValue 表示未找到与该键匹配的值或找到其他类型的值时返回的默认值。

返回:

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

getShortValue

public short getShortValue(String key)

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

覆盖:

BasePacMap 类中的 getShortValue

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。

返回:

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

getIntValue

public int getIntValue(String key, int defaultValue)

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

覆盖:

BasePacMap 类中的 getIntValue

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。
defaultValue 表示未找到与该键匹配的值或找到其他类型的值时返回的默认值。

返回:

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

getIntValue

public int getIntValue(String key)

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

覆盖:

BasePacMap 类中的 getIntValue

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。

返回:

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

getLongValue

public long getLongValue(String key, long defaultValue)

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

覆盖:

类 BasePacMap 中的 getLongValue

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。
defaultValue 表示未找到与该键匹配的值或找到其他类型的值时返回的默认值。

返回:

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

getLongValue

public long getLongValue(String key)

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

覆盖:

类 BasePacMap 中的 getLongValue

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。

返回:

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

getFloatValue

public float getFloatValue(String key, float defaultValue)

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

覆盖:

BasePacMap 类中的 getFloatValue

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。
defaultValue 表示未找到与该键匹配的值或找到其他类型的值时返回的默认值。

返回:

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

getFloatValue

public float getFloatValue(String key)

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

覆盖:

BasePacMap 类中的 getFloatValue

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。

返回:

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

getDoubleValue

public double getDoubleValue(String key, double defaultValue)

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

覆盖:

BasePacMap 类中的 getDoubleValue

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。
defaultValue 表示未找到与该键匹配的值或找到其他类型的值时返回的默认值。

返回:

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

getDoubleValue

public double getDoubleValue(String key)

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

覆盖:

BasePacMap 类中的 getDoubleValue

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。

返回:

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

getBooleanValue

public boolean getBooleanValue(String key, boolean defaultValue)

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

覆盖:

BasePacMap 类中的 getBooleanValue

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。
defaultValue 表示未找到与该键匹配的值或找到其他类型的值时返回的默认值。

返回:

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

getBooleanValue

public boolean getBooleanValue(String key)

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

覆盖:

BasePacMap 类中的 getBooleanValue

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。

返回:

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

getChar

public char getChar(String key, char defaultValue)

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

覆盖:

BasePacMap 类中的 getChar

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。
defaultValue 表示未找到与该键匹配的值或找到其他类型的值时返回的默认值。

返回:

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

getChar

public char getChar(String key)

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

覆盖:

BasePacMap 类中的 getChar

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。

返回:

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

getString

public String getString(String key, String defaultValue)

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

覆盖:

类 BasePacMap 中的 getString

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。
defaultValue 表示未找到与该键匹配的值或找到其他类型的值时返回的默认值。

返回:

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

getString

public String getString(String key)

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

覆盖:

类 BasePacMap 中的 getString

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。

返回:

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

getByteValueArray

public byte[] getByteValueArray(String key)

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

覆盖:

类 BasePacMap 中的 getByteValueArray

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。

返回:

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

getShortValueArray

public short[] getShortValueArray(String key)

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

覆盖:

BasePacMap 类中的 getShortValueArray

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。

返回:

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

getIntValueArray

public int[] getIntValueArray(String key)

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

覆盖:

类 BasePacMap 中的 getIntValueArray

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。

返回:

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

getIntegerList

public ArrayListInteger getIntegerList(String key)

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

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。

返回:

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

getLongValueArray

public long[] getLongValueArray(String key)

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

覆盖:

BasePacMap 类中的 getLongValueArray

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。

返回:

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

getFloatValueArray

public float[] getFloatValueArray(String key)

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

覆盖:

类 BasePacMap 中的 getFloatValueArray

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。

返回:

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

getDoubleValueArray

public double[] getDoubleValueArray(String key)

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

覆盖:

类 BasePacMap 中的 getDoubleValueArray

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。

返回:

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

getBooleanValueArray

public boolean[] getBooleanValueArray(String key)

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

覆盖:

类 BasePacMap 中的 getBooleanValueArray

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。

返回:

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

getCharArray

public char[] getCharArray(String key)

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

覆盖:

类 BasePacMap 中的 getCharArray

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。

返回:

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

getStringArray

public String[] getStringArray(String key)

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

覆盖:

BasePacMap 类中的 getStringArray

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。

返回:

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

getStringList

public ArrayListString getStringList(String key)

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

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。

返回:

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

getPacMap

public OptionalPacMap getPacMap(String key)

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

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。

返回:

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

getSerializable

public OptionalSerializable getSerializable(String key)

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

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。

返回:

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

getSequenceable

public OptionalSequenceable getSequenceable(String key)

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

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。

返回:

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

getSequenceableArray

public Sequenceable[] getSequenceableArray(String key)

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

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。

返回:

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

getSequenceableList

public ArrayListSequenceable getSequenceableList(String key)

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

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。

返回:

返回与指定键匹配的 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

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。

返回:

如果包含键,则返回 true; 否则返回 false。

remove

public void remove(String key)

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

覆盖:

在类 BasePacMap 中删除

参数:

参数名称 参数描述
key 表示String格式的key,可以为null。

clear

public void clear()

清除当前对象。

覆盖:

在 BasePacMap 类中清除

marshalling

public boolean marshalling(Parcel out)

将此 Sequenceable 对象编组为 Parcel。

指定者:

接口 Sequenceable 中的编组

覆盖:

BasePacMap 类中的编组

参数:

参数名称 参数描述
out 指示 Sequenceable 对象将被编组到的 Parcel 对象。

返回:

如果编组成功,则返回 true; 否则返回 false。

unmarshalling

public boolean unmarshalling(Parcel in)

从 Parcel 中解组此 Sequenceable 对象。

指定者:

在接口 Sequenceable 中解组

覆盖:

在 BasePacMap 类中解组

参数:

参数名称 参数描述
in 指示已将 Sequenceable 对象编组到的 Parcel 对象。

返回:

如果解组成功,则返回 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 中的等于

参数:

参数名称 参数描述
object 要与之比较的参考对象。

返回:

如果此对象与 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:

Throw名称 Throw描述
CloneNotSupportedException 如果对象的类不支持 Cloneable 接口。 覆盖 clone 方法的子类也可以抛出此异常,表示无法克隆实例。

deepCopy

public PacMap deepCopy()

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

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

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

返回:

返回 PacMap 对象的深层副本。

版权声明:本文采用知识共享 署名4.0国际许可协议 [BY-NC-SA] 进行授权
文章名称:《鸿蒙OS PacMap》
文章链接:https://zhuji.vsping.com/314015.html
本站资源仅供个人学习交流,请于下载后24小时内删除,不允许用于商业用途,否则法律问题自行承担。