鸿蒙OS Statement

Statement

public interface Statement

提供为预编译 SQL 语句设置值和执行预编译 SQL 语句的方法。

方法总结

修饰符和类型	方法	描述
void	clearValues()	清除预编译语句的所有动态值。
void	close()	关闭当前预编译的 SQL 语句。
void	execute()	执行预编译的 SQL 语句。
int	executeAndGetChanges()	执行预编译的 SQL 语句以获取受影响的行数。
long	executeAndGetLastInsertRowId()	执行预编译的 SQL 语句以获取最后插入的行的 ID。
long	executeAndGetLong()	执行预编译的 SQL 语句，获取 long 类型的返回值。
String	executeAndGetString()	执行预编译的 SQL 语句，获取字符串类型的返回值。
void	setBlob(int index, byte[] value)	动态设置预编译语句的字节数组值。
void	setDouble(int index, double value)	为预编译语句动态设置双精度值。
void	setLong(int index, long value)	动态设置预编译语句的 long 值。
void	setNull(int index)	为预编译语句动态设置 null。
void	setObject(int index, Object value)	动态设置预编译语句的对象值。
void	setString(int index, String value)	动态设置预编译语句的字符串值。
void	setStrings(String[] stringValues)	动态设置预编译语句的所有字符串值。

方法详情

setNull

void setNull(int index)

为预编译语句动态设置 null。

参数：

参数名称	参数描述
index	表示要为预编译语句设置的值的索引，从 1 开始。

setLong

void setLong(int index, long value)

动态设置预编译语句的 long 值。

参数：

参数名称	参数描述
index	表示要为预编译语句设置的值的索引，从 1 开始。
value	指示要为预编译语句设置的值。

setDouble

void setDouble(int index, double value)

为预编译语句动态设置双精度值。

参数：

参数名称	参数描述
index	表示要为预编译语句设置的值的索引，从 1 开始。
value	指示要为预编译语句设置的值。

setString

void setString(int index, String value)

动态设置预编译语句的字符串值。

参数：

参数名称	参数描述
index	表示要为预编译语句设置的值的索引，从 1 开始。
value	指示要为预编译语句设置的值。

setBlob

void setBlob(int index, byte[] value)

动态设置预编译语句的字节数组值。

参数：

参数名称	参数描述
index	表示要为预编译语句设置的值的索引，从 1 开始。
value	指示要为预编译语句设置的值。

setStrings

void setStrings(String[] stringValues)

动态设置预编译语句的所有字符串值。

参数：

参数名称	参数描述
stringValues	表示所有字符串值。

setObject

void setObject(int index, Object value)

动态设置预编译语句的对象值。

用于设置值的方法因值类型而异：

• 如果值为 null，请使用 Statement#setNull(int)。
• 如果值类型是布尔值，使用 Statement#setLong(int, long)。 1 表示真，0 表示假。
• 如果值类型是字节数组，则使用 [Statement#setBlob(int, byte])。
• 如果值类型是 Double 或 Float，请使用 Statement#setDouble(int, double)。
• 如果值类型是数字，请使用 Statement#setLong(int, long)。

如果该值不是上述任何一种类型，则将其转换为字符串并使用 Statement#setString(int, String) 进行设置。

参数：

参数名称	参数描述
index	表示要为预编译语句设置的值的索引，从 1 开始。
value	指示要为预编译语句设置的值。

clearValues

void clearValues()

清除预编译语句的所有动态值。

execute

void execute()

执行预编译的 SQL 语句。

executeAndGetLong

long executeAndGetLong()

执行预编译的 SQL 语句，获取 long 类型的返回值。

返回:

返回 long 类型的值。

executeAndGetString

String executeAndGetString()

执行预编译的 SQL 语句，获取字符串类型的返回值。

返回:

返回字符串类型的值。

executeAndGetChanges

int executeAndGetChanges()

执行预编译的 SQL 语句以获取受影响的行数。

返回:

返回受影响的行数。

executeAndGetLastInsertRowId

long executeAndGetLastInsertRowId()

执行预编译的 SQL 语句以获取最后插入的行的 ID。

返回:

返回最后插入的行的 ID。

close

void close()

关闭当前预编译的 SQL 语句。

不能再使用已关闭的 SQL 语句。