| java.lang.Object | |||
| ↳ | com.tencent.wcdb.database.SQLiteClosable | ||
| ↳ | com.tencent.wcdb.database.SQLiteProgram | ||
| ↳ | com.tencent.wcdb.database.SQLiteStatement | ||
Class Overview
Represents a statement that can be executed against a database. The statement cannot return multiple rows or columns, but single value (1 x 1) result sets are supported.
This class is not thread-safe.
Summary
| Public Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| void |
execute(CancellationSignal cancellationSignal)
Execute this SQL statement, if it is not a SELECT / INSERT / DELETE / UPDATE, for example
CREATE / DROP table, view, trigger, index etc.
| ||||||||||
| void |
execute()
Execute this SQL statement, if it is not a SELECT / INSERT / DELETE / UPDATE, for example
CREATE / DROP table, view, trigger, index etc.
| ||||||||||
| long |
executeInsert()
Execute this SQL statement and return the ID of the row inserted due to this call.
| ||||||||||
| long |
executeInsert(CancellationSignal cancellationSignal)
Execute this SQL statement and return the ID of the row inserted due to this call.
| ||||||||||
| int |
executeUpdateDelete(CancellationSignal cancellationSignal)
Execute this SQL statement, if the the number of rows affected by execution of this SQL
statement is of any importance to the caller - for example, UPDATE / DELETE SQL statements.
| ||||||||||
| int |
executeUpdateDelete()
Execute this SQL statement, if the the number of rows affected by execution of this SQL
statement is of any importance to the caller - for example, UPDATE / DELETE SQL statements.
| ||||||||||
| long |
simpleQueryForLong()
Execute a statement that returns a 1 by 1 table with a numeric value.
| ||||||||||
| long |
simpleQueryForLong(CancellationSignal cancellationSignal)
Execute a statement that returns a 1 by 1 table with a numeric value.
| ||||||||||
| String |
simpleQueryForString()
Execute a statement that returns a 1 by 1 table with a text value.
| ||||||||||
| String |
simpleQueryForString(CancellationSignal cancellationSignal)
Execute a statement that returns a 1 by 1 table with a text value.
| ||||||||||
| String | toString() | ||||||||||
|
[Expand]
Inherited Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
From class
com.tencent.wcdb.database.SQLiteProgram
| |||||||||||
|
From class
com.tencent.wcdb.database.SQLiteClosable
| |||||||||||
|
From class
java.lang.Object
| |||||||||||
|
From interface
java.io.Closeable
| |||||||||||
|
From interface
java.lang.AutoCloseable
| |||||||||||
Public Methods
public void execute (CancellationSignal cancellationSignal)
Execute this SQL statement, if it is not a SELECT / INSERT / DELETE / UPDATE, for example CREATE / DROP table, view, trigger, index etc.
Parameters
| cancellationSignal | A signal to cancel the operation in progress, or null if none.
If the operation is canceled, then OperationCanceledException will be thrown
when the query is executed. |
|---|
Throws
| SQLException | If the SQL string is invalid for some reason |
|---|
public void execute ()
Execute this SQL statement, if it is not a SELECT / INSERT / DELETE / UPDATE, for example CREATE / DROP table, view, trigger, index etc.
Throws
| SQLException | If the SQL string is invalid for some reason |
|---|
public long executeInsert ()
Execute this SQL statement and return the ID of the row inserted due to this call. The SQL statement should be an INSERT for this to be a useful call.
Returns
- the row ID of the last row inserted, if this insert is successful. -1 otherwise.
Throws
| SQLException | If the SQL string is invalid for some reason |
|---|
public long executeInsert (CancellationSignal cancellationSignal)
Execute this SQL statement and return the ID of the row inserted due to this call. The SQL statement should be an INSERT for this to be a useful call.
Parameters
| cancellationSignal | A signal to cancel the operation in progress, or null if none.
If the operation is canceled, then OperationCanceledException will be thrown
when the query is executed. |
|---|
Returns
- the row ID of the last row inserted, if this insert is successful. -1 otherwise.
Throws
| SQLException | If the SQL string is invalid for some reason |
|---|
public int executeUpdateDelete (CancellationSignal cancellationSignal)
Execute this SQL statement, if the the number of rows affected by execution of this SQL statement is of any importance to the caller - for example, UPDATE / DELETE SQL statements.
Parameters
| cancellationSignal | A signal to cancel the operation in progress, or null if none.
If the operation is canceled, then OperationCanceledException will be thrown
when the query is executed. |
|---|
Returns
- the number of rows affected by this SQL statement execution.
Throws
| SQLException | If the SQL string is invalid for some reason |
|---|
public int executeUpdateDelete ()
Execute this SQL statement, if the the number of rows affected by execution of this SQL statement is of any importance to the caller - for example, UPDATE / DELETE SQL statements.
Returns
- the number of rows affected by this SQL statement execution.
Throws
| SQLException | If the SQL string is invalid for some reason |
|---|
public long simpleQueryForLong ()
Execute a statement that returns a 1 by 1 table with a numeric value. For example, SELECT COUNT(*) FROM table;
Returns
- The result of the query.
Throws
| SQLiteDoneException | if the query returns zero rows |
|---|
public long simpleQueryForLong (CancellationSignal cancellationSignal)
Execute a statement that returns a 1 by 1 table with a numeric value. For example, SELECT COUNT(*) FROM table;
Parameters
| cancellationSignal | A signal to cancel the operation in progress, or null if none.
If the operation is canceled, then OperationCanceledException will be thrown
when the query is executed. |
|---|
Returns
- The result of the query.
Throws
| SQLiteDoneException | if the query returns zero rows |
|---|
public String simpleQueryForString ()
Execute a statement that returns a 1 by 1 table with a text value. For example, SELECT COUNT(*) FROM table;
Returns
- The result of the query.
Throws
| SQLiteDoneException | if the query returns zero rows |
|---|
public String simpleQueryForString (CancellationSignal cancellationSignal)
Execute a statement that returns a 1 by 1 table with a text value. For example, SELECT COUNT(*) FROM table;
Parameters
| cancellationSignal | A signal to cancel the operation in progress, or null if none.
If the operation is canceled, then OperationCanceledException will be thrown
when the query is executed. |
|---|
Returns
- The result of the query.
Throws
| SQLiteDoneException | if the query returns zero rows |
|---|