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 语句。