com.agimatec.sql
Class SQLStatement

java.lang.Object
  com.agimatec.sql.SQLStatement

public class SQLStatement
extends java.lang.Object

This class represents a SQLStatement with its parameters.

Constructor Summary

SQLStatement(java.lang.String stmtString)
Construct with the given sqlStatementString.

SQLStatement(java.lang.String stmtString, java.util.List params)
Construct with a given sqlStatementString an a parameter list

Method Summary

void	addParameter(java.lang.Object value) Add the given value to the receiver's parameter list.
java.sql.PreparedStatement	asPreparedStatement(java.sql.Connection conn) Create a new JDBC PreparedStatement with the receiver's parameters.
java.lang.String	getParameterizedStatement() return the statement including parameter values instead of ?
java.util.List	getParameters() Return the statement parameters
SQLStatement	getPreparedStatement() return a copy of the receiver or the receiver itself (when not changed) that is ready to be executed with asPreparedStatement(connection) where the SQL and parameters have been transformed so that execution result is the same as when the receiver would have been transformed by getParameterizedStatement().
java.lang.String	getStatement() Return the sql statement string
void	logInfo(org.apache.commons.logging.Log log) Logging convenience - Log the receiver's sql (with ?
void	provideParameters(java.sql.PreparedStatement stmt) Set the receiver's parameters into the given PreparedStatement.
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

SQLStatement

public SQLStatement(java.lang.String stmtString)

Construct with the given sqlStatementString. You may provide the parameters with getParameters().add() afterwards.

SQLStatement

public SQLStatement(java.lang.String stmtString,
                    java.util.List params)

Construct with a given sqlStatementString an a parameter list

Method Detail

getStatement

public java.lang.String getStatement()

Return the sql statement string

getParameters

public java.util.List getParameters()

Return the statement parameters

addParameter

public void addParameter(java.lang.Object value)

Add the given value to the receiver's parameter list.

asPreparedStatement

public java.sql.PreparedStatement asPreparedStatement(java.sql.Connection conn)
                                               throws java.sql.SQLException

Create a new JDBC PreparedStatement with the receiver's parameters.

Throws:

java.sql.SQLException

provideParameters

public void provideParameters(java.sql.PreparedStatement stmt)
                       throws java.sql.SQLException

Set the receiver's parameters into the given PreparedStatement. CAUTION: the given statement must match with the receiver!

Throws:

java.sql.SQLException

logInfo

public void logInfo(org.apache.commons.logging.Log log)

Logging convenience - Log the receiver's sql (with ? instead of parameters) and parameters (separetely) onto the logdevice under info priority

getParameterizedStatement

public java.lang.String getParameterizedStatement()

return the statement including parameter values instead of ?

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

getPreparedStatement

public SQLStatement getPreparedStatement()

return a copy of the receiver or the receiver itself (when not changed) that is ready to be executed with asPreparedStatement(connection) where the SQL and parameters have been transformed so that execution result is the same as when the receiver would have been transformed by getParameterizedStatement().

into adequate strings and modifies the statement so that correct behavior is guaranteed. Note: Parameters of Collection types are generated into the statement as separate parameters.