鴻蒙OS ValuesBucket

ValuesBucket

java.lang.Object

|---ohos.data.rdb.ValuesBucket

public class ValuesBucket
extends Object
implements Sequenceable

管理用于存儲(chǔ)一系列值的存儲(chǔ)桶。

桶中的值存儲(chǔ)在鍵值對(duì)中。

嵌套類摘要

從接口 ohos.utils.Sequenceable 繼承的嵌套類/接口
Sequenceable.ProducerT

構(gòu)造函數(shù)摘要

構(gòu)造函數(shù)	描述
ValuesBucket()	用于創(chuàng)建具有默認(rèn)初始大小的空 ValuesBucket 實(shí)例的無參數(shù)構(gòu)造函數(shù)。
ValuesBucket(int size)	用于創(chuàng)建具有給定初始大小的空 ValuesBucket 實(shí)例的構(gòu)造函數(shù)。
ValuesBucket(ValuesBucket values)	用于通過從現(xiàn)有實(shí)例復(fù)制值來創(chuàng)建 ValuesBucket 實(shí)例的構(gòu)造函數(shù)。
ValuesBucket(Parcel in)	用于通過從 Parcel 對(duì)象復(fù)制值來創(chuàng)建 ValuesBucket 實(shí)例的構(gòu)造函數(shù)。

方法總結(jié)

修飾符和類型	方法	描述
void	clear()	清除當(dāng)前 ValuesBucket 中的所有值。
void	delete(String columnName)	從當(dāng)前 ValuesBucket 中刪除指定列名的值。
boolean	equals(Object object)	指示某個(gè)其他對(duì)象是否“等于”這個(gè)對(duì)象。
SetMap.EntryString,Object	getAll()	獲取包含存儲(chǔ)在當(dāng)前 ValuesBucket 中的所有列及其值的 Set。
Boolean	getBoolean(String columnName)	獲取指定列名的布爾值。
Byte	getByte(String columnName)	獲取指定列名的字節(jié)值。
byte[]	getByteArray(String columnName)	獲取指定列名的字節(jié)數(shù)組值。
SetString	getColumnSet()	獲取包含存儲(chǔ)在當(dāng)前 ValuesBucket 中的所有列的 Set。
Double	getDouble(String columnName)	獲取指定列名的 Double 值。
Float	getFloat(String columnName)	獲取指定列名的浮點(diǎn)值。
Integer	getInteger(String columnName)	獲取指定列名的整數(shù)值。
Long	getLong(String columnName)	獲取指定列名的 Long 值。
Object	getObject(String columnName)	獲取指定列名的 Object 值。
Short	getShort(String columnName)	獲取指定列名的 Short 值。
String	getString(String columnName)	獲取指定列名的String值。
boolean	hasColumn(String columnName)	檢查當(dāng)前 ValuesBucket 是否包含指定列名的值。
int	hashCode()	返回對(duì)象的哈希碼值。
boolean	isEmpty()	檢查當(dāng)前 ValuesBucket 是否為空。
boolean	marshalling(Parcel out)	將 ValuesBucket 對(duì)象寫入 Parcel。
void	putBoolean(String columnName, Boolean value)	將一個(gè)布爾值放入當(dāng)前的 ValuesBucket 并將其與給定的列名相關(guān)聯(lián)。
void	putByte(String columnName, Byte value)	將一個(gè)字節(jié)值放入當(dāng)前的 ValuesBucket 并將其與給定的列名相關(guān)聯(lián)。
void	putByteArray(String columnName, byte[] value)	將字節(jié)數(shù)組值放入當(dāng)前的 ValuesBucket 并將其與給定的列名相關(guān)聯(lián)。
void	putDouble(String columnName, Double value)	將 Double 值放入當(dāng)前 ValuesBucket 并將其與給定的列名相關(guān)聯(lián)。
void	putFloat(String columnName, Float value)	將 Float 值放入當(dāng)前 ValuesBucket 并將其與給定的列名相關(guān)聯(lián)。
void	putInteger(String columnName, Integer value)	將一個(gè)整數(shù)值放入當(dāng)前的 ValuesBucket 并將其與給定的列名相關(guān)聯(lián)。
void	putLong(String columnName, Long value)	將 Long 值放入當(dāng)前 ValuesBucket 并將其與給定的列名相關(guān)聯(lián)。
void	putNull(String columnName)	將一個(gè)空值放入當(dāng)前的 ValuesBucket 并將其與給定的列名相關(guān)聯(lián)。
void	putShort(String columnName, Short value)	將 Short 值放入當(dāng)前 ValuesBucket 并將其與給定的列名相關(guān)聯(lián)。
void	putString(String columnName, String value)	將 String 值放入當(dāng)前 ValuesBucket 并將其與給定的列名相關(guān)聯(lián)。
void	putValues(ValuesBucket other)	將指定 ValuesBucket 的值放入當(dāng)前 ValuesBucket。
int	size()	獲取當(dāng)前 ValuesBucket 中存儲(chǔ)的值的數(shù)量。
String	toString()	返回對(duì)象的字符串表示形式。
boolean	unmarshalling(Parcel in)	從 Parcel 中讀取 ValuesBucket 對(duì)象。

從類 java.lang.Object 繼承的方法
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

從接口 ohos.utils.Sequenceable 繼承的方法
hasFileDescriptor

構(gòu)造函數(shù)詳細(xì)信息

ValuesBucket

public ValuesBucket()

用于創(chuàng)建具有默認(rèn)初始大小的空 ValuesBucket 實(shí)例的無參數(shù)構(gòu)造函數(shù)。

ValuesBucket

public ValuesBucket(int size)

用于創(chuàng)建具有給定初始大小的空 ValuesBucket 實(shí)例的構(gòu)造函數(shù)。

參數(shù)：

參數(shù)名稱	參數(shù)描述
size	指示 ValuesBucket 實(shí)例的初始大小。

ValuesBucket

public ValuesBucket(ValuesBucket values)

用于通過從現(xiàn)有實(shí)例復(fù)制值來創(chuàng)建 ValuesBucket 實(shí)例的構(gòu)造函數(shù)。

參數(shù)：

參數(shù)名稱	參數(shù)描述
values	指示現(xiàn)有的 ValuesBucket 對(duì)象。

ValuesBucket

public ValuesBucket(Parcel in)

用于通過從 Parcel 對(duì)象復(fù)制值來創(chuàng)建 ValuesBucket 實(shí)例的構(gòu)造函數(shù)。

參數(shù)：

參數(shù)名稱	參數(shù)描述
in	指示 Parcel 對(duì)象。

方法詳情

putString

public void putString(String columnName, String value)

將 String 值放入當(dāng)前 ValuesBucket 并將其與給定的列名相關(guān)聯(lián)。

如果給定的列名已經(jīng)存在于 ValuesBucket 中，它的值將被給定的值替換。

參數(shù)：

參數(shù)名稱	參數(shù)描述
columnName	表示 String 值的列名。
value	表示字符串值。

putValues

public void putValues(ValuesBucket other)

將指定 ValuesBucket 的值放入當(dāng)前 ValuesBucket。

如果當(dāng)前 ValuesBucket 中已經(jīng)存在任何指定的列，則它們的值將被指定的 ValuesBucket 中的列的值替換。

參數(shù)：

參數(shù)名稱	參數(shù)描述
other	表示指定的ValuesBucket。

putByte

public void putByte(String columnName, Byte value)

將一個(gè)字節(jié)值放入當(dāng)前的 ValuesBucket 并將其與給定的列名相關(guān)聯(lián)。

如果給定的列名已經(jīng)存在于 ValuesBucket 中，它的值將被給定的值替換。

參數(shù)：

參數(shù)名稱	參數(shù)描述
columnName	表示字節(jié)值的列名。
value	表示字節(jié)值。

putShort

public void putShort(String columnName, Short value)

將 Short 值放入當(dāng)前 ValuesBucket 并將其與給定的列名相關(guān)聯(lián)。

如果給定的列名已經(jīng)存在于 ValuesBucket 中，它的值將被給定的值替換。

參數(shù)：

參數(shù)名稱	參數(shù)描述
columnName	表示 Short 值的列名。
value	表示 Short 值。

putInteger

public void putInteger(String columnName, Integer value)

將一個(gè)整數(shù)值放入當(dāng)前的 ValuesBucket 并將其與給定的列名相關(guān)聯(lián)。

如果給定的列名已經(jīng)存在于 ValuesBucket 中，它的值將被給定的值替換。

參數(shù)：

參數(shù)名稱	參數(shù)描述
columnName	指示整數(shù)值的列名。
value	表示整數(shù)值。

putLong

public void putLong(String columnName, Long value)

將 Long 值放入當(dāng)前 ValuesBucket 并將其與給定的列名相關(guān)聯(lián)。

如果給定的列名已經(jīng)存在于 ValuesBucket 中，它的值將被給定的值替換。

參數(shù)：

參數(shù)名稱	參數(shù)描述
columnName	表示 Long 值的列名。
value	表示 Long 值。

putFloat

public void putFloat(String columnName, Float value)

將 Float 值放入當(dāng)前 ValuesBucket 并將其與給定的列名相關(guān)聯(lián)。

如果給定的列名已經(jīng)存在于 ValuesBucket 中，它的值將被給定的值替換。

參數(shù)：

參數(shù)名稱	參數(shù)描述
columnName	指示浮點(diǎn)值的列名。
value	指示浮點(diǎn)值。

putDouble

public void putDouble(String columnName, Double value)

將 Double 值放入當(dāng)前 ValuesBucket 并將其與給定的列名相關(guān)聯(lián)。

如果給定的列名已經(jīng)存在于 ValuesBucket 中，它的值將被給定的值替換。

參數(shù)：

參數(shù)名稱	參數(shù)描述
columnName	指示 Double 值的列名。
value	表示 Double 值。

putBoolean

public void putBoolean(String columnName, Boolean value)

將一個(gè)布爾值放入當(dāng)前的 ValuesBucket 并將其與給定的列名相關(guān)聯(lián)。

如果給定的列名已經(jīng)存在于 ValuesBucket 中，它的值將被給定的值替換。

參數(shù)：

參數(shù)名稱	參數(shù)描述
columnName	表示布爾值的列名。
value	表示布爾值。

putByteArray

public void putByteArray(String columnName, byte[] value)

將字節(jié)數(shù)組值放入當(dāng)前的 ValuesBucket 并將其與給定的列名相關(guān)聯(lián)。

如果給定的列名已經(jīng)存在于 ValuesBucket 中，它的值將被給定的值替換。

參數(shù)：

參數(shù)名稱	參數(shù)描述
columnName	表示字節(jié)數(shù)組值的列名。
value	表示字節(jié)數(shù)組值。

putNull

public void putNull(String columnName)

將一個(gè)空值放入當(dāng)前的 ValuesBucket 并將其與給定的列名相關(guān)聯(lián)。

如果給定的列名已存在于 ValuesBucket 中，則其值將被替換為 null。

參數(shù)：

參數(shù)名稱	參數(shù)描述
columnName	表示空值的列名。

size

public int size()

獲取當(dāng)前 ValuesBucket 中存儲(chǔ)的值的數(shù)量。

返回:

返回當(dāng)前 ValuesBucket 中存儲(chǔ)的值的數(shù)量。

isEmpty

public boolean isEmpty()

檢查當(dāng)前 ValuesBucket 是否為空。

返回:

如果 ValuesBucket 不包含任何值，則返回 true； 否則返回 false。

delete

public void delete(String columnName)

從當(dāng)前 ValuesBucket 中刪除指定列名的值。

如果 ValuesBucket 不包含給定的列名，則此方法不會(huì)執(zhí)行任何操作。

參數(shù)：

參數(shù)名稱	參數(shù)描述
columnName	表示要?jiǎng)h除的值的列名。

clear

public void clear()

清除當(dāng)前 ValuesBucket 中的所有值。

調(diào)用此方法后，當(dāng)前的 ValuesBucket 將為空。

hasColumn

public boolean hasColumn(String columnName)

檢查當(dāng)前 ValuesBucket 是否包含指定列名的值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
columnName	表示值的列名。

返回:

如果給定列名的值存在，則返回 true； 否則返回 false。

getObject

public Object getObject(String columnName)

獲取指定列名的 Object 值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
columnName	表示 Object 值的列名。

返回:

如果有的話，返回給定列名的對(duì)象值； 否則返回 null。

getString

public String getString(String columnName)

獲取指定列名的String值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
columnName	表示 String 值的列名。

返回:

如果有的話，返回給定列名的字符串值； 否則返回 null。

getLong

public Long getLong(String columnName)

獲取指定列名的 Long 值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
columnName	表示 Long 值的列名。

返回:

如果有的話，返回給定列名的 Long 值； 否則返回 null。

getInteger

public Integer getInteger(String columnName)

獲取指定列名的整數(shù)值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
columnName	指示整數(shù)值的列名。

返回:

如果有的話，返回給定列名的整數(shù)值； 否則返回 null。

getShort

public Short getShort(String columnName)

獲取指定列名的 Short 值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
columnName	表示 Short 值的列名。

返回:

如果有的話，返回給定列名的 Short 值； 否則返回 null。

getByte

public Byte getByte(String columnName)

獲取指定列名的字節(jié)值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
columnName	表示字節(jié)值的列名。

返回:

如果有的話，返回給定列名的字節(jié)值； 否則返回 null。

getDouble

public Double getDouble(String columnName)

獲取指定列名的 Double 值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
columnName	指示 Double 值的列名。

返回:

如果有的話，返回給定列名的 Double 值； 否則返回 null。

getFloat

public Float getFloat(String columnName)

獲取指定列名的浮點(diǎn)值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
columnName	指示浮點(diǎn)值的列名。

返回:

如果有的話，返回給定列名的浮點(diǎn)值； 否則返回 null。

getBoolean

public Boolean getBoolean(String columnName)

獲取指定列名的布爾值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
columnName	表示布爾值的列名。

返回:

如果有的話，返回給定列名的布爾值； 否則返回 null。

getByteArray

public byte[] getByteArray(String columnName)

獲取指定列名的字節(jié)數(shù)組值。

參數(shù)：

參數(shù)名稱	參數(shù)描述
columnName	表示字節(jié)數(shù)組值的列名。

返回:

如果有的話，返回給定列名的字節(jié)數(shù)組值； 否則返回 null。

getAll

public SetMap.EntryString,Object getAll()

獲取包含存儲(chǔ)在當(dāng)前 ValuesBucket 中的所有列及其值的 Set。

返回:

返回一個(gè) Set，其中包含存儲(chǔ)在當(dāng)前 ValuesBucket 中的所有列及其值。

getColumnSet

public SetString getColumnSet()

獲取包含存儲(chǔ)在當(dāng)前 ValuesBucket 中的所有列的 Set。

返回:

返回包含存儲(chǔ)在當(dāng)前 ValuesBucket 中的所有列的 Set。

equals

public boolean equals(Object object)

從類復(fù)制的描述：對(duì)象

指示某個(gè)其他對(duì)象是否“等于”這個(gè)對(duì)象。

equals 方法在非空對(duì)象引用上實(shí)現(xiàn)等價(jià)關(guān)系：

• 它是自反的：對(duì)于任何非空引用值 x，x.equals(x) 應(yīng)該返回 true。
• 它是對(duì)稱的：對(duì)于任何非空引用值 x 和 y，當(dāng)且僅當(dāng) y.equals(x) 返回 true 時(shí)，x.equals(y) 才應(yīng)該返回 true。
• 它是可傳遞的：對(duì)于任何非空引用值 x、y 和 z，如果 x.equals(y) 返回 true 并且 y.equals(z) 返回 true，則 x.equals(z) 應(yīng)該返回 true。
• 它是一致的：對(duì)于任何非空引用值 x 和 y，x.equals(y) 的多次調(diào)用始終返回 true 或始終返回 false，前提是沒有修改對(duì)象上 equals 比較中使用的信息。
• 對(duì)于任何非空引用值 x，x.equals(null) 應(yīng)該返回 false。

Object 類的 equals 方法實(shí)現(xiàn)了對(duì)象上最有區(qū)別的可能等價(jià)關(guān)系； 也就是說，對(duì)于任何非空引用值 x 和 y，當(dāng)且僅當(dāng) x 和 y 引用同一個(gè)對(duì)象（x == y 的值為 true）時(shí)，此方法才返回 true。

請(qǐng)注意，每當(dāng)重寫該方法時(shí)，通常都需要重寫 hashCode 方法，以維護(hù) hashCode 方法的一般約定，即相等的對(duì)象必須具有相等的哈希碼。

覆蓋：

類 Object 中的等于

參數(shù)：

參數(shù)名稱	參數(shù)描述
object	要與之比較的參考對(duì)象。

返回:

如果此對(duì)象與 obj 參數(shù)相同，則為 true； 否則為 false。

hashCode

public int hashCode()

從類復(fù)制的描述：對(duì)象

返回對(duì)象的哈希碼值。 支持這種方法是為了有利于哈希表，例如 HashMap 提供的那些。

hashCode 的一般合約是：

• 每當(dāng)在 Java 應(yīng)用程序執(zhí)行期間對(duì)同一對(duì)象多次調(diào)用時(shí)，hashCode 方法必須始終返回相同的整數(shù)，前提是沒有修改對(duì)象上相等比較中使用的信息。 該整數(shù)不需要從應(yīng)用程序的一次執(zhí)行到同一應(yīng)用程序的另一次執(zhí)行保持一致。
• 如果兩個(gè)對(duì)象根據(jù) equals(Object) 方法相等，則對(duì)兩個(gè)對(duì)象中的每一個(gè)調(diào)用 hashCode 方法必須產(chǎn)生相同的整數(shù)結(jié)果。
• 如果根據(jù) Object.equals(java.lang.Object) 方法，如果兩個(gè)對(duì)象不相等，則不要求對(duì)兩個(gè)對(duì)象中的每一個(gè)調(diào)用 hashCode 方法必須產(chǎn)生不同的整數(shù)結(jié)果。 但是，程序員應(yīng)該意識(shí)到，為不相等的對(duì)象生成不同的整數(shù)結(jié)果可能會(huì)提高哈希表的性能。

在合理可行的情況下，由 Object 類定義的 hashCode 方法確實(shí)為不同的對(duì)象返回不同的整數(shù)。 （這通常通過將對(duì)象的內(nèi)部地址轉(zhuǎn)換為整數(shù)來實(shí)現(xiàn)，但 Java? 編程語言不需要這種實(shí)現(xiàn)技術(shù)。）

覆蓋：

類 Object 中的 hashCode

返回:

此對(duì)象的哈希碼值。

toString

public String toString()

從類復(fù)制的描述：對(duì)象

返回對(duì)象的字符串表示形式。 通常，toString 方法返回一個(gè)“以文本方式表示”該對(duì)象的字符串。 結(jié)果應(yīng)該是一個(gè)簡潔但信息豐富的表示，易于人們閱讀。 建議所有子類重寫此方法。

Object 類的 toString 方法返回一個(gè)字符串，該字符串由對(duì)象作為其實(shí)例的類的名稱、at 符號(hào)字符“@”和對(duì)象哈希碼的無符號(hào)十六進(jìn)制表示形式組成。 換句話說，此方法返回一個(gè)等于以下值的字符串：

 getClass().getName() + '@' + Integer.toHexString(hashCode()) 

覆蓋：

類 Object 中的 toString

返回:

對(duì)象的字符串表示形式。

marshalling

public boolean marshalling(Parcel out)

將 ValuesBucket 對(duì)象寫入 Parcel。

指定者：

接口 Sequenceable 中的編組

參數(shù)：

參數(shù)名稱	參數(shù)描述
out	表示目標(biāo) Parcel。

返回:

如果操作成功，則返回 true； 否則返回 false。

unmarshalling

public boolean unmarshalling(Parcel in)

從 Parcel 中讀取 ValuesBucket 對(duì)象。

指定者：

在接口 Sequenceable 中解組

參數(shù)：

參數(shù)名稱	參數(shù)描述
in	表示目標(biāo) Parcel。

返回:

如果操作成功，則返回 true； 否則返回 false。