org.springframework.jdbc.core

Interface JdbcOperations

All Known Implementing Classes:

JdbcTemplate

public interface JdbcOperations

Interface specifying a basic set of JDBC operations. Implemented by JdbcTemplate. Not often used directly, but a useful option to enhance testability, as it can easily be mocked or stubbed.

Alternatively, the standard JDBC infrastructure can be mocked. However, mocking this interface constitutes significantly less work. As an alternative to a mock objects approach to testing data access code, consider the powerful integration testing support provided in the org.springframework.test package, shipped in spring-test.jar.

Author:

Rod Johnson, Juergen Hoeller

See Also:

JdbcTemplate

Method Summary

Modifier and Type	Method and Description
int[]	batchUpdate(String... sql) Issue multiple SQL updates on a single JDBC Statement using batching.
int[]	batchUpdate(String sql, BatchPreparedStatementSetter pss) Issue multiple update statements on a single PreparedStatement, using batch updates and a BatchPreparedStatementSetter to set values.
<T> int[][]	batchUpdate(String sql, Collection<T> batchArgs, int batchSize, ParameterizedPreparedStatementSetter<T> pss) Execute multiple batches using the supplied SQL statement with the collect of supplied arguments.
int[]	batchUpdate(String sql, List<Object[]> batchArgs) Execute a batch using the supplied SQL statement with the batch of supplied arguments.
int[]	batchUpdate(String sql, List<Object[]> batchArgs, int[] argTypes) Execute a batch using the supplied SQL statement with the batch of supplied arguments.
Map<String,Object>	call(CallableStatementCreator csc, List<SqlParameter> declaredParameters) Execute a SQL call using a CallableStatementCreator to provide SQL and any required parameters.
<T> T	execute(CallableStatementCreator csc, CallableStatementCallback<T> action) Execute a JDBC data access operation, implemented as callback action working on a JDBC CallableStatement.
<T> T	execute(ConnectionCallback<T> action) Execute a JDBC data access operation, implemented as callback action working on a JDBC Connection.
<T> T	execute(PreparedStatementCreator psc, PreparedStatementCallback<T> action) Execute a JDBC data access operation, implemented as callback action working on a JDBC PreparedStatement.
<T> T	execute(StatementCallback<T> action) Execute a JDBC data access operation, implemented as callback action working on a JDBC Statement.
void	execute(String sql) Issue a single SQL execute, typically a DDL statement.
<T> T	execute(String callString, CallableStatementCallback<T> action) Execute a JDBC data access operation, implemented as callback action working on a JDBC CallableStatement.
<T> T	execute(String sql, PreparedStatementCallback<T> action) Execute a JDBC data access operation, implemented as callback action working on a JDBC PreparedStatement.
<T> T	query(PreparedStatementCreator psc, ResultSetExtractor<T> rse) Query using a prepared statement, reading the ResultSet with a ResultSetExtractor.
void	query(PreparedStatementCreator psc, RowCallbackHandler rch) Query using a prepared statement, reading the ResultSet on a per-row basis with a RowCallbackHandler.
<T> List<T>	query(PreparedStatementCreator psc, RowMapper<T> rowMapper) Query using a prepared statement, mapping each row to a Java object via a RowMapper.
<T> T	query(String sql, Object[] args, int[] argTypes, ResultSetExtractor<T> rse) Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, reading the ResultSet with a ResultSetExtractor.
void	query(String sql, Object[] args, int[] argTypes, RowCallbackHandler rch) Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, reading the ResultSet on a per-row basis with a RowCallbackHandler.
<T> List<T>	query(String sql, Object[] args, int[] argTypes, RowMapper<T> rowMapper) Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, mapping each row to a Java object via a RowMapper.
<T> T	query(String sql, Object[] args, ResultSetExtractor<T> rse) Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, reading the ResultSet with a ResultSetExtractor.
void	query(String sql, Object[] args, RowCallbackHandler rch) Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, reading the ResultSet on a per-row basis with a RowCallbackHandler.
<T> List<T>	query(String sql, Object[] args, RowMapper<T> rowMapper) Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, mapping each row to a Java object via a RowMapper.
<T> T	query(String sql, PreparedStatementSetter pss, ResultSetExtractor<T> rse) Query using a prepared statement, reading the ResultSet with a ResultSetExtractor.
void	query(String sql, PreparedStatementSetter pss, RowCallbackHandler rch) Query given SQL to create a prepared statement from SQL and a PreparedStatementSetter implementation that knows how to bind values to the query, reading the ResultSet on a per-row basis with a RowCallbackHandler.
<T> List<T>	query(String sql, PreparedStatementSetter pss, RowMapper<T> rowMapper) Query given SQL to create a prepared statement from SQL and a PreparedStatementSetter implementation that knows how to bind values to the query, mapping each row to a Java object via a RowMapper.
<T> T	query(String sql, ResultSetExtractor<T> rse) Execute a query given static SQL, reading the ResultSet with a ResultSetExtractor.
<T> T	query(String sql, ResultSetExtractor<T> rse, Object... args) Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, reading the ResultSet with a ResultSetExtractor.
void	query(String sql, RowCallbackHandler rch) Execute a query given static SQL, reading the ResultSet on a per-row basis with a RowCallbackHandler.
void	query(String sql, RowCallbackHandler rch, Object... args) Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, reading the ResultSet on a per-row basis with a RowCallbackHandler.
<T> List<T>	query(String sql, RowMapper<T> rowMapper) Execute a query given static SQL, mapping each row to a Java object via a RowMapper.
<T> List<T>	query(String sql, RowMapper<T> rowMapper, Object... args) Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, mapping each row to a Java object via a RowMapper.
int	queryForInt(String sql) Deprecated. in favor of queryForObject(String, Class)
int	queryForInt(String sql, Object... args) Deprecated. in favor of queryForObject(String, Class, Object[]) )}
int	queryForInt(String sql, Object[] args, int[] argTypes) Deprecated. in favor of queryForObject(String, Object[], int[], Class) )}
List<Map<String,Object>>	queryForList(String sql) Execute a query for a result list, given static SQL.
<T> List<T>	queryForList(String sql, Class<T> elementType) Execute a query for a result list, given static SQL.
<T> List<T>	queryForList(String sql, Class<T> elementType, Object... args) Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, expecting a result list.
List<Map<String,Object>>	queryForList(String sql, Object... args) Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, expecting a result list.
<T> List<T>	queryForList(String sql, Object[] args, Class<T> elementType) Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, expecting a result list.
List<Map<String,Object>>	queryForList(String sql, Object[] args, int[] argTypes) Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, expecting a result list.
<T> List<T>	queryForList(String sql, Object[] args, int[] argTypes, Class<T> elementType) Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, expecting a result list.
long	queryForLong(String sql) Deprecated. in favor of queryForObject(String, Class)
long	queryForLong(String sql, Object... args) Deprecated. in favor of queryForObject(String, Class, Object[]) )}
long	queryForLong(String sql, Object[] args, int[] argTypes) Deprecated. in favor of queryForObject(String, Object[], int[], Class) )}
Map<String,Object>	queryForMap(String sql) Execute a query for a result Map, given static SQL.
Map<String,Object>	queryForMap(String sql, Object... args) Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, expecting a result Map.
Map<String,Object>	queryForMap(String sql, Object[] args, int[] argTypes) Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, expecting a result Map.
<T> T	queryForObject(String sql, Class<T> requiredType) Execute a query for a result object, given static SQL.
<T> T	queryForObject(String sql, Class<T> requiredType, Object... args) Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, expecting a result object.
<T> T	queryForObject(String sql, Object[] args, Class<T> requiredType) Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, expecting a result object.
<T> T	queryForObject(String sql, Object[] args, int[] argTypes, Class<T> requiredType) Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, expecting a result object.
<T> T	queryForObject(String sql, Object[] args, int[] argTypes, RowMapper<T> rowMapper) Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, mapping a single result row to a Java object via a RowMapper.
<T> T	queryForObject(String sql, Object[] args, RowMapper<T> rowMapper) Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, mapping a single result row to a Java object via a RowMapper.
<T> T	queryForObject(String sql, RowMapper<T> rowMapper) Execute a query given static SQL, mapping a single result row to a Java object via a RowMapper.
<T> T	queryForObject(String sql, RowMapper<T> rowMapper, Object... args) Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, mapping a single result row to a Java object via a RowMapper.
SqlRowSet	queryForRowSet(String sql) Execute a query for a SqlRowSet, given static SQL.
SqlRowSet	queryForRowSet(String sql, Object... args) Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, expecting a SqlRowSet.
SqlRowSet	queryForRowSet(String sql, Object[] args, int[] argTypes) Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, expecting a SqlRowSet.
int	update(PreparedStatementCreator psc) Issue a single SQL update operation (such as an insert, update or delete statement) using a PreparedStatementCreator to provide SQL and any required parameters.
int	update(PreparedStatementCreator psc, KeyHolder generatedKeyHolder) Issue an update statement using a PreparedStatementCreator to provide SQL and any required parameters.
int	update(String sql) Issue a single SQL update operation (such as an insert, update or delete statement).
int	update(String sql, Object... args) Issue a single SQL update operation (such as an insert, update or delete statement) via a prepared statement, binding the given arguments.
int	update(String sql, Object[] args, int[] argTypes) Issue a single SQL update operation (such as an insert, update or delete statement) via a prepared statement, binding the given arguments.
int	update(String sql, PreparedStatementSetter pss) Issue an update statement using a PreparedStatementSetter to set bind parameters, with given SQL.

Method Detail

execute

<T> T execute(ConnectionCallback<T> action)
       throws org.springframework.dao.DataAccessException

Execute a JDBC data access operation, implemented as callback action working on a JDBC Connection. This allows for implementing arbitrary data access operations, within Spring's managed JDBC environment: that is, participating in Spring-managed transactions and converting JDBC SQLExceptions into Spring's DataAccessException hierarchy.

The callback action can return a result object, for example a domain object or a collection of domain objects.

Parameters:

action - the callback object that specifies the action

Returns:

a result object returned by the action, or null

Throws:

org.springframework.dao.DataAccessException - if there is any problem

execute

<T> T execute(StatementCallback<T> action)
       throws org.springframework.dao.DataAccessException

Execute a JDBC data access operation, implemented as callback action working on a JDBC Statement. This allows for implementing arbitrary data access operations on a single Statement, within Spring's managed JDBC environment: that is, participating in Spring-managed transactions and converting JDBC SQLExceptions into Spring's DataAccessException hierarchy.

The callback action can return a result object, for example a domain object or a collection of domain objects.

Parameters:

action - callback object that specifies the action

Returns:

a result object returned by the action, or null

Throws:

org.springframework.dao.DataAccessException - if there is any problem

execute

void execute(String sql)
      throws org.springframework.dao.DataAccessException

Issue a single SQL execute, typically a DDL statement.

Parameters:

sql - static SQL to execute

Throws:

org.springframework.dao.DataAccessException - if there is any problem

query

<T> T query(String sql,
            ResultSetExtractor<T> rse)
     throws org.springframework.dao.DataAccessException

Execute a query given static SQL, reading the ResultSet with a ResultSetExtractor.

Uses a JDBC Statement, not a PreparedStatement. If you want to execute a static query with a PreparedStatement, use the overloaded query method with null as argument array.

Parameters:

sql - SQL query to execute

rse - object that will extract all rows of results

Returns:

an arbitrary result object, as returned by the ResultSetExtractor

Throws:

org.springframework.dao.DataAccessException - if there is any problem executing the query

See Also:

query(String, Object[], ResultSetExtractor)

query

void query(String sql,
           RowCallbackHandler rch)
    throws org.springframework.dao.DataAccessException

Execute a query given static SQL, reading the ResultSet on a per-row basis with a RowCallbackHandler.

Uses a JDBC Statement, not a PreparedStatement. If you want to execute a static query with a PreparedStatement, use the overloaded query method with null as argument array.

Parameters:

sql - SQL query to execute

rch - object that will extract results, one row at a time

Throws:

org.springframework.dao.DataAccessException - if there is any problem executing the query

See Also:

query(String, Object[], RowCallbackHandler)

query

<T> List<T> query(String sql,
                  RowMapper<T> rowMapper)
           throws org.springframework.dao.DataAccessException

Execute a query given static SQL, mapping each row to a Java object via a RowMapper.

Uses a JDBC Statement, not a PreparedStatement. If you want to execute a static query with a PreparedStatement, use the overloaded query method with null as argument array.

Parameters:

sql - SQL query to execute

rowMapper - object that will map one object per row

Returns:

the result List, containing mapped objects

Throws:

org.springframework.dao.DataAccessException - if there is any problem executing the query

See Also:

query(String, Object[], RowMapper)

queryForObject

<T> T queryForObject(String sql,
                     RowMapper<T> rowMapper)
              throws org.springframework.dao.DataAccessException

Execute a query given static SQL, mapping a single result row to a Java object via a RowMapper.

Uses a JDBC Statement, not a PreparedStatement. If you want to execute a static query with a PreparedStatement, use the overloaded queryForObject(String, RowMapper, Object...) method with null as argument array.

Parameters:

sql - SQL query to execute

rowMapper - object that will map one object per row

Returns:

the single mapped object

Throws:

org.springframework.dao.IncorrectResultSizeDataAccessException - if the query does not return exactly one row

org.springframework.dao.DataAccessException - if there is any problem executing the query

See Also:

queryForObject(String, Object[], RowMapper)

queryForObject

<T> T queryForObject(String sql,
                     Class<T> requiredType)
              throws org.springframework.dao.DataAccessException

Execute a query for a result object, given static SQL.

Uses a JDBC Statement, not a PreparedStatement. If you want to execute a static query with a PreparedStatement, use the overloaded queryForObject(String, Class, Object...) method with null as argument array.

This method is useful for running static SQL with a known outcome. The query is expected to be a single row/single column query; the returned result will be directly mapped to the corresponding object type.

Parameters:

sql - SQL query to execute

requiredType - the type that the result object is expected to match

Returns:

the result object of the required type, or null in case of SQL NULL

Throws:

org.springframework.dao.IncorrectResultSizeDataAccessException - if the query does not return exactly one row, or does not return exactly one column in that row

org.springframework.dao.DataAccessException - if there is any problem executing the query

See Also:

queryForObject(String, Object[], Class)

queryForMap

Map<String,Object> queryForMap(String sql)
                        throws org.springframework.dao.DataAccessException

Execute a query for a result Map, given static SQL.

Uses a JDBC Statement, not a PreparedStatement. If you want to execute a static query with a PreparedStatement, use the overloaded queryForMap(String, Object...) method with null as argument array.

The query is expected to be a single row query; the result row will be mapped to a Map (one entry for each column, using the column name as the key).

Parameters:

sql - SQL query to execute

Returns:

the result Map (one entry for each column, using the column name as the key)

Throws:

org.springframework.dao.IncorrectResultSizeDataAccessException - if the query does not return exactly one row

org.springframework.dao.DataAccessException - if there is any problem executing the query

See Also:

queryForMap(String, Object[]), ColumnMapRowMapper

queryForLong

@Deprecated
long queryForLong(String sql)
                       throws org.springframework.dao.DataAccessException

Deprecated. in favor of queryForObject(String, Class)

Execute a query that results in a long value, given static SQL.

Uses a JDBC Statement, not a PreparedStatement. If you want to execute a static query with a PreparedStatement, use the overloaded queryForLong method with null as argument array.

This method is useful for running static SQL with a known outcome. The query is expected to be a single row/single column query that results in a long value.

Parameters:

sql - SQL query to execute

Returns:

the long value, or 0 in case of SQL NULL

Throws:

org.springframework.dao.IncorrectResultSizeDataAccessException - if the query does not return exactly one row, or does not return exactly one column in that row

org.springframework.dao.DataAccessException - if there is any problem executing the query

See Also:

queryForLong(String, Object[])

queryForInt

@Deprecated
int queryForInt(String sql)
                     throws org.springframework.dao.DataAccessException

Deprecated. in favor of queryForObject(String, Class)

Execute a query that results in an int value, given static SQL.

Uses a JDBC Statement, not a PreparedStatement. If you want to execute a static query with a PreparedStatement, use the overloaded queryForInt method with null as argument array.

This method is useful for running static SQL with a known outcome. The query is expected to be a single row/single column query that results in an int value.

Parameters:

sql - SQL query to execute

Returns:

the int value, or 0 in case of SQL NULL

Throws:

org.springframework.dao.IncorrectResultSizeDataAccessException - if the query does not return exactly one row, or does not return exactly one column in that row

org.springframework.dao.DataAccessException - if there is any problem executing the query

See Also:

queryForInt(String, Object[])

queryForList

<T> List<T> queryForList(String sql,
                         Class<T> elementType)
                  throws org.springframework.dao.DataAccessException

Execute a query for a result list, given static SQL.

Uses a JDBC Statement, not a PreparedStatement. If you want to execute a static query with a PreparedStatement, use the overloaded queryForList method with null as argument array.

The results will be mapped to a List (one entry for each row) of result objects, each of them matching the specified element type.

Parameters:

sql - SQL query to execute

elementType - the required type of element in the result list (for example, Integer.class)

Returns:

a List of objects that match the specified element type

Throws:

org.springframework.dao.DataAccessException - if there is any problem executing the query

See Also:

queryForList(String, Object[], Class), SingleColumnRowMapper

queryForList

List<Map<String,Object>> queryForList(String sql)
                               throws org.springframework.dao.DataAccessException

Execute a query for a result list, given static SQL.

Uses a JDBC Statement, not a PreparedStatement. If you want to execute a static query with a PreparedStatement, use the overloaded queryForList method with null as argument array.

The results will be mapped to a List (one entry for each row) of Maps (one entry for each column using the column name as the key). Each element in the list will be of the form returned by this interface's queryForMap() methods.

Parameters:

sql - SQL query to execute

Returns:

an List that contains a Map per row

Throws:

org.springframework.dao.DataAccessException - if there is any problem executing the query

See Also:

queryForList(String, Object[])

queryForRowSet

SqlRowSet queryForRowSet(String sql)
                  throws org.springframework.dao.DataAccessException

Execute a query for a SqlRowSet, given static SQL.

Uses a JDBC Statement, not a PreparedStatement. If you want to execute a static query with a PreparedStatement, use the overloaded queryForRowSet method with null as argument array.

The results will be mapped to an SqlRowSet which holds the data in a disconnected fashion. This wrapper will translate any SQLExceptions thrown.

Note that that, for the default implementation, JDBC RowSet support needs to be available at runtime: by default, Sun's com.sun.rowset.CachedRowSetImpl class is used, which is part of JDK 1.5+ and also available separately as part of Sun's JDBC RowSet Implementations download (rowset.jar).

Parameters:

sql - SQL query to execute

Returns:

a SqlRowSet representation (possibly a wrapper around a javax.sql.rowset.CachedRowSet)

Throws:

org.springframework.dao.DataAccessException - if there is any problem executing the query

See Also:

queryForRowSet(String, Object[]), SqlRowSetResultSetExtractor, CachedRowSet

update

int update(String sql)
    throws org.springframework.dao.DataAccessException

Issue a single SQL update operation (such as an insert, update or delete statement).

Parameters:

sql - static SQL to execute

Returns:

the number of rows affected

Throws:

org.springframework.dao.DataAccessException - if there is any problem.

batchUpdate

int[] batchUpdate(String... sql)
           throws org.springframework.dao.DataAccessException

Issue multiple SQL updates on a single JDBC Statement using batching.

Will fall back to separate updates on a single Statement if the JDBC driver does not support batch updates.

Parameters:

sql - defining an array of SQL statements that will be executed.

Returns:

an array of the number of rows affected by each statement

Throws:

org.springframework.dao.DataAccessException - if there is any problem executing the batch

execute

<T> T execute(PreparedStatementCreator psc,
              PreparedStatementCallback<T> action)
       throws org.springframework.dao.DataAccessException

Execute a JDBC data access operation, implemented as callback action working on a JDBC PreparedStatement. This allows for implementing arbitrary data access operations on a single Statement, within Spring's managed JDBC environment: that is, participating in Spring-managed transactions and converting JDBC SQLExceptions into Spring's DataAccessException hierarchy.

The callback action can return a result object, for example a domain object or a collection of domain objects.

Parameters:

psc - object that can create a PreparedStatement given a Connection

action - callback object that specifies the action

Returns:

a result object returned by the action, or null

Throws:

org.springframework.dao.DataAccessException - if there is any problem

execute

<T> T execute(String sql,
              PreparedStatementCallback<T> action)
       throws org.springframework.dao.DataAccessException

Execute a JDBC data access operation, implemented as callback action working on a JDBC PreparedStatement. This allows for implementing arbitrary data access operations on a single Statement, within Spring's managed JDBC environment: that is, participating in Spring-managed transactions and converting JDBC SQLExceptions into Spring's DataAccessException hierarchy.

The callback action can return a result object, for example a domain object or a collection of domain objects.

Parameters:

sql - SQL to execute

action - callback object that specifies the action

Returns:

a result object returned by the action, or null

Throws:

org.springframework.dao.DataAccessException - if there is any problem

query

<T> T query(PreparedStatementCreator psc,
            ResultSetExtractor<T> rse)
     throws org.springframework.dao.DataAccessException

Query using a prepared statement, reading the ResultSet with a ResultSetExtractor.

A PreparedStatementCreator can either be implemented directly or configured through a PreparedStatementCreatorFactory.

Parameters:

psc - object that can create a PreparedStatement given a Connection

rse - object that will extract results

Returns:

an arbitrary result object, as returned by the ResultSetExtractor

Throws:

org.springframework.dao.DataAccessException - if there is any problem

See Also:

PreparedStatementCreatorFactory

query

<T> T query(String sql,
            PreparedStatementSetter pss,
            ResultSetExtractor<T> rse)
     throws org.springframework.dao.DataAccessException

Query using a prepared statement, reading the ResultSet with a ResultSetExtractor.

Parameters:

sql - SQL query to execute

pss - object that knows how to set values on the prepared statement. If this is null, the SQL will be assumed to contain no bind parameters. Even if there are no bind parameters, this object may be used to set fetch size and other performance options.

rse - object that will extract results

Returns:

an arbitrary result object, as returned by the ResultSetExtractor

Throws:

org.springframework.dao.DataAccessException - if there is any problem

query

<T> T query(String sql,
            Object[] args,
            int[] argTypes,
            ResultSetExtractor<T> rse)
     throws org.springframework.dao.DataAccessException

Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, reading the ResultSet with a ResultSetExtractor.

Parameters:

sql - SQL query to execute

args - arguments to bind to the query

argTypes - SQL types of the arguments (constants from java.sql.Types)

rse - object that will extract results

Returns:

an arbitrary result object, as returned by the ResultSetExtractor

Throws:

org.springframework.dao.DataAccessException - if the query fails

See Also:

Types

query

<T> T query(String sql,
            Object[] args,
            ResultSetExtractor<T> rse)
     throws org.springframework.dao.DataAccessException

Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, reading the ResultSet with a ResultSetExtractor.

Parameters:

sql - SQL query to execute

args - arguments to bind to the query (leaving it to the PreparedStatement to guess the corresponding SQL type); may also contain SqlParameterValue objects which indicate not only the argument value but also the SQL type and optionally the scale

rse - object that will extract results

Returns:

an arbitrary result object, as returned by the ResultSetExtractor

Throws:

org.springframework.dao.DataAccessException - if the query fails

query

<T> T query(String sql,
            ResultSetExtractor<T> rse,
            Object... args)
     throws org.springframework.dao.DataAccessException

Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, reading the ResultSet with a ResultSetExtractor.

Parameters:

sql - SQL query to execute

rse - object that will extract results

args - arguments to bind to the query (leaving it to the PreparedStatement to guess the corresponding SQL type); may also contain SqlParameterValue objects which indicate not only the argument value but also the SQL type and optionally the scale

Returns:

an arbitrary result object, as returned by the ResultSetExtractor

Throws:

org.springframework.dao.DataAccessException - if the query fails

query

void query(PreparedStatementCreator psc,
           RowCallbackHandler rch)
    throws org.springframework.dao.DataAccessException

Query using a prepared statement, reading the ResultSet on a per-row basis with a RowCallbackHandler.

A PreparedStatementCreator can either be implemented directly or configured through a PreparedStatementCreatorFactory.

Parameters:

psc - object that can create a PreparedStatement given a Connection

rch - object that will extract results, one row at a time

Throws:

org.springframework.dao.DataAccessException - if there is any problem

See Also:

PreparedStatementCreatorFactory

query

void query(String sql,
           PreparedStatementSetter pss,
           RowCallbackHandler rch)
    throws org.springframework.dao.DataAccessException

Query given SQL to create a prepared statement from SQL and a PreparedStatementSetter implementation that knows how to bind values to the query, reading the ResultSet on a per-row basis with a RowCallbackHandler.

Parameters:

sql - SQL query to execute

pss - object that knows how to set values on the prepared statement. If this is null, the SQL will be assumed to contain no bind parameters. Even if there are no bind parameters, this object may be used to set fetch size and other performance options.

rch - object that will extract results, one row at a time

Throws:

org.springframework.dao.DataAccessException - if the query fails

query

void query(String sql,
           Object[] args,
           int[] argTypes,
           RowCallbackHandler rch)
    throws org.springframework.dao.DataAccessException

Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, reading the ResultSet on a per-row basis with a RowCallbackHandler.

Parameters:

sql - SQL query to execute

args - arguments to bind to the query

argTypes - SQL types of the arguments (constants from java.sql.Types)

rch - object that will extract results, one row at a time

Throws:

org.springframework.dao.DataAccessException - if the query fails

See Also:

Types

query

void query(String sql,
           Object[] args,
           RowCallbackHandler rch)
    throws org.springframework.dao.DataAccessException

Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, reading the ResultSet on a per-row basis with a RowCallbackHandler.

Parameters:

sql - SQL query to execute

args - arguments to bind to the query (leaving it to the PreparedStatement to guess the corresponding SQL type); may also contain SqlParameterValue objects which indicate not only the argument value but also the SQL type and optionally the scale

rch - object that will extract results, one row at a time

Throws:

org.springframework.dao.DataAccessException - if the query fails

query

void query(String sql,
           RowCallbackHandler rch,
           Object... args)
    throws org.springframework.dao.DataAccessException

Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, reading the ResultSet on a per-row basis with a RowCallbackHandler.

Parameters:

sql - SQL query to execute

rch - object that will extract results, one row at a time

args - arguments to bind to the query (leaving it to the PreparedStatement to guess the corresponding SQL type); may also contain SqlParameterValue objects which indicate not only the argument value but also the SQL type and optionally the scale

Throws:

org.springframework.dao.DataAccessException - if the query fails

query

<T> List<T> query(PreparedStatementCreator psc,
                  RowMapper<T> rowMapper)
           throws org.springframework.dao.DataAccessException

Query using a prepared statement, mapping each row to a Java object via a RowMapper.

A PreparedStatementCreator can either be implemented directly or configured through a PreparedStatementCreatorFactory.

Parameters:

psc - object that can create a PreparedStatement given a Connection

rowMapper - object that will map one object per row

Returns:

the result List, containing mapped objects

Throws:

org.springframework.dao.DataAccessException - if there is any problem

See Also:

PreparedStatementCreatorFactory

query

<T> List<T> query(String sql,
                  PreparedStatementSetter pss,
                  RowMapper<T> rowMapper)
           throws org.springframework.dao.DataAccessException

Query given SQL to create a prepared statement from SQL and a PreparedStatementSetter implementation that knows how to bind values to the query, mapping each row to a Java object via a RowMapper.

Parameters:

sql - SQL query to execute

pss - object that knows how to set values on the prepared statement. If this is null, the SQL will be assumed to contain no bind parameters. Even if there are no bind parameters, this object may be used to set fetch size and other performance options.

rowMapper - object that will map one object per row

Returns:

the result List, containing mapped objects

Throws:

org.springframework.dao.DataAccessException - if the query fails

query

<T> List<T> query(String sql,
                  Object[] args,
                  int[] argTypes,
                  RowMapper<T> rowMapper)
           throws org.springframework.dao.DataAccessException

Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, mapping each row to a Java object via a RowMapper.

Parameters:

sql - SQL query to execute

args - arguments to bind to the query

argTypes - SQL types of the arguments (constants from java.sql.Types)

rowMapper - object that will map one object per row

Returns:

the result List, containing mapped objects

Throws:

org.springframework.dao.DataAccessException - if the query fails

See Also:

Types

query

<T> List<T> query(String sql,
                  Object[] args,
                  RowMapper<T> rowMapper)
           throws org.springframework.dao.DataAccessException

Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, mapping each row to a Java object via a RowMapper.

Parameters:

sql - SQL query to execute

args - arguments to bind to the query (leaving it to the PreparedStatement to guess the corresponding SQL type); may also contain SqlParameterValue objects which indicate not only the argument value but also the SQL type and optionally the scale

rowMapper - object that will map one object per row

Returns:

the result List, containing mapped objects

Throws:

org.springframework.dao.DataAccessException - if the query fails

query

<T> List<T> query(String sql,
                  RowMapper<T> rowMapper,
                  Object... args)
           throws org.springframework.dao.DataAccessException

Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, mapping each row to a Java object via a RowMapper.

Parameters:

sql - SQL query to execute

rowMapper - object that will map one object per row

args - arguments to bind to the query (leaving it to the PreparedStatement to guess the corresponding SQL type); may also contain SqlParameterValue objects which indicate not only the argument value but also the SQL type and optionally the scale

Returns:

the result List, containing mapped objects

Throws:

org.springframework.dao.DataAccessException - if the query fails

queryForObject

<T> T queryForObject(String sql,
                     Object[] args,
                     int[] argTypes,
                     RowMapper<T> rowMapper)
              throws org.springframework.dao.DataAccessException

Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, mapping a single result row to a Java object via a RowMapper.

Parameters:

sql - SQL query to execute

args - arguments to bind to the query (leaving it to the PreparedStatement to guess the corresponding SQL type)

argTypes - SQL types of the arguments (constants from java.sql.Types)

rowMapper - object that will map one object per row

Returns:

the single mapped object

Throws:

org.springframework.dao.IncorrectResultSizeDataAccessException - if the query does not return exactly one row

org.springframework.dao.DataAccessException - if the query fails

queryForObject

<T> T queryForObject(String sql,
                     Object[] args,
                     RowMapper<T> rowMapper)
              throws org.springframework.dao.DataAccessException

Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, mapping a single result row to a Java object via a RowMapper.

Parameters:

sql - SQL query to execute

args - arguments to bind to the query (leaving it to the PreparedStatement to guess the corresponding SQL type); may also contain SqlParameterValue objects which indicate not only the argument value but also the SQL type and optionally the scale

rowMapper - object that will map one object per row

Returns:

the single mapped object

Throws:

org.springframework.dao.IncorrectResultSizeDataAccessException - if the query does not return exactly one row

org.springframework.dao.DataAccessException - if the query fails

queryForObject

<T> T queryForObject(String sql,
                     RowMapper<T> rowMapper,
                     Object... args)
              throws org.springframework.dao.DataAccessException

Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, mapping a single result row to a Java object via a RowMapper.

Parameters:

sql - SQL query to execute

rowMapper - object that will map one object per row

args - arguments to bind to the query (leaving it to the PreparedStatement to guess the corresponding SQL type); may also contain SqlParameterValue objects which indicate not only the argument value but also the SQL type and optionally the scale

Returns:

the single mapped object

Throws:

org.springframework.dao.IncorrectResultSizeDataAccessException - if the query does not return exactly one row

org.springframework.dao.DataAccessException - if the query fails

queryForObject

<T> T queryForObject(String sql,
                     Object[] args,
                     int[] argTypes,
                     Class<T> requiredType)
              throws org.springframework.dao.DataAccessException

Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, expecting a result object.

The query is expected to be a single row/single column query; the returned result will be directly mapped to the corresponding object type.

Parameters:

sql - SQL query to execute

args - arguments to bind to the query

argTypes - SQL types of the arguments (constants from java.sql.Types)

requiredType - the type that the result object is expected to match

Returns:

the result object of the required type, or null in case of SQL NULL

Throws:

org.springframework.dao.IncorrectResultSizeDataAccessException - if the query does not return exactly one row, or does not return exactly one column in that row

org.springframework.dao.DataAccessException - if the query fails

See Also:

queryForObject(String, Class), Types

queryForObject

<T> T queryForObject(String sql,
                     Object[] args,
                     Class<T> requiredType)
              throws org.springframework.dao.DataAccessException

Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, expecting a result object.

The query is expected to be a single row/single column query; the returned result will be directly mapped to the corresponding object type.

Parameters:

sql - SQL query to execute

args - arguments to bind to the query (leaving it to the PreparedStatement to guess the corresponding SQL type); may also contain SqlParameterValue objects which indicate not only the argument value but also the SQL type and optionally the scale

requiredType - the type that the result object is expected to match

Returns:

the result object of the required type, or null in case of SQL NULL

Throws:

org.springframework.dao.IncorrectResultSizeDataAccessException - if the query does not return exactly one row, or does not return exactly one column in that row

org.springframework.dao.DataAccessException - if the query fails

See Also:

queryForObject(String, Class)

queryForObject

<T> T queryForObject(String sql,
                     Class<T> requiredType,
                     Object... args)
              throws org.springframework.dao.DataAccessException

Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, expecting a result object.

The query is expected to be a single row/single column query; the returned result will be directly mapped to the corresponding object type.

Parameters:

sql - SQL query to execute

requiredType - the type that the result object is expected to match

args - arguments to bind to the query (leaving it to the PreparedStatement to guess the corresponding SQL type); may also contain SqlParameterValue objects which indicate not only the argument value but also the SQL type and optionally the scale

Returns:

the result object of the required type, or null in case of SQL NULL

Throws:

org.springframework.dao.IncorrectResultSizeDataAccessException - if the query does not return exactly one row, or does not return exactly one column in that row

org.springframework.dao.DataAccessException - if the query fails

See Also:

queryForObject(String, Class)

queryForMap

Map<String,Object> queryForMap(String sql,
                               Object[] args,
                               int[] argTypes)
                        throws org.springframework.dao.DataAccessException

Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, expecting a result Map.

The query is expected to be a single row query; the result row will be mapped to a Map (one entry for each column, using the column name as the key).

Parameters:

sql - SQL query to execute

args - arguments to bind to the query

argTypes - SQL types of the arguments (constants from java.sql.Types)

Returns:

the result Map (one entry for each column, using the column name as the key)

Throws:

org.springframework.dao.IncorrectResultSizeDataAccessException - if the query does not return exactly one row

org.springframework.dao.DataAccessException - if the query fails

See Also:

queryForMap(String), ColumnMapRowMapper, Types

queryForMap

Map<String,Object> queryForMap(String sql,
                               Object... args)
                        throws org.springframework.dao.DataAccessException

Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, expecting a result Map. The queryForMap() methods defined by this interface are appropriate when you don't have a domain model. Otherwise, consider using one of the queryForObject() methods.

The query is expected to be a single row query; the result row will be mapped to a Map (one entry for each column, using the column name as the key).

Parameters:

sql - SQL query to execute

args - arguments to bind to the query (leaving it to the PreparedStatement to guess the corresponding SQL type); may also contain SqlParameterValue objects which indicate not only the argument value but also the SQL type and optionally the scale

Returns:

the result Map (one entry for each column, using the column name as the key)

Throws:

org.springframework.dao.IncorrectResultSizeDataAccessException - if the query does not return exactly one row

org.springframework.dao.DataAccessException - if the query fails

See Also:

queryForMap(String), ColumnMapRowMapper

queryForLong

@Deprecated
long queryForLong(String sql,
                              Object[] args,
                              int[] argTypes)
                       throws org.springframework.dao.DataAccessException

Deprecated. in favor of queryForObject(String, Object[], int[], Class) )}

Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, resulting in a long value.

The query is expected to be a single row/single column query that results in a long value.

Parameters:

sql - SQL query to execute

args - arguments to bind to the query

argTypes - SQL types of the arguments (constants from java.sql.Types)

Returns:

the long value, or 0 in case of SQL NULL

Throws:

org.springframework.dao.IncorrectResultSizeDataAccessException - if the query does not return exactly one row, or does not return exactly one column in that row

org.springframework.dao.DataAccessException - if the query fails

See Also:

queryForLong(String), Types

queryForLong

@Deprecated
long queryForLong(String sql,
                              Object... args)
                       throws org.springframework.dao.DataAccessException

Deprecated. in favor of queryForObject(String, Class, Object[]) )}

Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, resulting in a long value.

The query is expected to be a single row/single column query that results in a long value.

Parameters:

sql - SQL query to execute

args - arguments to bind to the query (leaving it to the PreparedStatement to guess the corresponding SQL type); may also contain SqlParameterValue objects which indicate not only the argument value but also the SQL type and optionally the scale

Returns:

the long value, or 0 in case of SQL NULL

Throws:

org.springframework.dao.IncorrectResultSizeDataAccessException - if the query does not return exactly one row, or does not return exactly one column in that row

org.springframework.dao.DataAccessException - if the query fails

See Also:

queryForLong(String)

queryForInt

@Deprecated
int queryForInt(String sql,
                            Object[] args,
                            int[] argTypes)
                     throws org.springframework.dao.DataAccessException

Deprecated. in favor of queryForObject(String, Object[], int[], Class) )}

Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, resulting in an int value.

The query is expected to be a single row/single column query that results in an int value.

Parameters:

sql - SQL query to execute

args - arguments to bind to the query

argTypes - SQL types of the arguments (constants from java.sql.Types)

Returns:

the int value, or 0 in case of SQL NULL

Throws:

org.springframework.dao.IncorrectResultSizeDataAccessException - if the query does not return exactly one row, or does not return exactly one column in that row

org.springframework.dao.DataAccessException - if the query fails

See Also:

queryForInt(String), Types

queryForInt

@Deprecated
int queryForInt(String sql,
                            Object... args)
                     throws org.springframework.dao.DataAccessException

Deprecated. in favor of queryForObject(String, Class, Object[]) )}

Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, resulting in an int value.

The query is expected to be a single row/single column query that results in an int value.

Parameters:

sql - SQL query to execute

args - arguments to bind to the query (leaving it to the PreparedStatement to guess the corresponding SQL type); may also contain SqlParameterValue objects which indicate not only the argument value but also the SQL type and optionally the scale

Returns:

the int value, or 0 in case of SQL NULL

Throws:

org.springframework.dao.IncorrectResultSizeDataAccessException - if the query does not return exactly one row, or does not return exactly one column in that row

org.springframework.dao.DataAccessException - if the query fails

See Also:

queryForInt(String)

queryForList

<T> List<T> queryForList(String sql,
                         Object[] args,
                         int[] argTypes,
                         Class<T> elementType)
                  throws org.springframework.dao.DataAccessException

Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, expecting a result list.

The results will be mapped to a List (one entry for each row) of result objects, each of them matching the specified element type.

Parameters:

sql - SQL query to execute

args - arguments to bind to the query

argTypes - SQL types of the arguments (constants from java.sql.Types)

elementType - the required type of element in the result list (for example, Integer.class)

Returns:

a List of objects that match the specified element type

Throws:

org.springframework.dao.DataAccessException - if the query fails

See Also:

queryForList(String, Class), SingleColumnRowMapper

queryForList

<T> List<T> queryForList(String sql,
                         Object[] args,
                         Class<T> elementType)
                  throws org.springframework.dao.DataAccessException

Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, expecting a result list.

The results will be mapped to a List (one entry for each row) of result objects, each of them matching the specified element type.

Parameters:

sql - SQL query to execute

args - arguments to bind to the query (leaving it to the PreparedStatement to guess the corresponding SQL type); may also contain SqlParameterValue objects which indicate not only the argument value but also the SQL type and optionally the scale

elementType - the required type of element in the result list (for example, Integer.class)

Returns:

a List of objects that match the specified element type

Throws:

org.springframework.dao.DataAccessException - if the query fails

See Also:

queryForList(String, Class), SingleColumnRowMapper

queryForList

<T> List<T> queryForList(String sql,
                         Class<T> elementType,
                         Object... args)
                  throws org.springframework.dao.DataAccessException

Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, expecting a result list.

The results will be mapped to a List (one entry for each row) of result objects, each of them matching the specified element type.

Parameters:

sql - SQL query to execute

elementType - the required type of element in the result list (for example, Integer.class)

args - arguments to bind to the query (leaving it to the PreparedStatement to guess the corresponding SQL type); may also contain SqlParameterValue objects which indicate not only the argument value but also the SQL type and optionally the scale

Returns:

a List of objects that match the specified element type

Throws:

org.springframework.dao.DataAccessException - if the query fails

See Also:

queryForList(String, Class), SingleColumnRowMapper

queryForList

List<Map<String,Object>> queryForList(String sql,
                                      Object[] args,
                                      int[] argTypes)
                               throws org.springframework.dao.DataAccessException

Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, expecting a result list.

The results will be mapped to a List (one entry for each row) of Maps (one entry for each column, using the column name as the key). Thus Each element in the list will be of the form returned by this interface's queryForMap() methods.

Parameters:

sql - SQL query to execute

args - arguments to bind to the query

argTypes - SQL types of the arguments (constants from java.sql.Types)

Returns:

a List that contains a Map per row

Throws:

org.springframework.dao.DataAccessException - if the query fails

See Also:

queryForList(String), Types

queryForList

List<Map<String,Object>> queryForList(String sql,
                                      Object... args)
                               throws org.springframework.dao.DataAccessException

Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, expecting a result list.

The results will be mapped to a List (one entry for each row) of Maps (one entry for each column, using the column name as the key). Each element in the list will be of the form returned by this interface's queryForMap() methods.

Parameters:

sql - SQL query to execute

args - arguments to bind to the query (leaving it to the PreparedStatement to guess the corresponding SQL type); may also contain SqlParameterValue objects which indicate not only the argument value but also the SQL type and optionally the scale

Returns:

a List that contains a Map per row

Throws:

org.springframework.dao.DataAccessException - if the query fails

See Also:

queryForList(String)

queryForRowSet

SqlRowSet queryForRowSet(String sql,
                         Object[] args,
                         int[] argTypes)
                  throws org.springframework.dao.DataAccessException

Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, expecting a SqlRowSet.

The results will be mapped to an SqlRowSet which holds the data in a disconnected fashion. This wrapper will translate any SQLExceptions thrown.

Note that that, for the default implementation, JDBC RowSet support needs to be available at runtime: by default, Sun's com.sun.rowset.CachedRowSetImpl class is used, which is part of JDK 1.5+ and also available separately as part of Sun's JDBC RowSet Implementations download (rowset.jar).

Parameters:

sql - SQL query to execute

args - arguments to bind to the query

argTypes - SQL types of the arguments (constants from java.sql.Types)

Returns:

a SqlRowSet representation (possibly a wrapper around a javax.sql.rowset.CachedRowSet)

Throws:

org.springframework.dao.DataAccessException - if there is any problem executing the query

See Also:

queryForRowSet(String), SqlRowSetResultSetExtractor, CachedRowSet, Types

queryForRowSet

SqlRowSet queryForRowSet(String sql,
                         Object... args)
                  throws org.springframework.dao.DataAccessException

Query given SQL to create a prepared statement from SQL and a list of arguments to bind to the query, expecting a SqlRowSet.

The results will be mapped to an SqlRowSet which holds the data in a disconnected fashion. This wrapper will translate any SQLExceptions thrown.

Note that that, for the default implementation, JDBC RowSet support needs to be available at runtime: by default, Sun's com.sun.rowset.CachedRowSetImpl class is used, which is part of JDK 1.5+ and also available separately as part of Sun's JDBC RowSet Implementations download (rowset.jar).

Parameters:

sql - SQL query to execute

args - arguments to bind to the query (leaving it to the PreparedStatement to guess the corresponding SQL type); may also contain SqlParameterValue objects which indicate not only the argument value but also the SQL type and optionally the scale

Returns:

a SqlRowSet representation (possibly a wrapper around a javax.sql.rowset.CachedRowSet)

Throws:

org.springframework.dao.DataAccessException - if there is any problem executing the query

See Also:

queryForRowSet(String), SqlRowSetResultSetExtractor, CachedRowSet

update

int update(PreparedStatementCreator psc)
    throws org.springframework.dao.DataAccessException

Issue a single SQL update operation (such as an insert, update or delete statement) using a PreparedStatementCreator to provide SQL and any required parameters.

A PreparedStatementCreator can either be implemented directly or configured through a PreparedStatementCreatorFactory.

Parameters:

psc - object that provides SQL and any necessary parameters

Returns:

the number of rows affected

Throws:

org.springframework.dao.DataAccessException - if there is any problem issuing the update

See Also:

PreparedStatementCreatorFactory

update

int update(PreparedStatementCreator psc,
           KeyHolder generatedKeyHolder)
    throws org.springframework.dao.DataAccessException

Issue an update statement using a PreparedStatementCreator to provide SQL and any required parameters. Generated keys will be put into the given KeyHolder.

Note that the given PreparedStatementCreator has to create a statement with activated extraction of generated keys (a JDBC 3.0 feature). This can either be done directly or through using a PreparedStatementCreatorFactory.

Parameters:

psc - object that provides SQL and any necessary parameters

generatedKeyHolder - KeyHolder that will hold the generated keys

Returns:

the number of rows affected

Throws:

org.springframework.dao.DataAccessException - if there is any problem issuing the update

See Also:

PreparedStatementCreatorFactory, GeneratedKeyHolder

update

int update(String sql,
           PreparedStatementSetter pss)
    throws org.springframework.dao.DataAccessException

Issue an update statement using a PreparedStatementSetter to set bind parameters, with given SQL. Simpler than using a PreparedStatementCreator as this method will create the PreparedStatement: The PreparedStatementSetter just needs to set parameters.

Parameters:

sql - SQL containing bind parameters

pss - helper that sets bind parameters. If this is null we run an update with static SQL.

Returns:

the number of rows affected

Throws:

org.springframework.dao.DataAccessException - if there is any problem issuing the update

update

int update(String sql,
           Object[] args,
           int[] argTypes)
    throws org.springframework.dao.DataAccessException

Issue a single SQL update operation (such as an insert, update or delete statement) via a prepared statement, binding the given arguments.

Parameters:

sql - SQL containing bind parameters

args - arguments to bind to the query

argTypes - SQL types of the arguments (constants from java.sql.Types)

Returns:

the number of rows affected

Throws:

org.springframework.dao.DataAccessException - if there is any problem issuing the update

See Also:

Types

update

int update(String sql,
           Object... args)
    throws org.springframework.dao.DataAccessException

Issue a single SQL update operation (such as an insert, update or delete statement) via a prepared statement, binding the given arguments.

Parameters:

sql - SQL containing bind parameters

args - arguments to bind to the query (leaving it to the PreparedStatement to guess the corresponding SQL type); may also contain SqlParameterValue objects which indicate not only the argument value but also the SQL type and optionally the scale

Returns:

the number of rows affected

Throws:

org.springframework.dao.DataAccessException - if there is any problem issuing the update

batchUpdate

int[] batchUpdate(String sql,
                  BatchPreparedStatementSetter pss)
           throws org.springframework.dao.DataAccessException

Issue multiple update statements on a single PreparedStatement, using batch updates and a BatchPreparedStatementSetter to set values.

Will fall back to separate updates on a single PreparedStatement if the JDBC driver does not support batch updates.

Parameters:

sql - defining PreparedStatement that will be reused. All statements in the batch will use the same SQL.

pss - object to set parameters on the PreparedStatement created by this method

Returns:

an array of the number of rows affected by each statement

Throws:

org.springframework.dao.DataAccessException - if there is any problem issuing the update

batchUpdate

int[] batchUpdate(String sql,
                  List<Object[]> batchArgs)
           throws org.springframework.dao.DataAccessException

Execute a batch using the supplied SQL statement with the batch of supplied arguments.

Parameters:

sql - the SQL statement to execute

batchArgs - the List of Object arrays containing the batch of arguments for the query

Returns:

an array containing the numbers of rows affected by each update in the batch

Throws:

org.springframework.dao.DataAccessException

batchUpdate

int[] batchUpdate(String sql,
                  List<Object[]> batchArgs,
                  int[] argTypes)
           throws org.springframework.dao.DataAccessException

Execute a batch using the supplied SQL statement with the batch of supplied arguments.

Parameters:

sql - the SQL statement to execute.

batchArgs - the List of Object arrays containing the batch of arguments for the query

argTypes - SQL types of the arguments (constants from java.sql.Types)

Returns:

an array containing the numbers of rows affected by each update in the batch

Throws:

org.springframework.dao.DataAccessException

batchUpdate

<T> int[][] batchUpdate(String sql,
                        Collection<T> batchArgs,
                        int batchSize,
                        ParameterizedPreparedStatementSetter<T> pss)
                 throws org.springframework.dao.DataAccessException

Execute multiple batches using the supplied SQL statement with the collect of supplied arguments. The arguments' values will be set using the ParameterizedPreparedStatementSetter. Each batch should be of size indicated in 'batchSize'.

Parameters:

sql - the SQL statement to execute.

batchArgs - the List of Object arrays containing the batch of arguments for the query

batchSize - batch size

pss - ParameterizedPreparedStatementSetter to use

Returns:

an array containing for each batch another array containing the numbers of rows affected by each update in the batch

Throws:

org.springframework.dao.DataAccessException

execute

<T> T execute(CallableStatementCreator csc,
              CallableStatementCallback<T> action)
       throws org.springframework.dao.DataAccessException

Execute a JDBC data access operation, implemented as callback action working on a JDBC CallableStatement. This allows for implementing arbitrary data access operations on a single Statement, within Spring's managed JDBC environment: that is, participating in Spring-managed transactions and converting JDBC SQLExceptions into Spring's DataAccessException hierarchy.

The callback action can return a result object, for example a domain object or a collection of domain objects.

Parameters:

csc - object that can create a CallableStatement given a Connection

action - callback object that specifies the action

Returns:

a result object returned by the action, or null

Throws:

org.springframework.dao.DataAccessException - if there is any problem

execute

<T> T execute(String callString,
              CallableStatementCallback<T> action)
       throws org.springframework.dao.DataAccessException

Execute a JDBC data access operation, implemented as callback action working on a JDBC CallableStatement. This allows for implementing arbitrary data access operations on a single Statement, within Spring's managed JDBC environment: that is, participating in Spring-managed transactions and converting JDBC SQLExceptions into Spring's DataAccessException hierarchy.

The callback action can return a result object, for example a domain object or a collection of domain objects.

Parameters:

callString - the SQL call string to execute

action - callback object that specifies the action

Returns:

a result object returned by the action, or null

Throws:

org.springframework.dao.DataAccessException - if there is any problem

call

Map<String,Object> call(CallableStatementCreator csc,
                        List<SqlParameter> declaredParameters)
                 throws org.springframework.dao.DataAccessException

Execute a SQL call using a CallableStatementCreator to provide SQL and any required parameters.

Parameters:

csc - object that provides SQL and any necessary parameters

declaredParameters - list of declared SqlParameter objects

Returns:

Map of extracted out parameters

Throws:

org.springframework.dao.DataAccessException - if there is any problem issuing the update