org.eclipse.smila.jdbc

Class SqlExecutor

java.lang.Object

org.eclipse.smila.jdbc.SqlExecutor

All Implemented Interfaces:

java.lang.AutoCloseable

public class SqlExecutor
extends java.lang.Object
implements java.lang.AutoCloseable

Class for executing multiple SQL requests by using one Connection and one PreparedStatement. Must be closed after processing to clean up DB resources!

Constructor Summary

Constructors

Constructor and Description
SqlExecutor(java.sql.Connection con, java.lang.String sql, long maxAttachmentSize, MessageCollector messages)

Method Summary

Methods

Modifier and Type	Method and Description
void	close() close statement and db connection.
java.util.Collection<Record>	execute(java.util.List<Value> parameters)
Record	executeAndMerge(java.util.List<Value> parameters)
int	executeUpdate(java.util.List<Value> parameters)
int	executeUpdate(java.util.List<Value> parameters, int nullType) execute update, supports null parameter values, too.
protected void	finalize()
java.lang.String	getSql()

Methods inherited from class java.lang.Object

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

Constructor Detail

SqlExecutor

public SqlExecutor(java.sql.Connection con,
           java.lang.String sql,
           long maxAttachmentSize,
           MessageCollector messages)
            throws java.sql.SQLException

Parameters:

con - a database connection

sql - an SQL statement which will be used as PreparedStatement, so it may contain '?' parameters.

Throws:

java.sql.SQLException

Method Detail

getSql

public java.lang.String getSql()

executeAndMerge

public Record executeAndMerge(java.util.List<Value> parameters)
                       throws java.sql.SQLException,
                              java.io.IOException

Parameters:

parameters - the parameters for the SQL (Prepared)statement given in the constructor. Values must not be null.

Returns:

one record. If SQL result contains multiple results, they are merged in one record.

Throws:

java.sql.SQLException

java.io.IOException

execute

public java.util.Collection<Record> execute(java.util.List<Value> parameters)
                                     throws java.sql.SQLException,
                                            java.io.IOException

Parameters:

parameters - the parameters for the SQL (Prepared)statement given in the constructor. Values must not be null.

Returns:

A collection of records.

Throws:

java.sql.SQLException

java.io.IOException

executeUpdate

public int executeUpdate(java.util.List<Value> parameters)
                  throws java.sql.SQLException,
                         java.io.IOException

Parameters:

parameters - the parameters for the SQL (Prepared)statement given in the constructor. Values must not be null.

Returns:

number of updated rows

Throws:

java.sql.SQLException

java.io.IOException

executeUpdate

public int executeUpdate(java.util.List<Value> parameters,
                int nullType)
                  throws java.sql.SQLException,
                         java.io.IOException

execute update, supports null parameter values, too.

Parameters:

parameters - the parameters for the SQL (Prepared)statement given in the constructor.

nullType - SQL type for null values in parameters, see Types.

Returns:

number of updated rows

Throws:

java.sql.SQLException

java.io.IOException

close

public void close()

close statement and db connection.

Specified by:

close in interface java.lang.AutoCloseable

finalize

protected void finalize()
                 throws java.lang.Throwable

Overrides:

finalize in class java.lang.Object

Throws:

java.lang.Throwable