ValuesBucket

java.lang.Object
- ohos.data.rdb.ValuesBucket

所有已实现的接口:

Sequenceable
```
public class ValuesBucket
extends Object
implements Sequenceable
```
Manages buckets used to store a series of values.
Values in buckets are stored in key-value pairs.

从以下版本开始:

1

SystemCapability

SystemCapability.Data#DATA_APPDATAMGR

嵌套类概要
- 从接口继承的嵌套类/接口 ohos.utils.Sequenceable
  Sequenceable.Producer<T>

构造器概要

构造器
构造器	说明
`ValuesBucket()`	A no-argument constructor used to create an empty `ValuesBucket` instance with the default initial size.
`ValuesBucket(int size)`	A constructor used to create an empty `ValuesBucket` instance with a given initial size.
`ValuesBucket(ValuesBucket values)`	A constructor used to create a `ValuesBucket` instance by copying values from an existing one.
`ValuesBucket(Parcel in)`	A constructor used to create a `ValuesBucket` instance by copying values from a `Parcel` object.

方法概要

所有方法实例方法具体方法
限定符和类型	方法	说明
`void`	`clear()`	Clears all values in the current `ValuesBucket`.
`void`	`delete(String columnName)`	Deletes the value of a specified column name from the current `ValuesBucket`.
`boolean`	`equals(Object object)`	Indicates whether some other object is "equal to" this one.
`Set<Map.Entry<String,Object>>`	`getAll()`	Obtains a `Set` containing all columns and their values stored in the current `ValuesBucket`.
`Boolean`	`getBoolean(String columnName)`	Obtains the `Boolean` value of a specified column name.
`Byte`	`getByte(String columnName)`	Obtains the byte value of a specified column name.
`byte[]`	`getByteArray(String columnName)`	Obtains the byte array value of a specified column name.
`Set<String>`	`getColumnSet()`	Obtains a `Set` containing all columns stored in the current `ValuesBucket`.
`Double`	`getDouble(String columnName)`	Obtains the `Double` value of a specified column name.
`Float`	`getFloat(String columnName)`	Obtains the `Float` value of a specified column name.
`Integer`	`getInteger(String columnName)`	Obtains the `Integer` value of a specified column name.
`Long`	`getLong(String columnName)`	Obtains the `Long` value of a specified column name.
`Object`	`getObject(String columnName)`	Obtains the `Object` value of a specified column name.
`Short`	`getShort(String columnName)`	Obtains the `Short` value of a specified column name.
`String`	`getString(String columnName)`	Obtains the `String` value of a specified column name.
`boolean`	`hasColumn(String columnName)`	Checks whether the current `ValuesBucket` contains the value of a specified column name.
`int`	`hashCode()`	Returns a hash code value for the object.
`boolean`	`isEmpty()`	Checks whether the current `ValuesBucket` is empty.
`boolean`	`marshalling(Parcel out)`	Write ValuesBucket object to Parcel.
`void`	`putBoolean(String columnName, Boolean value)`	Puts a `Boolean` value into the current `ValuesBucket` and associates it with a given column name.
`void`	`putByte(String columnName, Byte value)`	Puts a byte value into the current `ValuesBucket` and associates it with a given column name.
`void`	`putByteArray(String columnName, byte[] value)`	Puts a byte array value into the current `ValuesBucket` and associates it with a given column name.
`void`	`putDouble(String columnName, Double value)`	Puts a `Double` value into the current `ValuesBucket` and associates it with a given column name.
`void`	`putFloat(String columnName, Float value)`	Puts a `Float` value into the current `ValuesBucket` and associates it with a given column name.
`void`	`putInteger(String columnName, Integer value)`	Puts an `Integer` value into the current `ValuesBucket` and associates it with a given column name.
`void`	`putLong(String columnName, Long value)`	Puts a `Long` value into the current `ValuesBucket` and associates it with a given column name.
`void`	`putNull(String columnName)`	Puts a `null` value into the current `ValuesBucket` and associates it with a given column name.
`void`	`putShort(String columnName, Short value)`	Puts a `Short` value into the current `ValuesBucket` and associates it with a given column name.
`void`	`putString(String columnName, String value)`	Puts a `String` value into the current `ValuesBucket` and associates it with a given column name.
`void`	`putValues(ValuesBucket other)`	Puts values of a designated `ValuesBucket` into the current `ValuesBucket`.
`int`	`size()`	Obtains the number of values stored in the current `ValuesBucket`.
`String`	`toString()`	Returns a string representation of the object.
`boolean`	`unmarshalling(Parcel in)`	Reads ValuesBucket objects from Parcel.

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

从接口继承的方法 ohos.utils.Sequenceable
hasFileDescriptor

- 构造器详细资料
  - ValuesBucket
```
public ValuesBucket()
```
    A no-argument constructor used to create an empty ValuesBucket instance with the default initial size.
    
    从以下版本开始:
    
    1
  - ValuesBucket
```
public ValuesBucket(int size)
```
    A constructor used to create an empty ValuesBucket instance with a given initial size.
    
    参数:
    
    size - Indicates the initial size of the ValuesBucket instance.
    
    从以下版本开始:
    
    1
  - ValuesBucket
```
public ValuesBucket(ValuesBucket values)
```
    A constructor used to create a ValuesBucket instance by copying values from an existing one.
    
    参数:
    
    values - Indicates the existing ValuesBucket object.
    
    从以下版本开始:
    
    1
  - ValuesBucket
```
public ValuesBucket(Parcel in)
```
    A constructor used to create a ValuesBucket instance by copying values from a Parcel object.
    
    参数:
    
    in - Indicates the Parcel object.
    
    从以下版本开始:
    
    1
- 方法详细资料
  - putString
```
public void putString(String columnName,
                      String value)
```
    Puts a String value into the current ValuesBucket and associates it with a given column name.
    If the given column name already exists in the ValuesBucket, its value will be replaced by the given value.
    
    参数:
    
    columnName - Indicates the column name of the String value.
    
    value - Indicates the String value.
    
    从以下版本开始:
    
    1
  - putValues
```
public void putValues(ValuesBucket other)
```
    Puts values of a designated ValuesBucket into the current ValuesBucket.
    If any specified columns already exist in the current ValuesBucket, their values will be replaced by those of the columns in the designated ValuesBucket.
    
    参数:
    
    other - Indicates the designated ValuesBucket.
    
    从以下版本开始:
    
    1
  - putByte
```
public void putByte(String columnName,
                    Byte value)
```
    Puts a byte value into the current ValuesBucket and associates it with a given column name.
    If the given column name already exists in the ValuesBucket, its value will be replaced by the given value.
    
    参数:
    
    columnName - Indicates the column name of the byte value.
    
    value - Indicates the byte value.
    
    从以下版本开始:
    
    1
  - putShort
```
public void putShort(String columnName,
                     Short value)
```
    Puts a Short value into the current ValuesBucket and associates it with a given column name.
    If the given column name already exists in the ValuesBucket, its value will be replaced by the given value.
    
    参数:
    
    columnName - Indicates the column name of the Short value.
    
    value - Indicates the Short value.
    
    从以下版本开始:
    
    1
  - putInteger
```
public void putInteger(String columnName,
                       Integer value)
```
    Puts an Integer value into the current ValuesBucket and associates it with a given column name.
    If the given column name already exists in the ValuesBucket, its value will be replaced by the given value.
    
    参数:
    
    columnName - Indicates the column name of the Integer value.
    
    value - Indicates the Integer value.
    
    从以下版本开始:
    
    1
  - putLong
```
public void putLong(String columnName,
                    Long value)
```
    Puts a Long value into the current ValuesBucket and associates it with a given column name.
    If the given column name already exists in the ValuesBucket, its value will be replaced by the given value.
    
    参数:
    
    columnName - Indicates the column name of the Long value.
    
    value - Indicates the Long value.
    
    从以下版本开始:
    
    1
  - putFloat
```
public void putFloat(String columnName,
                     Float value)
```
    Puts a Float value into the current ValuesBucket and associates it with a given column name.
    If the given column name already exists in the ValuesBucket, its value will be replaced by the given value.
    
    参数:
    
    columnName - Indicates the column name of the Float value.
    
    value - Indicates the Float value.
    
    从以下版本开始:
    
    1
  - putDouble
```
public void putDouble(String columnName,
                      Double value)
```
    Puts a Double value into the current ValuesBucket and associates it with a given column name.
    If the given column name already exists in the ValuesBucket, its value will be replaced by the given value.
    
    参数:
    
    columnName - Indicates the column name of the Double value.
    
    value - Indicates the Double value.
    
    从以下版本开始:
    
    1
  - putBoolean
```
public void putBoolean(String columnName,
                       Boolean value)
```
    Puts a Boolean value into the current ValuesBucket and associates it with a given column name.
    If the given column name already exists in the ValuesBucket, its value will be replaced by the given value.
    
    参数:
    
    columnName - Indicates the column name of the Boolean value.
    
    value - Indicates the Boolean value.
    
    从以下版本开始:
    
    1
  - putByteArray
```
public void putByteArray(String columnName,
                         byte[] value)
```
    Puts a byte array value into the current ValuesBucket and associates it with a given column name.
    If the given column name already exists in the ValuesBucket, its value will be replaced by the given value.
    
    参数:
    
    columnName - Indicates the column name of the byte array value.
    
    value - Indicates the byte array value.
    
    从以下版本开始:
    
    1
  - putNull
```
public void putNull(String columnName)
```
    Puts a null value into the current ValuesBucket and associates it with a given column name.
    If the given column name already exists in the ValuesBucket, its value will be replaced by null.
    
    参数:
    
    columnName - Indicates the column name of the null value.
    
    从以下版本开始:
    
    1
  - size
```
public int size()
```
    Obtains the number of values stored in the current ValuesBucket.
    
    返回:
    
    Returns the number of values stored in the current ValuesBucket.
    
    从以下版本开始:
    
    1
  - isEmpty
```
public boolean isEmpty()
```
    Checks whether the current ValuesBucket is empty.
    
    返回:
    
    Returns true if the ValuesBucket does not contain any value; returns false otherwise.
    
    从以下版本开始:
    
    1
  - delete
```
public void delete(String columnName)
```
    Deletes the value of a specified column name from the current ValuesBucket.
    If the ValuesBucket does not contain the given column name, this method will not perform any operation.
    
    参数:
    
    columnName - Indicates the column name of the value to delete.
    
    从以下版本开始:
    
    1
  - clear
```
public void clear()
```
    Clears all values in the current ValuesBucket.
    The current ValuesBucket will be empty after this method is called.
    
    从以下版本开始:
    
    1
  - hasColumn
```
public boolean hasColumn(String columnName)
```
    Checks whether the current ValuesBucket contains the value of a specified column name.
    
    参数:
    
    columnName - Indicates the column name of the value.
    
    返回:
    
    Returns true if the value of the given column name exists; returns false otherwise.
    
    从以下版本开始:
    
    1
  - getObject
```
public Object getObject(String columnName)
```
    Obtains the Object value of a specified column name.
    
    参数:
    
    columnName - Indicates the column name of the Object value.
    
    返回:
    
    Returns the Object value of the given column name if any; returns null otherwise.
    
    从以下版本开始:
    
    1
  - getString
```
public String getString(String columnName)
```
    Obtains the String value of a specified column name.
    
    参数:
    
    columnName - Indicates the column name of the String value.
    
    返回:
    
    Returns the String value of the given column name if any; returns null otherwise.
    
    从以下版本开始:
    
    1
  - getLong
```
public Long getLong(String columnName)
```
    Obtains the Long value of a specified column name.
    
    参数:
    
    columnName - Indicates the column name of the Long value.
    
    返回:
    
    Returns the Long value of the given column name if any; returns null otherwise.
    
    从以下版本开始:
    
    1
  - getInteger
```
public Integer getInteger(String columnName)
```
    Obtains the Integer value of a specified column name.
    
    参数:
    
    columnName - Indicates the column name of the Integer value.
    
    返回:
    
    Returns the Integer value of the given column name if any; returns null otherwise.
    
    从以下版本开始:
    
    1
  - getShort
```
public Short getShort(String columnName)
```
    Obtains the Short value of a specified column name.
    
    参数:
    
    columnName - Indicates the column name of the Short value.
    
    返回:
    
    Returns the Short value of the given column name if any; returns null otherwise.
    
    从以下版本开始:
    
    1
  - getByte
```
public Byte getByte(String columnName)
```
    Obtains the byte value of a specified column name.
    
    参数:
    
    columnName - Indicates the column name of the byte value.
    
    返回:
    
    Returns the byte value of the given column name if any; returns null otherwise.
    
    从以下版本开始:
    
    1
  - getDouble
```
public Double getDouble(String columnName)
```
    Obtains the Double value of a specified column name.
    
    参数:
    
    columnName - Indicates the column name of the Double value.
    
    返回:
    
    Returns the Double value of the given column name if any; returns null otherwise.
    
    从以下版本开始:
    
    1
  - getFloat
```
public Float getFloat(String columnName)
```
    Obtains the Float value of a specified column name.
    
    参数:
    
    columnName - Indicates the column name of the Float value.
    
    返回:
    
    Returns the Float value of the given column name if any; returns null otherwise.
    
    从以下版本开始:
    
    1
  - getBoolean
```
public Boolean getBoolean(String columnName)
```
    Obtains the Boolean value of a specified column name.
    
    参数:
    
    columnName - Indicates the column name of the Boolean value.
    
    返回:
    
    Returns the Boolean value of the given column name if any; returns null otherwise.
    
    从以下版本开始:
    
    1
  - getByteArray
```
public byte[] getByteArray(String columnName)
```
    Obtains the byte array value of a specified column name.
    
    参数:
    
    columnName - Indicates the column name of the byte array value.
    
    返回:
    
    Returns the byte array value of the given column name if any; returns null otherwise.
    
    从以下版本开始:
    
    1
  - getAll
```
public Set<Map.Entry<String,Object>> getAll()
```
    Obtains a Set containing all columns and their values stored in the current ValuesBucket.
    
    返回:
    
    Returns a Set containing all columns and their values stored in the current ValuesBucket.
    
    从以下版本开始:
    
    1
  - getColumnSet
```
public Set<String> getColumnSet()
```
    Obtains a Set containing all columns stored in the current ValuesBucket.
    
    返回:
    
    Returns a Set containing all columns stored in the current ValuesBucket.
    
    从以下版本开始:
    
    1
  - equals
```
public boolean equals(Object object)
```
    从类复制的说明: Object
    Indicates whether some other object is "equal to" this one.
    The equals method implements an equivalence relation on non-null object references:
    - It is reflexive: for any non-null reference value x, x.equals(x) should return true.
    - It is symmetric: for any non-null reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true.
    - It is transitive: for any non-null reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true.
    - It is consistent: for any non-null reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the objects is modified.
    - For any non-null reference value x, x.equals(null) should return false.
    The equals method for class Object implements the most discriminating possible equivalence relation on objects; that is, for any non-null reference values x and y, this method returns true if and only if x and y refer to the same object (x == y has the value true).
    Note that it is generally necessary to override the hashCode method whenever this method is overridden, so as to maintain the general contract for the hashCode method, which states that equal objects must have equal hash codes.
    覆盖:
    
    equals 在类中 Object
    
    参数:
    
    object - the reference object with which to compare.
    
    返回:
    
    true if this object is the same as the obj argument; false otherwise.
    
    另请参阅:
    
    Object.hashCode(), HashMap
  - hashCode
```
public int hashCode()
```
    从类复制的说明: Object
    Returns a hash code value for the object. This method is supported for the benefit of hash tables such as those provided by HashMap.
    The general contract of hashCode is:
    - Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
    - If two objects are equal according to the equals(Object) method, then calling the hashCode method on each of the two objects must produce the same integer result.
    - It is not required that if two objects are unequal according to the Object.equals(java.lang.Object) method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.
    As much as is reasonably practical, the hashCode method defined by class Object does return distinct integers for distinct objects. (This is typically implemented by converting the internal address of the object into an integer, but this implementation technique is not required by the Java™ programming language.)
    覆盖:
    
    hashCode 在类中 Object
    
    返回:
    
    a hash code value for this object.
    
    另请参阅:
    
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - toString
```
public String toString()
```
    从类复制的说明: Object
    Returns a string representation of the object. In general, the toString method returns a string that "textually represents" this object. The result should be a concise but informative representation that is easy for a person to read. It is recommended that all subclasses override this method.
    The toString method for class Object returns a string consisting of the name of the class of which the object is an instance, the at-sign character `@', and the unsigned hexadecimal representation of the hash code of the object. In other words, this method returns a string equal to the value of:
    getClass().getName() + '@' + Integer.toHexString(hashCode())
    覆盖:
    
    toString 在类中 Object
    
    返回:
    
    a string representation of the object.
  - marshalling
```
public boolean marshalling(Parcel out)
```
    Write ValuesBucket object to Parcel.
    
    指定者:
    
    marshalling 在接口中 Sequenceable
    
    参数:
    
    out - Indicates the target Parcel.
    
    返回:
    
    Returns true if the operation is successful; returns false otherwise.
  - unmarshalling
```
public boolean unmarshalling(Parcel in)
```
    Reads ValuesBucket objects from Parcel.
    
    指定者:
    
    unmarshalling 在接口中 Sequenceable
    
    参数:
    
    in - Indicates the target Parcel.
    
    返回:
    
    Returns true if the operation is successful; returns false otherwise.

类 ValuesBucket

嵌套类概要

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

构造器概要

方法概要

从类继承的方法 java.lang.Object

从接口继承的方法 ohos.utils.Sequenceable

构造器详细资料

ValuesBucket

ValuesBucket

ValuesBucket

ValuesBucket

方法详细资料

putString

putValues

putByte

putShort

putInteger

putLong

putFloat

putDouble

putBoolean

putByteArray

putNull

size

isEmpty

delete

clear

hasColumn

getObject

getString

getLong

getInteger

getShort

getByte

getDouble

getFloat

getBoolean

getByteArray

getAll

getColumnSet

equals

hashCode

toString

marshalling

unmarshalling