程序包 ohos.data.resultset

类 TableResultSet

java.lang.Object

ohos.data.resultset.AbsResultSet

ohos.data.resultset.TableResultSet

所有已实现的接口:

ResultSet

public class TableResultSet
extends AbsResultSet

Represents a table result set that can be expanded dynamically.

The result set is stored in a two-dimensional Object array, and the addRow() method is used to add rows to the result set.

从以下版本开始:

2

SystemCapability

SystemCapability.Data#DATA_APPDATAMGR

嵌套类概要

嵌套类

限定符和类型	类	说明
class	TableResultSet.RowBuilder	Represents the row builder of the matrix result set.

从接口继承的嵌套类/接口 ohos.data.resultset.ResultSet

ResultSet.ColumnType

字段概要

从类继承的字段 ohos.data.resultset.AbsResultSet

DEFAULT_POS, isClosed, pos

构造器概要

构造器

构造器	说明
TableResultSet(String[] columnNames)	A constructor used to create a TableResultSet instance with specified column names.
TableResultSet(String[] columnNames, int initialCapacity)	A constructor used to create a TableResultSet instance with specified column names and capacity.

方法概要

限定符和类型	方法	说明
void	addRow(Iterable<?> columnValues)	Adds a row that contains column values of the iterator type to the end of a result set.
void	addRow(Object[] columnValues)	Adds a row that contains an array of column values to the end of a result set.
TableResultSet.RowBuilder	addRowByBuilder()	Adds a row to the end of a result set and obtains a builder.
String[]	getAllColumnNames()	Obtains the names of all columns in a result set.
byte[]	getBlob(int columnIndex)	Obtains the value of the specified column in the current row as a byte array.
int	getColumnCount()	Obtains the number of columns in the result set.
ResultSet.ColumnType	getColumnTypeForIndex(int columnIndex)	Obtains the data type based on the specified column index.
double	getDouble(int columnIndex)	Obtains the value of the specified column in the current row as a double.
float	getFloat(int columnIndex)	Obtains the value of the specified column in the current row as a float.
int	getInt(int columnIndex)	Obtains the value of the specified column in the current row as an int.
long	getLong(int columnIndex)	Obtains the value of the specified column in the current row as a long.
int	getRowCount()	Obtains the number of rows in the result set.
short	getShort(int columnIndex)	Obtains the value of the specified column in the current row as a short.
String	getString(int columnIndex)	Obtains the value of the specified column in the current row as a string.
boolean	goToRow(int rowIndex)	Go to the specified row of the result set.
boolean	isColumnNull(int columnIndex)	Checks whether the value of the specified column in the current row is null.

从类继承的方法 ohos.data.resultset.AbsResultSet

close, finalize, getAffectedByUris, getColumnIndexForName, getColumnNameForIndex, getExtensions, getRowIndex, goTo, goToFirstRow, goToLastRow, goToNextRow, goToPreviousRow, isAtFirstRow, isAtLastRow, isClosed, isEnded, isStarted, notifyChange, registerObserver, setAffectedByUris, setExtensions, unregisterObserver

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

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

TableResultSet

public TableResultSet(String[] columnNames,
                      int initialCapacity)

A constructor used to create a TableResultSet instance with specified column names and capacity.

The TableResultSet instance can be initialized based on the input capacity and column names.

参数:

columnNames - Indicates an array of the column names. The sequence of columns is determined by the array.

initialCapacity - Indicates the initial capacity of the TableResultSet instance.

从以下版本开始:

2

TableResultSet

public TableResultSet(String[] columnNames)

A constructor used to create a TableResultSet instance with specified column names.

The TableResultSet instance can be initialized based on the input column names.

参数:

columnNames - Indicates an array of the column names. The sequence of columns is determined by the array.

从以下版本开始:

2

方法详细资料

addRowByBuilder

public TableResultSet.RowBuilder addRowByBuilder()

Adds a row to the end of a result set and obtains a builder.

The obtained builder can be used to set column values for the added row.

返回:

Returns a builder that can be used to set column values for the added row.

从以下版本开始:

2

addRow

public void addRow(Object[] columnValues)

Adds a row that contains an array of column values to the end of a result set.

参数:

columnValues - Indicates the column values in the same sequence as those specified during the result set construction.

抛出:

IllegalArgumentException - Throws this exception if columnValues.length is not equal to columnNames.length.

从以下版本开始:

2

addRow

public void addRow(Iterable<?> columnValues)

Adds a row that contains column values of the iterator type to the end of a result set.

参数:

columnValues - Indicates the column values in the same sequence as those specified during the result set construction.

抛出:

IllegalArgumentException - Throws this exception if columnValues.size() is not equal to columnNames.length.

从以下版本开始:

2

getRowCount

public int getRowCount()

从接口复制的说明: ResultSet

Obtains the number of rows in the result set.

指定者:

getRowCount 在接口中 ResultSet

指定者:

getRowCount 在类中 AbsResultSet

返回:

Returns the number of rows in the result set.

getAllColumnNames

public String[] getAllColumnNames()

从接口复制的说明: ResultSet

Obtains the names of all columns in a result set.

The column names are returned as a string array, in which the strings are in the same order as the columns in the result set.

指定者:

getAllColumnNames 在接口中 ResultSet

指定者:

getAllColumnNames 在类中 AbsResultSet

返回:

Returns a string array containing all the column names in the result set.

getColumnCount

public int getColumnCount()

从接口复制的说明: ResultSet

Obtains the number of columns in the result set.

The returned number is equal to the length of the string array returned by the getAllColumnNames method.

指定者:

getColumnCount 在接口中 ResultSet

覆盖:

getColumnCount 在类中 AbsResultSet

返回:

Returns the number of columns in the result set.

另请参阅:

ResultSet.getAllColumnNames()

getColumnTypeForIndex

public ResultSet.ColumnType getColumnTypeForIndex(int columnIndex)

从接口复制的说明: ResultSet

Obtains the data type based on the specified column index.

The return value is of the enumeration type, which can be an integer, float, String, Blob, or null.

参数:

columnIndex - Indicates the specified column index.

返回:

Returns the data type of the specified column.

getBlob

public byte[] getBlob(int columnIndex)

从接口复制的说明: ResultSet

Obtains the value of the specified column in the current row as a byte array.

The implementation class determines whether to throw an exception if the value of the specified column in the current row is null or the specified column is not of the Blob type.

指定者:

getBlob 在接口中 ResultSet

指定者:

getBlob 在类中 AbsResultSet

参数:

columnIndex - Indicates the specified column index, which starts from 0.

返回:

Returns the value of the specified column as a byte array.

getString

public String getString(int columnIndex)

从接口复制的说明: ResultSet

Obtains the value of the specified column in the current row as a string.

The implementation class determines whether to throw an exception if the value of the specified column in the current row is null or the specified column is not of the string type.

指定者:

getString 在接口中 ResultSet

指定者:

getString 在类中 AbsResultSet

参数:

columnIndex - Indicates the specified column index, which starts from 0.

返回:

Returns the value of the specified column as a string.

getShort

public short getShort(int columnIndex)

Obtains the value of the specified column in the current row as a short.

he implementation class determines whether to throw an exception if the value of the specified column in the current row is null, the specified column is not of the integer type, or the integer is beyond the range [Short.MIN_VALUE, Short.MAX_VALUE].

指定者:

getShort 在接口中 ResultSet

指定者:

getShort 在类中 AbsResultSet

参数:

columnIndex - Indicates the specified column index, which starts from 0.

返回:

Returns the value of the specified column as a short.

从以下版本开始:

1

getInt

public int getInt(int columnIndex)

Obtains the value of the specified column in the current row as an int.

The implementation class determines whether to throw an exception if the value of the specified column in the current row is null, the specified column is not of the integer type, or the integer is beyond the range [Integer.MIN_VALUE, Integer.MAX_VALUE].

指定者:

getInt 在接口中 ResultSet

指定者:

getInt 在类中 AbsResultSet

参数:

columnIndex - Indicates the specified column index, which starts from 0.

返回:

Returns the value of the specified column as an int.

从以下版本开始:

1

getLong

public long getLong(int columnIndex)

Obtains the value of the specified column in the current row as a long.

The implementation class determines whether to throw an exception if the value of the specified column in the current row is null, the specified column is not of the integer type, or the integer is beyond the range [Long.MIN_VALUE, Long.MAX_VALUE].

指定者:

getLong 在接口中 ResultSet

指定者:

getLong 在类中 AbsResultSet

参数:

columnIndex - Indicates the specified column index, which starts from 0.

返回:

Returns the value of the specified column as a long.

从以下版本开始:

1

getFloat

public float getFloat(int columnIndex)

Obtains the value of the specified column in the current row as a float.

The implementation class determines whether to throw an exception if the value of the specified column in the current row is null, the specified column is not of the floating-point type, or the floating-point value cannot be represented by a float.

指定者:

getFloat 在接口中 ResultSet

指定者:

getFloat 在类中 AbsResultSet

参数:

columnIndex - Indicates the specified column index, which starts from 0.

返回:

Returns the value of the specified column as a float.

从以下版本开始:

1

getDouble

public double getDouble(int columnIndex)

Obtains the value of the specified column in the current row as a double.

The implementation class determines whether to throw an exception if the value of the specified column in the current row is null, the specified column is not of the floating-point type, or the floating-point value cannot be represented by a double.

指定者:

getDouble 在接口中 ResultSet

指定者:

getDouble 在类中 AbsResultSet

参数:

columnIndex - Indicates the specified column index, which starts from 0.

返回:

Returns the value of the specified column as a double.

从以下版本开始:

1

isColumnNull

public boolean isColumnNull(int columnIndex)

从接口复制的说明: ResultSet

Checks whether the value of the specified column in the current row is null.

指定者:

isColumnNull 在接口中 ResultSet

指定者:

isColumnNull 在类中 AbsResultSet

参数:

columnIndex - Indicates the specified column index, which starts from 0.

返回:

Returns true if the value of the specified column in the current row is null; returns false otherwise.

goToRow

public boolean goToRow(int rowIndex)

从接口复制的说明: ResultSet

Go to the specified row of the result set.

指定者:

goToRow 在接口中 ResultSet

指定者:

goToRow 在类中 AbsResultSet

参数:

rowIndex - Indicates the index of the specified row, which starts from 0.

返回:

Returns true if the result set is moved successfully; returns false otherwise.