service PreparedStatement in module com::sun::star::sdbc:: |
service PreparedStatement;
represents a precompiled SQL statement.
A SQL statement is pre-compiled and stored in a PreparedStatement object. This object can then be used to efficiently execute this statement multiple times.
Note:
The
setXXX
methods for setting IN parameter values
must specify types that are compatible with the defined SQL type of
the input parameter. For instance, if the IN parameter has SQL type
Integer, then the method
XParameters::setInt()
should be used.
If arbitrary parameter type conversions are required, the method XParameters::setObject() should be used with a target SQL type.
Example of setting a parameter; con
is an active connection.
pstmt = con.prepareStatement("UPDATE EMPLOYEES SET SALARY = ? WHERE ID = ?") pstmt.setDouble(1, 153833.00) pstmt.setLong(2, 110592)
Only one
ResultSet
per
Statement
can be open at any point in
time. Therefore, if the reading of one ResultSet is interleaved
with the reading of another, each must have been generated by
different Statements. All statement
execute
methods implicitly close a statement's current ResultSet if an open one exists.
Exported Interfaces |
optional for implementation, controls the releasing of resources and the notification of registered listeners.
freeing all resources of a statement. A related resultset will be freed as well.
provides information about and access to the properties from an implementation.
could be used for cancelling the execution of SQL statements, if both the DBMS and the driver support aborting an SQL statement. The implementation is optional.
is the interface for executing SQL prepared commands.
provides access to the result set description.
is used for setting parameters before execution of the precompiled statement.
provides the ability of batch execution. This interface is optional for execution.
A driver implementing batch execution must return true for XDatabaseMetaData::supportsBatchUpdates()
controls the chaining of warnings, which may occur on every call to the connected database. Chained warnings from previous calls will be cleared before processing a new call.
covers the handling of multiple results after executing an SQL command.
Property Summary |
|
QueryTimeOut | retrieves the number of seconds the driver will wait for a Statement to execute. If the limit is exceeded, a SQLException is thrown. There is no limitation, if set to zero. |
MaxFieldSize | returns the maximum number of bytes allowed for any column value. |
MaxRows | retrieves the maximum number of rows that a ResultSet can contain.
If the limit is exceeded, the excess rows are silently dropped.
There is no limitation, if set to zero. |
CursorName | defines the SQL cursor name that will be used by subsequent Statement
execute
methods.
|
ResultSetConcurrency | retrieves the result set concurrency. |
ResultSetType | Determine the result set type. |
FetchDirection | retrieves the direction for fetching rows from database tables
that is the default for result sets generated from this
Statement
object.
|
FetchSize | retrieves the number of result set rows that is the default fetch size
for result sets generated from this
Statement
object.
|
Property Details |
|||||||||
|
Copyright 2002 Sun Microsystems, Inc., 901 San Antonio Road, Palo Alto, CA 94303 USA.