鴻蒙OS ResultSet

ResultSet

public interface ResultSet

提供用于訪問通過查詢數(shù)據(jù)庫生成的數(shù)據(jù)庫結(jié)果集的方法。

抽象類 AbsResultSet 實(shí)現(xiàn)了 ResultSet 接口中的一些方法。

Since:

1

嵌套類摘要

修飾符和類型	接口	描述
static class	ResultSet.ColumnType	定義結(jié)果集中列的數(shù)據(jù)類型。

方法總結(jié)

修飾符和類型	方法	描述
void	close()	關(guān)閉結(jié)果集。
ListUri	getAffectedByUris()	獲取注冊(cè)的 URI 列表以觀察影響結(jié)果集的更改。
String[]	getAllColumnNames()	獲取結(jié)果集中所有列的名稱。
byte[]	getBlob(int columnIndex)	以字節(jié)數(shù)組的形式獲取當(dāng)前行中指定列的值。
int	getColumnCount()	獲取結(jié)果集中的列數(shù)。
int	getColumnIndexForName(String columnName)	根據(jù)指定的列名獲取列索引。
String	getColumnNameForIndex(int columnIndex)	根據(jù)指定的列索引獲取列名。
ResultSet.ColumnType	getColumnTypeForIndex(int columnIndex)	根據(jù)指定的列索引獲取數(shù)據(jù)類型。
double	getDouble(int columnIndex)	以 double 形式獲取當(dāng)前行中指定列的值。
PacMap	getExtensions()	獲取結(jié)果集的擴(kuò)展。
float	getFloat(int columnIndex)	獲取當(dāng)前行中指定列的值作為浮點(diǎn)數(shù)。
int	getInt(int columnIndex)	以 int 形式獲取當(dāng)前行中指定列的值。
long	getLong(int columnIndex)	以long形式獲取當(dāng)前行中指定列的值。
int	getRowCount()	獲取結(jié)果集中的行數(shù)。
int	getRowIndex()	獲取結(jié)果集的當(dāng)前索引。
short	getShort(int columnIndex)	以short形式獲取當(dāng)前行中指定列的值。
String	getString(int columnIndex)	以字符串形式獲取當(dāng)前行中指定列的值。
boolean	goTo(int offset)	以相對(duì)于其當(dāng)前位置的偏移量向前或向后轉(zhuǎn)到結(jié)果集的指定行。
boolean	goToFirstRow()	轉(zhuǎn)到結(jié)果集的第一行。
boolean	goToLastRow()	轉(zhuǎn)到結(jié)果集的最后一行。
boolean	goToNextRow()	轉(zhuǎn)到結(jié)果集的下一行。
boolean	goToPreviousRow()	轉(zhuǎn)到結(jié)果集的上一行。
boolean	goToRow(int rowIndex)	轉(zhuǎn)到結(jié)果集的指定行。
boolean	isAtFirstRow()	檢查結(jié)果集是否位于第一行。
boolean	isAtLastRow()	檢查結(jié)果集是否位于最后一行。
boolean	isClosed()	檢查當(dāng)前結(jié)果集是否關(guān)閉。
boolean	isColumnNull(int columnIndex)	檢查當(dāng)前行中指定列的值是否為空。
boolean	isEnded()	檢查結(jié)果集是否位于最后一行之后。
boolean	isStarted()	檢查結(jié)果集是否已移動(dòng)。
void	registerObserver(DataObserver observer)	注冊(cè)一個(gè)監(jiān)聽數(shù)據(jù)變化的觀察者。
void	setAffectedByUris(Object context, ListUri uris)	設(shè)置要觀察的數(shù)據(jù)的 URI。
void	setExtensions(PacMap extensions)	設(shè)置結(jié)果集的擴(kuò)展。
void	unregisterObserver(DataObserver observer)	取消注冊(cè)一個(gè)監(jiān)聽數(shù)據(jù)變化的觀察者。

方法詳情

getAllColumnNames

String[] getAllColumnNames()

獲取結(jié)果集中所有列的名稱。

列名作為字符串?dāng)?shù)組返回，其中字符串的順序與結(jié)果集中的列的順序相同。

返回:

返回包含結(jié)果集中所有列名的字符串?dāng)?shù)組。

Since:

1

getColumnCount

int getColumnCount()

獲取結(jié)果集中的列數(shù)。

返回的數(shù)字等于 getAllColumnNames 方法返回的字符串?dāng)?shù)組的長(zhǎng)度。

返回:

返回結(jié)果集中的列數(shù)。

Since:

1

getColumnTypeForIndex

ResultSet.ColumnType getColumnTypeForIndex(int columnIndex)

根據(jù)指定的列索引獲取數(shù)據(jù)類型。

返回值為枚舉類型，可以是整數(shù)、浮點(diǎn)數(shù)、字符串、Blob或null。

參數(shù)：

參數(shù)名稱	參數(shù)描述
columnIndex	表示指定的列索引。

返回:

返回指定列的數(shù)據(jù)類型。

Since:

1

getColumnIndexForName

int getColumnIndexForName(String columnName)

根據(jù)指定的列名獲取列索引。

列名作為輸入?yún)?shù)傳遞。

參數(shù)：

參數(shù)名稱	參數(shù)描述
columnName	指示結(jié)果集中指定列的名稱。

返回:

返回指定列的索引。

Since:

1

getColumnNameForIndex

String getColumnNameForIndex(int columnIndex)

根據(jù)指定的列索引獲取列名。

列索引作為輸入?yún)?shù)傳遞。

參數(shù)：

參數(shù)名稱	參數(shù)描述
columnIndex	指示結(jié)果集中指定列的索引。

返回:

返回指定列的名稱。

Since:

1

getRowCount

int getRowCount()

獲取結(jié)果集中的行數(shù)。

返回:

返回結(jié)果集中的行數(shù)。

Since:

1

getRowIndex

int getRowIndex()

獲取結(jié)果集的當(dāng)前索引。

結(jié)果集索引從 0 開始。

返回:

返回結(jié)果集的當(dāng)前索引。

Since:

1

goTo

boolean goTo(int offset)

以相對(duì)于其當(dāng)前位置的偏移量向前或向后轉(zhuǎn)到結(jié)果集的指定行。 正偏移量表示向后移動(dòng)，負(fù)偏移量表示向前移動(dòng)。

參數(shù)：

參數(shù)名稱	參數(shù)描述
offset	表示相對(duì)于當(dāng)前位置的偏移量。

返回:

如果結(jié)果集移動(dòng)成功并且沒有超出范圍，則返回 true； 否則返回 false。

Since:

1

goToRow

boolean goToRow(int rowIndex)

轉(zhuǎn)到結(jié)果集的指定行。

參數(shù)：

參數(shù)名稱	參數(shù)描述
rowIndex	表示指定行的索引，從0開始。

返回:

如果結(jié)果集移動(dòng)成功，則返回 true； 否則返回 false。

Since:

1

goToFirstRow

boolean goToFirstRow()

轉(zhuǎn)到結(jié)果集的第一行。

返回:

如果結(jié)果集移動(dòng)成功，則返回 true； 否則返回 false，例如，如果結(jié)果集為空。

Since:

1

goToLastRow

boolean goToLastRow()

轉(zhuǎn)到結(jié)果集的最后一行。

返回:

如果結(jié)果集移動(dòng)成功，則返回 true； 否則返回 false，例如，如果結(jié)果集為空。

Since:

1

goToNextRow

boolean goToNextRow()

轉(zhuǎn)到結(jié)果集的下一行。

返回:

如果結(jié)果集移動(dòng)成功，則返回 true； 否則返回 false，例如，如果結(jié)果集已經(jīng)在最后一行。

Since:

1

goToPreviousRow

boolean goToPreviousRow()

轉(zhuǎn)到結(jié)果集的上一行。

返回:

如果結(jié)果集移動(dòng)成功，則返回 true； 否則返回 false，例如，如果結(jié)果集已經(jīng)在第一行。

Since:

1

isEnded

boolean isEnded()

檢查結(jié)果集是否位于最后一行之后。

返回:

如果結(jié)果集位于最后一行之后，則返回 true； 否則返回 false。

Since:

1

isStarted

boolean isStarted()

檢查結(jié)果集是否已移動(dòng)。

返回:

如果結(jié)果集已被移動(dòng)，則返回 true； 如果結(jié)果集尚未移動(dòng)或結(jié)果集為空，則返回 false。

Since:

1

isAtFirstRow

boolean isAtFirstRow()

檢查結(jié)果集是否位于第一行。

返回:

如果結(jié)果集位于第一行，則返回 true； 否則返回 false。

Since:

1

isAtLastRow

boolean isAtLastRow()

檢查結(jié)果集是否位于最后一行。

返回:

如果結(jié)果集位于最后一行，則返回 true； 否則返回 false。

Since:

1

getBlob

byte[] getBlob(int columnIndex)

以字節(jié)數(shù)組的形式獲取當(dāng)前行中指定列的值。

實(shí)現(xiàn)類判斷當(dāng)前行中指定列的值為null或指定列不是Blob類型時(shí)是否拋出異常。

參數(shù)：

參數(shù)名稱	參數(shù)描述
columnIndex	表示指定的列索引，從 0 開始。

返回:

以字節(jié)數(shù)組的形式返回指定列的值。

Since:

1

getString

String getString(int columnIndex)

以字符串形式獲取當(dāng)前行中指定列的值。

實(shí)現(xiàn)類判斷當(dāng)前行中指定列的值為空或指定列不是字符串類型時(shí)是否拋出異常。

參數(shù)：

參數(shù)名稱	參數(shù)描述
columnIndex	表示指定的列索引，從 0 開始。

返回:

以字符串形式返回指定列的值。

Since:

1

getShort

short getShort(int columnIndex)

以short形式獲取當(dāng)前行中指定列的值。

如果當(dāng)前行中指定列的值為空，指定列不是整數(shù)類型，或者整數(shù)超出范圍[Short.MIN_VALUE，Short.MAX_VALUE]，實(shí)現(xiàn)類判斷是否拋出異常。

參數(shù)：

參數(shù)名稱	參數(shù)描述
columnIndex	表示指定的列索引，從 0 開始。

返回:

以 short 形式返回指定列的值。

Since:

1

getInt

int getInt(int columnIndex)

以 int 形式獲取當(dāng)前行中指定列的值。

如果當(dāng)前行中指定列的值為空、指定列不是整數(shù)類型或整數(shù)超出范圍[Integer.MIN_VALUE, Integer.MAX_VALUE]，實(shí)現(xiàn)類判斷是否拋出異常。

參數(shù)：

參數(shù)名稱	參數(shù)描述
columnIndex	表示指定的列索引，從 0 開始。

返回:

以 int 形式返回指定列的值。

Since:

1

getLong

long getLong(int columnIndex)

以long形式獲取當(dāng)前行中指定列的值。

實(shí)現(xiàn)類判斷當(dāng)前行中指定列的值為空、指定列不是整數(shù)類型或整數(shù)超出范圍[Long.MIN_VALUE, Long.MAX_VALUE]是否拋出異常。

參數(shù)：

參數(shù)名稱	參數(shù)描述
columnIndex	表示指定的列索引，從 0 開始。

返回:

以 long 形式返回指定列的值。

Since:

1

getFloat

float getFloat(int columnIndex)

獲取當(dāng)前行中指定列的值作為浮點(diǎn)數(shù)。

實(shí)現(xiàn)類判斷當(dāng)前行中指定列的值為空、指定列不是浮點(diǎn)類型或浮點(diǎn)值不能用float表示時(shí)是否拋出異常。

參數(shù)：

參數(shù)名稱	參數(shù)描述
columnIndex	表示指定的列索引，從 0 開始。

返回:

以浮點(diǎn)數(shù)形式返回指定列的值。

Since:

1

getDouble

double getDouble(int columnIndex)

以 double 形式獲取當(dāng)前行中指定列的值。

實(shí)現(xiàn)類判斷當(dāng)前行中指定列的值為空、指定列不是浮點(diǎn)類型或浮點(diǎn)值不能用雙精度表示時(shí)是否拋出異常。

參數(shù)：

參數(shù)名稱	參數(shù)描述
columnIndex	表示指定的列索引，從 0 開始。

返回:

以雙精度形式返回指定列的值。

Since:

1

isColumnNull

boolean isColumnNull(int columnIndex)

檢查當(dāng)前行中指定列的值是否為空。

參數(shù)：

參數(shù)名稱	參數(shù)描述
columnIndex	表示指定的列索引，從 0 開始。

返回:

如果當(dāng)前行中指定列的值為null，則返回true； 否則返回 false。

Since:

1

isClosed

boolean isClosed()

檢查當(dāng)前結(jié)果集是否關(guān)閉。

如果調(diào)用 close 方法關(guān)閉結(jié)果集，則返回 true。

返回:

如果結(jié)果集關(guān)閉，則返回 true； 否則返回 false。

Since:

1

close

void close()

關(guān)閉結(jié)果集。

在結(jié)果集上調(diào)用此方法將釋放其所有資源并使其無效。

Since:

1

setExtensions

void setExtensions(PacMap extensions)

設(shè)置結(jié)果集的擴(kuò)展。

您可以根據(jù)您的服務(wù)需求設(shè)置擴(kuò)展。

參數(shù)：

參數(shù)名稱	參數(shù)描述
extensions	指示要設(shè)置的擴(kuò)展名。

Since:

2

getExtensions

PacMap getExtensions()

獲取結(jié)果集的擴(kuò)展。

您將獲得的擴(kuò)展是根據(jù)您的服務(wù)要求設(shè)置的。

返回:

返回結(jié)果集的擴(kuò)展。

Since:

2

setAffectedByUris

void setAffectedByUris(Object context, ListUri uris)

設(shè)置要觀察的數(shù)據(jù)的 URI。

設(shè)置好 URI 后，調(diào)用 ResultSet#registerObserver 方法注冊(cè)一個(gè)監(jiān)聽數(shù)據(jù)變化的觀察者。

參數(shù)：

參數(shù)名稱	參數(shù)描述
context	表示上下文。
uris	用于觀察影響此 ResultSet 的更改的 Uri 列表。

Since:

2

getAffectedByUris

ListUri getAffectedByUris()

獲取注冊(cè)的 URI 列表以觀察影響結(jié)果集的更改。

URI 列表是使用 ResultSet#setAffectedByUris 方法設(shè)置的。

返回:

返回 URI 列表。

Since:

3

registerObserver

void registerObserver(DataObserver observer)

注冊(cè)一個(gè)監(jiān)聽數(shù)據(jù)變化的觀察者。

當(dāng)接收到指定 URI 的數(shù)據(jù)更改通知時(shí)，將觸發(fā)該觀察者。

參數(shù)：

參數(shù)名稱	參數(shù)描述
observer	表示要注冊(cè)的觀察者。

Since:

2

unregisterObserver

void unregisterObserver(DataObserver observer)

取消注冊(cè)一個(gè)監(jiān)聽數(shù)據(jù)變化的觀察者。

該方法用于在觀察者所屬的組件被銷毀之前釋放觀察者。

參數(shù)：

參數(shù)名稱	參數(shù)描述
observer	指示要注銷的觀察者。

Since:

2