org.springframework.jdbc.core
Interface CallableStatementCreator

All Known Implementing Classes:
JdbcTemplate.SimpleCallableStatementCreator

public interface CallableStatementCreator

One of the three central callback interfaces used by the JdbcTemplate class. This interface creates a CallableStatement given a connection, provided by the JdbcTemplate class. Implementations are responsible for providing SQL and any necessary parameters.

Implementations do not need to concern themselves with SQLExceptions that may be thrown from operations they attempt. The JdbcTemplate class will catch and handle SQLExceptions appropriately.

A PreparedStatementCreator should also implement the SqlProvider interface if it is able to provide the SQL it uses for PreparedStatement creation. This allows for better contextual information in case of exceptions.

Author:
Rod Johnson, Thomas Risberg
See Also:
JdbcTemplate.execute(CallableStatementCreator, CallableStatementCallback), JdbcTemplate.call(org.springframework.jdbc.core.CallableStatementCreator, java.util.List), SqlProvider

Method Summary
 java.sql.CallableStatement createCallableStatement(java.sql.Connection con)
          Create a callable statement in this connection.
 

Method Detail

createCallableStatement

public java.sql.CallableStatement createCallableStatement(java.sql.Connection con)
                                                   throws java.sql.SQLException
Create a callable statement in this connection. Allows implementations to use CallableStatements.

Parameters:
con - Connection to use to create statement
Returns:
a callable statement
Throws:
java.sql.SQLException - there is no need to catch SQLExceptions that may be thrown in the implementation of this method. The JdbcTemplate class will handle them.


Copyright (C) 2003-2004 The Spring Framework Project.